第19章 ヘッドレス Process Automation Manager コントローラーのインストールおよび実行
KIE Server は、管理モードまたは非管理モードで動作するように設定できます。KIE Server が非管理モードの場合は、手動で KIE コンテナー (デプロイメントユニット) を作成および維持する必要があります。KIE Server が管理されている場合は、Process Automation Manager コントローラーが KIE Server の設定を管理し、ユーザーはコントローラーと対話形式で KIE コンテナーを作成、維持します。
Business Central には Process Automation Manager コントローラーが組み込まれています。Business Central をインストールしている場合は、Execution Server ページを使用して KIE コンテナーを作成および維持します。Business Central なしで KIE Server の管理を自動化する場合は、ヘッドレス Process Automation Manager コントローラーを使用できます。
19.1. ヘッドレス 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.3
-
Red Hat Process Automation Manager 7.13.3 Add Ons (
rhpam-7.13.3-add-ons.zipファイル) をダウンロードします。 -
rhpam-7.13.3-add-ons.zipファイルを展開します。rhpam-7.13.3-controller-ee7.zipファイルは展開したディレクトリーにあります。 -
rhpam-7.13.3-controller-ee7.zipアーカイブを一時ディレクトリーに展開します。以下の例では、この名前をTEMP_DIRとします。 TEMP_DIR/rhpam-7.13.3-controller-ee7/controller.warディレクトリーをEAP_HOME/standalone/deployments/にコピーします。警告コピーするヘッドレス Process Automation Manager コントローラーデプロイメントの名前が、Red Hat JBoss EAP インスタンスの既存デプロイメントと競合しないことを確認します。
-
TEMP_DIR/rhpam-7.13.3-controller-ee7/SecurityPolicy/ディレクトリーの内容をEAP_HOME/binにコピーします。 - ファイルの上書きを求めるプロンプトが出されたら、Yes を選択します。
-
EAP_HOME/standalone/deployments/ディレクトリーに、controller.war.dodeployという名前で空のファイルを作成します。このファイルにより、サーバーが起動するとヘッドレス Process Automation Manager コントローラーが自動的にデプロイされます。
19.1.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'])"$ ./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'])"Copy to Clipboard Copied! Toggle word wrap Toggle overflow 注記必ず、既存のユーザー、ロール、またはグループとは異なるユーザー名を指定してください。たとえば、
adminという名前のユーザーは作成しないでください。パスワードは 8 文字以上で、数字と、英数字以外の文字をそれぞれ 1 文字以上使用する必要があります。ただし & の文字は使用できません。
- ユーザー名とパスワードを書き留めておきます。
19.1.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>"/>
<property name="org.kie.server.user" value="<USERNAME>"/> <property name="org.kie.server.pwd" value="<USER_PWD>"/>Copy to Clipboard Copied! Toggle word wrap Toggle overflow 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>"/>
<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>"/>Copy to Clipboard Copied! Toggle word wrap Toggle overflow このファイルで、以下の値を置き換えます。
-
<CONTROLLER_USER>および<CONTROLLER_PWD>をkie-serverロールを持つユーザーの認証情報に置き換えます。 -
<KIE_SERVER_ID>を KIE Server システムの ID または名前に置き換えます (例:rhpam-7.13.3-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 に接続します。
-