手順

1. 端末ウインドウで、インストーラー JAR ファイルをダウンロードしたディレクトリーに移動し、以下のコマンドを入力します。

   java -jar rhpam-installer-7.1.0.jar

   注記

   Windows でインストーラーを実行すると、インストール時に管理者の認証情報が求められる場合があります。この要求を回避するには、インストールコマンドに izpack.mode=privileged オプションを追加します。

   java -Dizpack.mode=privileged -jar
   rhpam-installer-7.1.0.jar

   また、32 ビットの Java 仮想マシンでインストーラーを実行している場合には、メモリー不足になる可能性があります。この問題を防ぐには、以下のコマンドを実行します。

   java -XX:MaxHeapSize=4g -jar
   rhpam-installer-7.1.0.jar

   グラフィカルインストーラーにスプラッシュ画面と使用許諾契約書のページが表示されます。

2. I accept the terms of this license agreement (本使用許諾契約書の内容に同意します) をクリックし、Next をクリックします。
3. Red Hat Process Automation Manager をインストールする Red Hat JBoss EAP 7.1 サーバーのホームを指定して、Next をクリックします。

4. インストールするコンポーネントを選択し、Next をクリックします。

   注記

   Business Central と Process Server は同じサーバーにインストールできますが、実稼働環境では異なるサーバーにこの 2 つをインストールすることを推奨します。ただし、実稼働環境では、Business Central と Process Server は異なるサーバーにインストールすることが推奨されます。そのためには、インストーラーを 2 回実行します。

5. ユーザーを作成して Next をクリックします。デフォルトでは、新規ユーザーに admin ロール、kie-server ロール、および rest-all ロールが付与されます。別のロールを選択する場合は、admin ロールを外します。詳細は、2章ロールおよびユーザー を参照してください。

   注記

   必ず、既存のユーザー、ロール、またはグループとは異なるユーザー名を指定してください。たとえば、admin という名前のユーザーは作成しないでください。

   パスワードは 8 文字以上で、数字と、英数字以外の文字をそれぞれ 1 文字以上使用する必要があります。ただし & の文字は使用できません。

   ユーザー名とパスワードを書き留めておきます。これは Business Central および Process Server にアクセスする際に必要になります。

6. Installation Overview ページで Next をクリックしてインストールを起動します。Installation Overview ページに、インストールされるコンポーネントの一覧が表示されます。
7. インストールが完了したら、Next をクリックします。

8. Configure Runtime Environment ページで、デフォルトのインストールまたは詳細設定のいずれかを選択します。

   Perform advanced configuration を選択した場合は、データベース設定、または特定の Process Server オプションのカスタマイズが選択できます。

9. JDBC Drive Configuration ページで Customize database settings を選択した場合は、データソースの JDBC ドライバーのベンダーを選択し、ドライバーの JAR ファイルを 1 つ以上選択し、Next をクリックします。

   データソースは、アプリケーションサーバーなど、Java Database Connectivity (JDBC) クライアントを有効にするオブジェクトで、データベースへの接続を確立します。アプリケーションは、JNDI (Java Naming and Directory Interface) ツリーまたはローカルのアプリケーションコンテキストでデータソースを検索し、データベース接続を要求してデータを取得します。Process Server にデータソースを設定して、サーバーと、指定したデータベースとの間で適切なデータ交換を行う必要があります。

10. Customize Process Server settings を選択した場合には、必要に応じて以下のいずれかを変更します。

    • Process Server プロパティーの名前を変更します。
    • ヘッドレス Process Automation Manager コントローラーの URL を変更します。
    • Process Server のサーバーオプションの選択を解除します。
11. Next をクリックして、ランタイム環境を設定します。
12. 画面上部に Processing finished が表示されたら、Next をクリックしてインストールを完了します。

13. 必要であれば、Generate Installation Script and Properties File をクリックしてインストールデータを XML ファイルに保存し、続いて Done をクリックします。このファイルを使用して、同じタイプのサーバーに Red Hat Process Automation Manager を自動的にインストールできます。XML ファイルの installpath パラメーターを変更して、Red Hat Process Automation Manager をインストールする新しいサーバーのパスを指定しなければならない点に注意してください。XML ファイルを使用してインストールを行う場合は、以下のコマンドを実行します。

    java -jar rhpam-installer-7.1.0.jar <path-to-file>

手順

1. 端末ウインドウにおいて、インストーラーファイルをダウンロードしたディレクトリーに移動し、以下のコマンドを入力します。

   java -jar rhpam-installer-7.1.0.jar -console

   コマンドラインの対話プロセスが開始し、使用許諾契約書が表示されます。

   press 1 to continue, 2 to quit, 3 to redisplay.

2. 使用許諾契約書を読んで 1 を入力し、Enter キーを押して続行します。

   Specify the home directory of one of the following servers:  Red Hat JBoss EAP 7.1

3. 既存の Red Hat JBoss EAP 7.1 インストールの親ディレクトリーを入力します。

   インストーラーが、指定したインストール場所を確認します。1 を入力して確認し、続行します。

   注記

   Business Central と Process Server は同じサーバーにインストールできますが、実稼働環境では異なるサーバーにこの 2 つをインストールすることを推奨します。ただし、実稼働環境では、Business Central と Process Server は異なるサーバーにインストールすることが推奨されます。

4. インストーラーの指示に従って、インストールを完了します。

   注記

   ユーザー名およびパスワードを作成する場合は、指定したユーザー名が既存のロールまたはグループの名前と競合しないようにしてください。たとえば、admin というロールがある場合は、admin という名前のユーザーは作成しないでください。

   パスワードは 8 文字以上で、数字と、英数字以外の文字をそれぞれ 1 文字以上使用する必要があります。ただし & の文字を使用することは できません。

   ユーザー名とパスワードを書き留めておきます。これは Business Central および Process Server にアクセスする際に必要になります。

5. インストールが完了すると、以下のメッセージが表示されます。

   Would you like to generate an automatic installation script and properties file?

6. y を入力してインストールデータが含まれる XML ファイルを作成します。y を入力すると、XML ファイルのパスを指定するように求められます。
7. パスを入力するか、Enter キーを押して提案されたパスを了承します。
8. Business Central のみをインストールした場合は、別のサーバーでこれらのステップを繰り返して Process Server をインストールします。

手順

1. 1 台目のコンピューターで、インタラクティブモードまたは CLI モードでインストーラーを実行します。詳細は以下のセクションのいずれかを参照してください。

   • 「インタラクティブモードでのインストーラーの使用」
   • 「CLI モードでのインストーラーの使用」
2. Component Selection ページで、Process Server チェックボックスを外します。
3. Business Central インストールを完了します。
4. 2 台目のコンピューターで、インタラクティブモードまたは CLI モードでインストーラーを実行します。
5. Component Selection ページで Business Central チェックボックスを外します。
6. Configure Runtime Environment ページで Perform Advanced Configuration を選択します。
7. Customize Process Server properties を選択し、Next をクリックします。
8. Process Server Properties Configuration ページで、New Server Configuration をクリックして Process Server を追加し、その Process Server に一意の名前を指定します。この名前は Business Central に表示され、複数の Process Server を区別できるようになります。

手順

1. rhpam-7.1.0-business-central-eap7-deployable.zip ファイルを一時ディレクトリーに展開します。以下の例では、この名前を TEMP_DIR とします。

2. TEMP_DIR/rhpam-7.1.0-business-central-eap7-deployable/jboss-eap-7.1 ディレクトリーの内容を EAP_HOME にコピーします。プロンプトが表示されたら、ファイルをマージまたは置き換えます。

   警告

   コピーする Red Hat Process Automation Manager デプロイメントの名前が、Red Hat JBoss EAP インスタンスの既存デプロイメントと競合しないことを確認します。

手順

1. rhpam-7.1.0-kie-server-ee7.zip アーカイブを一時ディレクトリーに展開します。以下の例では、この名前を TEMP_DIR とします。

2. TEMP_DIR/rhpam-7.1.0-kie-server-ee7/rhpam-7.1.0-kie-server-ee7/kie-server.war ディレクトリーを EAP_HOME/standalone/deployments/ にコピーします。

   警告

   コピーする Red Hat Process Automation Manager デプロイメントの名前が、Red Hat JBoss EAP インスタンスの既存デプロイメントと競合しないことを確認します。

3. TEMP_DIR/rhpam-7.1.0-kie-server-ee7/rhpam-7.1.0-kie-server-ee7/SecurityPolicy/ の内容を EAP_HOME/ bin にコピーします。ファイルの上書きを確認するメッセージが表示されたら、Replace をクリックします。
4. EAP_HOME/standalone/deployments/ ディレクトリーに、kie-server.war.dodeploy という名前で空のファイルを作成します。このファイルにより、サーバーが起動すると Process Server が自動的にデプロイされます。

手順

1. テキストエディターで EAP_HOME/standalone/configuration/standalone-full.xml を開き、<system-properties> タグの場所を特定します。

2. 以下のプロパティーを <system-properties> タグに追加します。<DATASOURCE> はデータソースの名前になり、<HIBERNATE_DIALECT> はデータベースの Hibernate 方言になります。

   注記

   org.kie.server.persistence.ds プロパティーのデフォルト値は java:jboss/datasources/ExampleDS です。org.kie.server.persistence.dialect プロパティーのデフォルト値は org.hibernate.dialect.H2Dialect です。

   <property name="org.kie.server.persistence.ds" value="<DATASOURCE>"/>
   <property name="org.kie.server.persistence.dialect" value="<HIBERNATE_DIALECT>"/>

   以下に例を示します。

   <system-properties>
       <property name="org.kie.server.repo" value="${jboss.server.data.dir}"/>
       <property name="org.kie.example" value="true"/>
       <property name="org.jbpm.designer.perspective" value="full"/>
       <property name="designerdataobjects" value="false"/>
       <property name="org.kie.server.user" value="rhpamUser"/>
       <property name="org.kie.server.pwd" value="rhpam123!"/>
       <property name="org.kie.server.location" value="http://localhost:8080/kie-server/services/rest/server"/>
       <property name="org.kie.server.controller" value="http://localhost:8080/business-central/rest/controller"/>
       <property name="org.kie.server.controller.user" value="kieserver"/>
       <property name="org.kie.server.controller.pwd" value="kieserver1!"/>
       <property name="org.kie.server.id" value="local-server-123"/>
   
       <!-- Data source properties. -->
       <property name="org.kie.server.persistence.ds" value="java:jboss/datasources/KieServerDS"/>
       <property name="org.kie.server.persistence.dialect" value="org.hibernate.dialect.PostgreSQLDialect"/>
   </system-properties>

手順

1. 端末アプリケーションで EAP_HOME/bin ディレクトリーに移動します。

2. Business Central へのログインに使用する、admin ロール持つユーザーを作成します。以下のコマンドの <username> および <password> を、作成するユーザーとそのパスワードに置き換えます。

   $ ./add-user.sh -a --user <USERNAME> --password <PASSWORD> --role admin,rest-all

   注記

   必ず、既存のユーザー、ロール、またはグループとは異なるユーザー名を指定してください。たとえば、admin という名前のユーザーは作成しないでください。

   パスワードは 8 文字以上で、数字と、英数字以外の文字をそれぞれ 1 文字以上使用する必要があります。ただし & の文字は使用できません。

3. Process Server にログインするのに使用する、kie-server ロールを持つユーザーを作成します。

   $ ./add-user.sh -a --user <USERNAME> --password <PASSWORD> --role kie-server

4. ユーザー名とパスワードを書き留めておきます。

   注記

   Business Central と Process Server を同じサーバーにインストールした場合は、両方のロールを持つユーザーを 1 つ作成できます。

   $ ./add-user.sh -a --user <USERNAME>  --password <PASSWORD> --role admin,rest-all,kie-server

   実稼働環境では、Business Central と Process Server を異なるサーバーにインストールすることを推奨します。

手順

1. Business Central の EAP_HOME/standalone/configuration/standalone-full.xml ファイルで、<system-properties> セクションの以下のプロパティーのコメントを解除し、<USERNAME> および <USER_PWD> を、kie-server ロールを持つユーザーの認証情報に置き換えます。

      <property name="org.kie.server.user" value="<USERNAME>"/>
      <property name="org.kie.server.pwd" value="<USER_PWD>"/>

2. Process Server の EAP_HOME/standalone/configuration/standalone-full.xml ファイルで、<system-properties> セクションの以下のプロパティーのコメントを解除します。

     <property name="org.kie.server.controller.user" value="<CONTROLLER_USER>"/>
     <property name="org.kie.server.controller.pwd" value="<CONTROLLER_PWD>"/>
     <property name="org.kie.server.id" value="<KIE_SERVER_ID>"/>
     <property name="org.kie.server.location" value="http://<HOST>:<PORT>/kie-server/services/rest/server"/>
     <property name="org.kie.server.controller" value="<CONTROLLER_URL>"/>

3. 以下の値を置き換えてください。

   • <CONTROLLER_USER> および <CONTROLLER_PWD> を rest-all ロールを持つユーザーの認証情報に置き換えます。
   • &lt ;KIE_SERVER_ID > を Process Server システムの ID または名前に置き換えます（例： rhpam-7.1.0-process_server-1）。
   • <HOST> を Process Server ホストの ID または名前に置き換えます (例: localhost または 192.7.8.9)。

   • <PORT> を Process Server ホストのポートに置き換えます (例: 8080)。

     注記

     org.kie.server.location プロパティーで Process Server の場所を指定します。

   • <CONTROLLER_URL> を Business Central の URL に置き換えます。起動中に Process Server がこの URL に接続します。

     • インストーラーまたは Red Hat JBoss EAP zip ファイルを使用して Business Central をインストールした場合、<CONTROLLER_URL> は以下のようになります。

       http://<HOST>:<PORT>/business-central/rest/controller

     • standalone.jar ファイルを使用して Business Central を実行している場合、<CONTROLLER_URL> は以下のようになります。

       http://<HOST>:<PORT>/rest/controller

手順

1. Red Hat カスタマーポータルの Software Downloads ページに移動し (ログインが必要)、ドロップダウンオプションから製品およびバージョンを選択します。

   • 製品: Process Automation Manager
   • Version: 7.1
2. Red Hat Process Automation Manager 7.1.0 Add Ons （ rhpam-7.1.0-add-ons.zip ファイル）をダウンロードします。
3. rhpam-7.1.0-add-ons.zip ファイルを展開します。rhpam-7.1-controller-ee7.zip ファイルは展開したディレクトリーにあります。
4. rhpam-7.1-controller-ee7 アーカイブを一時ディレクトリーに展開します。以下の例では、この名前を TEMP_DIR とします。

5. TEMP_DIR/rhpam-7.1-controller-ee7/controller.war ディレクトリーを EAP_HOME/standalone/deployments/ にコピーします。

   警告

   コピーするヘッドレス Process Automation Manager コントローラーデプロイメントの名前が、Red Hat JBoss EAP インスタンスの既存デプロイメントと競合しないことを確認します。

6. TEMP_DIR/rhpam-7.1-controller-ee7/SecurityPolicy/ ディレクトリーの内容を EAP_HOME/ bin にコピーします。ファイルの上書きを確認するメッセージが表示されたら、Yes を選択します。
7. EAP_HOME/standalone/deployments/ ディレクトリーに、controller.war.dodeploy という名前で空のファイルを作成します。このファイルにより、サーバーが起動するとヘッドレス Process Automation Manager コントローラーが自動的にデプロイされます。

手順

1. ターミナルアプリケーションで EAP_HOME/bin に移動します。

2. 以下のコマンドを入力します。

   • Linux または UNIX ベースのシステムの場合:

     $ ./standalone.sh

   • Windows の場合:

     standalone.bat

3. ヘッドレス Process Automation Manager コントローラーが Red Hat JBoss EAP 上で動作している ことを 確認する には、以下のコマンドを入力します。「ヘッドレス Process Automation Manager コントローラーのユーザー作成」ここで、<CONTROLLER> と <CONTROLLER_PWD> は、で作成したユーザー名とパスワードの組み合わせです。このコマンドにより、Process Server インスタンスに関する情報が出力されます。

   curl -X GET "http://<HOST>:<PORT>/controller/rest/controller/management/servers" -H  "accept: application/xml" -u '<CONTROLLER>:<CONTROLLER_PWD>'

手順

1. Red Hat Business Automation BOM を pom.xml ファイルで宣言します。

   <dependencyManagement>
    <dependencies>
     <dependency>
      <groupId>com.redhat.ba</groupId>
      <artifactId>ba-platform-bom</artifactId>
      <version>7.1.0.GA-redhat-00002</version>
      <type>pom</type>
      <scope>import</scope>
     </dependency>
    </dependencies>
   </dependencyManagement>
   <dependencies>
   <!-- Your dependencies -->
   </dependencies>

2. <dependencies> タグでお使いのプロジェクトに必要な依存関係を宣言します。製品の BOM をプロジェクトにインポートしたら、ユーザー向け製品依存関係のバージョンが定義されるため、<dependency> 要素のサブ要素 <version> を指定する必要はありません。ただし、<dependency> 要素を使用して、プロジェクトで使用する依存関係を宣言する必要があります。

3. Business Central に作成されない標準のプロジェクトでは、お使いのプロジェクトに必要な依存関係をすべて指定します。Business Central に作成するプロジェクトでは、基本的なプロセスエンジンの依存関係が Business Central に自動的に提供されます。

   • 標準的な Red Hat Process Automation Manager プロジェクトでは、使用する機能に応じて、以下の依存関係を宣言します。

     埋め込みプロセスエンジンの依存関係

     <!-- Public KIE API -->
     <dependency>
       <groupId>org.kie</groupId>
       <artifactId>kie-api</artifactId>
     </dependency>
     
     <!-- Core dependencies for process engine -->
     <dependency>
       <groupId>org.jbpm</groupId>
       <artifactId>jbpm-flow</artifactId>
     </dependency>
     
     <dependency>
       <artifactId>jbpm-flow-builder</artifactId>
     </dependency>
     
     <dependency>
       <groupId>org.jbpm</groupId>
       <artifactId>jbpm-bpmn2</artifactId>
     </dependency>
     
     <dependency>
       <groupId>org.jbpm</groupId>
       <artifactId>jbpm-runtime-manager</artifactId>
     </dependency>
     
     <dependency>
       <groupId>org.jbpm</groupId>
       <artifactId>jbpm-persistence-jpa</artifactId>
     </dependency>
     
     <dependency>
       <groupId>org.jbpm</groupId>
       <artifactId>jbpm-query-jpa</artifactId>
     </dependency>
     
     <dependency>
       <groupId>org.jbpm</groupId>
       <artifactId>jbpm-audit</artifactId>
     </dependency>
     
     <dependency>
       <groupId>org.jbpm</groupId>
       <artifactId>jbpm-kie-services</artifactId>
     </dependency>
     
     <!-- Dependency needed for default WorkItemHandler implementations. -->
     <dependency>
       <groupId>org.jbpm</groupId>
       <artifactId>jbpm-workitems-core</artifactId>
     </dependency>
     
     <!-- Logging dependency. You can use any logging framework compatible with slf4j. -->
     <dependency>
       <groupId>ch.qos.logback</groupId>
       <artifactId>logback-classic</artifactId>
       <version>${logback.version}</version>
     </dependency>

   • CDI を使用する Red Hat Process Automation Manager プロジェクトでは、通常、以下の依存関係を宣言します。

     CDI が有効化されたプロセスエンジンの依存関係

     <dependency>
       <groupId>org.kie</groupId>
       <artifactId>kie-api</artifactId>
     </dependency>
     
     <dependency>
       <groupId>org.jbpm</groupId>
       <artifactId>jbpm-kie-services</artifactId>
     </dependency>
     
     <dependency>
       <groupId>org.jbpm</groupId>
       <artifactId>jbpm-services-cdi</artifactId>
     </dependency>

   • 標準的な Red Hat Process Automation Manager プロジェクトでは、以下の依存関係を宣言します。

     埋め込みプロセスエンジンの依存関係

     <dependency>
       <groupId>org.drools</groupId>
       <artifactId>drools-compiler</artifactId>
     </dependency>
     
     <!-- Dependency for persistence support. -->
     <dependency>
       <groupId>org.drools</groupId>
       <artifactId>drools-persistence-jpa</artifactId>
     </dependency>
     
     <!-- Dependencies for decision tables, templates, and scorecards.
     For other assets, declare org.drools:drools-workbench-models-* dependencies. -->
     <dependency>
       <groupId>org.drools</groupId>
       <artifactId>drools-decisiontables</artifactId>
     </dependency>
     <dependency>
       <groupId>org.drools</groupId>
       <artifactId>drools-templates</artifactId>
     </dependency>
     <dependency>
       <groupId>org.drools</groupId>
       <artifactId>drools-scorecards</artifactId>
     </dependency>
     
     <!-- Dependency for loading KJARs from a Maven repository using KieScanner. -->
     <dependency>
       <groupId>org.kie</groupId>
       <artifactId>kie-ci</artifactId>
     </dependency>

   • Process Server を使用するには、以下の依存関係を宣言します。

     クライアントアプリケーションの Process Server 依存関係

     <dependency>
       <groupId>org.kie.server</groupId>
       <artifactId>kie-server-client</artifactId>
     </dependency>

   • Red Hat Process Automation Manager にリモートクライアントを作成するには、以下の依存関係を宣言します。

     クライアントの依存関係

     <dependency>
       <groupId>org.uberfire</groupId>
     </dependency>

   • ルール、プロセス定義など、アセットを含む JAR ファイルを作成する場合は、お使いの Maven プロジェクトのパッケージングの種類を kjar と指定し、org.kie:kie-maven-plugin を使用して、<project> 要素に置かれた kjar パッケージングタイプを処理します。以下の例の ${kie.version} は、What is the mapping between Red Hat Process Automation Manager and the Maven library version? に記載されている Maven ライブラリーのバージョンです。

     <packaging>kjar</packaging>
     <build>
      <plugins>
       <plugin>
        <groupId>org.kie</groupId>
        <artifactId>kie-maven-plugin</artifactId>
        <version>${kie.version}</version>
        <extensions>true</extensions>
       </plugin>
      </plugins>
     </build>

手順

1. 外部リポジトリーの接続およびアクセスの詳細が含まれる Maven settings.xml ファイルを作成します。settings.xml ファイルの詳細は Maven の Settings Reference を参照してください。
2. 既知の場所 (例: /opt/custom-config/settings.xml) にファイルを保存します。
3. Red Hat Process Automation Manager インストールディレクトリーで、standalone-full.xml ファイルに移動します。たとえば、Red Hat Process Automation Manager に Red Hat JBoss EAP インストールを使用する場合は $EAP_HOME/standalone/configuration/standalone-full.xml に移動します。

4. standalone-full.xml の <system-properties> タグで、kie.maven.settings.custom プロパティーに settings.xml ファイルのフルパス名を設定します。

   以下に例を示します。

   <property name="kie.maven.settings.custom" value="/opt/custom-config/settings.xml"/>

5. Business Central および Process Server を起動します。

手順

1. Red Hat JBoss EAP を起動し、Web ブラウザーで Business Central を開きます。
2. PNG 形式のイメージを、Red Hat Process Automation Manager インストールの EAP_HOME/standalone/deployments/business-central.war/img/ ディレクトリーにコピーします。
3. EAP_HOME/standalone/deployments/business-central.war/img/ ディレクトリーで、既存の login-screen-logo.png ファイルを移動するか名前を変更します。
4. PNG ファイル login-screen-logo.png の名前を変更します。
5. User name および Password フィールドに表示されるプロジェクトロゴを変更するには、デフォルトのイメージ RHPAM_Logo.svg を新しい SVG ファイルに置き換えます。
6. ログインページを強制的に完全に再読込みし、キャッシュを消去して変更を表示します。たとえば、Linux および Windows の多くの Web ブラウザーでは、Ctrl+F5 を押します。

手順

1. Red Hat JBoss EAP を起動し、Web ブラウザーで Business Central を開き、お使いのユーザー認証情報でログインします。
2. SVG 形式の新しいアプリケーションヘッダーイメージを、Red Hat Process Automation Manager システムの EAP_HOME/standalone/deployments/business-central.war/banner/ ディレクトリーにコピーします。
3. テキストエディターで EAP_HOME/standalone/deployments/business-central.war/banner/banner.html ファイルを開きます。

4. <img> タグの logo.svg を、新しいイメージ:admin-and-config/ のファイル名に置き換えます。

   <img src="banner/logo.svg"/>

5. ログインページを強制的に完全に再読込みし、キャッシュを消去して変更を表示します。たとえば、Linux および Windows の多くの Web ブラウザーでは、Ctrl+F5 を押します。