Red Hat JBoss EAP クラスター環境への Red Hat Process Automation Manager のインストールおよび設定

手順

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

   • 製品: Data Grid
   • バージョン: 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 を実行するには、JDG_HOME/bin に移動して以下のコマンドの 1 つを入力します。

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

     $ ./standalone.sh -c clustered.xml

   • Windows の場合:

     standalone.bat -c clustered.xml

手順

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

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

5. 以下のコマンドを入力します。以下のプレースホルダーを置き換えて、ブローカーおよびブローカーのユーザーを作成します。

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

   • <BROKER_NAME> は作成するブローカーの名前に置き換えます。

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

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

   amq-broker-7.2.0/bin/<BROKER_NAME>/bin/artemis run

手順

1. NFS バージョン 4 共有をエクスポートするようにサーバーを設定します。Red Hat Enterprise Linux での NFS 共有のエクスポートの方法については、「 ファイルシステムの管理」の「NFS 共有のエクスポート」を参照してください。NFS サーバーの作成に関する情報は、「How to configure NFS in RHEL 7」を参照してください。

2. サーバーで、/etc/exports ファイルに以下の行を追加し、rw,sync,no_root_squash オプションを指定して /opt/kie/data 共有を作成します。

   /opt/kie/data *(rw,sync,no_root_squash)

   たとえば、/opt/kie/data は共有フォルダー、* は NFS サーバーに接続可能な IP アドレス、(rw,sync,no_root_squash) は NFS に最小限必要なオプションを指します。以下に例を示します。

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

   注記

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

3. 各クライアントノードで、既存のディレクトリーに共有フォルダーをマウントします。

   # mount <SERVER_IP>:/opt/kie/data /opt/kie/data/niogit

4. 以下のプロパティーを standalone-full-ha.xml ファイルに追加し、.niogit および maven-repository ディレクトリーを nfs 共有フォルダーとしてバインドします。

   <property name="org.uberfire.nio.git.dir" value="/opt/kie/data/niogit"/>
   <property name="org.guvnor.m2repo.dir" value="/opt/kie/data/maven-repository"/>

手順

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

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

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

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

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

      • 製品: Process Automation Manager
      • バージョン: 7.6
   2. Red Hat Process Automation Manager 7.6.0 Business Central Deployable for Red Hat JBoss EAP 7 (rhpam-7.6.0-business-central-eap7-deployable.zip) をダウンロードします。
5. rhpam-7.6.0-business-central-eap7-deployable.zip ファイルを一時ディレクトリーに展開します。以下のコマンドでは、このディレクトリーを TEMP_DIR とします。
6. TEMP_DIR/rhpam-7.6.0-business-central-eap7-deployable/jboss-eap-7.2 の内容を EAP_HOME にコピーします。
7. 最新の Red Hat Process Automation Manager のパッチが利用できる場合には、ダウンロードして適用します。
8. EAP_HOME/bin ディレクトリーに移動します。

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

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

   注記

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

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

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

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

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

手順

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

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

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

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

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

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

   • <INFINISPAN_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="<INFINISPAN_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>

4. オプション: 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=""/>

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

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

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

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

   • Windows の場合:

     standalone.bat -c standalone-full.xml

手順

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.2 をインストールします。

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

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

4. Process Server をダウンロードします。

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

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

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

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

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

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

手順

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

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

   • datasource-jndi-name は、この手順の最初で指定したデータベースの JNDI 名です。
   • partition プロパティーの値にはあらゆる名前を入力できますが、ノードには、同じパーティション名を持つその他のノードのタイマーのみが表示されます。パーティション名を割り当てて、パーティションでノードをグループ分けすると、大規模なクラスターを複数の小規模クラスターに分割できます。これによりパフォーマンスが改善します。たとえば、1 つのクラスターに 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 属性値を示しています。

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

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

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

   • 以下のように、データソースを追加して、Process 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>

     警告

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

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

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

   警告

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

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

9. 以下のプロパティーを <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 に設定すると、テンプレートファイルへの変更の検出が、サーバーの再起動時に制限されます。

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

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

      $ ./standalone.sh

    • Windows の場合:

      standalone.bat

手順

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

   • 製品: Process Automation Manager
   • バージョン: 7.6
2. Red Hat Process Automation Manager 7.6.0 Add-Ons をダウンロードします。
3. ダウンロードした rhpam-7.6.0-add-ons.zip ファイルを一時ディレクトリーに展開します。rhpam-7.6-smart-router.jar ファイルは展開した rhpam-7.6.0-add-ons ディレクトリーにあります。
4. rhpam-7.6-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.6-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

   注記

   ルーターは、集約ソートを提供しますが、管理コンソールを介して使用する場合に返されるデータは raw フォーマットになります。したがって、ソートは、個々のサーバーがどのように返すかを示します。

   ページングは、標準フォーマットでサポートされます。

6. オプション: クライアント側から Smart Router を起動するには、以下のように、Process 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 設定のログイン認証情報です。

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

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

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

7. オプション: HTTPS を有効にして Smart Router を起動するには、以下のように TLS キーストアプロパティーを使用します。

   org.kie.server.router.tls.keystore = <KEYSTORE_PATH>
   org.kie.server.router.tls.keystore.password = <KEYSTORE_PWD>
   org.kie.server.router.tls.keystore.keyalias = <KEYSTORE_ALIAS>
   org.kie.server.router.tls.port = <HTTPS_PORT>
   -jar kie-server-router-proxy-7.10.0-SNAPSHOT.jar

   org.kie.server.router.tls.port は、HTTPS ポートの設定に使用されるプロパティーです。デフォルトの HTTPS ポート値は 9443 です。