Membuat rencana migrasi

Setelah membuat salinan sistem file mesin sumber di komputer lokal, langkah berikutnya adalah menganalisis sistem file untuk menyiapkan rencana migrasi. Rencana migrasi kemudian dapat digunakan untuk membuat artefak migrasi.

Halaman ini menjelaskan langkah-langkah yang diperlukan untuk menyiapkan rencana migrasi untuk workload yang berbeda.

Membuat rencana migrasi untuk penampung VM Linux

Untuk melakukan analisis, jalankan perintah berikut:

./m2c analyze \
  -s PATH_TO_COPIED_FILESYSTEM \
  -p linux-vm-container \
  -o ANALYSIS_OUTPUT_PATH \
  [ -r skip_size_checks=SKIP_SIZE_CHECKS  ] \
  [ -r big_files_threshold_mb=SIZE_IN_MB ]

Ganti kode berikut:

  • PATH_TO_COPIED_FILESYSTEM: jalur ke direktori sistem file yang disalin.
  • ANALYSIS_OUTPUT_PATH: jalur ke folder tempat Anda ingin membuat output analisis.
  • SKIP_SIZE_CHECKS: ini adalah parameter opsional. Secara default, atribut ini ditetapkan ke false dan Migrate to Containers CLI akan memeriksa lapisan image untuk memastikan ukurannya tidak melebihi 15 GB. Jika total ukuran lapisan gambar melebihi 15 GB, pembuatan artefak akan gagal dan Migrate to Containers CLI akan menampilkan pesan error. Untuk melewati pemeriksaan ukuran ini, tetapkan parameter ini ke true.
  • SIZE_IN_MB: ini adalah parameter opsional. Tentukan batas ukuran file, dalam MB, untuk memeriksa file yang melebihi ukuran tertentu. Jika Migrate to Containers CLI mendeteksi file dengan ukuran yang melebihi batas ukuran yang ditentukan, Migrate to Containers CLI akan menambahkan komentar dalam rencana migrasi yang dihasilkan dengan saran untuk mengecualikan file yang terdeteksi dari image container.

Setelah analisis selesai, direktori baru akan dibuat di jalur output yang ditentukan, yang berisi rencana migrasi, config.yaml.

Membuat rencana migrasi untuk workload Tomcat

Untuk komponen aplikasi Tomcat, proses ini memerlukan jalur catalina-home dan catalina-base sebagai input.

Untuk mengambil nilai ini, periksa proses server Tomcat yang berjalan:

ps aux | grep catalina

Untuk melakukan analisis, jalankan perintah berikut:

./m2c analyze \
  -s PATH_TO_COPIED_FILESYSTEM \
  -p tomcat-container \
  -o ANALYSIS_OUTPUT_PATH \
  -r catalina-home=PATH_TO_CATALINA_HOME \
  -r catalina-base=PATH_TO_CATALINA_BASE \
  -r java-version=JAVA_VERSION

Ganti kode berikut:

  • PATH_TO_COPIED_FILESYSTEM: jalur ke direktori sistem file yang disalin
  • ANALYSIS_OUTPUT_PATH: jalur ke folder tempat Anda ingin membuat output analisis
  • PATH_TO_CATALINA_HOME: jalur ke root penginstalan Tomcat
  • PATH_TO_CATALINA_BASE: jalur ke root konfigurasi runtime instance Tomcat yang Anda migrasikan. Beberapa basis harus dipisahkan menggunakan titik dua
  • JAVA_VERSION: Versi Java penampung dalam format X.Y. Versi Java default adalah 11.0.

Setelah analisis selesai, direktori baru akan dibuat di jalur output yang ditentukan, yang berisi rencana migrasi, config.yaml.

Membuat rencana migrasi untuk workload WebSphere

Opsional: Menyiapkan binerAppScanner.jar

Jika ingin memigrasikan workload tradisional WebSphere, atau melakukan migrasi antar-lingkungan Java yang berbeda, Anda dapat menyiapkan binaryAppScanner.jar. CLI Migrate to Containers mengotomatiskan penggunaan binaryAppScanner.jar untuk membuat konfigurasi WebSphere baru dan memfasilitasi modernisasi runtime Java.

Untuk menyiapkan binaryAppScanner.jar:

  1. Download file penginstal, binaryAppScannerInstaller.jar, dari Dukungan IBM. Anda harus menyetujui perjanjian lisensi sebagai bagian dari download.

  2. Ekstrak file binaryAppScanner.jar dan setujui perjanjian lisensi:

    java -jar binaryAppScannerInstaller.jar --acceptLicense --verbose INSTALL_LOCATION

    Ganti kode berikut:

    • INSTALL_LOCATION: direktori target untuk ekstraksi. Misalnya, jika Anda menetapkan /tmp sebagai direktori target, setelah penginstalan selesai, binaryAppScanner.jar akan tersedia di /tmp/wamt/binaryAppScanner.jar.

Melakukan analisis

Untuk melakukan analisis, jalankan perintah berikut:

./m2c analyze \
  -s PATH_TO_COPIED_FILESYSTEM \
  -p websphere-container \
  -o ANALYSIS_OUTPUT_PATH \
  -r websphere-profile=WEBSPHERE_PROFILE \
  -r websphere-home=WEBSPHERE_HOME \
  -r websphere-java-home=WEBSPHERE_JAVA_HOME \
  -r target-profile=TARGET_PROFILE \
  -r target-version=TARGET_VERSION \
  -r target-edition=TARGET_EDITION \
  -r target-se=TARGET_SE \
  -r target-ee=TARGET_EE \
  -r target-vendor=TARGET_VENDOR \
  -r target-base-image=TARGET_BASE_IMAGE \
  --volume PATH_TO_BINARYAPPSCANNER:/binaryAppScanner.jar

Ganti kode berikut:

  • PATH_TO_COPIED_FILESYSTEM: jalur ke direktori sistem file yang disalin.
  • ANALYSIS_OUTPUT_PATH: jalur ke folder tempat Anda ingin membuat output analisis.
  • WEBSPHERE_PROFILE: ini adalah parameter opsional. Menentukan profil WebSphere yang digunakan di VM sumber. Format: [Liberty|Tradisional].
  • WEBSPHERE_HOME: ini adalah parameter opsional. Tentukan jalur ke penginstalan server aplikasi di VM sumber.
  • WEBSPHERE_JAVA_HOME: ini adalah parameter opsional. Tentukan jalur ke penginstalan Java di VM sumber.
  • TARGET_PROFILE: ini adalah parameter opsional. Tentukan profil WebSphere yang akan digunakan dalam penampung target. Format: [Liberty|Tradisional]. Setelan defaultnya adalah profil sumber.
  • TARGET_VERSION: ini adalah parameter opsional. Tentukan versi WebSphere yang akan digunakan dalam penampung target. Setelan defaultnya adalah versi sumber.
  • TARGET_EDITION: ini adalah parameter opsional. Tentukan edisi WebSphere yang akan digunakan di penampung target. Format: [Base|Core|Open|ND]. Setelan defaultnya adalah edisi sumber.
  • TARGET_SE: ini adalah parameter opsional. Tentukan versi Java SE yang akan digunakan di penampung target. Format: [SE8|SE11|SE17]. Setelan defaultnya adalah Java SE sumber.
  • TARGET_EE: ini adalah parameter opsional. Tentukan versi Java EE atau Jakarta EE yang akan digunakan dalam container target. Format: [EE7|EE8|EE9|EE10]. Setelan defaultnya adalah Java EE atau Jakarta EE sumber.
  • TARGET_VENDOR: ini adalah parameter opsional. Tentukan vendor Java yang akan digunakan di penampung target. Format: [IBM Corporation|Oracle Corporation]. Setelan defaultnya adalah vendor Java sumber.
  • TARGET_BASE_IMAGE: ini adalah parameter opsional. Tentukan image dasar yang akan digunakan untuk penampung target.
  • PATH_TO_BINARYAPPSCANNER: ini adalah parameter opsional. Tentukan jalur ke file binaryAppScanner.jar di komputer lokal Anda.

Setelah analisis selesai, direktori baru akan dibuat di jalur output yang ditentukan, yang berisi rencana migrasi, config.yaml.

Membuat rencana migrasi untuk workload tradisional WebSphere

Menyiapkan binerAppScanner.jar

Download versi terbaru file binaryAppScanner.jar.

Jika Anda sudah menginstal file binaryAppScanner.jar, periksa versi saat ini:

java -jar binaryAppScanner.jar --version

Kemudian, bandingkan versi saat ini dengan versi yang ditampilkan dalam lisensi IBM yang muncul saat Anda mengklik Migrasi Toolkit untuk Biner Aplikasi untuk mendownload file. Jika berbeda, download versi terbaru file binaryAppScanner.jar.

Migrate to Containers CLI mengotomatiskan penggunaan binaryAppScanner.jar, yang tersedia sebagai bagian dari Toolkit Migrasi Server Aplikasi WebSphere IBM untuk Biner Aplikasi, untuk mengekstrak informasi konfigurasi dan file untuk aplikasi Server Aplikasi WebSphere di VM sumber.

Sebelum dapat melakukan migrasi, Anda harus menyetujui perjanjian lisensi dan mendownload Toolkit Migrasi Server Aplikasi WebSphere IBM untuk Biner Aplikasi, lalu mengekstrak file binaryAppScanner.jar.

Untuk menyiapkan binaryAppScanner.jar:

  1. Download file penginstal, binaryAppScannerInstaller.jar, dari Dukungan IBM. Anda harus menyetujui perjanjian lisensi sebagai bagian dari download.

  2. Jalankan perintah berikut untuk mengekstrak file binaryAppScanner.jar dan menyetujui Perjanjian Lisensi:

    java -jar binaryAppScannerInstaller.jar --acceptLicense --verbose

  3. Tentukan direktori target untuk ekstraksi. Misalnya, jika Anda menetapkan /tmp sebagai direktori target, setelah penginstalan selesai, binaryAppScanner.jar tersedia di /tmp/wamt/binaryAppScanner.jar.

Ambil WAS_HOME

Variabel lingkungan WAS_HOME menentukan lokasi penginstalan tradisional WebSphere Application Server, seperti /opt/IBM/WebSphere/AppServer/. CLI Migrate to Containers menggunakan nilai ini untuk menemukan dan menganalisis konfigurasi tradisional WebSphere dengan benar.

Untuk mengambil nilai ini, periksa proses tradisional WebSphere Application Server yang sedang berjalan:

ps aux | grep WAS_HOME

Menjalankan analisis

Untuk melakukan analisis, jalankan perintah berikut:

./m2c analyze \
  -s PATH_TO_COPIED_FILESYSTEM \
  -p websphere-traditional-container -o ANALYSIS_OUTPUT_PATH \
  -r was-home=PATH_TO_WAS_HOME \
  --volume PATH_TO_BINARYAPPSCANNER:/binaryAppScanner.jar

Ganti kode berikut:

  • PATH_TO_COPIED_FILESYSTEM: jalur ke direktori sistem file yang disalin.
  • ANALYSIS_OUTPUT_PATH: jalur ke folder tempat Anda ingin membuat output analisis.
  • PATH_TO_WAS_HOME: jalur ke penginstalan tradisional Server Aplikasi WebSphere.
  • PATH_TO_BINARYAPPSCANNER: jalur ke file binaryAppScanner.jar. Misalnya, jika Anda menentukan /tmp sebagai direktori target, binaryAppScanner.jar akan tersedia di /tmp/wamt/binaryAppScanner.jar.

Setelah analisis selesai, direktori baru akan dibuat di jalur output yang ditentukan, yang berisi rencana migrasi, config.yaml.

Membuat rencana migrasi untuk workload JBoss

Untuk komponen aplikasi JBoss, pembuatan rencana migrasi memerlukan variabel JBOSS_HOME sebagai input.

Untuk mengambil nilai ini, periksa proses server JBoss yang berjalan:

ps aux | grep jboss.home.dir

Untuk melakukan analisis, jalankan perintah berikut:

./m2c analyze \
  -s PATH_TO_COPIED_FILESYSTEM \
  -p jboss-container \
  -o ANALYSIS_OUTPUT_PATH \
  -r jboss-home=PATH_TO_JBOSS_HOME

Ganti kode berikut:

  • PATH_TO_COPIED_FILESYSTEM: jalur ke direktori sistem file yang disalin
  • ANALYSIS_OUTPUT_PATH: jalur ke folder tempat Anda ingin membuat output analisis
  • PATH_TO_JBOSS_HOME: jalur ke penginstalan JBoss

Setelah analisis selesai, direktori baru akan dibuat di jalur output yang ditentukan, yang berisi rencana migrasi, config.yaml.

Membuat rencana migrasi untuk workload Apache

Untuk melakukan analisis, jalankan perintah berikut:

./m2c analyze \
  -s PATH_TO_COPIED_FILESYSTEM \
  -p apache-container \
  -o ANALYSIS_OUTPUT_PATH

Ganti kode berikut:

  • PATH_TO_COPIED_FILESYSTEM: jalur ke direktori sistem file yang disalin
  • ANALYSIS_OUTPUT_PATH: jalur ke folder tempat Anda ingin membuat output analisis

Setelah analisis selesai, direktori baru akan dibuat di jalur output yang ditentukan, yang berisi rencana migrasi, config.yaml.

Membuat rencana migrasi untuk workload WordPress

Untuk melakukan analisis, jalankan perintah berikut:

./m2c analyze \
  -s PATH_TO_COPIED_FILESYSTEM \
  -p wordpress-container \
  -o ANALYSIS_OUTPUT_PATH

Ganti kode berikut:

  • PATH_TO_COPIED_FILESYSTEM: jalur ke direktori sistem file yang disalin
  • ANALYSIS_OUTPUT_PATH: jalur ke folder tempat Anda ingin membuat output analisis

Setelah analisis selesai, direktori baru akan dibuat di jalur output yang ditentukan, yang berisi rencana migrasi, config.yaml.

Membuat rencana migrasi untuk layanan Windows IIS

Untuk melakukan analisis, jalankan perintah berikut:

./m2c analyze -s PATH_TO_IMAGE -p windows-iis-container -o ANALYSIS_OUTPUT_PATH

Ganti kode berikut:

  • PATH_TO_IMAGE: jalur ke disk image mesin sumber. Anda dapat menentukan lebih dari satu disk image sekaligus menggunakan beberapa tanda -s. Misalnya, -s PATH_TO_IMAGE_1 -s PATH_TO_IMAGE_2...-s PATH_TO_IMAGE_N.
  • ANALYSIS_OUTPUT_PATH: jalur ke folder tempat Anda ingin membuat output analisis.

Setelah analisis selesai, direktori baru akan dibuat di jalur output yang ditentukan, yang berisi rencana migrasi, config.yaml.

Langkah selanjutnya