第3章 JBoss Server Migration Tool の実行
JBoss Server Migration Tool は以下のいずれかの方法で実行できます。
- インタラクティブモード: デフォルトであるこのモードを使用すると、移行する設定を確実に選択することができます。
- 非対話モード: このモードでは、プロンプトなしでツールを実行できます。
JBoss Server Migration Tool を実行する前に、ソースとターゲットの JBoss EAP サーバーの両方を停止する必要があります。
3.1. インタラクティブモードでの JBoss Server Migration Tool の実行
デフォルトでは、JBoss Server Migration Tool はインタラクティブに実行されます。このモードでは、移行するサーバー設定を正確に選択できます。
インタラクティブモードでは、移行するサブシステムを選択することはできません。サブシステムまたはタスクレベルでツールを設定する方法は、Configure the Migration Tasks Performed by the JBoss Server Migration Tool を参照してください。
以下は、最小限の移行を実行する基本的な手順です。移行元となるサーバーにカスタム設定 (例: デプロイメント) が含まれる場合や、デフォルトのリソースがない場合は、ツールにより追加のプロンプトが表示されます。
インタラクティブモードでツールを実行するには、ターゲットサーバーのインストールディレクトリーに移動し、
source引数をソースサーバーインストールへのパスとして指定します。$ EAP_HOME/bin/jboss-server-migration.sh --source EAP_PREVIOUS_HOME
EAP_PREVIOUS_HOME/standalone/configuration/ディレクトリーにあるソースサーバーのスタンドアロン設定をEAP_HOME/standalone/configuration/ディレクトリーにあるターゲットサーバーのスタンドアロン設定に移行するかどうかを決定するように求められます。Migrate the source's standalone server? yes/no? yes
noで応答すると、スタンドアロンサーバーの移行は省略され、スタンドアロンサーバー設定ファイルは移行されません。yesで応答すると、以下のプロンプトが表示されます。Migrate all configurations? yes/no? yes
yesで応答し、ソースサーバーのスタンドアロンサーバー設定ファイルをすべて移行します。noで応答すると、各standalone*.xml設定ファイルのプロンプトを受信します。次に、
EAP_PREVIOUS_HOME/domain/configuration/ディレクトリーにあるソースサーバーの管理対象ドメイン設定をEAP_HOME/domain/configuration/ディレクトリーにあるターゲットサーバーの設定に移行するかどうかを決定するように求められます。Migrate the source's managed domain? yes/no? yes
noで応答すると、管理対象ドメインの移行は省略され、管理対象ドメインの設定ファイルは移行されません。yesで応答すると、ツールはソースサーバーの管理対象ドメインコンテンツの移行を開始します。暗号化されたリポジトリーは、ソースサーバーの管理対象ドメインおよびホスト設定によって参照されるデプロイメントやデプロイメントオーバーレイなどのデータを保存するために使用されます。ソースサーバーとターゲットサーバーは同様のコンテンツリポジトリーを使用するため、ツールはソースサーバーからターゲットサーバーにデータをコピーして、結果をコンソールおよびサーバーログに出力します。INFO [ServerMigrationTask#397] Migrating domain content found: [22/caa450a9ba3b84eaf5a15b6da418b92ce6c98e/content, 23/b62a37ba8a4830622bfcdb960280577cc6796e/content] INFO [ServerMigrationTask#398] Resource with path /EAP_HOME/domain/data/content/22/caa450a9ba3b84eaf5a15b6da418b92ce6c98e/content migrated. INFO [ServerMigrationTask#399] Resource with path /EAP_HOME/domain/data/content/23/b62a37ba8a4830622bfcdb960280577cc6796e/content migrated.
次に、移行ツールは、管理対象ドメイン設定ファイルのソースサーバーをスキャンし、コンソールに結果を出力して、以下のプロンプトを表示します。
Migrate all configurations? yes/no? yes
yesで応答すると、ソースサーバーの管理対象ドメイン設定ファイルをすべて移行します。noで応答すると、各管理対象ドメイン設定ファイルのプロンプトを受信します。次に、移行ツールは、ホスト設定ファイルのソースサーバーをスキャンし、コンソールに結果を出力します。そして以下のプロンプトが表示されます。
INFO [ServerMigrationTask#457] Retrieving source's host configurations... INFO [ServerMigrationTask#457] /jboss-eap-6.4/domain/configuration/host-master.xml INFO [ServerMigrationTask#457] /jboss-eap-6.4/domain/configuration/host-slave.xml INFO [ServerMigrationTask#457] /jboss-eap-6.4/domain/configuration/host.xml Migrate all configurations? yes/no? yes
yesで応答すると、ソースサーバーのホスト設定ファイルをすべて移行します。noで応答すると、各ホスト設定ファイルのプロンプトを受信します。完了すると、サーバーコンソールに以下のメッセージが表示されます。
Migration Result: SUCCESS
