Red Hat Training

A Red Hat training course is available for Red Hat Decision Manager

第9章 ヘッドレス Decision Manager コントローラーのインストールおよび実行

Decision Server は、管理モードまたは非管理モードで動作するように設定できます。非管理モードの場合は、手動で KIE コンテナー (デプロイメントユニット) を作成および維持する必要があります。管理モードの場合は、Decision Manager コントローラーが Decision Server の設定を管理し、ユーザーはコントローラーと対話形式で KIE コンテナーを作成、維持します。

Decision Central には Decision Manager コントローラーが組み込まれています。Decision Central をインストールしている場合は、Execution Server ページを使用して KIE コンテナーを作成および維持します。Decision Central を使用せずに Decision Server の管理を自動化するには、ヘッドレス Decision Manager コントローラーを使用します。

9.1. ヘッドレス Decision Manager コントローラーのインストール

ヘッドレス Decision Manager コントローラーをインストールし、REST API または Decision Server Java Client API を使用してコントローラーを操作することができます。

前提条件

  • バックアップを作成してある Red Hat JBoss EAP システム (バージョン 7.2 またはそれ以降) が利用できる。Red Hat JBoss EAP システムのベースディレクトリーを EAP_HOME とする。
  • インストールを完了するのに必要なユーザーパーミッションが付与されている。

手順

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

    • Product: Decision Manager
    • バージョン: 7.2
  2. Red Hat Decision Manager 7.2.0 Add Ons (rhdm-7.2.0-add-ons.zip ファイル) をダウンロードします。
  3. rhdm-7.2.0-add-ons.zip ファイルを展開します。rhdm-7.2-controller-ee7.zip ファイルは展開したディレクトリーにあります。
  4. rhdm-7.2-controller-ee7.zip アーカイブを一時ディレクトリーに展開します。以下の例では、この名前を TEMP_DIR とします。

  5. TEMP_DIR/rhdm-7.2-controller-ee7/controller.war ディレクトリーを EAP_HOME/standalone/deployments/ にコピーします。

    警告

    コピーするヘッドレス Decision Manager コントローラーデプロイメントの名前が、Red Hat JBoss EAP インスタンスの既存デプロイメントと競合しないことを確認します。

  6. TEMP_DIR/rhdm-7.2-controller-ee7/SecurityPolicy/ ディレクトリーの中身を EAP_HOME/bin にコピーします。ファイルの上書きを確認するメッセージが表示されたら、Yes を選択します。
  7. EAP_HOME/standalone/deployments/ ディレクトリーに、controller.war.dodeploy という名前で空のファイルを作成します。このファイルにより、サーバーが起動するとヘッドレス Decision Manager コントローラーが自動的にデプロイされます。

9.1.1. ヘッドレス Decision Manager コントローラーの作成

ヘッドレス Decision Manager コントローラーを使用する前に、kie-server ロールを持つユーザーを作成する必要があります。

前提条件

  • ヘッドレス Decision Manager コントローラーが Red Hat JBoss EAP インストールのベースディレクトリー (EAP_HOME) にインストールされている。

手順

  1. 端末アプリケーションで EAP_HOME/bin ディレクトリーに移動します。

  2. 以下のコマンドを入力し、<USER_NAME> および <PASSWORD> を、作成するユーザー名およびパスワードに置き換えます。 

    $ ./add-user.sh -a --user <username> --password <password> --role kie-server
    注記

    必ず、既存のユーザー、ロール、またはグループとは異なるユーザー名を指定してください。たとえば、admin という名前のユーザーは作成しないでください。

    パスワードは 8 文字以上で、数字と、英数字以外の文字をそれぞれ 1 文字以上使用する必要があります。ただし & の文字は使用できません。

  3. ユーザー名とパスワードを書き留めておきます。

9.1.2. Decision Server とヘッドレス Decision Manager コントローラー の設定

Decision Server をヘッドレス Decision Manager コントローラーで管理する場合は、本セクションの説明に従って Decision Server インストールの standalone-full.xml とヘッドレス Decision Manager コントローラーの standalone.xml ファイルを編集する必要があります。

前提条件

  • 5章ZIP からの Red Hat Decision Manager のインストール セクションの説明に従って Decision Server が Red Hat JBoss EAP インストールのベースディレクトリー (EAP_HOME) にインストールされている。

  • ヘッドレス Decision Manager コントローラーが EAP_HOME にインストールされている。

    注記

    実稼働環境では Decision Server およびヘッドレス Decision Manager コントローラーを異なるサーバーにインストールすることを推奨します。ただし、開発環境のように Decision Server およびヘッドレス Decision Manager コントローラーを同じサーバーにインストールする場合は、併せて共有の standalone-full.xml ファイルを変更します。

  • Decision Server サーバーノードに、kie-server ロールをのあるユーザーが作成されている。

  • サーバーノードに、kie-server ロールのあるユーザーが作成されている。

    詳細は、「ユーザーの作成」 を参照してください。

手順

  1. 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>"/>

  2. Decision 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>"/>

  3. このファイルで、以下の値を置き換えます。

    • <CONTROLLER_USER> および <CONTROLLER_PWD> を kie-server ロールを持つユーザーの認証情報に置き換えます。
    • <KIE_SERVER_ID> を Decision Server システムの ID または名前に置き換えます (例: rhdm-7.2.0-decision_server-1)。
    • <HOST> を Decision Server ホストの ID または名前に置き換える (例: localhost または 192.7.8.9)。

    • <PORT> を Decision Server ホストのポートに置き換える (例: 8080)。

      注記

      org.kie.server.location プロパティーで Decision Server の場所を指定します。

    • <CONTROLLER_URL> をヘッドレス Decision Manager コントローラー の URL で置き換えます。
  4. Decision Server は、起動時にこの URL に接続します。