9.2. ヘッドレス Process Automation Manager コントローラーのインストール
ヘッドレス Process Automation Manager コントローラーをインストールして、REST API または KIE Server Java Client API を使用して対話します。
前提条件
-
バックアップを作成済みの Red Hat JBoss EAP システム (バージョン 7.4) が利用できる。Red Hat JBoss EAP システムのベースディレクトリーを
EAP_HOME
とする。 - インストールを完了するのに必要なユーザーパーミッションが付与されている。
手順
Red Hat カスタマーポータルの Software Downloads ページに移動し (ログインが必要)、ドロップダウンオプションから製品およびバージョンを選択します。
- 製品: Process Automation Manager
- バージョン: 7.13.4
-
Red Hat Process Automation Manager 7.13.4 Add Ons (
rhpam-7.13.4-add-ons.zip
ファイル) をダウンロードします。 -
rhpam-7.13.4-add-ons.zip
ファイルを展開します。rhpam-7.13.4-controller-ee7.zip
ファイルは展開したディレクトリーにあります。 -
rhpam-7.13.4-controller-ee7.zip
アーカイブを一時ディレクトリーに展開します。以下の例では、この名前をTEMP_DIR
とします。 TEMP_DIR/rhpam-7.13.4-controller-ee7/controller.war
ディレクトリーをEAP_HOME/standalone/deployments/
にコピーします。警告コピーするヘッドレス Process Automation Manager コントローラーデプロイメントの名前が、Red Hat JBoss EAP インスタンスの既存デプロイメントと競合しないことを確認します。
-
TEMP_DIR/rhpam-7.13.4-controller-ee7/SecurityPolicy/
ディレクトリーの内容をEAP_HOME/bin
にコピーします。 - ファイルの上書きを求めるプロンプトが出されたら、Yes を選択します。
-
EAP_HOME/standalone/deployments/
ディレクトリーに、controller.war.dodeploy
という名前で空のファイルを作成します。このファイルにより、サーバーが起動するとヘッドレス Process Automation Manager コントローラーが自動的にデプロイされます。
9.2.1. ヘッドレス Process Automation Manager コントローラーのユーザー作成
ヘッドレス Process Automation Manager コントローラーを使用する前に、kie-server
ロールを持つユーザーを作成する必要があります。
前提条件
-
ヘッドレス Process Automation Manager コントローラーが Red Hat JBoss EAP インストールのベースディレクトリー (
EAP_HOME
) にインストールされている。
手順
-
端末アプリケーションで
EAP_HOME/bin
ディレクトリーに移動します。 以下のコマンドを入力し、
<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=['kie-server'])"
注記必ず、既存のユーザー、ロール、またはグループとは異なるユーザー名を指定してください。たとえば、
admin
という名前のユーザーは作成しないでください。パスワードは 8 文字以上で、数字と、英数字以外の文字をそれぞれ 1 文字以上使用する必要があります。ただし & の文字は使用できません。
- ユーザー名とパスワードを書き留めておきます。
9.2.2. KIE Server およびヘッドレス Process Automation Manager コントローラーの設定
KIE Server をヘッドレス Process Automation Manager コントローラーから管理する場合は、KIE Server インストールの standalone-full.xml
ファイルと、ヘッドレス Process Automation Manager コントローラーインストールの standalone.xml
ファイルを編集する必要があります。
前提条件
-
KIE Server が
EAP_HOME
にインストールされている。 ヘッドレス Process Automation Manager コントローラーが
EAP_HOME
にインストールされている。注記実稼働環境では KIE Server およびヘッドレス Process Automation Manager コントローラーを異なるサーバーにインストールすることを推奨します。ただし、開発環境など、KIE Server およびヘッドレス Process Automation Manager コントローラーを同じサーバーにインストールする場合は、併せて共有の
standalone-full.xml
ファイルを変更します。-
KIE 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>"/>
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>"/>
- このファイルで、以下の値を置き換えます。
-
<CONTROLLER_USER>
および<CONTROLLER_PWD>
をkie-server
ロールを持つユーザーの認証情報に置き換えます。 -
<KIE_SERVER_ID>
を KIE Server システムの ID または名前に置き換えます (例:rhpam-7.13.4-kie-server-1
)。 -
<HOST>
を KIE Server ホストの ID または名前に置き換えます (例:localhost
または192.7.8.9
)。 <PORT>
を KIE Server ホストのポートに置き換えます (例:8080
)。注記org.kie.server.location
プロパティーで KIE Server の場所を指定します。-
<CONTROLLER_URL>
をヘッドレス Process Automation Manager コントローラーの URL で置き換えます。起動中に KIE Server がこの URL に接続します。