手順

1. IBM Installation Manager バージョン 1.8.5 以降を「IBM Installation Manager and Packaging Utility download links」ページからダウンロードします。IBM WebSphere のインストールには IBM Installation Manager が必要です。

2. ダウンロードしたアーカイブを展開し、作成されたディレクトリーで、root 権限で以下のコマンドを実行します。

   sudo ./install

   IBM Installation Manager が開きます。

3. File → Preferences の順に移動して、Add Repository をクリックします。
4. Add Repository ウィンドウに、IBM WebSphere 9.0 のリポジトリー URL を入力します。すべてのリポジトリー URL は、IBM Knowledge Center の「Online product repositories for IBM WebSphere Application Server offerings」ページで確認できます。
5. 端末で、インストール時に指定した IBM WebSphere Application Server フォルダーの場所に移動します。

6. /bin ディレクトリーに変更し、以下の例のようなコマンドを実行して、IBM WebSphere のプロファイル、ユーザー名、およびパスワードを作成します。プロファイルは、ランタイム環境を定義します。プロファイルには、ランタイム環境でサーバーが処理し、変更できるファイルがすべて含まれます。このユーザーはログインに必要になります。

   sudo ./manageprofiles.sh -create -profileName testprofile -profilePath /profiles/testprofile  -adminUserName websphere -adminPassword password123

7. 端末で、作成したプロファイルの bin ディレクトリー (例: /profiles/testprofile/bin) に移動し、以下のコマンドを実行して IBM WebSphere Application Server インスタンスを起動します。

   sudo ./startServer.sh <SERVER_NAME>

   <SERVER_NAME> は、WebSphere 統合ソリューションコンソールの Servers → Server Types → IBM WebSphere Application Servers で定義した IBM WebSphere Application Server の名前です。

8. Web ブラウザーで、以下の URL を開きます。

   http://<HOST>:9060/ibm/console

   <HOST> は、ターゲットサーバーの名前または IP アドレスです。

   たとえば、システムで起動している IBM WebSphere のローカルインスタンスに対して WebSphere 統合ソリューションコンソールを起動する場合は、以下の URL を Web ブラウザーに入力します。

   http://localhost:9060/ibm/console

9. WebSphere 統合ソリューションコンソールのログインページが表示されたら、管理者の認証情報を入力します。

手順

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

   • 製品: Process Automation Manager
   • バージョン: 7.8
2. Red Hat Process Automation Manager 7.8.0 KIE Server for All Supported EE7 Containers をダウンロードします。
3. rhpam-7.8.0-kie-server-ee7.zip アーカイブを一時ディレクトリーに展開します。以下の例では、このディレクトリーを TEMP_DIR とします。

4. kie-server.war ディレクトリーを再パッケージ化します。

   1. TEMP_DIR/rhpam-7.8.0-kie-server-ee7/kie-server.war ディレクトリーに移動します。
   2. TEMP_DIR/rhpam-7.8.0-kie-server-ee7/kie-server.war ディレクトリーのコンテンツを選択し、kie-server.zip ファイルを作成します。
   3. kie-server.zip の名前を kie-server.war に変更します。このファイルを使用して、KIE Server をデプロイします。
   4. オプションで、新しい kie-server.war ファイルを、デプロイしやすい便利な場所にコピーします。
5. WebSphere 統合ソリューションコンソールで、Applications → Application Types → WebSphere Enterprise Applications の順に移動します。
6. Install をクリックします。
7. 再パッケージ化した kie-server.war ファイルに移動して選択し、アップロードします。

8. Fast Path を選択し、Next をクリックします。

   Install New Application ウィザードが開きます。

9. Application Name を kie-server に変更し、Next をクリックします。
10. 要件に合わせて KIE Server モジュールをサーバーにマッピングし、Next をクリックします。
11. Bind Listeners for Message-Driven Beans の場合は 、両 Bean に Activation Specification を選択し、Target Resource JNDI Name フィールドに jms/activation/KIE.SERVER.REQUEST を入力し、KIE.SERVER.REQUEST 接続ファクトリーの jms/cf/KIE.SERVER.REQUEST JNDI 名を入力します。
12. Map Virtual Hosts for Web Modules セクションでは、デフォルト値をそのままにして、Next をクリックします。
13. コンテキストのルートを kie-server に設定します。
14. Metadata for Modules セクションで、デフォルト値をそのままにして Next をクリックします。
15. Finish をクリックして KIE Server をインストールし、Save をクリックして master 設定に変更を保存します。

手順

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. rhpam-7.8.0-add-ons.zip ファイルを一時ディレクトリーに展開します。以下の例では、このディレクトリーを TEMP_DIR とします。
5. rhpam-7.8.0-add-ons/rhpam-7.8.0-controller-ee7.zip ファイルを展開します。

6. controller.war ディレクトリーを再パッケージ化します。

   1. TEMP_DIR/rhpam-7.8.0-add-ons/rhpam-7.8.0-controller-ee7/controller.war ディレクトリーに移動します。
   2. TEMP_DIR/rhpam-7.8.0-add-ons/rhpam-7.8.0-controller-ee7/controller.war ディレクトリーの内容を選択して、controller.zip ファイルを作成します。
   3. controller.zip の名前を controller.war に変更します。これは、ヘッドレス Process Automation Manager コントローラーをデプロイするのに使用するファイルです。
   4. オプションで、新しい controller.war ファイルを、デプロイしやすい場所にコピーします。
7. WebSphere 統合ソリューションコンソールで、Applications → Application Types → WebSphere Enterprise Applications の順に移動します。
8. Install をクリックします。
9. 再パッケージ化した controller.war ファイルに移動し、選択してアップロードします。

10. Fast Path を選択し、Next をクリックします。

    Install New Application ウィザードが開きます。

11. Application Name を controller に変更し、Next をクリックします。
12. 要件に合わせて ヘッドレス Process Automation Manager コントローラーモジュールをサーバーにマッピングし、Next をクリックします。
13. Bind Listeners for Message-Driven Beans の場合は 、両 Bean に Activation Specification を選択し、Target Resource JNDI Name フィールドに jms/activation/KIE.SERVER.REQUEST を入力し、KIE.SERVER.REQUEST 接続ファクトリーの jms/cf/KIE.SERVER.REQUEST JNDI 名を入力します。
14. Map Virtual Hosts for Web Modules セクションでは、デフォルト値をそのままにして、Next をクリックします。
15. コンテキストルートを controller に設定します。
16. Metadata for Modules セクションで、デフォルト値をそのままにして Next をクリックします。
17. Finish をクリックしてヘッドレス Process Automation Manager コントローラーをインストールし、Save をクリックして master 設定への変更を保存します。

手順

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

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

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

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

     埋め込みプロセスエンジン依存関係

     <!-- Public KIE API -->
     <dependency>
       <groupId>org.kie</groupId>
       <artifactId>kie-api</artifactId>
     </dependency>
     
     <!-- Core dependencies for process engine -->
     <dependency>
       <groupId>org.jbpm</groupId>
       <artifactId>jbpm-flow</artifactId>
     </dependency>
     
     <dependency>
      <groupId>org.jbpm</groupId>
       <artifactId>jbpm-flow-builder</artifactId>
     </dependency>
     
     <dependency>
       <groupId>org.jbpm</groupId>
       <artifactId>jbpm-bpmn2</artifactId>
     </dependency>
     
     <dependency>
       <groupId>org.jbpm</groupId>
       <artifactId>jbpm-runtime-manager</artifactId>
     </dependency>
     
     <dependency>
       <groupId>org.jbpm</groupId>
       <artifactId>jbpm-persistence-jpa</artifactId>
     </dependency>
     
     <dependency>
       <groupId>org.jbpm</groupId>
       <artifactId>jbpm-query-jpa</artifactId>
     </dependency>
     
     <dependency>
       <groupId>org.jbpm</groupId>
       <artifactId>jbpm-audit</artifactId>
     </dependency>
     
     <dependency>
       <groupId>org.jbpm</groupId>
       <artifactId>jbpm-kie-services</artifactId>
     </dependency>
     
     <!-- Dependency needed for default WorkItemHandler implementations. -->
     <dependency>
       <groupId>org.jbpm</groupId>
       <artifactId>jbpm-workitems-core</artifactId>
     </dependency>
     
     <!-- Logging dependency. You can use any logging framework compatible with slf4j. -->
     <dependency>
       <groupId>ch.qos.logback</groupId>
       <artifactId>logback-classic</artifactId>
       <version>${logback.version}</version>
     </dependency>

   • CDI を使用する Red Hat Process Automation Manager プロジェクトでは、通常、以下の依存関係を宣言します。

     CDI が有効化されたプロセスエンジンの依存関係

     <dependency>
       <groupId>org.kie</groupId>
       <artifactId>kie-api</artifactId>
     </dependency>
     
     <dependency>
       <groupId>org.jbpm</groupId>
       <artifactId>jbpm-kie-services</artifactId>
     </dependency>
     
     <dependency>
       <groupId>org.jbpm</groupId>
       <artifactId>jbpm-services-cdi</artifactId>
     </dependency>

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

     <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>

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

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

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

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

     クライアントの依存関係

     <dependency>
       <groupId>org.uberfire</groupId>
       <artifactId>uberfire-rest-client</artifactId>
     </dependency>

   • ルール、プロセス定義など、アセットを含む JAR ファイルを作成する場合は、お使いの Maven プロジェクトのパッケージングの種類を kjar とし、org.kie:kie-maven-plugin を使用して、<project> 要素に置かれた kjar パッケージングタイプを処理します。以下の例の ${kie.version} は、「What is the mapping between Red Hat Process Automation 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>

3. プロジェクトで永続サポートのあるプロセスエンジンまたはデシジョンエンジンを使用する場合には、Red Hat Business Automation BOM ファイルから version.org.hibernate-4ee7 プロパティーをコピーして、pom.xml ファイルの dependencyManagement セクションに以下の Hibernate の依存関係を宣言する必要があります。

   Hibernate の依存関係

   <!-- hibernate dependencies -->
   <dependencyManagement>
     <dependencies>
       <dependency>
       <groupId>org.hibernate</groupId>
       <artifactId>hibernate-entitymanager</artifactId>
       <version>${version.org.hibernate-4ee7}</version>
       </dependency>
   
       <dependency>
       <groupId>org.hibernate</groupId>
       <artifactId>hibernate-core</artifactId>
       <version>${version.org.hibernate-4ee7}</version>
       </dependency>
     </dependencies>
   </dependencyManagement>

手順

1. JCEKS キーストアを作成します。
2. プロンプトが表示されたら、作成した KIE Server ユーザーのパスワードを入力します。

3. 以下の表に記載のシステムプロパティーを設定します。

   表8.1 KIE Server JCEKS を読み込む時に使用するシステムプロパティー

   システムプロパティー	プレースホルダー	説明
   kie.keystore.keyStoreURL	<KEYSTORE_URL>	使用する JCEKS の URL。例: file:///home/kie/keystores/keystore.jceks
   kie.keystore.keyStorePwd	<KEYSTORE_PWD>	JCEKS のパスワード
   kie.keystore.key.server.alias	<KEY_SERVER_ALIAS>	パスワードの保存先となる REST サービスのキーのエイリアス
   kie.keystore.key.server.pwd	<KEY_SERVER_PWD>	保存したパスワードを使用する REST サービスのエイリアスのパスワード
   kie.keystore.key.ctrl.alias	<KEY_CONTROL_ALIAS>	パスワードの保存先のデフォルトの REST Process Automation Controller のキーのエイリアス
   kie.keystore.key.ctrl.pwd	<KEY_CONTROL_PWD>	保存したパスワードを使用する、デフォルトの REST Process Automation Controller のエイリアスのパスワード

4. KIE Server を起動して、設定を検証します。