أداة ترحيل خادم JBoss هي أداة تعمل على ترحيل خوادم تطبيقات JBoss. فهو يقرأ ملفات تكوينات الخادم لإصدار سابق من 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 النهائي من أداة الترحيل.
تعقب المشكلة