第5章 ZIP からの Red Hat Process Automation Manager のインストール

手順

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

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

   警告

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

手順

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

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

手順

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

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

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

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

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

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

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

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

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

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

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

     注記

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

   • <CONTROLLER_URL> を Business Central の URL に置き換えます。KIE Server は、起動時にこの URL に接続します。

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

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

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

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