移行計画を作成する
ローカルマシンに移行元のファイル システムのコピーを作成したら、次のステップはファイル システムを分析して移行計画を準備することです。その後、移行計画を使用して移行アーティファクトを生成できます。
このページでは、さまざまなワークロードの移行計画を準備するために必要な手順について説明します。
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
を使用できます。
- INSTALL_LOCATION: 抽出用のターゲット ディレクトリ。たとえば、
分析を実行する
分析を行うには、次のコマンドを実行します。
./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
が保存されます。
次のステップ
- 次の移行計画をカスタマイズする方法を確認する。