10.2. ヘッドレス Process Automation Manager コントローラーのインストール
ヘッドレス Process Automation Manager コントローラーをインストールして、REST API または KIE Server Java Client API を使用して対話します。
前提条件
-
バックアップを作成済みの Red Hat JBoss EAP システム (バージョン 7.3) が利用できる。Red Hat JBoss EAP システムのベースディレクトリーを
EAP_HOMEとします。 - インストールを完了するのに必要なユーザーパーミッションが付与されている。
手順
Red Hat カスタマーポータルの Software Downloads ページに移動し (ログインが必要)、ドロップダウンオプションから製品およびバージョンを選択します。
- 製品: Process Automation Manager
- バージョン: 7.10
-
Red Hat Process Automation Manager 7.10.0 Add Ons (
rhpam-7.10.0-add-ons.zipファイル) をダウンロードします。 -
rhpam-7.10.0-add-ons.zipファイルを展開します。rhpam-7.10.0-controller-ee7.zipファイルは展開したディレクトリーにあります。 -
rhpam-7.10.0-controller-ee7アーカイブを一時ディレクトリーに展開します。以下の例では、この名前をTEMP_DIRとします。 TEMP_DIR/rhpam-7.10.0-controller-ee7/controller.warディレクトリーをEAP_HOME/standalone/deployments/にコピーします。警告コピーするヘッドレス Process Automation Manager コントローラーデプロイメントの名前が、Red Hat JBoss EAP インスタンスの既存デプロイメントと競合しないことを確認します。
-
TEMP_DIR/rhpam-7.10.0-controller-ee7/SecurityPolicy/ディレクトリーの内容をEAP_HOME/binにコピーします。 - ファイルの上書きを求めるプロンプトが出されたら、Yes を選択します。
-
EAP_HOME/standalone/deployments/ディレクトリーに、controller.war.dodeployという名前で空のファイルを作成します。このファイルにより、サーバーが起動するとヘッドレス Process Automation Manager コントローラーが自動的にデプロイされます。
10.2.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 文字以上使用する必要があります。ただし & の文字は使用できません。
- ユーザー名とパスワードを書き留めておきます。
10.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.10.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>をヘッドレス Process Automation Manager コントローラー の URL で置き換えます。起動中に KIE Server がこの URL に接続します。