第6章 IBM WebSphere Application Server へのヘッドレス Process Automation Manager コントローラーのインストールおよび実行
Process Server REST API または Java Client API を使用して Process Server に接続するには、IBM WebSphere Application Server にヘッドレス Process Automation Manager コントローラーをインストールします。ヘッドレス Process Automation Manager コントローラーは、一元化された方法で Process Server 設定を管理するため、このコントローラーを使用してコンテナーの作成および維持を行い、サーバーレベルのタスクを実行できます。
実稼働環境で最適な結果を得るには、Process Server とヘッドレス Process Automation Manager コントローラーを別のサーバーにインストールします。開発環境の場合は、Process Server とヘッドレス Process Automation Manager コントローラーを同じサーバーにインストールできます。
前提条件
- 「4章Process Server への IBM WebSphere Application Server の設定」の説明通りに IBM WebSphere Application Server インスタンスを設定している。
- Process Server が IBM WebSphere Application Server インスタンスにインストールされている。
- インストールを完了するのに必要なユーザーパーミッションがある。
手順
Red Hat カスタマーポータルの Software Downloads ページに移動し (ログインが必要)、ドロップダウンオプションから製品およびバージョンを選択します。
- 製品: Process Automation Manager
- バージョン: 7.6
- Red Hat Process Automation Manager 7.6.0 Add-Ons をダウンロードします。
-
ダウンロードした
rhpam-7.6.0-add-ons.zip
ファイルを一時ディレクトリーに展開します。 -
rhpam-7.6.0-add-ons.zip
ファイルを一時ディレクトリーに展開します。以下の例では、このディレクトリーをTEMP_DIR
とします。 -
rhpam-7.6.0-add-ons/rhpam-7.6-controller-ee7.zip
ファイルを展開します。 controller.war
ディレクトリーを再パッケージ化します。-
TEMP_DIR/rhpam-7.6.0-add-ons/rhpam-7.6-controller-ee7/controller.war
ディレクトリーに移動します。 -
TEMP_DIR/rhpam-7.6.0-add-ons/rhpam-7.6-controller-ee7/controller.war
ディレクトリーの内容を選択して、controller.zip
ファイルを作成します。 -
controller.zip
の名前をcontroller.war
に変更します。これは、ヘッドレス Process Automation Manager コントローラーをデプロイするのに使用するファイルです。 -
オプションで、新しい
controller.war
ファイルを、デプロイしやすい場所にコピーします。
-
- WebSphere 統合ソリューションコンソールで、Applications → Application Types → WebSphere Enterprise Applications の順に移動します。
- Install をクリックします。
-
再パッケージ化した
controller.war
ファイルに移動し、選択してアップロードします。 Fast Path を選択し、Next をクリックします。
Install New Application ウィザードが開きます。
-
Application Name を
controller
に変更し、Next をクリックします。 - 要件に合わせて ヘッドレス Process Automation Manager コントローラーモジュールをサーバーにマッピングし、Next をクリックします。
-
Bind Listeners for Message-Driven Beans の場合は 、両 Bean に Activation Specification を選択し、Target Resource JNDI Name フィールドに
jms/activation/KIE.SERVER.REQUEST
を入力し、KIE.SERVER.REQUEST
接続ファクトリーのjms/cf/KIE.SERVER.REQUEST
JNDI 名を入力します。 - Map Virtual Hosts for Web Modules セクションでは、デフォルト値をそのままにして、Next をクリックします。
-
コンテキストルートを
controller
に設定します。 - Metadata for Modules セクションで、デフォルト値をそのままにして Next をクリックします。
- Finish をクリックしてヘッドレス Process Automation Manager コントローラーをインストールし、Save をクリックして master 設定への変更を保存します。
6.1. ヘッドレス Process Automation Manager コントローラーへのクラスローディングの設定
ヘッドレス Process Automation Manager コントローラーをインストールしたら、親クラスを最後にロードするように、Process Server クラスローディングを設定する必要があります。
手順
-
Applications → Application Types → WebSphere Enterprise Applications に移動し、
kie-server
をクリックします。 - 左側の Detail Properties の見出しにある Class Loading and Update Detection をクリックします。
- プロパティーで、Class Loader Order を Classes loaded with local class loader first (parent last) に、WAR Class Loader Policy を Single class loader for application に変更します。
- 変更をマスター設定に保存します。
6.2. ヘッドレス Process Automation Manager コントローラーのシステムプロパティーの設定
ヘッドレス Process Automation Manager コントローラーをインストールしたら、本セクションで紹介するシステムプロパティーをアプリケーションサーバーに設定して、ヘッドレス Process Automation Manager コントローラーとの適切な接続を有効にします。
実稼働環境で最適な結果を得るには、Process Server とヘッドレス Process Automation Manager コントローラーを別のサーバーにインストールします。開発環境の場合は、Process Server とヘッドレス Process Automation Manager コントローラーを同じサーバーにインストールします。いずれの場合も、ヘッドレス Process Automation Manager コントローラーがインストールされているすべてのアプリケーションサーバーでこのプロパティーを変更します。
前提条件
- Process Server およびヘッドレス Process Automation Manager コントローラーがアプリケーションサーバーインスタンスにインストールされている。
手順
ヘッドレス Process Automation Manager コントローラーがインストールされているアプリケーションサーバーインスタンスに、以下の JVM プロパティー値を指定します。
表6.1 ヘッドレス Process Automation Manager コントローラーに必要なプロパティー
名前 要件 org.kie.server.user
kie-server
ロールが割り当てられているユーザーorg.kie.server.pwd
org.kie.server.user
プロパティーに指定したユーザーのパスワードProcess Server がインストールされているアプリケーションサーバーインスタンスに、以下の JVM プロパティー値を指定します。
表6.2 ヘッドレス Process Automation Manager コントローラーがインストールされている場合に Process Server に必要なプロパティー
名前 要件 org.kie.server.controller.user
kie-server
ロールが割り当てられているユーザーorg.kie.server.controller.pwd
org.kie.server.controller.user
プロパティーに指定したユーザーのパスワードorg.kie.server.id
Process Server インストールの ID または名前 (
rhdm700-decision-server-1
など)org.kie.server.location
Process Server の URL (
http://<HOST>:<PORT>/kie-server/services/rest/server
)org.kie.server.controller
ヘッドレス Process Automation Manager コントローラーの URL (
http://<HOST>:<PORT>/controller/rest/controller
)<HOST>
は、Process Server ホストの ID または名前です (例:localhost
または192.7.8.9
)。<PORT>
は Process Server ホストのポートです (例:7001
)。
6.3. ヘッドレス Process Automation Manager コントローラーグループおよびロールのマッピング
ヘッドレス Process Automation Manager コントローラーをインストールしたら、WebSphere 統合ソリューションコンソールに kie-server
グループを作成し、kie-server
ロールを kie-server
グループにマッピングします。
前提条件
- ヘッドレス Process Automation Manager コントローラーが IBM WebSphere Application Server インスタンスにインストールされている。
手順
-
WebSphere 統合ソリューションコンソールで、「Process Server グループおよびロールの作成」の記載通りに、
kie-server
グループおよびそのユーザーを作成します。 - Applications → Application Types → WebSphere Enterprise Applications に移動し、新たにインストールしたヘッドレス Process Automation Manager コントローラーを選択します。
- Detail Properties で Security Role to User/Group Mapping をクリックします。
-
kie-server
ロールを選択し、Map Groups をクリックして、kie-server
グループを検索します。 kie-server
グループを、Available 一覧から Selected 一覧に移動し、OK をクリックします。このマッピングにより、事前に作成した管理者ユーザーに Process Automation Manager へのアクセスが付与されます。
- Save をクリックしてマッピングを完了します。
6.4. インストールの検証
ヘッドレス Process Automation Manager コントローラーをインストールし、必要なシステムプロパティーとロール要件をアプリケーションサーバーに定義したら、ヘッドレス Process Automation Manager コントローラーが正しく動作していることを確認します。
前提条件
- Process Server およびヘッドレス Process Automation Manager コントローラーがアプリケーションサーバーインスタンスにインストールされている。
- アプリケーションサーバーで、ヘッドレス Process Automation Manager コントローラーに必要なシステムプロパティーおよびロール要件をすべて設定している。
手順
端末で以下のコマンドを実行して、ヘッドレス Process Automation Manager コントローラーが動作していることを確認します。
curl -X GET "http://<HOST>:<PORT>/controller/rest/controller/management/servers" -H "accept: application/xml" -u '<CONTROLLER>:<CONTROLLER_PWD>'
<HOST>
は、Process Server ホストの ID または名前です (例: localhost
または 192.7.8.9
)。
<PORT>
は Process Server ホストのポートです (例: 7001
)。
<CONTROLLER>
および <CONTROLLER_PWD>
は、本セクションで作成したユーザーの認証情報です。
このコマンドにより、Process Server インスタンスに関する情報が返されます。
あるいは、Process Server Java API Client を使用して、ヘッドレス Process Automation Manager コントローラーにアクセスすることもできます。
ヘッドレス Process Automation Manager コントローラーが実行していない場合は、アプリケーションサーバーインスタンスを停止して再起動し、ヘッドレス Process Automation Manager コントローラーの URL または API へ再度アクセスしてみてください。