Red Hat Process Automation Manager のインストールおよび設定

手順

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

   java -jar rhpam-installer-7.11.0.jar

   注記

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

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

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

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

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

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

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

   注記

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

5. ユーザーを作成して Next をクリックします。デフォルトでは、同じコンテナーに Business Central と KIE Server の両方をインストールする場合は、新しいユーザーに admin ロール、kie-server ロール、および rest-all ロールが割り当てられます。KIE Server のみをインストールした場合には、ユーザーには kie-server ロールが割り当てられます。別のロールを選択する場合は、admin ロールを外します。ロールの詳細は、11章Red Hat Process Automation Manager ロールおよびユーザー を参照してください。

   注記

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

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

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

6. Installation Overview ページで、インストールするコンポーネントを確認し、Next をクリックしてインストールを開始します。
7. インストールが完了したら、Next をクリックします。

8. KIE Server がインストールされている場合には、Component Installation で Configure Runtime の手順が表示されます。Configure Runtime Environment ページで、デフォルトのインストールを実行するか、詳細設定を行うかを選択します。

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

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

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

10. KIE Server Properties Configuration で Customize KIE Server properties を選択した場合は、以下のいずれかのプロパティーを変更します。

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

13. 必要に応じて、Generate Installation Script and Properties File をクリックして、XML ファイルでインストールデータを保存し、Done をクリックします。

    インストーラーは、2 つのファイルを生成します。auto.xml ファイルは、今後のインストールを自動化し、auto.xml.variables ファイルは、ユーザーのパスワードと他の機密情報に関連する変数を保存します。auto.xml ファイルを使用して、元のインストールと同じタイプのサーバーおよび同じ設定の複数のシステムで Red Hat Process Automation Manager のインストールを繰り返します。必要に応じて、auto.xml ファイルの installpath パラメーターを更新します。XML ファイルを使用してインストールを実行するには、以下のコマンドを入力します。

    java -jar rhpam-installer-7.11.0.jar <path-to-auto.xml-file>

手順

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

   java -jar rhpam-installer-7.11.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 or Red Hat JBoss Web Server 5. For more information, see https://access.redhat.com/articles/3405381[Red Hat Process Automation Manager 7 Supported Configurations].

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

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

   注記

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

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

   注記

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

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

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

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

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

6. y を入力してインストールデータが含まれる XML ファイルを作成します。あるいは、n を入力してインストールを完了します。y を入力すると、XML ファイルのパスを指定するように求められます。

7. パスを入力するか、Enter キーを押して提案されたパスを了承します。

   インストーラーは、2 つのファイルを生成します。auto.xml ファイルは、今後のインストールを自動化し、auto.xml.variables ファイルは、ユーザーのパスワードと他の機密情報に関連する変数を保存します。複数のシステムで auto.xml ファイルを使用して、元のインストールと同じ設定の同じタイプのサーバーに、Red Hat Process Automation Manager を簡単に繰り返しインストールできます。必要に応じて、auto.xml ファイルの installpath パラメーターを更新します。XML ファイルを使用してインストールを実行するには、以下のコマンドを入力します。

   java -jar rhpam-installer-7.11.0.jar <path-to-auto.xml-file>

8. Business Central だけをインストールした場合は、この手順を繰り返して、別のサーバーに KIE Server をインストールします。

手順

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

   • 「インタラクティブモードでのインストーラーの使用」
   • 「CLI モードでのインストーラーの使用」
2. Component Selection ページで、KIE Server チェックボックスを外します。
3. Business Central インストールを完了します。
4. 2 台目のコンピューターで、インタラクティブモードまたは CLI モードでインストーラーを実行します。
5. Component Selection ページで Business Central チェックボックスを外します。
6. Configure Runtime Environment ページで Perform Advanced Configuration を選択します。
7. Customize KIE Server properties を選択し、Next をクリックします。

8. Business Central のコントローラー URL を入力し、KIE Server に追加のプロパティーを設定します。コントローラー URL は、以下の形式を取ります。<HOST:PORT> は、2 台目のコンピューターの Business Central のアドレスに置き換えます。

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

9. インストールを完了します。
10. Process Automation Manager コントローラーが Business Central と統合されていることを確認するには、Business Central の Execution Servers ページに移動して、設定した KIE Server が REMOTE SERVERS に表示されていることを確認します。

手順

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

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

   警告

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

手順

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

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

   警告

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

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

手順

1. 以下の手順を実行して、データベースを準備します。

   1. TEMP_DIR などの一時ディレクトリーに rhpam-7.11.0-add-ons.zip を展開します。
   2. TEMP_DIR/rhpam-7.11.0-migration-tool.zip を展開します。
   3. 現在のディレクトリーから、TEMP_DIR/rhpam-7.11.0-migration-tool/ddl-scripts ディレクトリーに移動します。このディレクトリーには、複数のデータベースタイプの DDL スクリプトが含まれています。

   4. 使用するデータベースに、お使いのデータベースタイプの DDL スクリプトをインポートします。

      以下の例は、PostreSQL で jBPM データベース構造を作成します。

      psql jbpm < /ddl-scripts/postgresql/postgresql-jbpm-schema.sql

      注記

      PostgreSQL または Oracle を Spring Boot と併用する場合は、対応する Spring Boot の DDL スクリプト (/ddl-scripts/oracle/oracle-springboot-jbpm-schema.sql または /ddl-scripts/postgresql/postgresql-springboot-jbpm-schema.sql) をインポートする必要があります。

      注記

      PostgreSQL DDL スクリプトは、@LOB アノテーションが付けられたエンティティー属性の自動インクリメント整数値 (OID) 列で PostgreSQL スキーマを作成します。OID ではなく BYTEA などの他のバイナリー列タイプを使用するには、postgresql-bytea-jbpm-schema.sql スクリプトで PostgreSQL スキーマを作成し、Red Hat Process Automation Manager org.kie.persistence.postgresql.useBytea=true フラグを設定する必要があります。Red Hat Process Automation Manager は、OID ベースから BYTEA ベースのスキーマに変更する移行ツールを提供しません。

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

3. 以下のプロパティーを <system-properties> タグに追加します。<DATASOURCE> はデータソースの JNDI 名で、<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>"/>

   以下の例では、PostgreSQL hibernate 方言のデータソースの設定方法を紹介しています。

   <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. admin、rest-all、および kie-server ロールを持つユーザーを作成し、Business Central へのログインに使用します。

   注記

   admin ロールを持つユーザーは、Business Central の管理者です。rest-all ロールを持つユーザーは、Business Central REST 機能にアクセスできます。kie-server ロールを持つユーザーは、KIE Server REST 機能にアクセスできます。ユーザーが Business Central の Manage ビューおよび Track ビューにアクセスするには、kie-server ロールが必須となります。

   以下のコマンドの <USERNAME> および <password> を、作成するユーザーとそのパスワードに置き換えます。

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

   注記

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

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

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

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

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

   注記

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

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

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

手順

1. Red Hat Process Automation Manager インストールディレクトリーで、standalone-full.xml ファイルに移動します。たとえば、Red Hat Process Automation Manager に Red Hat JBoss EAP インストールを使用する場合は $EAP_HOME/standalone/configuration/standalone-full.xml に移動します。

2. standalone-full.xml ファイルを開き、<system-properties> タグの下に、以下の JVM プロパティーを設定します。

   表14.1 KIE Server インスタンスの JVM プロパティー

   プロパティー	値	注記
   org.kie.server.id	default-kie-server	KIE Server ID。
   org.kie.server.controller	http://localhost:8080/business-central/rest/controller	Business Central の場所Business Central の API に接続する URL。
   org.kie.server.controller.user	controllerUser	Business Central にログイン可能な rest-all ロールを持つユーザー名。
   org.kie.server.controller.pwd	controllerUser1234;	Business Central にログインできるユーザーのパスワード。
   org.kie.server.location	http://localhost:8080/kie-server/services/rest/server	KIE Server の場所KIE Server の API に接続する URL。

   表14.2 Business Central インスタンスの JVM プロパティー

   プロパティー	値	注記
   org.kie.server.user	controllerUser	kie-server ロールを持つユーザー名。
   org.kie.server.pwd	controllerUser1234;	ユーザーのパスワード。

   以下の例は、KIE Server インスタンスを設定する方法を示しています。

   <property name="org.kie.server.id" value="default-kie-server"/>
   <property name="org.kie.server.controller" value="http://localhost:8080/business-central/rest/controller"/>
   <property name="org.kie.server.controller.user" value="controllerUser"/>
   <property name="org.kie.server.controller.pwd" value="controllerUser1234;"/>
   <property name="org.kie.server.location" value="http://localhost:8080/kie-server/services/rest/server"/>

   以下の例は、Business Central インスタンスに設定する方法を示しています。

   <property name="org.kie.server.user" value="controllerUser"/>
   <property name="org.kie.server.pwd" value="controllerUser1234;"/>

3. KIE サーバーが正常に起動したことを確認するには、KIE サーバーが動作しているときに、http://SERVER:PORT/kie-server/services/rest/server/ に GET リクエストを送信します。KIE サーバー上での Red Hat Process Automation Manager の実行に関する詳細は、Red Hat Process Automation Manager の実行 を参照してください。

   認証に成功すると、以下の例のような XML 応答が返されます。

   <response type="SUCCESS" msg="Kie Server info">
       <kie-server-info>
           <capabilities>KieServer</capabilities>
           <capabilities>BRM</capabilities>
           <capabilities>BPM</capabilities>
           <capabilities>CaseMgmt</capabilities>
           <capabilities>BPM-UI</capabilities>
           <capabilities>BRP</capabilities>
           <capabilities>DMN</capabilities>
           <capabilities>Swagger</capabilities>
           <location>http://localhost:8230/kie-server/services/rest/server</location>
           <messages>
               <content>Server KieServerInfo{serverId='first-kie-server', version='7.5.1.Final-redhat-1', location='http://localhost:8230/kie-server/services/rest/server', capabilities=[KieServer, BRM, BPM, CaseMgmt, BPM-UI, BRP, DMN, Swagger]}started successfully at Mon Feb 05 15:44:35 AEST 2018</content>
               <severity>INFO</severity>
               <timestamp>2018-02-05T15:44:35.355+10:00</timestamp>
           </messages>
           <name>first-kie-server</name>
           <id>first-kie-server</id>
           <version>7.5.1.Final-redhat-1</version>
       </kie-server-info>
   </response>

4. 登録が正常に完了したことを確認します。

   1. Business Central にログインします。

   2. Menu → Deploy → Execution Servers の順にクリックします。

      正常に登録されている場合は、登録されたサーバーの ID が表示されます。

手順

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

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

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

   警告

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

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

手順

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

2. ヘッドレス Process Automation Manager コントローラーを、KIE Server をインストールした Red Hat JBoss EAP インスタンスと同じ Red Hat JBoss EAP インスタンスにインストールしている場合は、以下のいずれかのコマンドを実行します。

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

     $ ./standalone.sh -c standalone-full.xml

   • Windows の場合:

     standalone.bat -c standalone-full.xml

3. ヘッドレス Process Automation Manager コントローラーを、KIE Server をインストールした Red Hat JBoss EAP インスタンスとは別の Red Hat JBoss EAP インスタンスにインストールしている場合は、standalone.sh スクリプトで Process Automation Manager コントローラーを開始します。

   注記

   この場合は、standalone.xml ファイルに必要な設定変更を加えます。

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

     $ ./standalone.sh

   • Windows の場合:

     standalone.bat

4. ヘッドレス Process Automation Manager コントローラーが Red Hat JBoss EAP 上で動作していることを確認するには、以下のコマンドを入力します。ここで、<CONTROLLER> と <CONTROLLER_PWD> は、「ヘッドレス Process Automation Manager コントローラーのユーザー作成」 で作成したユーザー名とパスワードの組み合わせになります。このコマンドにより、KIE 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.11.0.redhat-00005</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>
       <groupId>org.jbpm</groupId>
       <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:business-central-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>

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

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

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

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

     クライアントの依存関係

     <dependency>
       <groupId>org.uberfire</groupId>
       <artifactId>uberfire-rest-client</artifactId>
     </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 と KIE Server を起動または再起動します。

手順

1. 公開インターネットに送信アクセスができるコンピューターで、以下のアクションを実行します。

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

   • 製品: Red Hat Process Automation Manager

   • バージョン: 7.11

     1. Red Hat Process Automation Manager 7.11.0 Offliner Content List (rhpam-7.11.0-offliner.zip) の製品配信可能ファイルをダウンロードして展開します。
     2. rhpam-7.11.0-offliner.zip ファイルの内容を任意のディレクトリーに展開します。

     3. ディレクトリーに移動し、以下のコマンドを入力します。

        ./offline-repo-builder.sh offliner.txt

        このコマンドは、repository サブディレクトリーを作成し、必要なアーティファクトをこのサブディレクトリーにダウンロードします。これはミラーリポジトリーです。

        一部のダウンロードが失敗したことを示すメッセージが表示された場合は、同じコマンドを再度実行してください。ダウンロードが再び失敗する場合は、Red Hat サポートに連絡してください。

3. Business Central 外でサービスを開発し、追加の依存関係がある場合は、ミラーリポジトリーにその依存関係を追加します。サービスを Maven プロジェクトとして開発した場合は、以下の手順を使用し、これらの依存関係を自動的に用意します。公開インターネットへに送信接続できるコンピューターで、この手順を実行します。

   1. ローカルの Maven キャッシュディレクトリー (~/.m2/repository) のバックアップを作成して、ディレクトリーを削除します。
   2. mvn clean install コマンドを使用してプロジェクトのソースをビルドします。

   3. すべてのプロジェクトで以下のコマンドを入力し、Maven を使用してプロジェクトで生成したすべてのアーティファクトのランタイムの依存関係をすべてダウンロードするようにします。

      mvn -e -DskipTests dependency:go-offline -f /path/to/project/pom.xml --batch-mode -Djava.net.preferIPv4Stack=true

      /path/to/project/pom.xml を、プロジェクトの pom.xml ファイルのパスに置き換えます。

   4. ローカルの Maven キャッシュディレクトリー (~/.m2/repository) の内容を、作成した repository サブディレクトリーにコピーします。
4. repository サブディレクトリーの内容を、Red Hat Process Automation Manager をデプロイしたコンピューターのディレクトリーにコピーします。このディレクトリーがオフラインの Maven ミラーリポジトリーになります。
5. 「Business Central および KIE Server への外部 Maven リポジトリーの設定」 の説明に従って、Red Hat Process Automation Manager デプロイメント向けに、settings.xml ファイルを作成して設定します。

6. settings.xml ファイルで以下を変更します。

   • <profile> タグの下に、<repositories> タグまたは <pluginRepositores> タグがない場合は、不足しているタグを追加します。

   • <repositories> の下に、以下のコンテンツを追加します。

     <repository>
       <id>offline-repository</id>
       <url>file:///path/to/repo</url>
       <releases>
         <enabled>true</enabled>
       </releases>
       <snapshots>
         <enabled>false</enabled>
       </snapshots>
     </repository>

     /path/to/repo は、ローカルの Maven ミラーリポジトリーのディレクトリーに対する完全パスに置き換えます。

   • <pluginRepositories> の下に、以下のコンテンツを追加します。

     <repository>
       <id>offline-plugin-repository</id>
       <url>file:///path/to/repo</url>
       <releases>
         <enabled>true</enabled>
       </releases>
       <snapshots>
         <enabled>false</enabled>
       </snapshots>
     </repository>

     /path/to/repo は、ローカルの Maven ミラーリポジトリーのディレクトリーに対する完全パスに置き換えます。

7. Business Central の kie.maven.offline.force プロパティーを true に設定します。Business Central のプロパティーの設定手順は、Red Hat JBoss EAP 7.3 への Red Hat Process Automation Manager のインストールおよび設定 を参照してください。

手順

1. Red Hat JBoss EAP を起動し、Web ブラウザーで Business Central を開きます。
2. SVG 形式のイメージを、Red Hat Process Automation Manager インストールの EAP_HOME/standalone/deployments/business-central.war/img/ ディレクトリーにコピーします。
3. EAP_HOME//standalone/deployments/business-central.war/img/ ディレクトリーで、既存の redhat_logo.png ファイルを移動するか名前を変更します。
4. PNG ファイル redhat_logo.png の名前を変更します。
5. User name フィールドおよび Password フィールドの上に表示されるプロジェクトロゴを変更するには、デフォルトのイメージ BC_Logo.png を新しい 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.png を、新しい image:admin-and-config/ のファイル名に置き換えます。

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

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

手順

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

   • Product: Data Grid
   • Version: 7.3
2. お使いのシステムの任意の場所に、Red Hat JBoss Data Grid 7.3.0 Server (jboss-datagrid-7.3.0-1-server.zip) のインストールファイルをダウンロードして展開します。以下の例では、展開したディレクトリーは JDG_HOME と呼ばれます。
3. Red Hat Data Grid を最新のバージョンに更新します。詳細は、Red Hat Data Grid User Guide を参照してください。

4. Red Hat Data Grid を実行するには、JDG_HOME/bin に移動して以下のコマンドを入力します。

   $ ./standalone.sh -c clustered.xml -b <HOST>

   <HOST> は、Red Hat Data Grid をインストールしたサーバーの IP アドレスまたはホスト名に置き換えます。

手順

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

   • Product: AMQ Broker
   • バージョン: 7.8.1
2. Red Hat AMQ Broker 7.8.1 (amq-broker-7.8.1-bin.zip) の横の Download をクリックします。
3. amq-broker-7.8.1-bin.zip ファイルを展開します。
4. amq-broker-7.8.1-bin/amq-broker-7.8.1/bin のディレクトリーに移動します。

5. 以下のコマンドを入力し、ブローカーおよびブローカーユーザーを作成します。

   ./artemis create --host <HOST> --user <AMQ_USER> --password <AMQ_PASSWORD> --require-login <BROKER_NAME>

   上記の例で、以下のプレースホルダーを置き換えてください。

   • <HOST> は、AMQ Broker をインストールしたサーバーの IP アドレスまたはホスト名に置き換えます。
   • <AMQ_USER> および <AMQ_PASSWORD> は、任意のユーザー名とパスワードの組み合わせに置き換えます。
   • <BROKER_NAME> は作成するブローカーの名前に置き換えます。

6. AMQ Broker を実行するには、amq-broker-7.8.1-bin/amq-broker-7.8.1/bin ディレクトリーで以下のコマンドを入力します。

   <BROKER_NAME>/bin/artemis run

手順

1. NFS バージョン 4 共有をエクスポートするようにサーバーを設定します。Red Hat Enterprise Linux での NFS 共有のエクスポートの方法については、ファイルシステムの管理 のNFS 共有のエクスポートを参照してください。NFS サーバーの作成に関する情報は、RHEL 7 で NFS を設定する を参照してください。
2. テキストエディターで このサーバーの /etc/exports ファイルを開きます。

3. /etc/exports ファイルに以下の行を追加します。<HOST_LIST> は、サーバーへの接続が許可されているホストのスペース区切りリストに置き換えます。

   /opt/kie/data <HOST_LIST>

   以下に例を示します。

   /opt/kie/data 192.268.1.0/24(rw,sync) 192.268.1.1/24(no_root_squash)

   これにより、NFS に必要となる最小オプション rw,sync,no_root_squash を使用して /opt/kie/data 共有が作成されます。

   注記

   /opt/kie/data の代わりに別の共有名を使用できます。別の共有名を使用する場合には、Business Central を実行する全ノードの設定時に、この名前を使用する必要があります。

手順

1. クラスターの各ノードに Red Hat JBoss EAP 7.3 をインストールします。

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

      • Product: Enterprise Application Platform
      • Version: 7.3
   2. Red Hat JBoss Enterprise Application Platform 7.3.0 の横にある Download をクリックします。(JBEAP-7.3.0/jboss-eap-7.3.0.zip)。
2. jboss-eap-7.3.0.zip ファイルを展開します。以下の例では、EAP_HOME を jboss-eap-7.3/jboss-eap-7.3 ディレクトリーとします。
3. 最新の Red Hat JBoss EAP パッチが利用できる場合には、ダウンロードして適用します。

4. クラスターの各ノードで Red Hat Process Automation Manager をダウンロードします。

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

      • Product: Process Automation Manager
      • バージョン: 7.11
   2. Red Hat Process Automation Manager 7.11.0 Business Central Deployable for Red Hat JBoss EAP 7 (rhpam-7.11.0-business-central-eap7-deployable.zip) をダウンロードします。
5. rhpam-7.11.0-business-central-eap7-deployable.zip ファイルを一時ディレクトリーに展開します。以下のコマンドでは、このディレクトリーを TEMP_DIR とします。
6. TEMP_DIR/rhpam-7.11.0-business-central-eap7-deployable/jboss-eap-7.3 の内容を EAP_HOME にコピーします。
7. 最新の Red Hat Process Automation Manager のパッチが利用できる場合には、ダウンロードして適用します。
8. 高可用性環境向けに Red Hat Single Sign-On を設定します。詳細は、Red Hat Process Automation Managerr と Red Hat Single Sign-On の統合 および Red Hat Single Sign-On サーバー管理ガイド を参照してください。

手順

1. NFS で共有されているディレクトリーを /data としてマウントします。Root ユーザーで以下のコマンドを入力します。

   mkdir /data
   mount <NFS_SERVER_IP>:<DATA_SHARE> /data

   <NFS_SERVER_IP> は、NFS サーバーシステムの IP アドレスまたはホスト名に置き換えてください。<DATA_SHARE> は、設定した共有名 (例: /opt/kie/data) に置き換えます。

2. /data NFS ディレクトリーに kie-wb-playground ディレクトリーを作成します。

   mkdir /kie-wb-playground

3. EAP_HOME/bin ディレクトリーに kie-wb-playground ディレクトリーを作成し、ディレクトリーをマウントします。

   mount -o rw,sync,actimeo=1 <NFS_SERVER_IP>:<DATA_SHARE>/kie-wb-playground kie-wb-playground

4. テキストエディターで EAP_HOME/standalone/configuration/standalone-full.xml ファイルを開きます。

5. <system-properties> 要素でプロパティーを編集または追加し、以下のプレースホルターを置き換えます。

   • <AMQ_USER> および <AMQ_PASSWORD> は、AMQ Broker の作成時に定義した認証情報に置き換えます。
   • <AMQ_BROKER_IP_ADDRESS> は AMQ Broker の IP アドレスに置き換えます。

   • <DATA_GRID_NODE_IP> は、Red Hat Data Grid のインストール先の IP アドレスに置き換えます。

     <system-properties>
       <property name="appformer-jms-connection-mode" value="REMOTE"/>
       <property name="appformer-jms-username" value="<AMQ_USER>"/>
       <property name="appformer-jms-password" value="<AMQ_USER_PASSWORD>"/>
       <property name="appformer-jms-url"
          value="tcp://<AMQ_BROKER_IP_ADDRESS>:61616?ha=true&amp;retryInterval=1000&amp;retryIntervalMultiplier=1.0&amp;reconnectAttempts=-1"/>
       <property name="org.appformer.ext.metadata.infinispan.port"
          value="11222"/>
       <property name="org.appformer.ext.metadata.infinispan.host"
          value="<DATA_GRID_NODE_IP>"/>
       <property name="org.appformer.ext.metadata.infinispan.realm"
          value="ApplicationRealm"/>
       <property name="org.appformer.ext.metadata.infinispan.cluster"
          value="kie-cluster"/>
       <property name="org.appformer.ext.metadata.index"
          value="infinispan"/>
       <property name="org.uberfire.nio.git.dir"
          value="/data"/>
       <property name="es.set.netty.runtime.available.processors"
          value="false"/>
     </system-properties>

6. オプション: Red Hat Data Grid のデプロイメントで認証が必要な場合は、<system-properties> 要素でプロパティーを編集または追加し、以下のプレースホルターを置き換えます。

   • <SERVER_NAME> は、Red Hat Data Grid のサーバー設定で指定したサーバー名に置き換えます。

   • <SASL_QOP> は、Red Hat Data Grid サーバー設定の auth、auth-int、および auth-conf の値に置き換えます。

     <property name="org.appformer.ext.metadata.infinispan.server.name"
        value="<SERVER_NAME>"/>
     <property name="org.appformer.ext.metadata.infinispan.sasl.qop"
        value="<SASL_QOP>"/>
     <property name="org.appformer.ext.metadata.infinispan.username"
        value=""/>
     <property name="org.appformer.ext.metadata.infinispan.password"
        value=""/>

7. standalone-full.xml ファイルを保存します。

8. クラスターを起動するには EAP_HOME/bin に移動して、以下のコマンドを入力します。

   $ ./standalone.sh -c standalone-full.xml -b <HOST>

   <HOST> は、Red Hat Process Automation Manager をインストールしたサーバーの IP アドレスまたはホスト名に置き換えます。

手順

1. ネットワーク速度をテストします。

   1. 各サーバーノードのコマンド端末で、iPerf3 をインストールします。

      $ dnf install iperf3

   2. NFS サーバーノード (サーバーノード 3) のコマンドターミナルで、iPerf3 をサーバーモードで起動します。

      $ iperf3 -s

   3. 各 Business Central サーバーノードのコマンド端末で以下のコマンドを入力して、ホストとして NFS サーバーノードを設定して、クライアントモードで iPerf3 を起動します。

      $ iperf3 -c <NFS_SERVER_IP>
      +
      In this example, replace `<NFS_SERVER_IP>` with the IP address of the NFS server.

   4. 各サーバーノードの結果を以下の最小値の例と比較します。

      iperf3 -c 172.31.47.103
      Connecting to host 172.31.47.103, port 5201
      [  5] local 172.31.39.4 port 44820 connected to 172.31.47.103 port 5201
      [ ID] Interval           Transfer     Bitrate         Retr  Cwnd
      [  5]   0.00-1.00   sec   143 MBytes  1.20 Gbits/sec    0    419 KBytes
      [  5]   1.00-2.00   sec   111 MBytes   928 Mbits/sec    6    848 KBytes
      [  5]   2.00-3.00   sec  53.8 MBytes   451 Mbits/sec    0   1.08 MBytes
      [  5]   3.00-4.00   sec  52.5 MBytes   440 Mbits/sec    1   1022 KBytes
      [  5]   4.00-5.00   sec  53.8 MBytes   451 Mbits/sec    1    935 KBytes
      [  5]   5.00-6.00   sec  53.8 MBytes   451 Mbits/sec    1    848 KBytes
      [  5]   6.00-7.00   sec  52.5 MBytes   440 Mbits/sec    0   1.08 MBytes
      [  5]   7.00-8.00   sec  53.8 MBytes   451 Mbits/sec    1   1.01 MBytes
      [  5]   8.00-9.00   sec  53.8 MBytes   451 Mbits/sec    1    953 KBytes
      [  5]   9.00-10.00  sec  52.5 MBytes   440 Mbits/sec    1    856 KBytes
      - - - - - - - - - - - - - - - - - - - - - - - - -
      [ ID] Interval           Transfer     Bitrate         Retr
      [  5]   0.00-10.00  sec   680 MBytes   570 Mbits/sec   12             sender
      [  5]   0.00-10.04  sec   677 MBytes   566 Mbits/sec                  receiver
      
      iperf Done.

2. NFS 情報を確認します。

   1. 各 Business Central サーバーノードのコマンド端末で、NFS ノードをマウントします。

      $ mount -o actimeo=1 <NFS_SERVER_IP>:/opt/nfs/kie /opt/kie/niogit

   2. マウントされた各ノードのコマンド端末で、nfsiostat と入力します。

      $ nfsiostat

   3. 各サーバーノードの結果を以下の最小値の例と比較します。

      nfsiostat
      ops/s	rpc bklog
      6.415	0.000
      
      read:
      ops/s	kB/s	kB/op	retrans	avg RTT (ms)	avg exe (ms)	avg queue (ms)	errors
      0.031	0.045	1.452	0 (0.0%)	0.129		0.166		0.019		0 (0.0%)
      
      write:
      ops/s	kB/s	kB/op	retrans	avg RTT (ms)	avg exe (ms)	avg queue (ms)	errors
      0.517	0.467	0.903	0 (0.0%)	1.235		1.269		0.01 8		0 (0.0%)

3. ディスクが SSD であることを確認します。

   1. NFS サーバーのコマンド端末で、df -h を入力して、以下の例で示すようにディスクを特定します。

      $ df -h
      Filesystem               Size  Used Avail Use% Mounted on
      devtmpfs                 3.8G     0  3.8G   0% /dev
      tmpfs                    3.9G     0  3.9G   0% /dev/shm
      tmpfs                    3.9G   33M  3.8G   1% /run
      tmpfs                    3.9G     0  3.9G   0% /sys/fs/cgroup
      /dev/xvda2                25G  3.2G   22G  13% /
      tmpfs                    781M     0  781M   0% /run/user/1000
      172.31.47.103:/root/nfs   25G  2.1G   23G   9% /root/nfs

   2. lsblk -d を入力して、ディスクが SSD であることを確認します。

      $ lsblk -d

   3. hdparm -Tt と入力して、ディスクをテストします。

      $ hdparm -Tt /dev/xvda2

   4. 各サーバーノードの結果を以下の最小値の例と比較します。

      $ hdparm -Tt /dev/xvda2
      
      /dev/xvda2:
       Timing cached reads:   18670 MB in  1.99 seconds = 9389.01 MB/sec
       Timing buffered disk reads: 216 MB in  3.03 seconds =  71.40 MB/sec

手順

1. Web ブラウザーで、<node-IP-address>:8080/business-central を入力します。<node-IP-address> は特定のノードの IP アドレスに置き換えます。
2. インストール時に作成した admin ユーザーの認証情報を入力します。Business Central ホームページが表示されます。
3. Menu → Design → Projects の順に選択します。
4. MySpace スペースを開きます。
5. Try Samples → Mortgages → OK の順にクリックします。Assets ウィンドウが表示されます。
6. Add Asset → Data Object をクリックします。
7. Data Object フィールドに MyDataObject と入力し、OK をクリックします。
8. Spaces → mySpace → Mortgages の順にクリックし、アセットリストに MyDataObject があることを確認します。

9. Web ブラウザーに以下の URL を入力します。<node_IP_address> には、クラスターの別のノードのアドレスに置き換えます。

   http://<node_IP_address>:8080/business-central

10. MyDataObject アセットを作成した最初のノードの Business Central にログインするときに使用した認証情報と同じものを入力します。
11. Menu → Design → Projects の順に選択します。
12. MySpace スペースを開きます。
13. Mortgages プロジェクトを選択します。
14. MyDataObject がアセットリストにあることを確認します。
15. Mortgages プロジェクトを選択します。

手順

1. クラスターの各ノードに Red Hat JBoss EAP 7.3 をインストールします。

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

      • Product: Enterprise Application Platform
      • Version: 7.3
   2. Red Hat JBoss Enterprise Application Platform 7.3.0 (jboss-eap-7.3.0.zip) の横にある Download をクリックします。
2. jboss-eap-7.3.0.zip ファイルを展開します。jboss-eap-7.3/jboss-eap-7.3 ディレクトリーは EAP_HOME とします。
3. 最新の Red Hat JBoss EAP パッチが利用できる場合には、ダウンロードして適用します。

4. KIE Server のダウンロード:

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

      • Product: Process Automation Manager
      • バージョン: 7.11
   2. Red Hat Process Automation Manager 7.11.0 KIE Server for All Supported EE8 Containers (rhpam-7.11.0-kie-server-ee8.zip) をダウンロードします。
5. rhpam-7.11.0-kie-server-ee8.zip アーカイブを一時ディレクトリーに展開します。以下の例では、この名前を TEMP_DIR とします。

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

   警告

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

7. TEMP_DIR/rhpam-7.11.0-kie-server-ee8/rhpam-7.11.0-kie-server-ee8/SecurityPolicy/ の内容を EAP_HOME/bin にコピーします。
8. ファイルを上書きするように求められたら、Replace をクリックします。
9. EAP_HOME/standalone/deployments/ ディレクトリーに、kie-server.war.dodeploy という名前で空のファイルを作成します。このファイルにより、サーバーが起動すると KIE Server が自動的にデプロイされます。
10. 最新の Red Hat Process Automation Manager のパッチが利用できる場合には、ダウンロードして適用します。
11. EAP_HOME/bin ディレクトリーに移動します。

12. KIE Server へのログインに使用する kie-server ロールのユーザーを作成します。

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

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

手順

1. JDBC ドライバーを、このクラスターの一部となる Red Hat JBoss EAP の全インスタンスにインストールします。詳細は、Red Hat JBoss EAP 7.3 設定ガイド の JDBC ドライバー セクションを参照してください。
2. テキストエディターで EAP_HOME/standalone/configuration/standalone-full.xml ファイルを開きます。

3. data-stores プロパティーと、その上の timer-service thread-pool-name を編集します。

   • datasource-jndi-name は、この手順の最初で指定したデータベースの JNDI 名です。
   • partition プロパティーの値にはあらゆる名前を入力できますが、ノードには、同じパーティション名を持つその他のノードのタイマーのみが表示されます。パーティション名を割り当てて、パーティションでノードをグループ分けすると、大規模なクラスターを複数の小規模クラスターに分割できます。これによりパフォーマンスが改善します。これを行うと、パフォーマンスが向上します。たとえば、ノードが 100 個含まれるクラスターで、ノード 100 個すべてが同じタイマーを実行して更新しようとする代わりに、ノード 5 個ずつのグループに異なるパーティション名を指定し、ノード 5 個ずつのクラスターを 20 個作成できます。
   • default-data-store 属性値を ejb_timer_ds に置き換えます。

   • refresh-interval の値をミリ秒で設定して、EJB タイマーがデータベースに接続して同期し、処理するタスクをロードする頻度を指定します。

     <timer-service thread-pool-name="default" default-data-store="ejb_timer_ds">
     <data-stores>
         <database-data-store name="ejb_timer_ds" datasource-jndi-name="java:jboss/datasources/ejb_timer" database="postgresql" partition="ejb_timer_part" refresh-interval="30000"/>
     </data-stores>
     </timer-service>

     以下の表は、サポートされるデータベースと、対応する database 属性値を示しています。

     表29.1 サポートされているデータベース

     データベース	属性値
     Hyper SQL (デモを目的としており、サポートはされません)	hsql
     PostgreSQL	postgresql
     Oracle	oracle
     IBM DB2	db2
     Microsoft SQL Server	mssql
     MySQL および MariaDB	mysql

4. KIE Server および EJB タイマーデータソースを standalone-full.xml ファイルに追加します。この例では、<DATABASE> はデータベース名、<SERVER_NAME> は JNDI データベースのホスト名、<USER_NAME> および <USER_PWD> はそのデータベースの認証情報になります。

   • 以下のように、データソースを追加して、KIE Server がデータベースに接続できるようにします。

     <xa-datasource jndi-name="java:/jboss/datasources/rhpam" pool-name="rhpam-RHPAM" use-java-context="true" enabled="true">
       <xa-datasource-property name="DatabaseName"><DATABASE></xa-datasource-property>
       <xa-datasource-property name="PortNumber">5432</xa-datasource-property>
       <xa-datasource-property name="ServerName"><SERVER_NAME></xa-datasource-property>
       <driver>postgresql</driver>
       <security>
         <user-name><USER_NAME></user-name>
         <password><USER_PWD></password>
     </security>
     </xa-datasource>

   • 以下のように、データソースを追加して、EJB タイマーを有効化します。

     <xa-datasource jndi-name="java:jboss/datasources/ejb_timer" pool-name="ejb_timer" use-java-context="true" enabled="true">
         <xa-datasource-property name="DatabaseName"><DATABASE></xa-datasource-property>
         <xa-datasource-property name="PortNumber">5432</xa-datasource-property>
         <xa-datasource-property name="ServerName"><SERVER_NAME></xa-datasource-property>
         <driver>postgresql</driver>
         <transaction-isolation>TRANSACTION_READ_COMMITTED</transaction-isolation>
         <security>
             <user-name><USER_NAME></user-name>
             <password><USER_PWD></password>
         </security>
     </xa-datasource>

     警告

     KIE Server ランタイムデータおよび EJB タイマーデータに、別々のデータベースを使用する必要があります。

5. <system-properties> 要素に以下のプロパティーを追加し、以下のプレースホルターを置き換えます。

   • <JNDI_NAME> は、データソースの JNDI 名です。Red Hat Process Automation Manager の場合は java:/jboss/datasources/rhpam です。

   • <DIALECT> は、データベースの hibernate ダイアレクトです。

     以下の方言がサポートされます。

     • DB2: org.hibernate.dialect.DB2Dialect
     • MSSQL: org.hibernate.dialect.SQLServer2012Dialect
     • MySQL: org.hibernate.dialect.MySQL5InnoDBDialect
     • MariaDB: org.hibernate.dialect.MySQL5InnoDBDialect
     • Oracle: org.hibernate.dialect.Oracle10gDialect
     • PostgreSQL: org.hibernate.dialect.PostgreSQL82Dialect

     • PostgreSQL plus: org.hibernate.dialect.PostgresPlusDialect

       <system-properties>
         <property name="org.kie.server.persistence.ds" value="<JNDI_NAME>"/>
         <property name="org.kie.server.persistence.dialect" value="<DIALECT>"/>
         <property name="org.jbpm.ejb.timer.tx" value="true"/>
       </system-properties>

6. standalone-full.xml ファイルを保存します。

7. クラスターを起動するには EAP_HOME/bin に移動して、以下のコマンドの 1 つを入力します。

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

     $ ./standalone.sh -c standalone-full.xml

   • Windows の場合:

     standalone.bat -c standalone-full.xml

手順

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

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

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

   警告

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

6. TEMP_DIR/rhpam-7.11.0-controller-ee7/SecurityPolicy/ ディレクトリーの内容を EAP_HOME/bin にコピーします。
7. ファイルの上書きを求めるプロンプトが出されたら、Yes をクリックします。
8. EAP_HOME/standalone/deployments/ ディレクトリーに、controller.war.dodeploy という名前で空のファイルを作成します。このファイルにより、サーバーが起動するとヘッドレス Process Automation Manager コントローラーが自動的にデプロイされます。
9. テキストエディターで EAP_HOME/standalone/configuration/standalone.xml ファイルを開きます。

10. 以下のプロパティーを <system-properties> 要素に追加し、<NFS_STORAGE> を、テンプレート設定が保存されている NFS ストレージへの絶対パスに置き換えます。

    <system-properties>
      <property name="org.kie.server.controller.templatefile.watcher.enabled" value="true"/>
      <property name="org.kie.server.controller.templatefile" value="<NFS_STORAGE>"/>
    </system-properties>

    テンプレートファイルには、特定のデプロイメントシナリオのデフォルト設定が含まれます。

    org.kie.server.controller.templatefile.watcher.enabled プロパティーの値を true に設定すると、別のスレッドが開始してテンプレートファイルの修正を監視します。この確認の間隔はデフォルトで 30000 ミリ秒になり、org.kie.server.controller.templatefile.watcher.interval システムプロパティーで制御できます。このプロパティーの値を false に設定すると、テンプレートファイルへの変更の検出が、サーバーの再起動時に制限されます。

11. ヘッドレス Process Automation Manager コントローラーを開始するには、EAP_HOME/bin に移動して、以下のコマンドを実行します。

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

      $ ./standalone.sh

    • Windows の場合:

      standalone.bat

手順

1. 環境を準備します。

   1. 以下のエクステンションが standalone.xml ファイルに存在することを確認し、必要な場合は追加します。

      <extension module="org.jboss.as.clustering.infinispan"/>
      <extension module="org.jboss.as.clustering.jgroups"/>

   2. standalone.xml ファイルで、<subsystem xmlns="urn:jboss:domain:infinispan:9.0"> サブシステムを見つけ、以下の例のように、nodes という名前のキャッシュと jobs という名前のキャッシュを含む jbpm という名前のキャッシュコンテナーエントリーを作成します。

      <cache-container name="jbpm">
        <transport lock-timeout="60000"/>
        <replicated-cache name="nodes">
            <transaction mode="BATCH"/>
        </replicated-cache>
        <replicated-cache name="jobs">
            <transaction mode="BATCH"/>
        </replicated-cache>
      </cache-container>

   3. レプリケートされたキャッシュと分散キャッシュの jgroups サブシステムを追加します。

      <subsystem xmlns="urn:jboss:domain:jgroups:7.0">
          <channels default="ee">
              <channel name="ee" stack="udp" cluster="ejb"/>
          </channels>
          <stacks>
              <stack name="udp">
                  <transport type="UDP" socket-binding="jgroups-udp"/>
                  <protocol type="PING"/>
                  <protocol type="MERGE3"/>
                  <socket-protocol type="FD_SOCK" socket-binding="jgroups-udp-fd"/>
                  <protocol type="FD_ALL"/>
                  <protocol type="VERIFY_SUSPECT"/>
                  <protocol type="pbcast.NAKACK2"/>
                  <protocol type="UNICAST3"/>
                  <protocol type="pbcast.STABLE"/>
                  <protocol type="pbcast.GMS"/>
                  <protocol type="UFC"/>
                  <protocol type="MFC"/>
                  <protocol type="FRAG3"/>
                </stack>
                <stack name="tcp">
                  <transport type="TCP" socket-binding="jgroups-tcp"/>
                  <socket-protocol type="MPING" socket-binding="jgroups-mping"/>
                  <protocol type="MERGE3"/>
                  <socket-protocol type="FD_SOCK" socket-binding="jgroups-tcp-fd"/>
                  <protocol type="FD_ALL"/>
                  <protocol type="VERIFY_SUSPECT"/>
                  <protocol type="pbcast.NAKACK2"/>
                  <protocol type="UNICAST3"/>
                  <protocol type="pbcast.STABLE"/>
                  <protocol type="pbcast.GMS"/>
                  <protocol type="MFC"/>
                  <protocol type="FRAG3"/>
                </stack>
            </stacks>
          </subsystem>

   4. 以下のインターフェイスを設定します。

      <interface name="private">
          <inet-address value="${jboss.bind.address.private:127.0.0.1}"/>
      </interface>

   5. 以下のソケットを設定します。

      <socket-binding name="jgroups-mping" interface="private" multicast-address="${jboss.default.multicast.address:230.0.0.4}" multicast-port="45700"/>
      
        <socket-binding name="jgroups-tcp" interface="private" port="7600"/>
        <socket-binding name="jgroups-tcp-fd" interface="private" port="57600"/>
        <socket-binding name="jgroups-udp" interface="private" port="55200" multicast-address="${jboss.default.multicast.address:230.0.0.4}" multicast-port="45688"/>
        <socket-binding name="jgroups-udp-fd" interface="private" port="54200"/>

2. Infinispan 拡張機能を KIE Server に追加します。

   1. テキストエディターで kie-server.war/WEB-INF/jboss-deployment-structure.xml ファイルを開き、以下の依存関係をファイルに追加します。

          <module name="org.infinispan" services="export"/>
          <module name="org.jgroups" />

   2. JAR ファイルをダウンロードします。

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

         • 製品: Process Automation Manager
         • バージョン: 7.11
      2. Red Hat Process Automation Manager 7.11.0 Maven Repository (rhpam-7.11.0-maven-repository.zip) をダウンロードし、ZIP ファイルを展開します。
      3. 展開したファイルが含まれるディレクトリーに移動し、maven-repository/org/kie/server/kie-server-services-jbpm-cluster/7.52.0.Final-redhat-00007/kie-server-services-jbpm-cluster-7.52.0.Final-redhat-00007.jar ファイルを kie-server.war/WEB-INF/lib ディレクトリーにコピーします。

手順

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

   • Product: Process Automation Manager
   • バージョン: 7.11
2. Red Hat Process Automation Manager 7.11.0 Add-Ons をダウンロードします。
3. ダウンロードした rhpam-7.11.0-add-ons.zip ファイルを一時ディレクトリーに展開します。rhpam-7.11.0-smart-router.jar ファイルは展開した rhpam-7.11.0-add-ons ディレクトリーにあります。
4. rhpam-7.11.0-smart-router.jar ファイルを、ファイルを実行するディレクトリーにコピーします。

5. 以下のコマンドを入力して、Smart Router を起動します。

   java
   -Dorg.kie.server.router.host=<ROUTER_HOST>
   -Dorg.kie.server.router.port=<ROUTER_PORT>
   -Dorg.kie.server.controller=<CONTROLLER_URL>
   -Dorg.kie.server.controller.user=<CONTROLLER_USER>
   -Dorg.kie.server.controller.pwd=<CONTROLLER_PWD>
   -Dorg.kie.server.router.config.watcher.enabled=true
   -Dorg.kie.server.router.repo=<NFS_STORAGE>
   -jar rhpam-7.11.0-smart-router.jar

   上のコマンドのプロパティーのデフォルト値は、以下のようになります。

   org.kie.server.router.host=localhost
   org.kie.server.router.port=9000
   org.kie.server.controller= N/A
   org.kie.server.controller.user=kieserver
   org.kie.server.controller.pwd=kieserver1!
   org.kie.server.router.repo= <CURRENT_WORKING_DIR>
   org.kie.server.router.config.watcher.enabled=false

   org.kie.server.controller は、以下のように、サーバーコントローラーの URL です。

   org.kie.server.controller=http://<HOST>:<PORT>/controller/rest/controller

   org.kie.server.router.config.watcher.enabled は、ウォッチャーサービスシステムプロパティーを有効にする任意の設定です。

6. Smart Router に接続する必要のあるすべての KIE サーバーインスタンスでは、org.kie.server.router システムプロパティーに Smart Router の URL を設定します。

7. クライアント側から Smart Router にアクセスするには、以下のように、KIE Server の URL の代わりに Smart Router の URL を使用します。

   KieServicesConfiguration config = KieServicesFactory.newRestConfiguration("http://smartrouter.example.com:9000", "USERNAME", "PASSWORD");

   この例では、smartrouter.example.com は Smart Router URL で、USERNAME および PASSWORD は、Smart Router 設定のログイン認証情報です。

8. データサンプルを投入できるように、管理対象外の KIE Server に新しいコンテナーを作成するには、以下の HTTP 要求を送信します。

   $ curl -v -X POST -H 'Content-type: application/xml' -H 'X-KIE-Content-Type: xstream' -d @create-container.xml -u ${KIE_CRED} http://${KIE-SERVER-HOST}:${KIE-SERVER-PORT}/kie-server/services/rest/server/config/

9. create-container.xml ファイルの内容を確認します。

   <script>
     <create-container>
       <container container-id="example:timer-test:1.1">
         <release-id>
           <group-id>example</group-id>
           <artifact-id>timer-test</artifact-id>
           <version>1.1</version>
         </release-id>
         <config-items>
           <itemName>RuntimeStrategy</itemName>
           <itemValue>PER_PROCESS_INSTANCE</itemValue>
           <itemType></itemType>
         </config-items>
       </container>
     </create-container>
   </script>

   Smart Router コンソールにデプロイされたメッセージが表示されます。以下に例を示します。

   INFO: Added http://localhost:8180/kie-server/services/rest/server as server location for container example:timer-test:1.1

10. コンテナーの一覧を表示するには、次のコマンドを入力します。

    $ curl http://localhost:9000/mgmt/list

    コンテナーの一覧が表示されます。

    {
      "containerInfo": [{
        "alias": "timer-test",
        "containerId": "example:timer-test:1.1",
        "releaseId": "example:timer-test:1.1"
      }],
      "containers": [
        {"example:timer-test:1.1": ["http://localhost:8180/kie-server/services/rest/server"]},
        {"timer-test": ["http://localhost:8180/kie-server/services/rest/server"]}
      ],
      "servers": [
        {"kieserver2": []},
        {"kieserver1": ["http://localhost:8180/kie-server/services/rest/server"]}
      ]
    }

11. Smart Router の URL を使用してプロセスを初期化するには以下のコマンドを入力します。

    $ curl -s -X POST -H 'Content-type: application/json' -H 'X-KIE-Content-Type: json' -d '{"timerDuration":"9s"}' -u kieserver:kieserver1! http://localhost:9000/containers/example:timer-test:1.1/processes/timer-test.TimerProcess/instances

手順

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

   java -jar rhpam-installer-7.11.0.jar

   注記

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

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

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

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

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

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

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

   Business Central は Red Hat JBoss Web Server にインストールすることができません。Business Central をインストールできるのは Red Hat JBoss EAP だけです。ただし、KIE Server とヘッドレス Process Automation Manager コントローラーは、Red Hat JBoss Web Server にインストールできます。ヘッドレス Process Automation Manager コントローラーは、KIE Server の管理に使用されます。複数の KIE Server インスタンスを管理する予定がある場合は、ヘッドレス Process Automation Manager コントローラーをインストールします。

5. ユーザーを作成して Next をクリックします。デフォルトでは、同じコンテナーに Business Central と KIE Server の両方をインストールする場合は、新しいユーザーに admin ロール、kie-server ロール、および rest-all ロールが割り当てられます。KIE Server のみをインストールした場合には、ユーザーには kie-server ロールが割り当てられます。KIE Server REST 機能にアクセスするには kie-server ロールが必要です。

   注記

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

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

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

6. Installation Overview ページで、インストールするコンポーネントを確認し、Next をクリックしてインストールを開始します。
7. インストールが完了したら、Next をクリックします。

8. KIE Server がインストールされている場合には、Component Installation で Configure Runtime の手順が表示されます。Configure Runtime Environment ページで、デフォルトのインストールを実行するか、詳細設定を行うかを選択します。

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

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

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

10. KIE Server Properties Configuration で Customize KIE Server properties を選択した場合は、以下のいずれかのプロパティーを変更します。

    • KIE Server ID の値を変更して、KIE Server プロパティーの名前を変更します。
    • 無効にする KIE Server 機能の選択を解除します。
11. Next をクリックして、ランタイム環境を設定します。
12. 画面上部に Processing finished が表示されたら、Next をクリックしてインストールを完了します。

13. 必要に応じて、Generate Installation Script and Properties File をクリックして、XML ファイルでインストールデータを保存し、Done をクリックします。

    インストーラーは、2 つのファイルを生成します。auto.xml ファイルは、今後のインストールを自動化し、auto.xml.variables ファイルは、ユーザーのパスワードと他の機密情報に関連する変数を保存します。auto.xml ファイルを使用して、元のインストールと同じタイプのサーバーおよび同じ設定の複数のシステムで Red Hat Process Automation Manager のインストールを繰り返します。必要に応じて、auto.xml ファイルの installpath パラメーターを更新します。XML ファイルを使用してインストールを実行するには、以下のコマンドを入力します。

    java -jar rhpam-installer-7.11.0.jar <path-to-auto.xml-file>

手順

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

   java -jar rhpam-installer-7.11.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 or Red Hat JBoss Web Server 5. For more information, see https://access.redhat.com/articles/3405381[Red Hat Process Automation Manager 7 Supported Configurations].

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

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

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

   注記

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

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

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

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

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

6. y を入力してインストールデータが含まれる XML ファイルを作成します。あるいは、n を入力してインストールを完了します。y を入力すると、XML ファイルのパスを指定するように求められます。

7. パスを入力するか、Enter キーを押して提案されたパスを了承します。

   インストーラーは、2 つのファイルを生成します。auto.xml ファイルは、今後のインストールを自動化し、auto.xml.variables ファイルは、ユーザーのパスワードと他の機密情報に関連する変数を保存します。複数のシステムで auto.xml ファイルを使用して、元のインストールと同じ設定の同じタイプのサーバーに、Red Hat Process Automation Manager を簡単に繰り返しインストールできます。必要に応じて、auto.xml ファイルの installpath パラメーターを更新します。XML ファイルを使用してインストールを実行するには、以下のコマンドを入力します。

   java -jar rhpam-installer-7.11.0.jar <path-to-auto.xml-file>

8. KIE Server だけをインストールした場合は、この手順を繰り返して、別のサーバーにヘッドレス Process Automation Manager コントローラーをインストールします。

手順

1. rhpam-7.11.0-add-ons.zip ファイルを展開します。

2. 展開した rhpam-7.11.0-add-ons.zip ファイルから、以下のファイルを展開します。

   • rhpam-7.11.0-kie-server-jws.zip
   • rhpam-7.11.0-process-engine.zip

   以下の説明では、展開した rhpam-7.11.0-kie-server-jws.zip ファイルが含まれるディレクトリーは JWS_TEMP_DIR と呼ばれ、展開した rhpam-7.11.0-process-engine.zip ファイルが含まれるディレクトリーは ENGINE_TEMP_DIR と呼ばれます。

3. JWS_TEMP_DIR/rhpam-7.11.0-kie-server-jws/kie-server.war ディレクトリーを JWS_HOME/tomcat/webapps ディレクトリーにコピーします。

   注記

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

4. kie-server.war ディレクトリーから .war 拡張子を削除します。
5. kie-tomcat-integration-7.52.0.Final-redhat-00007.jar ファイルを ENGINE_TEMP_DIR ディレクトリーから JWS_HOME/tomcat/lib ディレクトリーに移動します。
6. jboss-jacc-api-<VERSION>.jar ファイル、slf4j-api-<VERSION>.jar ファイル、および slf4j-jdk14-<VERSION>.jar ファイルを ENGINE_TEMP_DIR/lib ディレクトリーから JWS_HOME/tomcat/lib ディレクトリーに移動します。<VERSION> は lib ディレクトリーのバージョンのアーティファクトファイル名に置き換えます。

7. 最後の Valve 定義の後にある JWS_HOME/tomcat/conf/server.xml ファイルの <host> 要素に、以下の行を追加します。

   <Valve className="org.kie.integration.tomcat.JACCValve" />

8. テキストエディターで JWS_HOME/tomcat/conf/tomcat-users.xml ファイルを開きます。

9. JWS_HOME/tomcat/conf/tomcat-users.xml ファイルにユーザーおよびロールを追加します。以下の例で、<ROLE_NAME> は Red Hat Process Automation Manager でサポートされているロールです。<USER_NAME> および <USER_PWD> は、選択したユーザー名とパスワードです。

   <role rolename="<ROLE_NAME>"/>
   <user username="<USER_NAME>" password="<USER_PWD>" roles="<ROLE_NAME>"/>

   ユーザーに複数のロールを割り当てる場合は、以下の例に示すようにロールをコンマで区切ります。

   <role rolename="admin"/>
   <role rolename="kie-server"/>
   <user username="rhpamUser" password="user1234" roles="admin,kie-server"/>

10. JWS_HOME/tomcat/bin ディレクトリーで以下の手順の 1 つを実行します。

    • Linux または UNIX の場合は、以下の内容の setenv.sh ファイルを作成します。

      CATALINA_OPTS="-Xmx1024m -Dorg.jboss.logging.provider=jdk"

    • Windows の場合は、以下の内容の setenv.bat ファイルを作成します。

      set CATALINA_OPTS=-Xmx1024m -Dorg.jboss.logging.provider=jdk

手順

1. 以下の手順を実行して、データベースを準備します。

   1. TEMP_DIR などの一時ディレクトリーに rhpam-7.11.0-add-ons.zip を展開します。
   2. TEMP_DIR/rhpam-7.11.0-migration-tool.zip を展開します。
   3. 現在のディレクトリーから、TEMP_DIR/rhpam-7.11.0-migration-tool/ddl-scripts ディレクトリーに移動します。このディレクトリーには、複数のデータベースタイプの DDL スクリプトが含まれています。

   4. 使用するデータベースに、お使いのデータベースタイプの DDL スクリプトをインポートします。以下に例を示します。

      psql jbpm < /ddl-scripts/postgresql/postgresql-jbpm-schema.sql

      注記

      PostgreSQL または Oracle を Spring Boot と併用する場合は、対応する Spring Boot の DDL スクリプト (/ddl-scripts/oracle/oracle-springboot-jbpm-schema.sql または /ddl-scripts/postgresql/postgresql-springboot-jbpm-schema.sql) をインポートする必要があります。

2. rhpam-7.11.0-maven-repository.zip のオフライン Maven リポジトリーファイルを展開します。

3. 展開したオフラインの Maven リポジトリーから JWS_HOME/tomcat/lib ディレクトリーにコピーします。VERSION は対象のライブラリーのバージョンに置き換えます。

   org/jboss/spec/javax/transaction/jboss-transaction-api_1.2_spec/{VERSION}/jboss-transaction-api_1.2_spec-{VERSION}.jar
   org/jboss/integration/narayana-tomcat/{VERSION}/narayana-tomcat-{VERSION}.jar
   org/jboss/narayana/jta/narayana-jta/{VERSION}/narayana-jta-{VERSION}.jar
   org/jboss/jboss-transaction-spi/{VERSION}/jboss-transaction-spi-{VERSION}.jar

4. データベースの JDBC ドライバーを JWS_HOME/tomcat/lib ディレクトリーにコピーします。

5. JWS_HOME/tomcat/conf/context.xml ファイルで、プーリングしている XA データソースを設定します。

   注記

   以下の例のプロパティーで、お使いのデータベースサーバーに該当しない場合があります。JDBC ドライバーのドキュメントを参照して、どのプロパティーを設定するかを判断してください。

   1. プーリング機能なしで XA データソースを設定します。この XA データソースは、対象のデータベースに新規接続を作成するときに使用します。以下の例では、XA データソースは xads で、変数は 表36.1「XA データソースの変数」 に定義されています。

      <?xml version="1.0" encoding="UTF-8"?>
      <Context>
      <Resource
      auth="Container"
      databaseName="${datasource.dbName}"
      description="XA Data Source"
      factory="org.apache.tomcat.jdbc.naming.GenericNamingResourcesFactory" loginTimeout="0"
      name="xads"
      uniqueName="xads"
      portNumber="${datasource.port}"
      serverName="${datasource.hostname}"
      testOnBorrow="false"
      type="${datasource.class}"
      url="${datasource.url}"
      URL="${datasource.url}"
      user="${datasource.username}"
      password="${datasource.password}"
      driverType="4"
      schema="${datasource.schema}"
      />
      </Context>

      表36.1 XA データソースの変数

      変数	説明
      <datasource.dbName>	データベース名。
      <datasource.port>	データベースのポート番号。
      <datasource.hostname>	データベースホスト名。
      <datasource.class>	JDBC ドライバーの XADataSource クラス。
      <datasource.url>	JDBC データベース接続の URL。データベースによって、URL プロパティーが url、または URL (H2 データベースなど) になります。
      <datasource.username>	データベース接続のユーザー名。
      <datasource.password>	データベース接続のパスワード。
      <datasource.schema>	データベーススキーマ。

   2. 新規接続の作成時に XA データソースに依存するプーリングデータソースを設定します。以下の例では、データソースは poolingXaDs で、<datasource.username> はデータベース接続のユーザー名、<datasource.password> はデータベース接続のパスワードどなっています。

      <?xml version="1.0" encoding="UTF-8"?>
      <Context>
      <Resource
      name="poolingXaDs"
      uniqueName="poolingXaDs"
      auth="Container"
      description="Pooling XA Data Source" factory="org.jboss.narayana.tomcat.jta.TransactionalDataSourceFactory" testOnBorrow="true"
      transactionManager="TransactionManager" transactionSynchronizationRegistry="TransactionSynchronizationRegistry" type="javax.sql.XADataSource"
      username="${datasource.username}"
      password="${datasource.password}"
      xaDataSource="xads"
      />
      </Context>

      データソースが java:comp/env/poolingXaDs の JNDI 名で取得でき、次の手順に記載されているように、org.kie.server.persistence.ds システムプロパティーを使用して KIE Server に渡すことができます。

      注記

      プーリングのデータソース設定は、特に TransactionManager や TransactionSynchronizationRegistry など、kie-server アプリケーションの context.xml ファイルで以前に設定された追加リソースに依存します。

6. KIE Server をがデータソースを使用するように設定します。

   1. テキストエディターで以下のスクリプトのいずれかを開きます。

      注記

      setenv.sh スクリプトまたは setenv.bat スクリプトはすでに存在しているはずです。存在していない場合は作成してください。

      • Linux または Unix の場合:

        JWS_HOME/tomcat/bin/setenv.sh

      • Windows の場合:

        JWS_HOME/tomcat/bin/setenv.bat

   2. 以下のプロパティーを CATALINA_OPS に追加します。<hibernate.dialect> はお使いのデータベースの Hibernate 方言に置き換えます。

      CATALINA_OPTS="-Xmx1024m
      -Dorg.jboss.logging.provider=jdk
      -Dorg.kie.server.persistence.ds=java:comp/env/poolingXaDs
      -Dorg.kie.server.persistence.tm=JBossTS
      -Dorg.kie.server.persistence.dialect=${<hibernate.dialect>}"

手順

1. Maven プロジェクトを生成します。pom.xml ファイルは、Maven プロジェクトの作成時に自動的に生成されます。

2. pom.xml ファイルを編集して、追加の依存関係および新たなリポジトリーを追加します。

   プロジェクトのコンパイルおよびパッケージング時に、Maven がすべての JAR ファイルおよび依存関係にある JAR ファイル を Maven リポジトリーからダウンロードします。

手順

1. settings.xml ファイルでは、Red Hat Process Automation Manager プロジェクトが使用するリポジトリーを宣言します。通常、これは online Red Hat Process Automation Manager Maven repository、または Red Hat カスタマーポータルからダウンロードする Red Hat Process Automation Manager Maven リポジトリーおよび使用するカスタムアーティファクト用のリポジトリーのいずれかです。

2. Business Central または KIE Server が settings.xml ファイルを使用するように設定されていることを確認します。たとえば、kie.maven.settings.custom=<SETTINGS_FILE_PATH> プロパティーを指定し、<SETTINGS_FILE_PATH> は settings.xml ファイルのパスに置き換えます。

   Red Hat JBoss Web Server で、KIE Server の場合は -Dkie.maven.settings.custom=<SETTINGS_FILE_PATH> を setenv.sh (Linux) または setenv.bat (Windows) ファイルの CATALINA_OPTS セクションに追加します。スタンドアロンの Business Central の場合は、以下のコマンドを入力します。

   java -jar rhpam-7.11.0-business-central-standalone.jar -s application-config.yaml -Dkie.maven.settings.custom=<SETTINGS_FILE_PATH>

手順

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

   <dependencyManagement>
    <dependencies>
     <dependency>
      <groupId>com.redhat.ba</groupId>
      <artifactId>ba-platform-bom</artifactId>
      <version>7.11.0.redhat-00005</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>
       <groupId>org.jbpm</groupId>
       <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:business-central-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>

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

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

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

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

     クライアントの依存関係

     <dependency>
       <groupId>org.uberfire</groupId>
       <artifactId>uberfire-rest-client</artifactId>
     </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. 公開インターネットに送信アクセスができるコンピューターで、以下のアクションを実行します。

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

   • 製品: Red Hat Process Automation Manager

   • バージョン: 7.11

     1. Red Hat Process Automation Manager 7.11.0 Offliner Content List (rhpam-7.11.0-offliner.zip) の製品配信可能ファイルをダウンロードして展開します。
     2. rhpam-7.11.0-offliner.zip ファイルの内容を任意のディレクトリーに展開します。

     3. ディレクトリーに移動し、以下のコマンドを入力します。

        ./offline-repo-builder.sh offliner.txt

        このコマンドは、repository サブディレクトリーを作成し、必要なアーティファクトをこのサブディレクトリーにダウンロードします。これはミラーリポジトリーです。

        一部のダウンロードが失敗したことを示すメッセージが表示された場合は、同じコマンドを再度実行してください。ダウンロードが再び失敗する場合は、Red Hat サポートに連絡してください。

3. Business Central 外でサービスを開発し、追加の依存関係がある場合は、ミラーリポジトリーにその依存関係を追加します。サービスを Maven プロジェクトとして開発した場合は、以下の手順を使用し、これらの依存関係を自動的に用意します。公開インターネットへに送信接続できるコンピューターで、この手順を実行します。

   1. ローカルの Maven キャッシュディレクトリー (~/.m2/repository) のバックアップを作成して、ディレクトリーを削除します。
   2. mvn clean install コマンドを使用してプロジェクトのソースをビルドします。

   3. すべてのプロジェクトで以下のコマンドを入力し、Maven を使用してプロジェクトで生成したすべてのアーティファクトのランタイムの依存関係をすべてダウンロードするようにします。

      mvn -e -DskipTests dependency:go-offline -f /path/to/project/pom.xml --batch-mode -Djava.net.preferIPv4Stack=true

      /path/to/project/pom.xml を、プロジェクトの pom.xml ファイルのパスに置き換えます。

   4. ローカルの Maven キャッシュディレクトリー (~/.m2/repository) の内容を、作成した repository サブディレクトリーにコピーします。
4. repository サブディレクトリーの内容を、Red Hat Process Automation Manager をデプロイしたコンピューターのディレクトリーにコピーします。このディレクトリーがオフラインの Maven ミラーリポジトリーになります。
5. 「Maven 設定ファイルの修正」 の説明に従って、Red Hat Process Automation Manager デプロイメント向けに、settings.xml ファイルを作成して設定します。

6. settings.xml ファイルで以下を変更します。

   • <profile> タグの下に、<repositories> タグまたは <pluginRepositores> タグがない場合は、不足しているタグを追加します。

   • <repositories> の下に、以下のコンテンツを追加します。

     <repository>
       <id>offline-repository</id>
       <url>file:///path/to/repo</url>
       <releases>
         <enabled>true</enabled>
       </releases>
       <snapshots>
         <enabled>false</enabled>
       </snapshots>
     </repository>

     /path/to/repo は、ローカルの Maven ミラーリポジトリーのディレクトリーに対する完全パスに置き換えます。

   • <pluginRepositories> の下に、以下のコンテンツを追加します。

     <repository>
       <id>offline-plugin-repository</id>
       <url>file:///path/to/repo</url>
       <releases>
         <enabled>true</enabled>
       </releases>
       <snapshots>
         <enabled>false</enabled>
       </snapshots>
     </repository>

     /path/to/repo は、ローカルの Maven ミラーリポジトリーのディレクトリーに対する完全パスに置き換えます。

手順

1. WebSphere 統合ソリューションコンソールで、Security → Global Security の順にクリックし、Enable Application Security オプションが選択されていることを確認します。選択していても、サーバーレベルで上書きされている可能性があります。
2. Security Configuration Wizard をクリックし、Next をクリックします。
3. ユーザー情報を含むリポジトリーを選択します。たとえば、ローカル設定で Federated repositories を選択します。
4. Next をクリックします。
5. Primary administrative user name および Password を入力します。
6. Next をクリックし、Finish をクリックします。

7. Messages ウィンドウで Save をクリックして、プライマリー設定への変更を保存します。

   図47.1 セキュリティー変更の保存

   

8. 端末で、インストール時に指定した IBM WebSphere Application Server の /bin ディレクトリーの場所に移動し、以下のコマンドを実行して IBM WebSphere を停止して再起動し、セキュリティーの変更を適用します。

   sudo ./stopServer.sh <SERVER_NAME>

   sudo ./startServer.sh <SERVER_NAME>

   <SERVER_NAME> は、WebSphere 統合ソリューションコンソールの Servers → Server Types → IBM WebSphere Application Servers で定義した IBM WebSphere Application Server の名前に置き換えます。

手順

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

   • 製品: Process Automation Manager
   • バージョン: 7.11
2. Red Hat Process Automation Manager 7.11.0 Add-Ons をダウンロードします。

3. 以下の手順を実行して、データベースを準備します。

   1. TEMP_DIR などの一時ディレクトリーに rhpam-7.11.0-add-ons.zip を展開します。
   2. TEMP_DIR/rhpam-7.11.0-migration-tool.zip を展開します。
   3. 現在のディレクトリーから、TEMP_DIR/rhpam-7.11.0-migration-tool/ddl-scripts ディレクトリーに移動します。このディレクトリーには、複数のデータベースタイプの DDL スクリプトが含まれています。

   4. 使用するデータベースに、お使いのデータベースタイプの DDL スクリプトをインポートします。以下に例を示します。

      psql jbpm < /ddl-scripts/postgresql/postgresql-jbpm-schema.sql

      注記

      PostgreSQL または Oracle を Spring Boot と併用する場合は、対応する Spring Boot の DDL スクリプト (/ddl-scripts/oracle/oracle-springboot-jbpm-schema.sql または /ddl-scripts/postgresql/postgresql-springboot-jbpm-schema.sql) をインポートする必要があります。

4. WebSphere 統合ソリューションコンソールで、Resources → JDBC → Data sources の順に移動します。
5. データソースを使用するアプリケーションでスコープを選択します。セル、ノード、クラスター、またはサーバーを選択できます。
6. New をクリックし、Create a data source ウィザードを開きます。

7. Data source name フィールドに一意の名前を入力し、JNDI name フィールドに JNDI (Java Naming and Directory Interface) 名を入力します。アプリケーションサーバーは JNDI 名を使用して、アプリケーションのリソース参照をこのデータソースにバインドします。

   複数のリソースタイプ (データソース、J2C 接続ファクトリー/JMS 接続ファクトリー) に割り当てる JNDI 名を重複させないでください。

   同じスコープに、同じタイプの複数のリソースに割り当てる JNDI 名を重複させないでください。

8. プロバイダーを作成している場合は、Next をクリックして Select an existing JDBC provider を選択します。作成していない場合は Create new JDBC provider をクリックして、新しいプロバイダーの詳細を定義します。(JDBC プロバイダーは、データソースを追加するための前提条件であるため、事前に作成しておくことが推奨されます。)
9. CMP (container managed persistence) のエンタープライズ Bean がこのデータソースにアクセスする必要がある場合は、Enter database specific properties for the data source パネルで Use this data source in container managed persistence (CMP) をクリックします。これにより、その他のデータベース関連のプロパティーが書き込まれます。

10. 必要に応じて、データソースのセキュリティーエイリアスを設定します。すべての認証メソッドで None を選択するか、以下のいずれを選択できます。

    • Component-managed authentication alias: コンポーネントリソース参照の res-auth 値が Application の場合に使用する認証エイリアスを指定します。新しいエイリアスを定義するには、Related Items → J2EE Connector Architecture (J2C) authentication data entries に移動します。コンポーネント管理エイリアスは、データソース認証に対してアプリケーションに指定した ID およびパスワードの組み合わせとなります。したがって、データソースに設定したエイリアスは、アプリケーションコードのエイリアスと同一にする必要があります。
    • Mapping-configuration alias: コンポーネントリソース参照にログイン設定がない場合にのみ利用します。res-auth 値を Container に設定した場合は、ログイン設定およびコンポーネントリソース参照の関連プロパティーを指定することが、認証ストラテジーを定義するのに推奨される方法です。DefaultPrincipalMapping ログイン設定を指定する場合の関連プロパティーは JAAS - J2C 認証データエントリーエイリアスです。
    • Container-managed authentication alias: コンポーネントリソース参照にログイン設定がない場合にのみ利用します。res-auth 値を Container に設定する場合は、ログイン設定と、コンポーネントリソース参照の関連プロパティーを指定することで、コンテナー管理認証ストラテジーが判断されます。

11. Next をクリックしてデータソースの情報を確認し、Finish をクリックして設定を保存してウィザードを終了します。

    Data sources パネルには、新しい設定と、同じスコープに設定したその他のデータソースがテーブルに表示されます。

手順

1. WebSphere 統合ソリューションコンソールで、Servers → Server Types → IBM WebSphere Application Servers の順にクリックします。
2. アプリケーションサーバーの一覧で、KIE Server をデプロイするサーバーを選択します。

3. Server Infrastructure で Java and Process Management → Process Definition をクリックします。

   図47.2 WebSphere 設定ページ

   

4. Additional Properties で Java Virtual Machine をクリックします。

   図47.3 プロセスの定義設定ページ

   

   これにより、IBM WebSphere を起動するのに使用する JVM の設定プロパティーが開きます。

5. Initial heap size および Maximum heap size の両方を 2048 に設定し、Apply をクリックして Java Virtual Machine (JVM) メモリーサイズを増やします。KIE Server はこの値でテストされています。JVM メモリーサイズを増やさないと、KIE Server のデプロイ時に IBM WebSphere Application Server がフリーズするかエラーが発生します。
6. Additional Properties で Custom Properties をクリックします。

7. New → Custom JVM Properties の順にクリックし、以下のプロパティーを IBM WebSphere に追加します。

   表47.4 KIE Server のシステムプロパティー

   名前	値	説明
   kie.server.jms.queues.response	jms/KIE.SERVER.RESPONSE	KIE Server が使用する応答用の JMS キューの JNDI 名。
   org.kie.server.domain	WSLogin	JMS の使用時にユーザーの認証に使用される JAAS LoginContext ドメイン。
   org.kie.server.persistence.ds	jdbc/jbpm	KIE Server のデータソースの JNDI 名。
   org.kie.server.persistence.tm	org.hibernate.engine.transaction.jta.platform.internal.WebSphereJtaPlatform	Hibernate プロパティーを設定するためのトランザクションマネージャープラットフォーム。
   org.kie.server.persistence.dialect	例: org.hibernate.dialect.H2Dialect	使用する Hibernate 方言を指定します。データソースに従って設定します。
   org.kie.executor.jms.queue	jms/KIE.SERVER.EXECUTOR	KIE Server へのジョブエグゼキューターの JMS キュー。
   org.kie.executor.jms.cf	jms/cf/KIE.SERVER.EXECUTOR	KIE Server へのジョブエグゼキューターの JMS 接続ファクトリー。
   org.kie.server.router	例: http://localhost:9000	(オプション) クラスター化された KIE Server 環境で、アプリケーションサーバーがその一部である 1 つ以上の KIE Server ルーター (Smart Router) の URL を 1 つ以上指定します。
   org.jboss.logging.provider	jdk	このプロパティーは、CA SiteMinder TAI (SMTAI) が環境にインストールされている場合にのみ必要になります。このプロパティーを使用すると、Dashbuilder でログを記録するために、Hibernate が log4j ではなく、JDK を強制的に使用しようとします。CA SiteMinder TAI (SMTAI) には古いバージョンの log4j が含まれており、これにより競合が生じます。

8. 保存 をクリックして、プライマリー設定への変更を保存します。

手順

1. WebSphere 統合ソリューションコンソールで、Users and Groups → Manage Groups の順にクリックします。
2. Manage Groups 画面で Create をクリックします。
3. Create a Group 画面の Group name ボックスに kie-server と入力し、Create をクリックします。
4. kie-server グループに追加するユーザーを作成するには、Users and Groups → Manage Users の順にクリックします。
5. Create a User セクションで、必要な情報を入力します。
6. Group Membership をクリックします。
7. Group Membership 画面で kie-server をクリックして Mapped To に移動し、Close をクリックします。
8. Create a User 画面で Create をクリックします。

手順

1. WebSphere 統合ソリューションコンソールで、Applications → Application Types → WebSphere Enterprise Applications に移動し、新たにインストールした kie-server アプリケーションを選択します。
2. Detail Properties で Security Role to User/Group Mapping をクリックします。
3. kie-server ロールを選択し、Map Groups をクリックして、kie-server グループを検索します。

4. kie-server グループを、Available 一覧から Selected 一覧に移動し、OK をクリックします。

   このマッピングにより、IBM WebSphere Application Server の kie-server グループのユーザーに、KIE Server へのアクセスが付与されます。

5. Save をクリックしてマッピングを完了します。

手順

1. Applications → Application Types → WebSphere Enterprise Applications に移動し、kie-server をクリックします。
2. 左側の Detail Properties の見出しにある Class Loading and Update Detection をクリックします。
3. プロパティーで、Class Loader Order を Classes loaded with local class loader first (parent last) に、WAR Class Loader Policy を Single class loader for application に変更します。
4. 変更をプライマリー設定に保存します。

手順

1. サーバーが実行していることを確認するには、以下のタスクのいずれかを実行します。

   • KIE Server の URL (http://<HOST>:<PORT>/kie-server ) に移動します。

   • http://<HOST>:<PORT>/kie-server/services/rest/server に GET 要求を送信し、KIE Server REST API が応答するかどうかを確認します。

     上記の例では、以下のプレースホルダーを置き換えてください。

     • <HOST> は、KIE Server ホストの ID または名前に置き換えます (例: localhost または 192.7.8.9)。
     • <PORT> は、KIE Server ホストのポート番号に置き換えます (例: 9060)。
2. KIE Server が実行していない場合は、IBM WebSphere Application Server インスタンスを停止して再起動し、KIE Server の URL または API に再度アクセスしてみてください。

手順

1. Applications → Application Types → WebSphere Enterprise Applications に移動し、kie-server をクリックします。
2. 左側の Detail Properties の見出しにある Class Loading and Update Detection をクリックします。
3. プロパティーで、Class Loader Order を Classes loaded with local class loader first (parent last) に、WAR Class Loader Policy を Single class loader for application に変更します。
4. 変更をプライマリー設定に保存します。

手順

1. ヘッドレス Process Automation Manager コントローラーがインストールされているアプリケーションサーバーインスタンスに、以下の JVM プロパティー値を指定します。

   表49.1 ヘッドレス Process Automation Manager コントローラーに必要なプロパティー

   名前	要件
   org.kie.server.user	kie-server ロールが割り当てられているユーザー
   org.kie.server.pwd	org.kie.server.user プロパティーに指定したユーザーのパスワード

2. KIE Server がインストールされているアプリケーションサーバーインスタンスに、以下の JVM プロパティー値を指定します。

   表49.2 ヘッドレス Process Automation Manager コントローラーがインストールされている場合に KIE Server に必要なプロパティー

   名前	要件
   org.kie.server.controller.user	kie-server ロールが割り当てられているユーザー
   org.kie.server.controller.pwd	org.kie.server.controller.user プロパティーに指定したユーザーのパスワード
   org.kie.server.id	KIE Server インストールの ID または名前 (rhdm700-decision-server-1 など)
   org.kie.server.location	KIE Server の URL (http://<HOST>:<PORT>/kie-server/services/rest/server)
   org.kie.server.controller	ヘッドレス Process Automation Manager コントローラーの URL (http://<HOST>:<PORT>/controller/rest/controller)

   <HOST> は、KIE Server ホストの ID または名前に置き換えます (例: localhost または 192.7.8.9)。

   <PORT> は、KIE Server ホストのポート番号に置き換えます (例: 7001)。

手順

1. WebSphere 統合ソリューションコンソールで、KIE Server グループおよびロールの作成 の記載通りに、kie-server グループと、このグループのユーザーを作成します。
2. Applications → Application Types → WebSphere Enterprise Applications に移動し、新たにインストールしたヘッドレス Process Automation Manager コントローラーを選択します。
3. Detail Properties で Security Role to User/Group Mapping をクリックします。
4. kie-server ロールを選択し、Map Groups をクリックして、kie-server グループを検索します。

5. kie-server グループを、Available 一覧から Selected 一覧に移動し、OK をクリックします。

   このマッピングにより、事前に作成した管理者ユーザーに Process Automation Manager へのアクセスが付与されます。

6. Save をクリックしてマッピングを完了します。

手順

1. WebLogic 管理コンソールで Security Realms に移動します。
2. 必要なセキュリティーレルムを選択するか、New をクリックして新しいセキュリティーレルムを作成します。
3. Users and Groups → Groups → New の順に移動して、kie-server グループを作成します。
4. Users → New の順に移動し、新しいユーザーを作成します。

5. server-user などのユーザーとそのパスワードを入力し、OK をクリックします。

   重要

   選択したユーザー名が、ロールまたはグループの名前と競合しないようにします。たとえば、kie-server という名前のロールが存在する場合は、kie-server という名前のユーザーを作成しないでください。

6. 新たに作成したユーザーをクリックして、Groups タブに戻ります。
7. 選択ツールを使用して、kie-server グループを Available フィールドから Chosen フィールドに移動し、Save をクリックします。

手順

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

   • 製品: Process Automation Manager
   • バージョン: 7.11
2. Red Hat Process Automation Manager 7.11.0 Add-Ons をダウンロードします。

3. 以下の手順を実行して、データベースを準備します。

   1. TEMP_DIR などの一時ディレクトリーに rhpam-7.11.0-add-ons.zip を展開します。
   2. TEMP_DIR/rhpam-7.11.0-migration-tool.zip を展開します。
   3. 現在のディレクトリーから、TEMP_DIR/rhpam-7.11.0-migration-tool/ddl-scripts ディレクトリーに移動します。このディレクトリーには、複数のデータベースタイプの DDL スクリプトが含まれています。

   4. 使用するデータベースに、お使いのデータベースタイプの DDL スクリプトをインポートします。以下に例を示します。

      psql jbpm < /ddl-scripts/postgresql/postgresql-jbpm-schema.sql

      注記

      PostgreSQL または Oracle を Spring Boot と併用する場合は、対応する Spring Boot の DDL スクリプト (/ddl-scripts/oracle/oracle-springboot-jbpm-schema.sql または /ddl-scripts/postgresql/postgresql-springboot-jbpm-schema.sql) をインポートする必要があります。

4. WebLogic 管理コンソールで、Change Center → Lock & Edit の順に移動します。
5. Domain Structure で、Services → Data Sources の順に移動します。
6. Summary of Data Sources ページで、New → Generic Data Source の順にクリックします。

7. JDBC Data Sources Properties ページで、以下の情報を入力するか、選択します。

   • Name: この JDBC データソースの名前を入力します。この名前は設定ファイル (config.xml) と管理コンソールでこのデータソースを参照するのに使用されます。
   • JNDI Name: JDBC データソースをバインドする JNDI パスを入力します。アプリケーションは、接続を予約する際に、この名前を使用して、JNDI ツリーでデータソースを検索します。
   • Database Type: 接続するデータベースの DBMS を選択します。DBMS が記載されていない場合は Other を選択します。
8. Next をクリックして、続行します。
9. データベースに接続するのに使用する データベースドライバー を選択します。この一覧には、選択した DBMS 用の一般的な JDBC ドライバーと、すでにインストールされているその他の JDBC ドライバーが含まれます。

10. Transaction Options ページで、Supports Global Transactions オプションを選択したままにし、利用可能なトランザクションオプションから選択します。このチェックボックスの選択をはずし、このデータソースでグローバルトランザクションを無効 (無視) することもできます。多くの場合、最適なデータ効率を得るために、このオプションは選択したままにする必要があります。

    • Two-Phase Commit: このオプションを選択すると、標準の XA 処理が有効になります。このオプションは、XA JDBC ドライバーを選択して、データベース接続を作成する場合に限り使用できます。
    • Logging Last Resource: このオプションを選択すると、LLR (Logging Last Resource) トランザクションの最適化を使用するグローバルトランザクションに非 XA JDBC 接続を使用できるようになります。このオプションは、Emulate Two-Phase Commit よりも推奨されます。このオプションは、非 XA JDBC ドライバーを選択してデータベース接続を作成する場合に限り使用できます。
    • Emulate Two-Phase Commit: このオプションを選択すると XA JDBC 接続が有効になり、JTA を使用する分散トランザクションでの使用がエミュレートされます。このオプションは、アプリケーションがヒューリスティック条件を容認する場合に限り選択します。このオプションは、非 XA JDBC ドライバーを選択してデータベース接続を作成する場合に限り使用できます。
    • One-Phase Commit: このオプションを選択すると、グローバルトランザクションで使用する 非 XA 接続のみをトランザクションに使用します。このオプションは、非 XA JDBC ドライバーを選択してデータベース接続を作成する場合に限り使用できます。
11. Next をクリックして、続行します。

12. Connection Properties ページで、以下のプロパティーに値を入力します。

    • Service Name: 接続するデータベースのサービス名を指定します。データソースが 1 つ以上提供されている場合は、各データソースに同じサービス名を指定する必要があります。このフィールドは、Oracle Real Application Clusters (RAC) に利用可能なサービスインスタンス接続ドライバーが 1 つ選択されている場合に限り使用できます。
    • Database Name: 接続するデーターベースの名前を入力します。データベースの名前要件は、JDBC ドライバーおよび DBMS によって異なります。
    • Host Name: データベースをホストするサーバーの DNS 名または IP アドレスを入力します。Oracle GridLink サービスインスタンス接続を作成し、データソースを 1 つ以上提供する場合は、各データソースに対する接続は同じにする必要があります。
    • Port: 接続要求に対してデータベースサーバーがリッスンするポートを入力します。
    • Database User Name: データソースの各接続で使用するデータベースのユーザーアカウント名を入力します。
    • Password/Confirm Password: データベースユーザーアカウントのパスワードを入力します。
    • oracle.jdbc.DRCPConnectionClass: お使いの環境で必要な場合は、オプションで、DCRP (Database Resident Connection Pooling) 接続クラスを入力します。
13. Next をクリックして、続行します。

14. Test Database Connection ページで接続パラメーターを確認して、Test Configuration をクリックします。

    Oracle WebLogic Server は、管理サーバーからデータベースへの接続を作成しようとします。接続テストの結果がページ上部に表示されます。テストに失敗した場合は、設定エラーを修正して、再度テストしてみてください。

15. Next をクリックして続行します。選択した JDBC ドライバーが管理サーバーにインストールされていない場合は、この手順を省略できます。
16. Select Targets ページで、データソースをデプロイするサーバーまたはクラスターを選択し、Finish をクリックします。
17. WebLogic 管理コンソールのメインメニューに戻り、Change Center → Activate Changes の順に選択します。