本頁面由 Cloud Translation API 翻譯而成。

建立遷移計畫

在本機上建立來源機器檔案系統的複本後，下一步就是分析檔案系統，以便準備遷移計畫。接著，您可以使用遷移計畫產生遷移構件。

本頁說明為不同工作負載準備遷移計畫所需的步驟。

為 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 傳統工作負載，或在不同 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 指定為目標目錄，安裝完成後，binaryAppScanner.jar 會顯示在 /tmp/wamt/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 傳統工作負載建立遷移計畫

設定 binaryAppScanner.jar

下載最新版的 binaryAppScanner.jar 檔案。

如果您已安裝 binaryAppScanner.jar 檔案，請檢查目前的版本：

java -jar binaryAppScanner.jar --version

接著，請比較您目前的版本與 IBM 授權中顯示的版本，點選「Migration Toolkit for Application Binaries」下載檔案時，系統會顯示這項資訊。如果不同，請下載最新版本的 binaryAppScanner.jar 檔案。

Migrate to Containers CLI 可自動使用 binaryAppScanner.jar，該工具可透過 IBM WebSphere Application Server Migration Toolkit for Application Binaries 提供，用於擷取來源 VM 中 WebSphere Application Server 應用程式的設定資訊和檔案。

您必須先接受授權協議，然後下載 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 指定為目標目錄，安裝完成後，binaryAppScanner.jar 會位於 /tmp/wamt/binaryAppScanner.jar。

擷取 `WAS_HOME`

WAS_HOME 環境變數會指定 WebSphere Application Server traditional 的安裝位置，例如 /opt/IBM/WebSphere/AppServer/。Migrate to Containers CLI 會使用這個值，正確找出並分析 WebSphere 傳統設定。

如要擷取這個值，請檢查執行中的 WebSphere Application Server 傳統程序：

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 傳統安裝位置的路徑。
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 傳統工作負載建立遷移計畫

設定 binaryAppScanner.jar

擷取 WAS_HOME

執行分析

為 JBoss 工作負載建立遷移計畫

為 Apache 工作負載建立遷移計畫

建立 WordPress 工作負載的遷移計畫

為 Windows IIS 服務建立遷移計畫

後續步驟

擷取 `WAS_HOME`