第6章 Oracle WebLogic Server へのヘッドレス Process Automation Manager コントローラーのインストールおよび実行

KIE Server REST API または Java Client API を使用して KIE Server に接続するには、Oracle WebLogic Server にヘッドレス Process Automation Manager コントローラーをインストールします。ヘッドレス Process Automation Manager コントローラーは、一元化された方法で KIE Server 設定を管理するため、このコントローラーを使用してコンテナーの作成および維持を行い、サーバーレベルのタスクを実行できます。

前提条件

  • 4章KIE Server への Oracle WebLogic Server の設定」の説明通りに、Oracle WebLogic Server インスタンスが設定されている。
  • KIE Server が Oracle WebLogic Server インスタンスにインストールされている。
  • インストールを完了するのに必要なユーザーパーミッションがある。

手順

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

    • 製品: Process Automation Manager
    • バージョン: 7.8
  2. Red Hat Process Automation Manager 7.8.0 Add-Ons をダウンロードします。
  3. ダウンロードした rhpam-7.8.0-add-ons.zip ファイルを一時ディレクトリーに展開します。
  4. WebLogic 管理コンソールで、Security RealmsUsers and Groups の順に移動します。
  5. 事前に作成した kie-server グループに移動して、ヘッドレス Process Automation Manager コントローラーのユーザー (controller など) を作成します。続いて、このユーザーのパスワードを設定して OK をクリックします。グループとユーザーの作成方法の詳細は、「KIE Server のグループおよびユーザーの設定」 を参照してください。
  6. Deployments に移動して、既存のアプリケーションをすべて表示します。
  7. Install をクリックします。
  8. rhpam-7.8.0-add-ons.zip ファイルをダウンロードして展開した一時ディレクトリーに移動し、rhpam-7.8.0-add-ons/rhpam-7.8.0-controller-ee7.zip/controller.war に移動します。
  9. controller.war ファイルを選択し、Next をクリックして続行します。
  10. ターゲットとするスタイルとして Install this deployment as an application を選択し、Next をクリックします。
  11. アプリケーション名を controller のままにし、セキュリティーモデルを DD Only に設定します。残りのオプションはデフォルトのままにし、Next をクリックして続行します。
  12. Additional Configuration セクションで No, I will review the configuration later を選択し、Finish をクリックします。

6.1. ヘッドレス Process Automation Manager コントローラーのシステムプロパティーの設定

ヘッドレス Process Automation Manager コントローラーをインストールしたら、本セクションで紹介するシステムプロパティーをアプリケーションサーバーに設定して、ヘッドレス Process Automation Manager コントローラーとの適切な接続を有効にします。

注記

実稼働環境で最適な結果を得るには、KIE Server とヘッドレス Process Automation Manager コントローラーを別のサーバーにインストールします。開発環境の場合は、KIE Server とヘッドレス Process Automation Manager コントローラーを同じサーバーにインストールします。いずれの場合も、ヘッドレス Process Automation Manager コントローラーがインストールされているすべてのアプリケーションサーバーでこのプロパティーを変更します。

前提条件

  • KIE 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. KIE Server がインストールされているアプリケーションサーバーインスタンスに、以下の JVM プロパティー値を指定します。

    表6.2 ヘッドレス Process Automation Manager コントローラーがインストールされている場合に KIE Server に必要なプロパティー

    名前要件

    org.kie.server.controller.user

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

    org.kie.server.controller.pwd

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

    org.kie.server.id

    KIE Server インストールの ID または名前 (rhdm700-decision-server-1 など)

    org.kie.server.location

    KIE 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> は、KIE Server ホストの ID または名前です (例: localhost または 192.7.8.9)。

    <PORT> は、KIE Server ホストのポートです (例: 7001)。

6.2. インストールの検証

ヘッドレス Process Automation Manager コントローラーをインストールし、必要なシステムプロパティーとロール要件をアプリケーションサーバーに定義したら、ヘッドレス Process Automation Manager コントローラーが正しく動作していることを確認します。

前提条件

  • KIE 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> は、KIE Server ホストの ID または名前です (例: localhost または 192.7.8.9)。

<PORT> は、KIE Server ホストのポートです (例: 7001)。

<CONTROLLER> および <CONTROLLER_PWD> は、本セクションで作成したユーザーの認証情報です。

このコマンドにより、KIE Server インスタンスに関する情報が返されます。

注記

あるいは、KIE Server Java API Client を使用して、ヘッドレス Process Automation Manager コントローラーにアクセスすることもできます。

ヘッドレス Process Automation Manager コントローラーが実行していない場合は、アプリケーションサーバーインスタンスを停止して再起動し、ヘッドレス Process Automation Manager コントローラーの URL または API へ再度アクセスしてみてください。