JBoss Server Migration Tool は、JBoss Application Server を移行するツールです。 WildFly または JBoss EAP の以前のリリース (ソースサーバーと呼ばれます) のサーバー設定ファイルを読み取り、最新のリリースまたはターゲットサーバーに移行します。このツールは、構成に加えて、ソース サーバーにあるモジュール、デプロイメント、その他のリソースを移行することもできます。
Java 8.0 (Java SDK 1.8) 以降
アパッチメイブン
次のコマンドを使用して、ソースからツールをビルドします。
mvn clean install
dist/standalone/target/
ディレクトリに移動し、 jboss-server-migration-VERSION_NUMBER.zip
ファイルを解凍します。
unzip jboss-server-migration-34.0.0.Final-SNAPSHOT.zip
ターミナルを開き、 dist/standalone/target/jboss-server-migration/
ディレクトリに移動します。
次のコマンドを実行します。
For Linux|Mac: ./jboss-server-migration.sh -s SOURCE_SERVER_PATH -t TARGET_SERVER_PATH For Windows: jboss-server-migration.bat -s SOURCE_SERVER_PATH -t TARGET_SERVER_PATH
SOURCE_SERVER_PATH
、移行元のサーバー インストールの前のバージョンへのパスに置き換えます (例: ${user.home}/wildfly-26.0.0.Final/
TARGET_SERVER_PATH
、古い構成の移行先となる現在のバージョンのサーバー インストールへのパスに置き換えます (例: ${user.home}/wildfly-31.0.0.Final/
コマンドを実行すると、ツールは指定されたパスからソース サーバーとターゲット サーバーを識別し、サーバーの移行を開始します。
---------------------------------------------------------- ---- JBoss Server Migration Tool ----------------------- ---------------------------------------------------------- Retrieving servers... INFO SOURCE server name: WildFly Full, version: 26.0.0.Final. INFO TARGET server name: WildFly Full, version: 34.0.0.Final-SNAPSHOT. ---------------------------------------------------------- ---------------------------------------------------------- Server migration starting...
各サーバーの移行はいくつかの移行タスクで構成されており、ユーザーの操作が必要な場合と不要な場合があります。
INFO --- Migrating modules requested by environment... INFO Module cmtool.module1:main migrated. INFO --- Migrating standalone server... INFO No source's standalone content found to migrate. INFO Source's standalone configurations found: [standalone.xml] INFO Migrating standalone configuration standalone.xml... INFO Subsystem infinispan updated. INFO Subsystem undertow updated. INFO Security realms migrated. INFO Non-persistent deployments found in standalone/deployments: [cmtool-helloworld5.war, cmtool-helloworld6.war] INFO Non-persistent deployment cmtool-helloworld5.war migrated. INFO Non-persistent deployment cmtool-helloworld6.war migrated. INFO --- Migrating managed domain... INFO No source's domain content found to migrate. INFO Source's domain configurations found: [domain.xml] INFO Migrating domain configuration domain.xml... INFO Subsystem infinispan updated. INFO Subsystem undertow updated. INFO Source's host configurations found: [host.xml] INFO Migrating host configuration host.xml... INFO Migrating host master... INFO Security realms migrated.
サーバーの移行が完了すると、移行タスクの結果を要約したTask Summary
レポートが表示されます。サーバー移行が完了しました。
INFO ---------------------------------------------------------------------------------------------- Task Summary ---------------------------------------------------------------------------------------------- server .............................................................................. SUCCESS modules.migrate-modules-requested-by-user .......................................... SUCCESS modules.migrate-modules-requested-by-user.migrate-module(id=cmtool.module1:main) .. SUCCESS standalone ......................................................................... SUCCESS standalone-configurations ......................................................... SUCCESS standalone-configuration(source=standalone.xml) .................................. SUCCESS domain ............................................................................. SUCCESS domain-configurations ............................................................. SUCCESS domain-configuration(source=domain.xml) .......................................... SUCCESS host-configurations ............................................................... SUCCESS host-configuration(source=host.xml) .............................................. SUCCESS
完了すると、次のメッセージが表示されるはずです。
---------------------------------------------------------------------------------------------- Migration Result: SUCCESS ----------------------------------------------------------------------------------------------
追加のレポートはreports/
ディレクトリにある場合があります。
migration-report.html
: HTML レポートは、移行の詳細な結果を示す適切にフォーマットされたレポートです。
migration-report.xml
: XML ファイルには、収集されたすべての移行データが含まれます。
ファイル ログは、 logs/
ディレクトリに存在する場合があります。
migration.log
: ログには、サーバー移行の実行に関する詳細情報が含まれています。
移行失敗エラー
バージョン Y がバージョン X からの移行をサポートしていないために移行が失敗したことを示すエラー メッセージが表示された場合は、「リリース」セクションを参照して、バージョンの移行に必要な移行ツールのバージョンを確認してください。たとえば、WildFly 16.0.0 から WildFly 22.0.0 への移行に移行ツール 1.11.0 Final を使用することはできません。そのためには、移行ツール バージョン 1.10.0 Final が必要です。
問題追跡ツール