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

手順

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

   java -jar rhpam-installer-7.13.3.jar

   注記

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

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

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

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

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

2. I accept the terms of this license agreement (本使用許諾契約書の内容に同意します) をクリックし、Next をクリックします。
3. Red Hat Process Automation Manager をインストールする Red Hat JBoss EAP 7.4 サーバーのホームを指定して、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 Decision Manager ロールおよびユーザー を参照してください。

   注記

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

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

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

6. Installation Overview ページで、インストールするコンポーネントを確認し、Next をクリックしてインストールを開始します。
7. インストールが完了したら、Next をクリックします。
8. 画面上部に Processing finished が表示されたら、Next をクリックしてインストールを完了します。

9. 必要に応じて、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.13.3.jar <path-to-auto.xml-file>

手順

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

   java -jar rhpam-installer-7.13.3.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.4 インストールの親ディレクトリーを入力します。

   インストーラーが、指定したインストール場所を確認します。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.13.3.jar <path-to-auto.xml-file>

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

手順

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

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

   警告

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

手順

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

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

   警告

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

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

手順

1. 必要に応じて、Red Hat Process Automation Manager でプロパティーベースのユーザーストレージの使用をファイルベースのユーザーストレージに変更する場合は、以下の手順を実行します。

   1. 以下のコマンドを実行して、kie-fs-realm パッチを適用します。

      $ ./bin/elytron-tool.sh filesystem-realm --users-file application-users.properties --roles-file application-roles.properties --output-location kie-fs-realm-users

   2. 各 kie-fs-realm-users/*/<USER>.xml ファイルを開きます。<USER> は Red Hat Process Automation Manager のユーザーです。
   3. <attribute name="roles" value= を <attribute name="role" value= に置き換えます。
2. 端末アプリケーションで EAP_HOME/bin ディレクトリーに移動します。

3. ユーザーを作成して、admin ロール、rest-all ロール、および kie-server ロールを割り当てます。

   注記

   admin ロールを持つユーザーは、Business Central の管理者です。rest-all ロールを持つユーザーは、Business Central REST 機能にアクセスできます。kie-server ロールを持つユーザーは、KIE Server REST 機能にアクセスできます。

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

   $ ./bin/jboss-cli.sh --commands="embed-server --std-out=echo,/subsystem=elytron/filesystem-realm=ApplicationRealm:add-identity(identity=<USERNAME>),/subsystem=elytron/filesystem-realm=ApplicationRealm:set-password(identity=<USERNAME>, clear={password='<PASSWORD>'}),/subsystem=elytron/filesystem-realm=ApplicationRealm:add-identity-attribute(identity=<USERNAME>, name=role, value=[admin,rest-all,kie-server])"

   注記

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

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

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

   $ ./bin/jboss-cli.sh --commands="embed-server --std-out=echo,/subsystem=elytron/filesystem-realm=ApplicationRealm:add-identity(identity=<USERNAME>),/subsystem=elytron/filesystem-realm=ApplicationRealm:set-password(identity=<USERNAME>, clear={password='<PASSWORD>'}),/subsystem=elytron/filesystem-realm=ApplicationRealm:add-identity-attribute(identity=<USERNAME>, name=role, value=[kie-server])"

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

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

   $ ./bin/jboss-cli.sh --commands="embed-server --std-out=echo,/subsystem=elytron/filesystem-realm=ApplicationRealm:add-identity(identity=<USERNAME>),/subsystem=elytron/filesystem-realm=ApplicationRealm:set-password(identity=<USERNAME>, clear={password='<PASSWORD>'}),/subsystem=elytron/filesystem-realm=ApplicationRealm:add-identity-attribute(identity=<USERNAME>, name=role, value=[admin,rest-all,kie-server])"

   注記

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

7. オプション: 一度に複数のユーザーを作成するには、ユーザーデータが含まれるファイルを作成し、以下のコマンドを実行します。<USER_DATA>.cli はユーザーデータを含むファイルです。

   $ ./bin/jboss-cli.sh --file=<USER_DATA>.cli

   <USER_DATA>.cli ファイルには、以下の例のようなデータが含まれている必要があります。

   embed-server --std-out=echo
   
   # first user
   /subsystem=elytron/filesystem-realm=ApplicationRealm:add-identity(identity=<USERNAME>)
   /subsystem=elytron/filesystem-realm=ApplicationRealm:set-password(identity=<USERNAME>, clear={password='<PASSWORD>'})
   /subsystem=elytron/filesystem-realm=ApplicationRealm:add-identity-attribute(identity=<USERNAME>, name=role, value=[admin,role,group])
   
   # second user
   ...

手順

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 の実行に関する詳細は、Running 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 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 ファイルを開きます。
3. <system-properties> タグの下で、以下の JVM プロパティーの値を CPU の数に設定します。

手順

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

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

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

   警告

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

6. TEMP_DIR/rhpam-7.13.3-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.13.3.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 Decision Manager プロジェクトでは、使用する機能に応じて、以下の依存関係を宣言します。

   • 標準的な Red Hat Decision 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 Decision 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 Decision 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 ページに移動し (ログインが必要)、ドロップダウンオプションから製品およびバージョンを選択します。

   • 製品: Process Automation Manager

   • バージョン: 7.13.3

     1. Red Hat Process Automation Manager 7.13.3 Offliner Content List (rhpam-7.13.3-offliner.zip) の製品配信可能ファイルをダウンロードして展開します。
     2. rhpam-7.13.3-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.4 への Red Hat Decision Manager のインストールおよび設定 を参照してください。

手順

1. Red Hat JBoss EAP を起動し、Web ブラウザーで Business Central を開きます。
2. SVG 形式のイメージを、Red Hat Decision 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 Decision Manager インストールの EAP_HOME/standalone/deployments/decision-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: 8.1
2. Red Hat Data Grid 8.1.0 Server (redhat-datagrid-8.1.0-server.zip) のインストールファイルをダウンロードして、システム上の任意の場所に展開します。以下の例では、デプロイメントしたディレクトリーは JDG_HOME と呼ばれます。
3. Red Hat Data Grid を最新のバージョンに更新します。詳細は、Red Hat Data Grid User Guide を参照してください。

4. Red Hat Data Grid のユーザーを追加するには、JDG_HOME/bin に移動し、以下のコマンドを入力します。

   $ ./cli.sh user create <DATAGRID_USER_NAME> -p <DATA_GRID_PASSWORD> -r default

5. Red Hat Data Grid サーバーのメモリーパラメーターを変更するには、JDG_HOME/bin/server.conf ファイルを開き、以下の行を見つけます。

   -Xms64m -Xmx512m -XX:MetaspaceSize=64M

6. この行を以下の内容に置き換えます。

   -Xms256m -Xmx2048m -XX:MetaspaceSize=256M

7. JDG_HOME/server/conf/infinispan.xml ファイルを開き、以下の行を見つけます。

   <hotrod-connector name="hotrod"/>

8. この行を以下の内容に置き換えます。

   <hotrod-connector name="hotrod">
       <authentication>
           <sasl mechanisms="SCRAM-SHA-512 SCRAM-SHA-384 SCRAM-SHA-256
                   SCRAM-SHA-1 DIGEST-SHA-512 DIGEST-SHA-384
                   DIGEST-SHA-256 DIGEST-SHA DIGEST-MD5 PLAIN"
               server-name="infinispan"
               qop="auth"/>
       </authentication>
   </hotrod-connector>

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

   $ ./server.sh -b <HOST>

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

手順

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

   • Product: AMQ Broker
   • Version: 7.8.2
2. Red Hat AMQ Broker 7.8.2 (amq-broker-7.8.2-bin.zip) の横の Download をクリックします。
3. amq-broker-7.8.2-bin.zip ファイルをデプロイメントします。
4. amq-broker-7.8.2-bin/amq-broker-7.8.2/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.2-bin/amq-broker-7.8.2/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.168.1.0/24(rw,sync) 192.168.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.4 をインストールします。

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

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

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

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

      • PRODUCT: Process Automation Manager
      • バージョン: 7.13.3
   2. Red Hat Decision Manager 7.13.3 Business Central Deployable for Red Hat JBoss EAP 7 (rhpam-7.13.3-business-central-eap7-deployable.zip) をダウンロードします。
5. rhpam-7.13.3-business-central-eap7-deployable.zip ファイルを一時ディレクトリーに展開します。以下のコマンドでは、このディレクトリーを TEMP_DIR とします。
6. TEMP_DIR/rhpam-7.13.3-business-central-eap7-deployable/jboss-eap-7.4 の内容を EAP_HOME にコピーします。
7. 最新の Red Hat Process Automation Manager のパッチが利用できる場合には、ダウンロードして適用します。
8. 高可用性環境向けに Red Hat Single Sign-On を設定します。詳細は、Red Hat Decision Manager と 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 アドレスに置き換えます。
   • <SERVER_NAME> は、Red Hat Data Grid のサーバー設定で指定したサーバー名に置き換えます。
   • <SASL_QOP> は、Red Hat Data Grid サーバー設定の auth、auth-int、auth-conf の値の組み合わせです。

   • <DATAGRID_USER_NAME> および <DATA_GRID_PASSWORD> は、Red Hat Data Grid の作成時に定義した認証情報です。

     <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"/>
       <property name="org.appformer.ext.metadata.infinispan.username" value="<DATAGRID_USER_NAME>"/>
       <property name="org.appformer.ext.metadata.infinispan.password" value="<DATA_GRID_PASSWORD>"/>
       <property name="org.appformer.ext.metadata.index" value="infinispan"/>
       <property name="org.appformer.ext.metadata.infinispan.sasl.qop" value="auth"/>
       <property name="org.appformer.ext.metadata.infinispan.server.name" value="infinispan"/>
       <property name="org.appformer.ext.metadata.infinispan.realm" value="default"/>
       <property name="org.appformer.concurrent.managed.thread.limit" value="1000"/>
       <property name="org.appformer.concurrent.unmanaged.thread.limit" value="1000"/>
       <property name="org.appformer.concurrent.indexing.thread.limit" value="0"/>
       <property name="org.appformer.ext.metadata.infinispan.server.name"
          value="<SERVER_NAME>"/>
       <property name="org.appformer.ext.metadata.infinispan.sasl.qop"
          value="<SASL_QOP>"/>
     </system-properties>

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

7. クラスターを起動するには 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.4 をインストールします。

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

      • Product: Enterprise Application Platform
      • バージョン: 7.4
   2. Red Hat JBoss Enterprise Application Platform 7.4.1 (jboss-eap-7.4.1.zip) の横にある Download をクリックします。
2. jboss-eap-7.4.1.zip ファイルをデプロイメントします。jboss-eap-7.4/jboss-eap-7.4 ディレクトリーは、以下のように参照されます。EAP_HOME
3. 最新の Red Hat JBoss EAP パッチが利用できる場合には、ダウンロードして適用します。

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

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

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

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

   警告

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

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

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

    $ ./bin/jboss-cli.sh --commands="embed-server --std-out=echo,/subsystem=elytron/filesystem-realm=ApplicationRealm:add-identity(identity=<USERNAME>),/subsystem=elytron/filesystem-realm=ApplicationRealm:set-password(identity=<USERNAME>, clear={password='<PASSWORD>'}),/subsystem=elytron/filesystem-realm=ApplicationRealm:add-identity-attribute(identity=<USERNAME>, name=role, value=['kie-server'])"

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

14. クラスターを起動するには 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.13.3
2. Red Hat Process Automation Manager 7.13.3 Add Ons (rhpam-7.13.3-add-ons.zip ファイル) をダウンロードします。
3. rhpam-7.13.3-add-ons.zip ファイルを展開します。rhpam-7.13.3-controller-ee7.zip ファイルは展開したディレクトリーにあります。
4. rhpam-7.13.3-controller-ee7.zip アーカイブを一時ディレクトリーに展開します。以下の例では、この名前を TEMP_DIR とします。

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

   警告

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

6. TEMP_DIR/rhpam-7.13.3-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. 端末ウインドウで、インストーラー JAR ファイルをダウンロードしたディレクトリーに移動し、以下のコマンドを入力します。

   java -jar rhpam-installer-7.13.3.jar

   注記

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

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

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

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

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

2. I accept the terms of this license agreement (本使用許諾契約書の内容に同意します) をクリックし、Next をクリックします。
3. Red Hat Process Automation Manager をインストールする Red Hat JBoss Web Server 5.5.1 のホームを指定して、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. 画面上部に Processing finished が表示されたら、Next をクリックしてインストールを完了します。

9. 必要に応じて、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.13.3.jar <path-to-auto.xml-file>

手順

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

   java -jar rhpam-installer-7.13.3.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.5.1 インストールの親ディレクトリーを入力します。

   インストーラーが、指定したインストール場所を確認します。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.13.3.jar <path-to-auto.xml-file>

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

手順

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

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

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

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

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

   注記

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

4. kie-server.war ディレクトリーから .war 拡張子を削除します。
5. kie-tomcat-integration-7.67.0.Final-redhat-00019.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 Decision 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
       -Dorg.jbpm.server.ext.disabled=true
       -Dorg.jbpm.ui.server.ext.disabled=true
       -Dorg.jbpm.case.server.ext.disabled=true"

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

      set CATALINA_OPTS="-Xmx1024m -Dorg.jboss.logging.provider=jdk -Dorg.jbpm.server.ext.disabled=true -Dorg.jbpm.ui.server.ext.disabled=true -Dorg.jbpm.case.server.ext.disabled=true

手順

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

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

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

手順

1. settings.xml ファイルでは、Red Hat Decision Manager プロジェクトが使用するリポジトリーを宣言します。これは通常、Red Hat カスタマーポータルからダウンロードしたオンラインの Red Hat Decision Manager Maven リポジトリーまたは Red Hat Decision 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.13.3-business-central-standalone.jar --cli-script=application-script.cli -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.13.3.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 Decision Manager プロジェクトでは、使用する機能に応じて、以下の依存関係を宣言します。

   • 標準的な Red Hat Decision 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 Decision 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 Decision 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 ページに移動し (ログインが必要)、ドロップダウンオプションから製品およびバージョンを選択します。

   • 製品: Process Automation Manager

   • バージョン: 7.13.3

     1. Red Hat Process Automation Manager 7.13.3 Offliner Content List (rhpam-7.13.3-offliner.zip) の製品配信可能ファイルをダウンロードして展開します。
     2. rhpam-7.13.3-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 をクリックして、プライマリー設定への変更を保存します。

   図45.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. WebSphere 統合ソリューションコンソールで、Servers → Server Types → IBM WebSphere Application Servers の順にクリックします。
2. アプリケーションサーバーのリストで、KIE Server をデプロイするサーバーを選択します。

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

   図45.2 WebSphere 設定ページ

   

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

   図45.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 に追加します。

   表45.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.jbpm.server.ext.disabled	true	RHDM でサポートされていない Business Central の機能を無効にします。設定されていない場合、KIE Server は機能しますが、起動時にエラーメッセージを表示します。
   org.jbpm.ui.server.ext.disabled	true	RHDM でサポートされていない Business Central の機能を無効にします。設定されていない場合、KIE Server は機能しますが、起動時にエラーメッセージを表示します。
   org.jbpm.case.server.ext.disabled	true	RHDM でサポートされていない Business Central の機能を無効にします。設定されていない場合、KIE Server は機能しますが、起動時にエラーメッセージを表示します。
   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> は、ヘッドレスの Process Automation Manager コントローラーの 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 プロパティー値を指定します。

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

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

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

   表47.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 をクリックします。

   このマッピングにより、事前に作成した管理者ユーザーに Decision 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. Java Virtual Machine (JVM) のメモリーサイズを増やすには、以下のシステムプロパティーを設定します。

   USER_MEM_ARGS=-Xms512m -Xmx1024m

   JVM メモリーサイズを増やさないと、KIE Server のデプロイ時に Oracle WebLogic Server がフリーズするか、エラーが発生します。

2. Oracle WebLogic Server インスタンスに、以下の KIE Server システムプロパティーを指定します。

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

   名前	値	説明
   kie.server.jms.queues.response	jms/KIE.SERVER.RESPONSE	KIE Server が使用する応答用の JMS キューの JNDI 名。
   org.kie.server.domain	OracleDefaultLoginConfiguration	JMS の使用時にユーザーの認証に使用される JAAS LoginContext ドメイン。
   org.jbpm.server.ext.disabled	true	RHDM でサポートされていない Business Central の機能を無効にします。設定されていない場合、KIE Server は機能しますが、起動時にエラーメッセージを表示します。
   org.jbpm.ui.server.ext.disabled	true	RHDM でサポートされていない Business Central の機能を無効にします。設定されていない場合、KIE Server は機能しますが、起動時にエラーメッセージを表示します。
   org.jbpm.case.server.ext.disabled	true	RHDM でサポートされていない Business Central の機能を無効にします。設定されていない場合、KIE Server は機能しますが、起動時にエラーメッセージを表示します。

3. JAVA_OPTIONS 環境編集に同じプロパティー値を設定します。

   JAVA_OPTIONS="-Dkie.server.jms.queues.response=jms/KIE.SERVER.RESPONSE
    -Dorg.kie.server.domain=OracleDefaultLoginConfiguration
    -Dorg.jbpm.server.ext.disabled=true
    -Dorg.jbpm.ui.server.ext.disabled=true
    -Dorg.jbpm.case.server.ext.disabled=true"

手順

1. WebLogic 管理コンソールで、Change Center → Lock & Edit の順に移動します。
2. Domain Structure で Environment → Servers → Control の順にクリックします。
3. 停止するサーバーを選択して、Shutdown をクリックします。
4. When Work Completes を選択してサーバーを正常に停止するか、Force Shutdown Now を選択して継続中のタスクの完了を待たずに直ちにサーバーを停止します。
5. Server Life Cycle Assistant ペインで Yes をクリックして、シャットダウンを完了します。

6. シャットダウンが完了したら、端末でドメインディレクトリーに移動し、WLS_HOME/user_projects/<DOMAIN_NAME> に移動します。以下に例を示します。

   WLS\user_projects\mydomain

7. 以下のいずれかのコマンドを実行して Oracle WebLogic Server を再起動し、新しい設定を適用します。

   UNIX ベースのシステムの場合:

   startWebLogic.sh

   Windows オペレーティングシステムの場合:

   startWebLogic.cmd

8. Web ブラウザーで管理コンソール (例: http://localhost:7001/console/) を開き、認証情報を使用してログインします。

手順

1. Web ブラウザーに KIE Server の URL (http://<HOST>:<PORT>/kie-server/services/rest/server) を入力します。

2. KIE Server が実行していることを確認します。

   KIE Server が実行していない場合は、Oracle WebLogic Server インスタンスを停止して再起動し、KIE Server の URL に再度アクセスしてみてください。

手順

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

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

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

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

   表56.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)。