JBoss Server Migration Tool คือเครื่องมือที่โอนย้าย JBoss Application Servers โดยจะอ่านไฟล์การกำหนดค่าเซิร์ฟเวอร์สำหรับ 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 โปรดดูที่ส่วนการเผยแพร่เพื่อดูว่าเวอร์ชันของเครื่องมือการย้ายที่คุณต้องการสำหรับการย้ายเวอร์ชันของคุณ ตัวอย่างเช่น คุณไม่สามารถใช้เครื่องมือ Migration Tool 1.11.0 Final ในการย้าย WildFly 16.0.0 ไปเป็น WildFly 22.0.0 เพื่อที่คุณจะต้องใช้เครื่องมือการย้ายข้อมูลเวอร์ชัน 1.10.0 ขั้นสุดท้าย
ติดตามปัญหา