Membuat rencana migrasi

Setelah membuat salinan sistem file mesin sumber di mesin 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 output analisis dibuat.
  • SKIP_SIZE_CHECKS: ini adalah parameter opsional. Secara default, nilai ini ditetapkan ke false dan CLI Migrate to Containers memeriksa lapisan gambar untuk memastikan ukurannya tidak melebihi 15 GB. Jika jumlah total lapisan gambar melebihi 15 GB, pembuatan artefak akan gagal dan CLI Migrate to Containers akan menampilkan pesan error. Untuk melewati pemeriksaan ukuran ini, tetapkan parameter ini ke true.
  • SIZE_IN_MB: ini adalah parameter opsional. Tentukan nilai minimum ukuran file, dalam MB, untuk memeriksa file yang melebihi ukuran tertentu. Jika Migrate to Containers CLI mendeteksi file dengan ukuran yang melebihi nilai minimum 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 sedang 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 output analisis dibuat
  • 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 binaryAppScanner.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 menentukan /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 output analisis dibuat.
  • WEBSPHERE_PROFILE: ini adalah parameter opsional. Tentukan profil WebSphere yang digunakan di VM sumber. Format: [Liberty|Traditional].
  • 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 di penampung target. Format: [Liberty|Traditional]. Setelan defaultnya adalah profil sumber.
  • TARGET_VERSION: ini adalah parameter opsional. Tentukan versi WebSphere yang akan digunakan di 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 di penampung 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 binaryAppScanner.jar

Download file binaryAppScanner.jar versi terbaru.

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

java -jar binaryAppScanner.jar --version

Kemudian, bandingkan versi Anda saat ini dengan versi yang ditampilkan dalam lisensi IBM yang muncul saat Anda mengklik Migration Toolkit for Application Binaries untuk mendownload file. Jika berbeda, download versi terbaru file binaryAppScanner.jar.

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

Sebelum dapat melakukan migrasi, Anda harus menyetujui perjanjian lisensi dan mendownload IBM WebSphere Application Server Migration Toolkit for Application Binaries, 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 menentukan /tmp sebagai direktori target, setelah penginstalan selesai, binaryAppScanner.jar akan tersedia di /tmp/wamt/binaryAppScanner.jar.

Mengambil WAS_HOME

Variabel lingkungan WAS_HOME menentukan tempat WebSphere Application Server tradisional diinstal, seperti /opt/IBM/WebSphere/AppServer/. Migrate to Containers CLI 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 output analisis dibuat.
  • PATH_TO_WAS_HOME: jalur ke penginstalan WebSphere Application Server tradisional.
  • 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 sedang 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 output analisis dibuat
  • 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 output analisis dibuat

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 output analisis dibuat

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 image disk mesin sumber. Anda dapat menentukan lebih dari satu image disk sekaligus menggunakan beberapa flag -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 output analisis dibuat.

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

Langkah selanjutnya