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。
問題追蹤器