第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 インスタンスにインストールされている。
  • インストールを完了するのに必要なユーザーパーミッションがある。

手順

  1. Red Hat カスタマーポータルの Software Downloads ページに移動し (ログインが必要)、ドロップダウンオプションから製品およびバージョンを選択します。

    • 製品: Process Automation Manager
    • バージョン: 7.6
  2. Red Hat Process Automation Manager 7.6.0 Add-Ons をダウンロードします。
  3. ダウンロードした rhpam-7.6.0-add-ons.zip ファイルを一時ディレクトリーに展開します。
  4. rhpam-7.6.0-add-ons.zip ファイルを一時ディレクトリーに展開します。以下の例では、このディレクトリーを TEMP_DIR とします。
  5. rhpam-7.6.0-add-ons/rhpam-7.6-controller-ee7.zip ファイルを展開します。
  6. controller.war ディレクトリーを再パッケージ化します。

    1. TEMP_DIR/rhpam-7.6.0-add-ons/rhpam-7.6-controller-ee7/controller.war ディレクトリーに移動します。
    2. TEMP_DIR/rhpam-7.6.0-add-ons/rhpam-7.6-controller-ee7/controller.war ディレクトリーの内容を選択して、controller.zip ファイルを作成します。
    3. controller.zip の名前を controller.war に変更します。これは、ヘッドレス Process Automation Manager コントローラーをデプロイするのに使用するファイルです。
    4. オプションで、新しい controller.war ファイルを、デプロイしやすい場所にコピーします。
  7. WebSphere 統合ソリューションコンソールで、ApplicationsApplication TypesWebSphere Enterprise Applications の順に移動します。
  8. Install をクリックします。
  9. 再パッケージ化した controller.war ファイルに移動し、選択してアップロードします。
  10. Fast Path を選択し、Next をクリックします。

    Install New Application ウィザードが開きます。

  11. Application Namecontroller に変更し、Next をクリックします。
  12. 要件に合わせて ヘッドレス Process Automation Manager コントローラーモジュールをサーバーにマッピングし、Next をクリックします。
  13. 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 名を入力します。
  14. Map Virtual Hosts for Web Modules セクションでは、デフォルト値をそのままにして、Next をクリックします。
  15. コンテキストルートを controller に設定します。
  16. Metadata for Modules セクションで、デフォルト値をそのままにして Next をクリックします。
  17. Finish をクリックしてヘッドレス Process Automation Manager コントローラーをインストールし、Save をクリックして master 設定への変更を保存します。

6.1. ヘッドレス Process Automation Manager コントローラーへのクラスローディングの設定

ヘッドレス Process Automation Manager コントローラーをインストールしたら、親クラスを最後にロードするように、Process Server クラスローディングを設定する必要があります。

手順

  1. ApplicationsApplication TypesWebSphere Enterprise Applications に移動し、kie-server をクリックします。
  2. 左側の Detail Properties の見出しにある Class Loading and Update Detection をクリックします。
  3. プロパティーで、Class Loader OrderClasses loaded with local class loader first (parent last) に、WAR Class Loader PolicySingle class loader for application に変更します。
  4. 変更をマスター設定に保存します。

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 コントローラーがアプリケーションサーバーインスタンスにインストールされている。

手順

  1. ヘッドレス Process Automation Manager コントローラーがインストールされているアプリケーションサーバーインスタンスに、以下の JVM プロパティー値を指定します。

    表6.1 ヘッドレス Process Automation Manager コントローラーに必要なプロパティー

    名前要件

    org.kie.server.user

    kie-server ロールが割り当てられているユーザー

    org.kie.server.pwd

    org.kie.server.user プロパティーに指定したユーザーのパスワード

  2. 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 インスタンスにインストールされている。

手順

  1. WebSphere 統合ソリューションコンソールで、「Process Server グループおよびロールの作成」の記載通りに、kie-server グループおよびそのユーザーを作成します。
  2. ApplicationsApplication TypesWebSphere Enterprise Applications に移動し、新たにインストールしたヘッドレス Process Automation Manager コントローラーを選択します。
  3. Detail PropertiesSecurity Role to User/Group Mapping をクリックします。
  4. kie-server ロールを選択し、Map Groups をクリックして、kie-server グループを検索します。
  5. kie-server グループを、Available 一覧から Selected 一覧に移動し、OK をクリックします。

    このマッピングにより、事前に作成した管理者ユーザーに Process Automation Manager へのアクセスが付与されます。

  6. 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 へ再度アクセスしてみてください。