对迁移进行故障诊断

如果您的部署环境未成功迁移,您可以采用多个步骤来解决问题。

请考虑以下可能性:
  • 可能发生了 SOAP 调用超时
  • 目标环境的迁移命令可能由于其他原因而失败。您可以针对特定命令行实用程序启用跟踪,然后重新运行这些特定命令,以对某些故障进行诊断。

如果在源环境上运行了所有迁移命令,并在迁移失败之前创建了 Snapshot,那么无需从头开始重新运行所有迁移命令。如果在目标环境上迁移失败(例如,在数据库升级步骤上或者在运行 BPMMigrate命令时),那么您可以恢复数据库,然后仅在目标环境上重新运行这些命令。

SOAP 调用超时

如果您使用 SOAP 连接,那么完成迁移命令所需的时间可能超过指定的 SOAP 超时值。您可能会看到类似如下的异常:java.net.SocketTimeoutException: Read timed out

为预防出现此问题,请在 soap.client.props 文件中修改 com.ibm.SOAP.requestTimeout 属性的值。
  • 如果您在源环境所在的计算机上安装产品的新版本,那么可在 BPM_home_8.5/util/migration/resources/ 中找到此文件。
  • 如果您在其他计算机上安装了产品的新版本,并将迁移文件复制到源环境中,那么可在 remote_migration_utility/util/migration/resources/ 中找到此文件。

启用跟踪

要对迁移失败的原因进行诊断,可以启用跟踪,然后重新运行命令。 要针对迁移命令启用跟踪,请完成以下步骤:
  1. 找到 logging.properties 文件。
    对于 DBUpgrade 命令行实用程序,该文件位于 BPM_home_8.5/util/dbUpgrade 中。例如:
    • 针对 Linux 操作系统针对 UNIX 操作系统/opt/ibm/WebSphere/AppServer/util/dbUgrade/logging.properties
    • 针对 Windows 操作系统C:\bpm 85\util\dbUpgrade\logging.properties
    对于以下命令行实用程序:
    • BPMExtractDBConfiguration
    • BPMExtractSourceInformation
    • BPMManageApplications
    • BPMMergeFileRegistry
    • BPMMigrate
    该文件位于 BPM_home_8.5/util/migration/resources 中。 例如:
    • 针对 Linux 操作系统针对 UNIX 操作系统/opt/ibm/WebSphere/AppServer/util/migration/resources/logging.properties
    • 针对 Windows 操作系统C:\bpm 85\util\migration\resources\logging.properties
  2. logging.properties 文件中设置日志级别。 对于全局日志记录级别和文件输出日志级别,缺省日志级别均为 FINE。将这两个属性均更改为 FINEST,以在日志中捕获更多的详细信息。例如:
    # default global logging level. Logging level possible values: FINEST, FINER, FINE, INFO, WARNING, SEVERE.
    .level = FINEST
    # file output properties
    com.ibm.bpm.migration.logging.NonBlockingFileHandler.level = FINEST 

如果以下任何命令出现异常,请将日志级别更改为 FINEST,重新运行该命令,然后检查结果,如针对每条命令所述。