Alat Migrasi Server JBoss adalah alat yang memigrasikan Server Aplikasi JBoss. Ia membaca file konfigurasi server untuk rilis WildFly atau JBoss EAP sebelumnya, yang disebut sebagai server sumber, dan memigrasikannya ke rilis terbaru atau server target. Selain konfigurasi, alat ini juga mampu memigrasikan modul, penerapan, dan sumber daya lain yang ditemukan di server sumber.
Java 8.0 (Java SDK 1.8) atau lebih baru
Apache Maven
Gunakan perintah berikut untuk membuat alat dari sumber:
mvn clean install
Arahkan ke direktori dist/standalone/target/
dan unzip file jboss-server-migration-VERSION_NUMBER.zip
unzip jboss-server-migration-34.0.0.Final-SNAPSHOT.zip
Buka terminal dan navigasikan ke direktori dist/standalone/target/jboss-server-migration/
.
Jalankan perintah berikut.
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
Ganti SOURCE_SERVER_PATH
dengan jalur ke versi instalasi server sebelumnya yang ingin Anda migrasikan, misalnya: ${user.home}/wildfly-26.0.0.Final/
Ganti TARGET_SERVER_PATH
dengan jalur ke versi instalasi server saat ini yang Anda inginkan untuk memigrasikan konfigurasi lama, misalnya: ${user.home}/wildfly-31.0.0.Final/
Saat Anda menjalankan perintah, alat tersebut mengidentifikasi server sumber dan target dari jalur yang disediakan, dan memulai migrasi server.
---------------------------------------------------------- ---- 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...
Setiap migrasi server terdiri dari beberapa tugas migrasi, yang mungkin memerlukan atau tidak memerlukan interaksi pengguna.
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.
Setelah migrasi server selesai, laporan Task Summary
akan ditampilkan, yang merangkum hasil tugas migrasi. Migrasi server selesai.
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
Anda akan melihat pesan berikut setelah selesai.
---------------------------------------------------------------------------------------------- Migration Result: SUCCESS ----------------------------------------------------------------------------------------------
Laporan tambahan dapat ditemukan di direktori reports/
.
migration-report.html
: Laporan HTML adalah laporan berformat bagus yang menunjukkan hasil migrasi secara detail.
migration-report.xml
: File XML mencakup semua data migrasi yang dikumpulkan.
File log dapat ditemukan di direktori logs/
.
migration.log
: Log berisi informasi rinci tentang pelaksanaan migrasi server.
Kesalahan Migrasi Gagal
Jika Anda mendapatkan pesan kesalahan yang memberitahukan bahwa migrasi gagal karena versi Y tidak mendukung migrasi dari versi X, silakan merujuk ke bagian Rilis untuk melihat versi Alat Migrasi mana yang Anda perlukan untuk memigrasikan versi Anda. Misalnya Anda tidak dapat menggunakan Alat Migrasi 1.11.0 Final untuk memigrasikan WildFly 16.0.0 ke WildFly 22.0.0. Untuk itu Anda memerlukan Alat Migrasi Versi 1.10.0 Final.
Pelacak Masalah