创建迁移计划
在本地机器上创建源机器文件系统的副本后,下一步是分析文件系统以准备迁移计划。然后,迁移计划可用于生成迁移工件。
本页面介绍了为不同工作负载准备迁移计划所需的步骤。
为 Linux 虚拟机容器创建迁移计划
如需执行分析,请运行以下命令:
./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
中。
- 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:这是一个可选参数。请指定源虚拟机中使用的 WebSphere 配置文件。格式:[Liberty|Traditional]。
- WEBSPHERE_HOME:这是一个可选参数。请指定源虚拟机中应用服务器安装的路径。
- WEBSPHERE_JAVA_HOME:这是一个可选参数。请指定源虚拟机中 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
然后,将当前版本与点击 Migration Toolkit for Application Binaries 下载文件后出现的 IBM 许可中显示的版本进行比较。如果它们不同,请下载最新版本的 binaryAppScanner.jar
文件。
Migrate to Containers CLI 会自动使用 binaryAppScanner.jar
(作为 IBM WebSphere Application Server Migration Toolkit for Application Binaries 的一部分提供)来为源虚拟机中的 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 传统版的安装位置,例如 /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
。
后续步骤
- 了解如何自定义以下各项的迁移计划: