Red Hat JBoss Web Server への Red Hat Decision Manager のインストールおよび設定

手順

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

   java -jar rhdm-installer-7.2.0.jar

   Copy to Clipboard Toggle word wrap
   注記

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

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

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

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

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

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

   Decision Central は Red Hat JBoss Web Server にインストールすることができません。Business Central をインストールできるのは Red Hat JBoss EAP だけです。ヘッドレス Decision Manager コントローラーは、Decision Server を管理するために使用します。ヘッドレス Decision Manager コントローラーは、Decision Server の管理に使用されます。複数の Decision Server インスタンスを管理する予定がある場合は、ヘッドレス Decision Manager コントローラーをインストールします。

5. ユーザーを作成して Next をクリックします。デフォルトでは、新規ユーザーに admin ロール、kie-server ロール、および rest-all ロールが付与されます。Decision Server REST 機能にアクセスするには kie-server ロールが必要です。

   注記

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

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

   ユーザー名とパスワードを書き留めておきます。Decision 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.2.0.jar <path-to-file>

   Copy to Clipboard Toggle word wrap

手順

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

   java -jar rhdm-installer-7.2.0.jar -console

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

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

   Copy to Clipboard Toggle word wrap

3. 既存の Red Hat JBoss Web Server 5.0.1 以降のインストールの親ディレクトリーを入力します。

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

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

   注記

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

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

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

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

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

   Copy to Clipboard Toggle word wrap
6. y を入力してインストールデータが含まれる XML ファイルを作成します。あるいは、n を入力してインストールを完了します。y を入力すると、XML ファイルのパスを指定するよう求められます。
7. パスを入力するか、Enter キーを押して提案されたパスを了承します。
8. Decision Server だけをインストールした場合は、この手順を繰り返して、別のサーバーにヘッドレス Decision Manager コントローラーをインストールします。

手順

1. rhdm-7.2.0-add-ons.zip ファイルを展開します。

2. 展開した rhdm-7.2.0-add-ons.zip ファイルから、以下のファイルを展開します。

   • rhdm-7.2-kie-server-jws.zip
   • rhdm-7.2-decision-engine.zip

   以下の説明では、展開した rhdm-7.2-kie-server-jws.zip ファイルが含まれるディレクトリーは JWS_TEMP_DIR と呼ばれ、展開した rhdm-7.2-decision-engine.zip ファイルが含まれるディレクトリーは ENGINE_TEMP_DIR と呼ばれます。

3. JWS_TEMP_DIR/rhdm-7.2-kie-server-jws/kie-server.war ディレクトリーを JWS_HOME/tomcat/webapps ディレクトリーにコピーします。

   注記

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

4. kie-server.war ディレクトリーから .war 拡張子を削除します。
5. kie-tomcat-integration-7.14.0.Final-redhat-00002.jar ファイルを ENGINE_TEMP_DIR ディレクトリーから JWS_HOME/tomcat/lib ディレクトリーに移動します。
6. jboss-jacc-api-<VERSION>.jar ファイル、slf4j-api-<VERSION>.jar ファイル、および slf4j-jdk14-<VERSION>.jar ファイルを ENGINE_TEMP_DIR/lib ディレクトリーから JWS_HOME/tomcat/lib ディレクトリーに移動します。<VERSION> は lib ディレクトリーのバージョンのアーティファクトファイル名に置き換えます。
7. rhdm-7.2.0-maven-repository.zip ファイルを展開します。

8. 展開した Maven リポジトリーから 以下のライブラリーから JWS_HOME/tomcat/lib フォルダーに、以下のライブラリーをコピーします。

   org.jboss.spec.javax.transaction:jboss-transaction-api_1.2_spec
   org.jboss.integration:narayana-tomcat
   org.jboss.narayana.jta:narayana-jta
   org.jboss:jboss-transaction-spi

   Copy to Clipboard Toggle word wrap

9. 最後の Valve 定義の後にある TOMCAT_HOME/conf/server.xml ファイルの <host> 要素に、以下の行を追加します。

   <Valve className="org.kie.integration.tomcat.JACCValve" />

   Copy to Clipboard Toggle word wrap
10. テキストエディターで JWS_HOME/tomcat/conf/tomcat-users.xml ファイルを開きます。

11. JWS_HOME/tomcat/conf/tomcat-users.xml ファイルにユーザーおよびロールを追加します。以下の例で、<ROLE_NAME> は Red Hat Decision Manager でサポートされるロールです。<USER_NAME> および <USER_PWD> は、選択したユーザー名とパスワードです。

    <role rolename="<ROLE_NAME>"/>
    <user username="<USER_NAME>" password="<USER_PWD>" roles="<ROLE_NAME>"/>

    Copy to Clipboard Toggle word wrap

    ユーザーに複数のロールを割り当てる場合は、以下の例に示すようにロールをコンマで区切ります。

    <role rolename="admin"/>
    <role rolename="kie-server"/>
    <user username="rhdmUser" password="user1234" roles="admin,kie-server"/>

    Copy to Clipboard Toggle word wrap

12. JWS_HOME/tomcat/bin ディレクトリーで以下の手順の 1 つを実行します。

    • Linux または UNIX の場合は、以下の内容の setenv.sh ファイルを作成します。

      CATALINA_OPTS="-Xmx1024m
       -Dorg.jboss.logging.provider=jdk
       -Dorg.jbpm.server.ext.disabled=true
       -Dorg.jbpm.ui.server.ext.disabled=true
       -Dorg.jbpm.case.server.ext.disabled=true"

      Copy to Clipboard Toggle word wrap

    • Windows の場合は、以下の内容の setenv.bat ファイルを作成します。

      set CATALINA_OPTS="-Xmx1024m -Dorg.jboss.logging.provider=jdk -Dorg.jbpm.server.ext.disabled=true -Dorg.jbpm.ui.server.ext.disabled=true -Dorg.jbpm.case.server.ext.disabled=true

      Copy to Clipboard Toggle word wrap

手順

1. Maven プロジェクトを生成します。pom.xml ファイルは、Maven プロジェクトの作成時に自動的に生成されます。

2. pom.xml ファイルを編集して、追加の依存関係および新たなリポジトリーを追加します。

   プロジェクトのコンパイルおよびパッケージング時に、Maven がすべての JAR ファイルおよび依存関係にある JAR ファイル を Maven リポジトリーからダウンロードします。

手順

1. settings.xml ファイルでは、Red Hat Decision Manager プロジェクトが使用するリポジトリーを宣言します。通常、これは Red Hat カスタマーポータルからダウンロードする オンラインの Red Hat Decision Manager Maven リポジトリー または Red Hat Decision Manager Maven リポジトリーと、使用するカスタムアーティファクトのリポジトリーです。
2. たとえば kie.maven.settings.custom=<path_to_settings.xml> プロパティーを指定して、Decision Central または Decision Server が settings.xml ファイルを使用するように設定されていることを確認します。

手順

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

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

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

3. Decision Central に作成されないスタンドアロンプロジェクトでは、お使いのプロジェクトに必要な依存関係をすべて指定します。Decision Central に作成するプロジェクトでは、基本的なデシジョンエンジンの依存関係が Decision 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:drools-workbench-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>

     Copy to Clipboard Toggle word wrap

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

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

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

     Copy to Clipboard Toggle word wrap

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

     クライアントの依存関係

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

     Copy to Clipboard Toggle word wrap

   • ルール、プロセス定義など、アセットを含む 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>

     Copy to Clipboard Toggle word wrap