移行計画を作成する

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

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

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 を設定するには:

IBM サポートからインストーラファイル binaryAppScannerInstaller.jar をダウンロードします。ダウンロードの際に、ライセンス契約に同意する必要があります。
binaryAppScanner.jar ファイルを解凍し、使用許諾契約に同意します。
```
java -jar binaryAppScannerInstaller.jar --acceptLicense --verbose INSTALL_LOCATION
```
次のように置き換えます。
- INSTALL_LOCATION: 抽出用のターゲットディレクトリ。たとえば、/tmp をターゲットディレクトリとして指定すると、インストールの完了後に /tmp/wamt/binaryAppScanner.jar で binaryAppScanner.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 を設定するには:

IBM サポートからインストーラファイル binaryAppScannerInstaller.jar をダウンロードします。ダウンロードの際に、ライセンス契約に同意する必要があります。
次のコマンドを実行して binaryAppScanner.jar ファイルを抽出し、使用許諾契約に同意します。
```
java -jar binaryAppScannerInstaller.jar --acceptLicense --verbose
```
抽出先のターゲットディレクトリを指定します。たとえば、/tmp をターゲットディレクトリとして指定すると、インストールの完了後に /tmp/wamt/binaryAppScanner.jar で binaryAppScanner.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 が保存されます。

次のステップ

次の移行計画をカスタマイズする方法を確認する。

移行計画を作成する

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

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

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

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

分析を実行する

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

binaryAppScanner.jar を設定する

WAS_HOME を取得する

分析を実行する

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

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

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

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

次のステップ

`WAS_HOME` を取得する