手順

1. 端末ウインドウで、インストーラー JAR ファイルをダウンロードしたディレクトリーに移動し、以下のコマンドを入力します。

   java -jar rhdm-installer-7.3.0.jar

   注記

   Windows でインストーラーを実行すると、インストール時に管理者の認証情報が求められる場合があります。この要求を回避するには、インストールコマンドに izpack.mode=privileged オプションを追加します。

   java -Dizpack.mode=privileged -jar
   rhdm-installer-7.3.0.jar

   また、32 ビットの Java 仮想マシンでインストーラーを実行している場合には、メモリー不足になる可能性があります。この問題を防ぐには、以下のコマンドを実行します。

   java -XX:MaxHeapSize=4g -jar
   rhdm-installer-7.3.0.jar

   グラフィカルインストーラーにスプラッシュ画面と使用許諾契約書のページが表示されます。

2. I accept the terms of this license agreement (本使用許諾契約書の内容に同意します) をクリックし、Next をクリックします。
3. Red Hat Decision Manager をインストールする Red Hat JBoss EAP 7.2 サーバーのホームを指定して、Next をクリックします。

4. インストールするコンポーネントを選択し、Next をクリックします。

   注記

   Business Central と Decision Server は同じサーバーにインストールできますが、実稼働環境では異なるサーバーにこの 2 つをインストールすることを推奨します。ただし、実稼働環境では、Business Central と Decision Server は異なるサーバーにインストールすることが推奨されます。そのためには、インストーラーを 2 回実行します。

5. ユーザーを作成して Next をクリックします。デフォルトでは、新規ユーザーに admin ロール、kie-server ロール、および rest-all ロールが付与されます。別のロールを選択する場合は、admin ロールを外します。詳細は、2章ロールおよびユーザー を参照してください。

   注記

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

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

   ユーザー名とパスワードを書き留めておきます。Business Central および Decision Server にアクセスする際に必要になります。

6. Installation Overview ページで Next をクリックしてインストールを起動します。Installation Overview ページに、インストールされるコンポーネントの一覧が表示されます。
7. インストールが完了したら、Next をクリックします。
8. 画面上部に Processing finished が表示されたら、Next をクリックしてインストールを完了します。

9. 必要であれば、Generate Installation Script and Properties File をクリックしてインストールデータを XML ファイルに保存し、続いて Done をクリックします。このファイルを使用して、同じタイプのサーバー上に Red Hat Decision Manager を自動的にインストールすることができます。XML ファイルの installpath パラメーターを変更して、Red Hat Decision Manager をインストールする新しいサーバーのパスを指定しなければならない点に注意してください。XML ファイルを使用してインストールを行う場合は、以下のコマンドを実行します。

   java -jar rhdm-installer-7.3.0.jar <path-to-file>

手順

1. 端末ウインドウにおいて、インストーラーファイルをダウンロードしたディレクトリーに移動し、以下のコマンドを入力します。

   java -jar rhdm-installer-7.3.0.jar -console

   コマンドラインの対話プロセスが開始し、使用許諾契約書が表示されます。

   press 1 to continue, 2 to quit, 3 to redisplay.

2. 使用許諾契約書を読んで 1 を入力し、Enter キーを押して続行します。

   Specify the home directory of one of the following servers:  Red Hat JBoss EAP 7.2 or Red Hat JBoss Web Server 5.0.1

3. 既存の Red Hat JBoss EAP 7.2 インストールの親ディレクトリーを入力します。

   インストーラーが、指定したインストール場所を確認します。1 を入力して確認し、続行します。

   注記

   Business Central と Decision Server は同じサーバーにインストールできますが、実稼働環境では異なるサーバーにこの 2 つをインストールすることを推奨します。ただし、実稼働環境では、Business Central と Decision Server は異なるサーバーにインストールすることが推奨されます。

4. インストーラーの指示に従って、インストールを完了します。

   注記

   ユーザー名およびパスワードを作成する場合は、指定したユーザー名が既存のロールまたはグループの名前と競合しないようにしてください。たとえば、admin というロールがある場合は、admin という名前のユーザーは作成しないでください。

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

   ユーザー名とパスワードを書き留めておきます。Business Central および Decision Server にアクセスする際に必要になります。

5. インストールが完了すると、以下のメッセージが表示されます。

   Would you like to generate an automatic installation script and properties file?

6. y を入力してインストールデータが含まれる XML ファイルを作成します。あるいは、n を入力してインストールを完了します。y を入力すると、XML ファイルのパスを指定するよう求められます。
7. パスを入力するか、Enter キーを押して提案されたパスを了承します。
8. Business Central のみをインストールした場合は、別のサーバーでこれらのステップを繰り返して Decision Server をインストールします。

手順

1. rhdm-7.3.0-decision-central-eap7-deployable.zip ファイルを一時ディレクトリーに展開します。以下の例では、この名前を TEMP_DIR とします。

2. TEMP_DIR/rhdm-7.3.0-decision-central-eap7-deployable/jboss-eap-7.2 ディレクトリーのコンテンツを EAP_HOME にコピーします。プロンプトが表示されたら、ファイルをマージまたは置き換えます。

   警告

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

手順

1. rhdm-7.3.0-kie-server-ee8.zip アーカイブを一時ディレクトリーに展開します。以下の例では、この名前を TEMP_DIR とします。

2. TEMP_DIR/rhdm-7.3.0-kie-server-ee8/rhdm-7.3.0-kie-server-ee8/kie-server.war ディレクトリーを EAP_HOME/standalone/deployments/ にコピーします。

   警告

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

3. TEMP_DIR/rhdm-7.3.0-kie-server-ee8/rhdm-7.3.0-kie-server-ee8/SecurityPolicy/ ディレクトリーのコンテンツを EAP_HOME/bin にコピーします。ファイルの上書きを確認するメッセージが表示されたら、Replace をクリックします。
4. EAP_HOME/standalone/deployments/ ディレクトリーに、kie-server.war.dodeploy という名前で空のファイルを作成します。このファイルにより、サーバーが起動すると Decision Server が自動的にデプロイされます。

手順

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

2. Business Central へのログインに使用する、admin ロール持つユーザーを作成します。以下のコマンドの <username> および <password> を、作成するユーザーとそのパスワードに置き換えます。

   $ ./add-user.sh -a --user <USERNAME>  --password <PASSWORD> --role admin

   注記

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

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

3. Decision Server へのログインに使用する、kie-server ロールのユーザーを作成します。

   $ ./add-user.sh -a --user <USERNAME>  --password <PASSWORD> --role kie-server

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

   注記

   Business Central と Decision Server を同じサーバーにインストールした場合は、両方のロールを持つユーザーを 1 つ作成できます。

   $ ./add-user.sh -a --user <USERNAME>  --password <PASSWORD> --role admin,rest-all,kie-server

   実稼働環境では、Business Central と Decision Server は異なるサーバーにインストールすることが推奨されます。

手順

1. Business Central の 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> を rest-all ロールを持つユーザーの認証情報に置き換えます。
   • <KIE_SERVER_ID> を Decision Server システムの ID または名前に置き換えます (例: rhdm-7.3.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> を Business Central の URL に置き換えます。Decision Server は、起動時にこの URL に接続します。

     • インストーラーまたは Red Hat JBoss EAP zip ファイルを使用して Business Central をインストールした場合、<CONTROLLER_URL> は以下のようになります。

       http://<HOST>:<PORT>/decision-central/rest/controller

     • standalone.jar ファイルを使用して Business Central を実行している場合、<CONTROLLER_URL> は以下のようになります。

       http://<HOST>:<PORT>/rest/controller

手順

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

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

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

   警告

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

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

手順

1. ターミナルアプリケーションで EAP_HOME/bin に移動します。

2. ヘッドレス Decision Manager コントローラーを、Decision Server をインストールした Red Hat JBoss EAP インスタンスと同じ Red Hat JBoss EAP インスタンスにインストールしている場合は、以下のいずれかのコマンドを実行します。

   • Linux または UNIX ベースのシステムの場合:

     $ ./standalone.sh -c standalone-full.xml

   • Windows の場合:

     standalone.bat -c standalone-full.xml

3. ヘッドレス Decision Manager コントローラーを、Decision Server をインストールした Red Hat JBoss EAP インスタンスとは別の Red Hat JBoss EAP インスタンスにインストールしている場合は、standalone.sh スクリプトで Decision Manager コントローラーを開始できます。

   注記

   この場合は、standalone.xml ファイルに必要な設定変更を加えます。

   • Linux または UNIX ベースのシステムの場合:

     $ ./standalone.sh

   • Windows の場合:

     standalone.bat

4. ヘッドレス Decision Manager コントローラーが Red Hat JBoss EAP 上で動作していることを確認するには、以下のコマンドを入力します。ここで、<CONTROLLER> と <CONTROLLER_PWD> は、「ヘッドレス Decision Manager コントローラーの作成」で作成したユーザー名とパスワードの組み合わせです。このコマンドにより、Decision Server インスタンスに関する情報が出力されます。

   curl -X GET "http://<HOST>:<PORT>/controller/rest/controller/management/servers" -H  "accept: application/xml" -u '<CONTROLLER>:<CONTROLLER_PWD>'

手順

1. Red Hat Business Automation BOM を pom.xml ファイルで宣言します。

   <dependencyManagement>
    <dependencies>
     <dependency>
      <groupId>com.redhat.ba</groupId>
      <artifactId>ba-platform-bom</artifactId>
      <version>7.3.0.GA-redhat-00002</version>
      <type>pom</type>
      <scope>import</scope>
     </dependency>
    </dependencies>
   </dependencyManagement>
   <dependencies>
   <!-- Your dependencies -->
   </dependencies>

2. <dependencies> タグでお使いのプロジェクトに必要な依存関係を宣言します。製品の BOM をプロジェクトにインポートしたら、ユーザー向け製品依存関係のバージョンが定義されるため、<dependency> 要素のサブ要素 <version> を指定する必要はありません。ただし、<dependency> 要素を使用して、プロジェクトで使用する依存関係を宣言する必要があります。

3. Business Central に作成されない標準のプロジェクトでは、お使いのプロジェクトに必要な依存関係をすべて指定します。Business Central に作成するプロジェクトでは、基本的なデシジョンエンジンの依存関係が Business Central に自動的に提供されます。

   • 標準的な Red Hat Decision Manager プロジェクトでは、使用する機能に応じて、以下の依存関係を宣言します。

   • 標準的な Red Hat Decision Manager プロジェクトでは、以下の依存関係を宣言します。

     埋め込みデシジョンエンジン依存関係

     <dependency>
       <groupId>org.drools</groupId>
       <artifactId>drools-compiler</artifactId>
     </dependency>
     
     <!-- Dependency for persistence support. -->
     <dependency>
       <groupId>org.drools</groupId>
       <artifactId>drools-persistence-jpa</artifactId>
     </dependency>
     
     <!-- Dependencies for decision tables, templates, and scorecards.
     For other assets, declare org.drools:business-central-models-* dependencies. -->
     <dependency>
       <groupId>org.drools</groupId>
       <artifactId>drools-decisiontables</artifactId>
     </dependency>
     <dependency>
       <groupId>org.drools</groupId>
       <artifactId>drools-templates</artifactId>
     </dependency>
     <dependency>
       <groupId>org.drools</groupId>
       <artifactId>drools-scorecards</artifactId>
     </dependency>
     
     <!-- Dependency for loading KJARs from a Maven repository using KieScanner. -->
     <dependency>
       <groupId>org.kie</groupId>
       <artifactId>kie-ci</artifactId>
     </dependency>

   • Decision Server を使用するには、以下の依存関係を宣言します。

     クライアントアプリケーション Decision Server 依存関係

     <dependency>
       <groupId>org.kie.server</groupId>
       <artifactId>kie-server-client</artifactId>
     </dependency>

   • Red Hat Decision Manager にリモートクライアントを作成するには、以下の依存関係を宣言します。

     クライアントの依存関係

     <dependency>
       <groupId>org.uberfire</groupId>
     </dependency>

   • ルール、プロセス定義など、アセットを含む JAR ファイルを作成する場合は、お使いの Maven プロジェクトのパッケージングの種類を kjar と指定し、org.kie:kie-maven-plugin を使用して、<project> 要素に置かれた kjar パッケージングタイプを処理します。以下の例の ${kie.version} は、What is the mapping between Red Hat Decision Manager and the Maven library version? に記載されている Maven ライブラリーのバージョンです。

     <packaging>kjar</packaging>
     <build>
      <plugins>
       <plugin>
        <groupId>org.kie</groupId>
        <artifactId>kie-maven-plugin</artifactId>
        <version>${kie.version}</version>
        <extensions>true</extensions>
       </plugin>
      </plugins>
     </build>

手順

1. 外部リポジトリーの接続およびアクセスの詳細が含まれる Maven settings.xml ファイルを作成します。settings.xml ファイルの詳細は Maven の Settings Reference を参照してください。
2. 既知の場所 (例: /opt/custom-config/settings.xml) にファイルを保存します。
3. Red Hat Decision Manager インストールディレクトリーで、standalone-full.xml ファイルに移動します。たとえば、Red Hat Decision Manager に Red Hat JBoss EAP インストールを使用する場合は $EAP_HOME/standalone/configuration/standalone-full.xml にアクセスします。

4. standalone-full.xml の <system-properties> タグで、kie.maven.settings.custom プロパティーに settings.xml ファイルのフルパス名を設定します。

   以下に例を示します。

   <property name="kie.maven.settings.custom" value="/opt/custom-config/settings.xml"/>

5. Business Central と Decision Server を起動または再起動します。

手順

1. Red Hat JBoss EAP を起動し、Web ブラウザーで Business Central を開きます。
2. PNG 形式のイメージを、Red Hat Decision Manager インストールの EAP_HOME/standalone/deployments/decision-central.war/img/ ディレクトリーにコピーします。
3. EAP_HOME//standalone/deployments/decision-central.war/img/ ディレクトリーで、既存の login-screen-logo.png ファイルを移動するか名前を変更します。
4. PNG ファイル login-screen-logo.png の名前を変更します。
5. User name および Password フィールドの上に表示されるプロジェクトロゴを変更するには、デフォルトイメージ RHDM_Logo.svg を新しい SVG ファイルに置き換えます。
6. ログインページを強制的に完全に再読込みし、キャッシュを消去して変更を表示します。たとえば、Linux および Windows の多くの Web ブラウザーでは、Ctrl+F5 を押します。

手順

1. Red Hat JBoss EAP を起動し、Web ブラウザーで Business Central を開き、お使いのユーザー認証情報でログインします。
2. SVG 形式の新しいアプリケーションヘッダーイメージを、Red Hat Decision Manager システムの EAP_HOME/standalone/deployments/decision-central.war/banner/ ディレクトリーにコピーします。
3. テキストエディターで EAP_HOME/standalone/deployments/decision-central.war/banner/banner.html ファイルを開きます。

4. <img> タグの logo.svg を、新しいイメージ:admin-and-config/ のファイル名に置き換えます。

   <img src="banner/logo.svg"/>

5. ログインページを強制的に完全に再読込みし、キャッシュを消去して変更を表示します。たとえば、Linux および Windows の多くの Web ブラウザーでは、Ctrl+F5 を押します。