第9章 ヘッドレス Process Automation Manager コントローラーのインストールおよび実行
Process Server は、管理モードまたは非管理モードで動作するように設定できます。Process Server が非管理モードにある場合は、手動で KIE コンテナーを作成および維持する必要があります (デプロイメントユニット)。Process Server が管理モードにある場合は、Process Automation Manager コントローラーが Process Server 設定を管理するため、ユーザーがコントローラーと対話して KIE コンテナーの作成と維持を行います。
Business Central には Process Automation Manager コントローラーが組み込まれています。Business Central をインストールしている場合は、Execution Server ページを使用して KIE コンテナーを作成および維持します。Business Central なしで Process Server の管理を自動化するには、ヘッドレス Process Automation Manager コントローラーを使用することで可能になります。
9.1. ヘッドレス Process Automation Manager コントローラーのインストール
ヘッドレス Process Automation Manager コントローラーをインストールして、REST API または Process Server Java Client API を使用して対話します。
前提条件
-
バックアップを作成してある Red Hat JBoss EAP システム(バージョン 7.1 またはそれ以降)が利用できる。Red Hat JBoss EAP システムのベースディレクトリーを
EAP_HOME
とする。 - インストールを完了するのに必要なユーザーパーミッションが付与されている。
手順
Red Hat カスタマーポータルの Software Downloads ページに移動し (ログインが必要)、ドロップダウンオプションから製品およびバージョンを選択します。
- 製品: Process Automation Manager
- Version: 7.1
-
Red Hat Process Automation Manager 7.1.0 Add Ons (
rhpam-7.1.0-add-ons.zip
ファイル)をダウンロードします。 -
rhpam-7.1.0-add-ons.zip
ファイルを展開します。rhpam-7.1-controller-ee7.zip
ファイルは展開したディレクトリーにあります。 -
rhpam-7.1-controller-ee7
アーカイブを一時ディレクトリーに展開します。以下の例では、この名前をTEMP_DIR
とします。 TEMP_DIR/rhpam-7.1-controller-ee7/controller.war
ディレクトリーをEAP_HOME/standalone/deployments/
にコピーします。警告コピーするヘッドレス Process Automation Manager コントローラーデプロイメントの名前が、Red Hat JBoss EAP インスタンスの既存デプロイメントと競合しないことを確認します。
-
TEMP_DIR/rhpam-7.1-controller-ee7/SecurityPolicy/ ディレクトリーの内容を
にコピーします。ファイルの上書きを確認するメッセージが表示されたら、Yes を選択します。EAP_HOME/
bin -
EAP_HOME/standalone/deployments/
ディレクトリーに、controller.war.dodeploy
という名前で空のファイルを作成します。このファイルにより、サーバーが起動するとヘッドレス Process Automation Manager コントローラーが自動的にデプロイされます。
9.1.1. ヘッドレス Process Automation Manager コントローラーのユーザー作成
ヘッドレス Process Automation Manager コントローラーを使用する前に、kie-server
ロールを持つユーザーを作成する必要があります。
前提条件
ヘッドレス Process Automation Manager コントローラーが Red Hat JBoss EAP インストールのベースディレクトリー (EAP_HOME
) にインストールされている。
手順
-
端末アプリケーションで
EAP_HOME/bin
ディレクトリーに移動します。 以下のコマンドを入力し、
<USER_NAME>
および<PASSWORD>
を、作成するユーザー名およびパスワードに置き換えます。$ ./add-user.sh -a --user <USER_NAME> --password <PASSWORD> --role kie-server
注記必ず、既存のユーザー、ロール、またはグループとは異なるユーザー名を指定してください。たとえば、
admin
という名前のユーザーは作成しないでください。パスワードは 8 文字以上で、数字と、英数字以外の文字をそれぞれ 1 文字以上使用する必要があります。ただし & の文字は使用できません。
- ユーザー名とパスワードを書き留めておきます。
9.1.2. Process Server およびヘッドレス Process Automation Manager コントローラーの設定
Process Server をヘッドレス Process Automation Manager コントローラーで管理する場合は、本セクションの説明に従って Process Server インストールの standalone-full.xml
ファイルとヘッドレス Process Automation Manager コントローラーの standalone.xml
ファイルを編集する必要があります。
前提条件
-
「 5章ZIP ファイルからの Red Hat Process Automation Manager のインストール 」セクションの説明に従って Process Server が Red Hat JBoss EAP インストールのベースディレクトリー(
EAP_HOME
)にインストールされている。 ヘッドレス Process Automation Manager コントローラーが
EAP_HOME
にインストールされている。注記実稼働環境では Process Server およびヘッドレス Process Automation Manager コントローラーを異なるサーバーにインストールすることを推奨します。ただし、開発環境など、Process Server およびヘッドレス Process Automation Manager コントローラーを同じサーバーにインストールする場合は、併せて共有の
standalone-full.xml
ファイルを変更します。-
Process Server ノードに、
kie-server
ロールを持つユーザーが作成されている。 サーバーノードに、
kie-server
ロールのあるユーザーが作成されている。詳細は、「ユーザーの作成」 を参照してください。
手順
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>"/>
Process Server の
EAP_HOME/standalone/configuration/standalone-full.xml
ファイルの<system-properties>
セクションに以下のプロパティーを追加します。<property name="org.kie.server.controller.user" value="<CONTROLLER_USER>"/> <property name="org.kie.server.controller.pwd" value="<CONTROLLER_PWD>"/> <property name="org.kie.server.id" value="<KIE_SERVER_ID>"/> <property name="org.kie.server.location" value="http://<HOST>:<PORT>/kie-server/services/rest/server"/> <property name="org.kie.server.controller" value="<CONTROLLER_URL>"/>
このファイルで、以下の値を置き換えます。
-
<CONTROLLER_USER>
および<CONTROLLER_PWD>
をkie-server
ロールを持つユーザーの認証情報に置き換えます。 -
<
;KIE_SERVER_ID
> を Process Server システムの ID または名前に置き換えます(例:rhpam-7.1.0-process_server-1)
。 -
<HOST>
を Process Server ホストの ID または名前に置き換えます (例:localhost
または192.7.8.9
)。 <PORT>
を Process Server ホストのポートに置き換えます (例:8080
)。注記org.kie.server.location
プロパティーで Process Server の場所を指定します。-
<CONTROLLER_URL>
をヘッドレス Process Automation Manager コントローラー の URL で置き換えます。
-
- 起動中に Process Server がこの URL に接続します。