第2章 Decision Central のデータ移行

手順

1. Red Hat JBoss BPM Suite 6.4 に対する現在の Decision Central ディストリビューションにある bin/.niogit ディレクトリーの位置を特定し、新しい Red Hat Decision Manager 7.1 インストールで同じディレクトリーを見つけます。

   例:

   $ ~/$JBOSS_HOME/bin/.niogit

   $ ~/$RHDM_HOME/bin/.niogit

2. 端末で、Red Hat JBoss BRMS 6.4 の 現在の Decision Central ディストリビューションから、新しい Red Hat Decision Manager 7.1 インストールディレクトリーの bin ディレクトリーに、.niogit ディレクトリーをコピーします。

   cp -r /$JBOSS_HOME/bin/.niogit  /$RHDM_HOME/bin/

   コピーした .niogit ディレクトリーは、移行ツールが Red Hat Decision Manager 7.1 に用意するディレクトリーで、オリジナルの .niogit ディレクトリーは Red Hat JBoss BRMS 6.4 インストールに残り、この手順で使用する移行ツールでは修正されません。

3. Red Hat Decision Manager 7.1 の bin ディレクトリーにある .index ディレクトリーを削除します。Red Hat Decision Manager 7.1 には、Red Hat JBoss BRMS 6.4 に準拠していない特定の更新が含まれるため、このディレクトリーは削除する必要があります。bin ディレクトリーのインデックスは、移行してから Red Hat Decision Manager 7.1 を起動するときに再作成されます。
4. Red Hat で Decision Manager 7.1 にコピーした .niogit ディレクトリーのパスを書き留めます。このパスは、移行ツールを実行する際に必要になります。

5. プロジェクトの移行時に追加、削除、または更新する特定の dependencies、repositories、または pluginRepositories がある場合は、これらの要素を含む pom-migration.json ファイルを作成します。移行ツールを実行すると、移行にこのファイルを含めるかどうかを尋ねるプロンプトが表示されます。

   pom-migration.json ファイルには以下のセクションが必要です。

   • "dependencies":[]
   • "repositories-add":[]
   • "repositories-remove":[]
   • "repositories-update-urls":[]
   • "pluginRepositories-add":[]
   • "pluginRepositories-remove":[]
   • "pluginRepositories-update-urls":[]

   この中の要素のいずれかがプロジェクトに適用されない場合は、解析エラーを回避するために空のセクションとして追加します。

   サンプルファイル pom-migration.json:

   {
     "dependencies":[
   
       {"groupId":"junit", "artifactId":"junit", "version":"4.12", "scope":"test"},
       {"groupId":"com.thoughtworks.xstream", "artifactId":"xstream", "version":"4.12", "scope":"test"}
   
     ],
   
     "repositories-add":[
       {
         "id":"jboss-public-repository-group",
         "name":"JBoss Public Repository Group",
         "url":"http://repository.jboss.org/nexus/content/groups/public/",
         "releasesEnabled":true,
         "releasesUpdatePolicy":"never",
         "snapshotEnabled":true,
         "snapshotUpdatePolicy":"never"
       },
       {
         "id":"kie-internal-staging-repository-group",
         "name":"KIE Internal Staging Repositories",
         "url":"https://origin-repository.jboss.org/nexus/content/groups/kie-internal-group",
         "releasesEnabled":true,
         "releasesUpdatePolicy":"never",
         "snapshotEnabled":false,
         "snapshotUpdatePolicy":"never"
       }
     ],
   
     "repositories-remove":[
       {
         "id":"productization-repository", "url":"http://download.lab.bos.redhat.com/brewroot/repos/jb-ip-6.1-build/latest/maven/"
       }
     ],
   
     "repositories-update-urls":[
       {
         "id":"guvnor-m2-repo", "url":"http://localhost:8080/decision-central/maven3/"
       }
     ],
   
     "pluginRepositories-add":[
   
       {
         "id":"jboss-public-repository-group",
         "name":"JBoss Public Repository Group",
         "url":"http://repository.jboss.org/nexus/content/groups/public/",
         "releasesEnabled":true,
         "releasesUpdatePolicy":"never",
         "snapshotEnabled":true,
         "snapshotUpdatePolicy":"never"
       },
       {
         "id":"kie-internal-staging-repository-group",
         "name":"KIE Internal Staging Repositories",
         "url":"https://origin-repository.jboss.org/nexus/content/groups/kie-internal-group",
         "releasesEnabled":true,
         "releasesUpdatePolicy":"never",
         "snapshotEnabled":false,
         "snapshotUpdatePolicy":"never"
       }
   
     ],
     "pluginRepositories-remove":[],
     "pluginRepositories-update-urls":[]
   }

   (依存関係 のみを持つ) サンプルファイル pom-migration.json:

   {
     "dependencies":[
   
       {"groupId":"junit", "artifactId":"junit", "version":"4.12", "scope":"test"},
       {"groupId":"com.thoughtworks.xstream", "artifactId":"xstream", "version":"4.12", "scope":"test"}
   
     ],
     "repositories-add":[],
     "repositories-remove":[],
     "repositories-update-urls":[],
     "pluginRepositories-add":[],
     "pluginRepositories-remove":[],
     "pluginRepositories-update-urls":[]
   }

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

   • Product: Decision Manager
   • Version: 7.1
7. Red Hat Decision Manager 7.1.0 Add-Ons をダウンロードして、ダウンロードした rhdm-7.1.0-add-ons.zip ファイルを一時ディレクトリーに展開します。
8. 展開した rhdm-7.1.0-add-ons ディレクトリーに、rhdm-7.1-migration-tool.zip サブディレクトリーを展開します。移行ツールは bin ディレクトリーに保存されています。

9. 端末で、rhdm-7.1-migration-tool ディレクトリーを展開した一時ディレクトリーに移動して、移行ツールを実行します。$RHDM_NIOGIT_DIR の部分は、Red Hat Process Automation Manager 7.1 インストールにコピーしておいた .niogit ディレクトリーのパスになります。

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

   $ cd $INSTALL_DIR/rhdm-7.1-migration-tool/bin
   $ ./migration-tool.sh -t $RHDM_NIOGIT_DIR

   Windows の場合:

   $ cd $INSTALL_DIR\rhdm-7.1-migration-tool\bin
   $ migration-tool.bat -t $RHDM_NIOGIT_DIR

   コマンドプロンプトが表示されると、以下のオプションが表示されます。

   • Project structure migration: Red Hat JBoss BRMS 6.4 プロジェクトリポジトリー構造を、Red Hat Decision Manager 7.1 で使用される新しいプロジェクト指向の構造に移行します。
   • System configuration directory structure migration: Red Hat JBoss BRMS 6.4 で使用される system.git リポジトリー構造を、Red Hat Decision Manager 7.1 で使用される新しい構造に移行します。この移行オプションでは、プロジェクト構造の移行を最初に実行する必要があります。
   • Forms migration: Red Hat Decision Manager 7.1 で必要な依存関係を持つ pom.xml ファイルを更新します。この移行オプションでは、プロジェクト構造の移行とシステム設定ディレクトリー構造の移行を最初に実行する必要があります。
   • All: すべての移行オプションを順番に実行します。
   • Exit: 移行ツールを終了します。

10. All オプションを選択して、移行を順番に実行します。

    注記

    移行オプションを一度に 1 つずつ実行する場合は、最初に実行する移行オプションを実行します。ツールを実行したら、Decision Central 移行ツールを再度実行して、次に実行する移行オプションを選択します。

11. 特定の移行オプションを実行するようにプロンプトが表示されるたびに yes を入力します。

    POM 移行オプションで、作成しておいた外部の pom-migration.json ファイルのパスを指定する場合は、プロンプトが表示された時に yes を入力して、パスを入力します。

12. ツールの実行が終了したら、Exit オプションを選択して移行ツールを終了します。

    .niogit ディレクトリー構造は、Red Hat Decision Manager 7.1 の Decision Central と互換性があります。プロジェクトディレクトリーは別のリポジトリーにあり、その他の関連する設定はすべて移行されています。新しい .niogit ディレクトリーに移動して、再構築したコンテンツを確認できます。

手順

1. (リポジトリーのクローンが作成されていない場合は) ローカルディレクトリーで、移行するプロジェクトを含む Git リポジトリーのクローンを作成します。

   $ cd $REPO_DIR/
   $ git clone $GIT_REPO_URL

2. クローンを作成した Git リポジトリーのパスを書き留めます。移行ツールを実行する際にパスが必要になります。
3. 移行ツールの実行後に、新たに移行したリポジトリーのコピーを置く出力ディレクトリーを作成します。既存のディレクトリーを出力場所としても使用できます。この出力ディレクトリーのパスを書き留めます。移行ツールは、クローンとして作成したリポジトリーのコピー上で作動します。ツールの実行時に新しい出力ディレクトリーのパスを求めるプロンプトがこのツールにより表示されます。

4. プロジェクトの移行時に追加、削除、または更新する特定の dependencies、repositories、または pluginRepositories がある場合は、これらの要素を含む pom-migration.json ファイルを作成します。移行ツールを実行すると、移行にこのファイルを含めるかどうかを尋ねるプロンプトが表示されます。

   pom-migration.json ファイルには以下のセクションが必要です。

   • "dependencies":[]
   • "repositories-add":[]
   • "repositories-remove":[]
   • "repositories-update-urls":[]
   • "pluginRepositories-add":[]
   • "pluginRepositories-remove":[]
   • "pluginRepositories-update-urls":[]

   この中の要素のいずれかがプロジェクトに適用されない場合は、解析エラーを回避するために空のセクションとして追加します。

   サンプルファイル pom-migration.json:

   {
     "dependencies":[
   
       {"groupId":"junit", "artifactId":"junit", "version":"4.12", "scope":"test"},
       {"groupId":"com.thoughtworks.xstream", "artifactId":"xstream", "version":"4.12", "scope":"test"}
   
     ],
   
     "repositories-add":[
       {
         "id":"jboss-public-repository-group",
         "name":"JBoss Public Repository Group",
         "url":"http://repository.jboss.org/nexus/content/groups/public/",
         "releasesEnabled":true,
         "releasesUpdatePolicy":"never",
         "snapshotEnabled":true,
         "snapshotUpdatePolicy":"never"
       },
       {
         "id":"kie-internal-staging-repository-group",
         "name":"KIE Internal Staging Repositories",
         "url":"https://origin-repository.jboss.org/nexus/content/groups/kie-internal-group",
         "releasesEnabled":true,
         "releasesUpdatePolicy":"never",
         "snapshotEnabled":false,
         "snapshotUpdatePolicy":"never"
       }
     ],
   
     "repositories-remove":[
       {
         "id":"productization-repository", "url":"http://download.lab.bos.redhat.com/brewroot/repos/jb-ip-6.1-build/latest/maven/"
       }
     ],
   
     "repositories-update-urls":[
       {
         "id":"guvnor-m2-repo", "url":"http://localhost:8080/decision-central/maven3/"
       }
     ],
   
     "pluginRepositories-add":[
   
       {
         "id":"jboss-public-repository-group",
         "name":"JBoss Public Repository Group",
         "url":"http://repository.jboss.org/nexus/content/groups/public/",
         "releasesEnabled":true,
         "releasesUpdatePolicy":"never",
         "snapshotEnabled":true,
         "snapshotUpdatePolicy":"never"
       },
       {
         "id":"kie-internal-staging-repository-group",
         "name":"KIE Internal Staging Repositories",
         "url":"https://origin-repository.jboss.org/nexus/content/groups/kie-internal-group",
         "releasesEnabled":true,
         "releasesUpdatePolicy":"never",
         "snapshotEnabled":false,
         "snapshotUpdatePolicy":"never"
       }
   
     ],
     "pluginRepositories-remove":[],
     "pluginRepositories-update-urls":[]
   }

   (依存関係 のみを持つ) サンプルファイル pom-migration.json:

   {
     "dependencies":[
   
       {"groupId":"junit", "artifactId":"junit", "version":"4.12", "scope":"test"},
       {"groupId":"com.thoughtworks.xstream", "artifactId":"xstream", "version":"4.12", "scope":"test"}
   
     ],
     "repositories-add":[],
     "repositories-remove":[],
     "repositories-update-urls":[],
     "pluginRepositories-add":[],
     "pluginRepositories-remove":[],
     "pluginRepositories-update-urls":[]
   }

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

   • Product: Decision Manager
   • Version: 7.1
6. Red Hat Decision Manager 7.1.0 Add-Ons をダウンロードして、ダウンロードした rhdm-7.1.0-add-ons.zip ファイルを一時ディレクトリーに展開します。
7. 展開した rhdm-7.1.0-add-ons ディレクトリーに、rhdm-7.1-migration-tool.zip サブディレクトリーを展開します。移行ツールは bin ディレクトリーに保存されています。

8. コマンド端末で、rhdm-7.1-migration-tool ディレクトリーを展開した一時ディレクトリーに移動して、移行ツールを実行します。$GIT_REPO_PATH の部分は、作成した Git リポジトリーのパスになります。

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

   $ cd $INSTALL_DIR/rhdm-7.1-migration-tool/bin
   $ ./migration-tool.sh -t $GIT_REPO_PATH

   Windows の場合:

   $ cd $INSTALL_DIR\rhdm-7.1-migration-tool\bin
   $ migration-tool.bat -t $GIT_REPO_PATH

9. 表示されるコマンドプロンプトに、移行したリポジトリーのコピーを置く出力ディレクトリーへのパスを入力します。移行ツールは、クローンとして作成したリポジトリーのコピー上で作動し、指定した出力先に新しいリポジトリーを配置します。

   出力先を入力後、移行ツールがリポジトリーのコピーを用意し、すべてのプロジェクトディレクトリーが Red Hat Decision Manager 7.1 と互換性を保てるように再構築します。

   コマンドプロンプトに、以下の追加移行オプションが表示されます。

   • POMs migration: Red Hat Decision Manager 7.1 で必要な依存関係が含まれる pom.xml を更新します。
   • All: 残りのすべての移行オプションを順番に実行します。
   • Exit: 移行ツールを終了します。
   注記

   出力先で移行ツールを開始するとこのオプションが自動的に実行するため、Project structure migration オプションは表示されません。

10. All オプションを選択して、移行を順番に実行します。

    注記

    移行オプションを一度に 1 つずつ実行する場合は、最初に実行する移行オプションを実行します。ツールを実行したら、Decision Central 移行ツールを再度実行して、次に実行する移行オプションを選択します。

11. 特定の移行オプションを実行するようにプロンプトが表示されるたびに yes を入力します。

    POM 移行オプションで、作成しておいた外部の pom-migration.json ファイルのパスを指定する場合は、プロンプトが表示された時に yes を入力して、パスを入力します。

12. ツールの実行が終了したら、Exit オプションを選択して移行ツールを終了します。

    指定した出力先のプロジェクトディレクトリーは、Red Hat Decision Manager 7.1 の Decision Central と互換性のある個々のリポジトリーに分かれます。新しいプロジェクトリポジトリーは、作業ディレクトリーのないベアリポジトリーであるため、コンテンツファイルを表示しません。各リポジトリーのクローンを作成してベアリポジトリーではないリポジトリーを作成し、ディレクトリーのコンテンツを確認します。

13. Red Hat Decision Manager 7.1 の Decision Central にログインします。
14. 各プロジェクトに対して、プロジェクトのスペースを作成または選択し、Import Project をクリックします。

15. 新たに構築したプロジェクトリポジトリーの リポジトリー URL を入力します。この URL は、出力先へのローカルファイルパス (移行ツールを実行したワークステーションから直接インポートしている場合)、GitHub URL、またはリポジトリーをアップロードしたその他のファイルのホスト先にできます。

    例: ローカルファイルの場所

    file:///$OUTPUT_DIR/loan-application.git

    例: GitHub リポジトリーの場所

    https://github.com/$REPO/loan-application.git

    注記

    プロジェクトデータで Git hooks を使用する場合は、移行を調整する hooks スクリプトの更新が必要になる場合があります。