第6章 スタンドアロン Decision Server Controller のインストールと実行
Decision Server を管理モードまたは非管理モードで動作するように設定することができます。Decision Server が非管理モードにある場合は、手動でコンテナーを作成および維持する必要があります。Decision Server が管理モードにある場合は、スタンドアロン Decision Server Controller が Decision Server の設定を管理し、ユーザーは Controller を操作してコンテナーを作成および維持します。
スタンドアロン Decision Server Controller は、Decision Central に組み込まれています。Decision Central をインストールしている場合は、Exection Server ページを使用してコンテナーを作成および維持します。Decision Central をインストールしていない場合は、スタンドアロン Decision Server Controller をインストールし、REST API または Decision Server Java Client API を使用して Controller を操作できます。
6.1. Controller のダウンロードおよび展開
IBM WebSphere にインストールする前に、スタンドアロン Decision Server Controller をダウンロードして展開する必要があります。
- Red Hat カスタマーポータル にログインします。
- ページ上部の ダウンロード をクリックします。
- 表示される Product Downloads ページで JBOSS INTEGRATION AND AUTOMATION セクションに移動し、Red Hat Decision Manager をクリックします。
- Software Downloads ページで、必要に応じて Product メニューから Decision Manager を選択し、Version メニューから 7.0 を選択します。
- Red Hat Decision Manager 7.0.0 Add Ons の横の Download をクリックします。
-
rhdm-7.0.0.GA-add-ons.zip
ファイルを展開します。rhdm-7.0-controller-ee7.zip
ファイルは、展開したディレクトリーにあります。 -
rhdm-7.0-controller-ee7.zip
ファイルを一時ディレクトリー (例:TEMP_DIR
) に展開します。 TEMP_DIR/controller.war
ディレクトリーに移動して、以下のコマンドを実行します。zip -r controller.war ./*
zip -r controller.war ./*
Copy to Clipboard Copied!
6.2. Controller への環境変数の設定
このセクションで紹介する環境変数を設定します。
前提条件
- Decision Server が IBM WebSphere インスタンスにインストールされています。
Controller が IBM WebSphere インスタンスにインストールされています。
注記Red Hat では、実稼働環境では、Decision Server とスタンドアロン Decision Server Controller を異なるサーバーにインストールすることを推奨します。(たとえば開発環境として) Decision Server とスタンドアロン Decision Server Controller を同じサーバーにインストールする場合は、同じ IBM WebSphere インスタンスを、以下のように変更する必要があります。
-
Decision Server ノード:
kie-server
ロールを持つユーザー -
Controller サーバーノード:
kie-server
ロールを持つユーザー
手順
Controller をインストールする IBM WebSphere インスタンスに、以下の JVM プロパティー値を設定します。
-
org.kie.server.user
:kie-server
ロールを持つユーザー -
org.kie.server.pwd
:org.kie.server.user
プロパティーに指定したユーザーのパスワード
-
Decision Server をインストールする IBM WebSphere インスタンスに、以下の JVM プロパティー値を指定します。
-
org.kie.server.controller.user
:kie-server
ロールを持つユーザー -
org.kie.server.controller.pwd
:org.kie.server.controller.user
プロパティーに指定したユーザーのパスワード -
org.kie.server.id
: Decision Server インストールの ID または名前 (例:rhdm700-decision-server-1
) -
org.kie.server.location
:http://<HOST>:<PORT>/kie-server/services/rest/server
org.kie.server.controller
: スタンドアロン Decision Server Controller の URL (例:http://<HOST>:<PORT>/controller/rest/controller
)この例では、以下を示しています。
-
<HOST>
: Decision Server ホストの ID または名前 (例:localhost
or192.7.8.9
) -
<PORT>
: Decision Server ホストのポート (例:8080
)
-
6.3. Controller のインストール
このセクションでは、IBM WebSphere Application Server に Controller をインストールする方法を説明します。
Controller をインストールし、REST API または Decision Server Java Client API を使用して Controller を操作できます。
前提条件
- 本書に説明した方法で、IBM WebSphere インスタンスが設定されています。
- インストールを完了するのに十分なユーザーパーミッションがあります。
-
rhdm-7.0-controller-ee7.zip
ファイルを展開し、controller.war
ファイルに再圧縮します。
手順
Applications
Application Types WebSphere Enterprise Applications をクリックします。 これにより、システムで既存のアプリケーションがすべて表示され、新しいアプリケーションをインストールできます。
- Install をクリックします。
-
ローカルのファイルシステムから Controller WAR ファイル (
controller.war
) をアップロードします。 Fast Path を選択し、Next をクリックします。
Install New Application ウィザードが開きます。
- Map Virtual Hosts for Web Modules セクションでは、デフォルト値をそのままにして、Next をクリックします。
-
コンテキストルートを
controller
に設定します。 - Metadata for Modules セクションで、デフォルト値をそのままにして Next をクリックします。
- Finish をクリックして、その controller をインストールします。
- Save をクリックして、マスター設定への変更を保存します。
6.3.1. グループとロールのマッピング
controller
ロールを、ユーザーまたはグループにマップします。
手順
-
新たにインストールした
kie-server
アプリケーションのメイン設定ページに戻ります (ApplicationsApplication Types WebSphere Enterprise Applications)。 - Detail Properties の下にある Security Role to User/Group Mapping をクリックします。
-
kie-server
ロールを選択し、Map Groups をクリックして、kie-server
グループを検索します。 -
controller
グループを、Available 一覧から Selected 一覧に移動し、OK をクリックします。このマッピングにより、先に作成した管理ユーザーに Decision Server へのアクセスが付与されます。 -
Save をクリックして、
kie-server
アプリケーションを起動します。
6.3.2. インストールの検証
コントローラーをインストールして起動したら、問題なく動作することを検証します。
手順
Controller が IBM WebSphere で動作していることを検証するには、以下のコマンドを実行します。
curl -X GET "http://<HOST>:<PORT>/controller/rest/controller/management/servers" -H "accept: application/xml" -u '<CONTROLLER>:<CONTROLLER_PWD>'
curl -X GET "http://<HOST>:<PORT>/controller/rest/controller/management/servers" -H "accept: application/xml" -u '<CONTROLLER>:<CONTROLLER_PWD>'
Copy to Clipboard Copied! このコマンドで、
<CONTROLLER>
および<CONTROLLER_PWD>
を、このセクションで作成したユーザーの認証情報に置き換えます。このコマンドにより、Decision Server インスタンスに関する情報が出力されます。
-
http://TARGET_SERVER:PORT/kie-server/services/rest/server
で GET 要求を送信して、Controller REST API が機能するかどうかを確認します。