BPMMigrationPreValidation 命令行实用程序

在线编辑

使用 BPMMigrationPreValidation 命令行实用程序来检查迁移准备情况。此命令将确保您的源环境处于正确状态，可进行迁移。此命令还会告知您在迁移后必须进行的更改。

BPMMigrationPreValidation 命令将查找源环境中必须在迁移前解决的潜在问题，并告知您在迁移后必须进行的更改。该命令将执行以下验证：

概要文件验证：
- 验证迁移是否支持源产品和版本
- 验证 IBM® Business Process Manager 应用程序的状态
- 验证所有 IBM BPM 数据源的连接状态
- 验证 IBM BPM 消息传递引擎的状态
- 执行以下检查：
  - 所有现有服务集成总线 (SIB) 消息是否在一个事务中
  - 是否有太多的 SIB 消息停滞在队列中
  - 是否存在任何未处理的失败事件
- 通知您在迁移后必须进行的更改，包括以下更改：
  - 由于已在源环境中进行添加而未迁移的认证别名
  - 由于已在源环境中进行添加而未迁移的数据源
- 通知您迁移期间发生的关键更改，包括以下更改：
  - 安全性更改
  - XML 配置属性文件的更改。某些 XML 安全性配置属性将自动移至 WebSphere® Application Server 配置文件。这些属性将导出到属性文件，并将在运行该命令时移至 WebSphere Application Server 配置文件。请参阅迁移到 WebSphere Application Server 配置文件的WebSphere Lombardi Edition XML 配置属性中的表，以获取已移动的属性的列表。
- 通知您在迁移后可能需要修订的当前配置，包括以下配置：
  - XML 配置属性文件
  - 轻量级第三方认证 (LTPA) 密钥文件
  - 拓扑信息
数据库验证：
- 通知您数据量是否会延长迁移所需的停机时间
- 检查定制索引
- 分析迁移影响表，并在需要时建议可在迁移前执行的操作
- 检查日志文件大小是否足够，如果大小不足，可提供用于更新日志文件大小的命令
- 检查 Business Space 表中的记录是否有效。
- 提醒您检查 oobLoadedStatus.properties 文件。

运行该命令之后，转至您所指定的报告目录，然后在浏览器中打开 index.html 文件以查看报告。如果看到验证错误或警告，单击该行即可查看问题的详细信息以及在迁移之前解决这些错误或警告所需要采取的步骤。

先决条件

必须满足以下条件：

确保在运行此命令前运行部署环境或独立服务器。
用户名和密码取自 migration.properties 文件。此用户名必须具有各种 WebSphere 特权。 WebSphere 主管理用户拥有所有权限。在源环境中，您可以通过转至用户和组 > 管理用户角色在管理控制台中找到主管理用户名。

位置

BPMMigrationPreValidation 命令行实用程序位于 install_root_23.0.2/bin 目录中。

如果已在其他计算机上安装产品的新版本，并且已将迁移文件复制到源环境，那么此命令位于源计算机上的 remote_migration_utility/bin 中。

如果未使用远程迁移实用程序，那么日志文件位于 install_root_23.0.2/logs/migration中。

如果您要使用远程迁移实用程序，那么该日志文件位于 remote_migration_utility/logs/migration 中。

语法

install_root_23.0.2/bin/BPMMigrationPreValidation 
-propertiesFile path_to_migration_properties_file 
-reportDir path_to_report_package

参数

-propertiesFile

必须参数，用于指定源迁移属性文件（在其中指定源环境的配置信息）的完整路径。

如果在与源环境相同的计算机上安装了产品的新版本，那么可在 install_root_23.0.2/util/migration/resources/migration.properties中找到样本文件。
如果在其他计算机上安装了产品的新版本，并且已将迁移文件复制到源环境，那么该样本文件位于 remote_migration_utility/util/migration/resources/migration.properties 中。

您必须检查该文件中的所有属性，并根据需要进行编辑。

-reportDir

必需参数，它指定用于存储验证报告的目录的路径。

-help

提供命令用法的可选参数。

示例

BPMMigrationPreValidation.sh -propertiesFile /opt/BPM23.0.2/util/migration/resources/source_migration.properties -reportDir /BPM751_precheck_report

BPMMigrationPreValidation.bat -propertiesFile "C:\BPM 23.0.2\util\migration\resources\source_migration.properties" -reportDir E:\BPM751_precheck_report