移行計画を作成する

ローカルマシンに移行元のファイル システムのコピーを作成したら、次のステップはファイル システムを分析して移行計画を準備することです。その後、移行計画を使用して移行アーティファクトを生成できます。

このページでは、さまざまなワークロードの移行計画を準備するために必要な手順について説明します。

Linux VM コンテナの移行計画を作成する

分析を行うには、次のコマンドを実行します。

./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 ]

次のように置き換えます。

  • PATH_TO_COPIED_FILESYSTEM: コピーされたファイル システム ディレクトリのパス。
  • ANALYSIS_OUTPUT_PATH: 分析の出力を作成するフォルダのパス。
  • SKIP_SIZE_CHECKS: これは省略可能なパラメータです。デフォルトでは、false に設定されています。Migrate to Containers CLI は、イメージレイヤをチェックし、サイズが 15 GB を超えていないことを確認します。イメージレイヤの合計サイズが 15 GB を超えると、アーティファクトの生成に失敗し、Migrate to Containers CLI にエラー メッセージが表示されます。このサイズチェックをスキップするには、このパラメータを true に設定します。
  • SIZE_IN_MB: これは省略可能なパラメータです。ファイルサイズのしきい値を MB 単位で指定し、指定したサイズを超えるファイルがないかをチェックします。指定されたサイズしきい値を超えるファイルが検出された場合、Migrate to Containers CLI は生成された移行計画にコメントを追加し、検出されたファイルをコンテナ イメージから除外することを提案します。

分析が完了すると、指定された出力パスに新しいディレクトリが作成され、そこに移行計画 config.yaml が保存されます。

Tomcat ワークロードの移行計画を作成する

Tomcat アプリ コンポーネントの場合、このプロセスには入力として catalina-home パスと catalina-base パスが必要です。

これらの値を取得するには、実行中の Tomcat サーバー プロセスを確認します。

ps aux | grep catalina

分析を行うには、次のコマンドを実行します。

./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

次のように置き換えます。

  • PATH_TO_COPIED_FILESYSTEM: コピーされたファイル システム ディレクトリのパス
  • ANALYSIS_OUTPUT_PATH: 分析の出力を作成するフォルダのパス
  • PATH_TO_CATALINA_HOME: Tomcat インストールのルートのパス
  • PATH_TO_CATALINA_BASE: 移行する Tomcat インスタンスのランタイム構成のルートのパス。複数のベースを区切る場合は、コロンを使用します。
  • JAVA_VERSION: コンテナの Java のバージョン(X.Y 形式)。デフォルトの Java バージョンは 11.0 です。

分析が完了すると、指定された出力パスに新しいディレクトリが作成され、そこに移行計画 config.yaml が保存されます。

WebSphere ワークロードの移行計画を作成する

省略可: binaryAppScanner.jar を設定する

WebSphere traditional ワークロードを移行する場合、または異なる Java 環境間で移行を行う場合は、binaryAppScanner.jar を設定できます。Migrate to Containers CLI は、binaryAppScanner.jar の使用を自動化して新しい WebSphere 構成を生成し、Java ランタイムのモダナイゼーションを容易にします。

binaryAppScanner.jar を設定するには:

  1. IBM サポートからインストーラ ファイル binaryAppScannerInstaller.jar をダウンロードします。ダウンロードの際に、ライセンス契約に同意する必要があります。

  2. binaryAppScanner.jar ファイルを解凍し、使用許諾契約に同意します。

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

    次のように置き換えます。

    • INSTALL_LOCATION: 抽出用のターゲット ディレクトリ。たとえば、/tmp をターゲット ディレクトリとして指定すると、インストールの完了後に /tmp/wamt/binaryAppScanner.jarbinaryAppScanner.jar を使用できます。

分析を実行する

分析を行うには、次のコマンドを実行します。

./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

次のように置き換えます。

  • PATH_TO_COPIED_FILESYSTEM: コピーされたファイル システム ディレクトリのパス。
  • ANALYSIS_OUTPUT_PATH: 分析の出力を作成するフォルダのパス。
  • WEBSPHERE_PROFILE: これは省略可能なパラメータです。ソース VM で使用される WebSphere プロファイルを指定します。形式: [Liberty|Traditional]
  • WEBSPHERE_HOME: これは省略可能なパラメータです。移行元 VM にあるアプリケーション サーバーのインストール パスを指定します。
  • WEBSPHERE_JAVA_HOME: これは省略可能なパラメータです。移行元 VM にある Java のインストール パスを指定します。
  • TARGET_PROFILE: これは省略可能なパラメータです。ターゲット コンテナで使用する WebSphere プロファイルを指定します。形式: [Liberty|Traditional]デフォルトはソース プロファイルです。
  • TARGET_VERSION: これは省略可能なパラメータです。ターゲット コンテナで使用する WebSphere のバージョンを指定します。デフォルトはソース バージョンです。
  • TARGET_EDITION: これは省略可能なパラメータです。ターゲット コンテナで使用する WebSphere のエディションを指定します。形式は [Base|Core|Open|ND] です。デフォルトはソースのエディションです。
  • TARGET_SE: これは省略可能なパラメータです。ターゲット コンテナで使用する Java SE のバージョンを指定します。形式は [SE8|SE11|SE17] です。デフォルトはソースの Java SE です。
  • TARGET_EE: これは省略可能なパラメータです。ターゲット コンテナで使用する Java EE または Jakarta EE のバージョンを指定します。形式は [EE7|EE8|EE9|EE10] です。デフォルトはソース Java EE または Jakarta EE です。
  • TARGET_VENDOR: これは省略可能なパラメータです。ターゲット コンテナで使用する Java ベンダーを指定します。形式は [IBM Corporation|Oracle Corporation] です。デフォルトはソース Java ベンダーです。
  • TARGET_BASE_IMAGE: これは省略可能なパラメータです。ターゲット コンテナに使用するベースイメージを指定します。
  • PATH_TO_BINARYAPPSCANNER: これは省略可能なパラメータです。ローカルマシン上の binaryAppScanner.jar ファイルのパスを指定します。

分析が完了すると、指定された出力パスに新しいディレクトリが作成され、そこに移行計画 config.yaml が保存されます。

WebSphere traditional ワークロードの移行計画を作成する

binaryAppScanner.jar を設定する

binaryAppScanner.jar ファイルの最新バージョンをダウンロードします。

binaryAppScanner.jar ファイルがすでにインストールされている場合は、現在のバージョンを確認します。

java -jar binaryAppScanner.jar --version

次に、[Migration Toolkit for Application Binaries] をクリックして、ファイルをダウンロードする際に表示される IBM ライセンスのバージョンと比較します。これらが異なる場合は、binaryAppScanner.jar ファイルの最新バージョンをダウンロードしてください。

Migrate to Containers CLI は、IBM WebSphere Application Server Migration Toolkit for Application Binaries の一部として利用可能な binaryAppScanner.jar の使用を自動化し、ソース VM 内の WebSphere アプリケーション サーバー アプリケーションの構成情報とファイルを抽出します。

移行を行う前に、使用許諾契約に同意し、IBM WebSphere Application Server Migration Toolkit for Application Binaries をダウンロードして、binaryAppScanner.jar ファイルを抽出する必要があります。

binaryAppScanner.jar を設定するには:

  1. IBM サポートからインストーラ ファイル binaryAppScannerInstaller.jar をダウンロードします。ダウンロードの際に、ライセンス契約に同意する必要があります。

  2. 次のコマンドを実行して binaryAppScanner.jar ファイルを抽出し、使用許諾契約に同意します。

    java -jar binaryAppScannerInstaller.jar --acceptLicense --verbose
    
  3. 抽出先のターゲット ディレクトリを指定します。たとえば、/tmp をターゲット ディレクトリとして指定すると、インストールの完了後に /tmp/wamt/binaryAppScanner.jarbinaryAppScanner.jar を使用できます。

WAS_HOME を取得する

WAS_HOME 環境変数は、WebSphere Application Server traditional がインストールされている場所(/opt/IBM/WebSphere/AppServer/ など)を指定します。Migrate to Containers CLI では、この値を使用して Websphere traditional の構成を検出し、分析します。

この値を取得するには、動作している WebSphere Application Server traditional のプロセスを確認します。

ps aux | grep WAS_HOME

分析を実行する

分析を行うには、次のコマンドを実行します。

./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

次のように置き換えます。

  • PATH_TO_COPIED_FILESYSTEM: コピーされたファイル システム ディレクトリのパス。
  • ANALYSIS_OUTPUT_PATH: 分析の出力を作成するフォルダのパス。
  • PATH_TO_WAS_HOME: WebSphere Application Server traditional のインストール パス。
  • PATH_TO_BINARYAPPSCANNER: binaryAppScanner.jar ファイルのパス。たとえば、ターゲット ディレクトリとして /tmp を指定した場合、binaryAppScanner.jar/tmp/wamt/binaryAppScanner.jar で使用できます。

分析が完了すると、指定された出力パスに新しいディレクトリが作成され、そこに移行計画 config.yaml が保存されます。

JBoss ワークロードの移行計画を作成する

JBoss アプリ コンポーネントの場合、移行計画を作成するには、入力として JBOSS_HOME 変数が必要です。

この値を取得するには、実行中の JBoss サーバー プロセスを確認します。

ps aux | grep jboss.home.dir

分析を行うには、次のコマンドを実行します。

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

次のように置き換えます。

  • PATH_TO_COPIED_FILESYSTEM: コピーされたファイル システム ディレクトリのパス
  • ANALYSIS_OUTPUT_PATH: 分析の出力を作成するフォルダのパス
  • PATH_TO_JBOSS_HOME: JBoss インストールのパス

分析が完了すると、指定された出力パスに新しいディレクトリが作成され、そこに移行計画 config.yaml が保存されます。

Apache ワークロードの移行計画を作成する

分析を行うには、次のコマンドを実行します。

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

次のように置き換えます。

  • PATH_TO_COPIED_FILESYSTEM: コピーされたファイル システム ディレクトリのパス
  • ANALYSIS_OUTPUT_PATH: 分析の出力を作成するフォルダのパス

分析が完了すると、指定された出力パスに新しいディレクトリが作成され、そこに移行計画 config.yaml が保存されます。

WordPress ワークロードの移行計画を作成する

分析を行うには、次のコマンドを実行します。

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

次のように置き換えます。

  • PATH_TO_COPIED_FILESYSTEM: コピーされたファイル システム ディレクトリのパス
  • ANALYSIS_OUTPUT_PATH: 分析の出力を作成するフォルダのパス

分析が完了すると、指定された出力パスに新しいディレクトリが作成され、そこに移行計画 config.yaml が保存されます。

Windows IIS サービスの移行計画を作成する

分析を行うには、次のコマンドを実行します。

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

次のように置き換えます。

  • PATH_TO_IMAGE: ソースマシンのディスク イメージのパス。複数の -s フラグを使用して、一度に複数のディスク イメージを指定できます。例: -s PATH_TO_IMAGE_1 -s PATH_TO_IMAGE_2...-s PATH_TO_IMAGE_N
  • ANALYSIS_OUTPUT_PATH: 分析の出力を作成するフォルダのパス。

分析が完了すると、指定された出力パスに新しいディレクトリが作成され、そこに移行計画 config.yaml が保存されます。

次のステップ