前提条件/事前作業

1. BRMS 6.4 Business Central において、該当プロジェクトが含まれるリポジトリーの名前を探します。デフォルトのリポジトリー名は repository1 です。
2. BRMS 6.4 Business Central を停止します。
3. .niogit ディレクトリーを探します。デフォルトのシステムでは、その場所は $EAP_home/bin/.niogit です。この場所は、$EAP_home/standalone/configuration/standalone.xml ファイルのシステムプロパティー org.uberfire.nio.git.dir で変更できます。システムプロパティーは、Business Central を起動するコマンドで -D オプションを指定して設定することもできます。
4. 別の JBoss EAP システムを使用して、BRMS 6.4 Business Central と同じホスト上に Red Hat Decision Manager (Decision Central を含む) をインストールします。手順については『Red Hat Decision Manager のオンプレミスインストール』を参照してください。

手順

1. Red Hat Decision Manager 7.0 Decision Central にログインします。
2. メインメニューで Projects を選択します。
3. アイコンをクリックし、Import Project を選択します。

4. Repository URL フィールドに、以下のフォーマットで URL を入力します。

   file://<path>/.niogit/<repository>.git

   たとえば、.niogit ディレクトリーの場所が /opt/eap7.0/bin/.niogit で、repository1 リポジトリーからプロジェクトをインポートする場合、URL は以下のようになります。

   file:///opt/eap7.0/bin/.niogit/repository1.git

5. Import をクリックします。
6. インポートするプロジェクトを選択して Import をクリックします。

7. NoRemoteRepositoryException の例外が表示される場合があります。その場合は、以下のステップを実施します。

   1. シェルのターミナルで、インポートするリポジトリーのサブディレクトリー (.niogit の下位ディレクトリー) に移動します
   2. リモートのリストを表示します (git remote -v)。

   3. リストにあるすべてのリモートを削除します (git remote remove <remote-name>)。

      例:

      $ /opt/eap7.0/bin/.niogit/repository1.git
      $ git remote -v
      origin  https://github.com/guvnorngtestuser1/guvnorng-playground (fetch)
      origin  https://github.com/guvnorngtestuser1/guvnorng-playground (push)
      $ git remote remove origin

      続いて、もう一度プロジェクトをインポートします (必要であれば、新しいリポジトリーに別途リモートを追加することができます)。

8. インポートおよびインデックス化が完了するのを待ちます。
9. インポートするリポジトリーが他にあれば、手順を繰り返します。

手順

1. プロジェクトの pom.xml ファイルを開きます。

2. 以下のグループに属するすべての依存関係から、<version> タグを削除します。

   • org.kie
   • org.drools
   • org.jbpm
   • org.optaplanner

3. <dependencyManagement> セクション内の <dependencies> タグの下に、以下の依存関係を追加します。

   <dependency>
     <groupId>org.jboss.bom.rhdm</groupId>
     <artifactId>rhdm-platform-bom</artifactId>
     <version>${rhdm.version}</version>
     <scope>import</scope>
     <type>pom</type>
   </dependency>

   ここで、${rhdm.version} は、Red Hat Decision Manager 7.0 用 Maven リポジトリーの org.jboss.bom.rhdm:rhdm-platform-bom アーティファクトのバージョンです。リポジトリーに入り、maven-repository/org/jboss/bom/rhdm/rhdm-platform-bom ディレクトリーに移動して、アーティファクトのバージョンを確認できます。このディレクトリーのサブディレクトリーの名前だけを、バージョンとして指定します (例: 7.0.0.GA-redhat-1)。

4. コードに Drools CDI アノテーション (@KReleaseId、@KContainer、@KBase、@KSession) が使用されている場合は、以下の依存関係も追加します。

   <dependency>
     <groupId>org.drools</groupId>
     <artifactId>drools-cdi</artifactId>
   </dependency>

   アノテーションを処理する CDI 拡張子が別のモジュールを使用して定義されるようになったので、この依存関係が必要です。この依存関係がないと、アノテーションは機能しません。

5. (必要に応じて) 古い org.guvnor 依存関係を、新しい org.uberfire 依存関係に置き換えます。

   古い org.guvnor 依存関係:

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

   新しい org.uberfire 依存関係:

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

6. プロジェクトアーティファクトのバージョンを更新し、pom.xml ファイルを保存します。
7. 通常の Maven ビルドを使用してプロジェクトをビルドし直します。
8. ビルドエラー、またはその後に実行エラーが発生する場合は、「移行した Java プロジェクトで発生するビルドエラーおよび実行エラーのトラブルシューティング」で説明する情報を元に、それらの問題を解決します。

手順

1. BRMS 6.4 KIE Server と同じホスト上に Red Hat Decision Manager 7.0 Decision Server をインストールします。その際には、別の JBoss EAP システムを使用します。手順については『Red Hat Decision Manager のオンプレミスインストール』を参照してください。
2. BRMS 6.4 KIE Server と同じポートにバインドするように、Red Hat Decision Manager 7.0 Decision Server を設定します (デフォルトの設定は同じです)。

3. 既存のデシジョンサービス (KJAR ファイル) を含む Maven リポジトリーを使用するように、Decision Server を設定します。以下の手法のいずれかを使用します。

   • BRMS 6.4 KIE Server で使用していたものと同じ KJAR ファイルを使用します。Maven 設定をコピーするには、kie.maven.settings.custom システムプロパティーの値を、古いバージョンの $EAP_home/standalone/configuration/standalone.xml ファイルから新しいバージョンの同じファイルにコピーします。
   • 既存のデシジョンサービスを新しいバージョンにアップグレードします。手順については「2章Decision Central でのプロジェクト移行作業」および「3章Java プロジェクトの移行」を参照してください。新たな KJAR ファイルを Maven リポジトリーにアップロードします。続いて、そのリポジトリーを使用するように Decision Server を設定します。
   1. Maven リポジトリーの settings.xml ファイルを作成します。

   2. Red Hat Decision Manager 7.0 Decision Server の $EAP_home/standalone/configuration/standalone.xml ファイルにおいて、<system-properties> タグの kie.maven.settings.custom property を settings.xml ファイルのフルパス名に設定します。以下に例を示します。

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

      この場合、KJAR ファイルのバージョンを変更する必要があります。開始するサービスのバージョンに正しく変更します。既存クライアントとの互換性を最大限維持するために、引き続き同じコンテナー名を使用することができます。

4. BRMS 6.4 KIE Server を停止します。
5. Red Hat Decision Manager 7.0 Decision Server を起動します。
6. API を使用して必要なデシジョンサービスを開始します。手順については『デシジョンサービスのパッケージングおよびデプロイメント』を参照してください。