JBoss 服务器迁移工具是迁移 JBoss 应用程序服务器的工具。它读取 WildFly 或 JBoss EAP 先前版本(称为源服务器)的服务器配置文件,并将它们迁移到最新版本或目标服务器。除了配置之外,该工具还能够迁移源服务器中的模块、部署和其他资源。
Java 8.0 (Java SDK 1.8) 或更高版本
阿帕奇Maven
使用以下命令从源代码构建该工具:
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 迁移而导致迁移失败,请参阅版本部分,了解迁移您的版本所需的迁移工具版本。例如,您无法使用迁移工具 1.11.0 Final 将 WildFly 16.0.0 迁移到 WildFly 22.0.0。为此,您需要迁移工具版本 1.10.0 Final。
问题跟踪器