迁移注意事项

在开始迁移到 WebSphere® Application Server V 9.0之前，需要了解一些注意事项。

受支持的配置:

本主题阐述概要文件配置迁移。 要将应用程序迁移到最新版本，请使用 WebSphere Application Server Migration Toolkit。

AIX®， HP-UX， IBM® i， Linux®， Solaris 和 Windows 操作系统的注意事项

在迁移应用程序服务器之前，应先注意以下信息：
  • 在执行迁移之前，请评估 WebSphere Application Server V 9.0中不推荐使用的项。

    有关更多信息，请参阅 不推荐，已稳定，已取代和已移除的功能部件。

  • 配置迁移工具不会转换应用程序或使应用程序与新的 Java SDK 级别相兼容。 在迁移到新的 Java SDK 之前，请先使用 WebSphere Application Server Migration Toolkit 对应用程序进行评估以了解可能需要进行的任何更改，并在进行任何必要更新之后测试应用程序。 请参阅 WebSphere Migration Knowledge Collection: Migration to Liberty。

    请参阅 迁移 API 和规范 以获取更多信息。

  • 迁移工具会创建一个含有旧版本中配置的备份副本的迁移备份目录，该备份目录的大小等于旧概要文件中配置目录及应用程序再加上跟踪文件的大小。 此外，系统必须具有用于目标概要文件的空间，目标概要文件在迁移之后将与源概要文件的大小相同。

    系统要求备份目录具有的存储容量取决于您的环境和使用的迁移工具。

    • 位置：备份目录，以 WASPreUpgrade 和 WASPostUpgrade 命令的参数形式指定
    • 数量：要估算使用这些命令时的存储需求，请将下列数量相加。
      • 先前配置中所有概要文件的下列项的大小：
        • profile_root/installableApps 目录
        • profile_root/installedApps 目录
        • profile_root/config 目录
        • profile_root/properties 目录
        • 在 libraries.xml 配置文件中引用的共享库
        • 在 resources.xml 配置文件中引用的资源适配器归档 (RAR) 文件
      • 如果启用了跟踪，请为跟踪文件预留足够的空间，该空间取决于配置的大小和复杂程度。
  • 如果使用隔离的数据存储库 (尤其是非共享数据存储库，例如 SIB 和 Apache Derby 数据库的事务日志) ，并且从先前发行版进行迁移，那么在运行 WASPreUpgrade 命令时将保存现有数据库和事务日志。 您在运行 WASPreUpgrade 命令之后对数据库进行的任何更改不会反映在已迁移的环境中。
    • 如果有存储在这些本地数据存储库中的任务关键信息，那么应在尝试进行迁移前，安全地关闭与那些存储库交互的所有服务器。 在迁移成功完成或回滚之前，那些服务器应保持脱机。
    • 如果进行了多次迁移尝试，那么无论是因为意外回滚还是应用修订，都请重新运行 WASPreUpgrade 命令以使对独立数据存储库进行的任何更改反映在已迁移的环境中。
    在迁移已完成或已回滚至先前版本之后，可以重新启动与这些独立数据存储库交互的服务器。
  • 如果 SIB 对消息传递引擎中的一个或全部使用文件存储选项，请不要迁移有活动服务器的节点。
    • [Windows]尝试在活动应用程序服务器上复制文件存储器时， WASPreUpgrade 命令失败，发生文件锁定异常。
    • [Linux][AIX] WASPreUpgrade 命令复制锁定的文件，这可能会影响数据一致性。
    对热迁移而言，消息传递引擎的数据存储器是一种选择；但是如果必须使用文件存储器，那么就不应运行服务器。
  • [Windows]如果尝试运行 WASPreUpgrade 命令以从版本 6.1 迁移，但拥有 SIB 文件存储器的节点和应用程序服务器仍在运行，那么可能会发生类似如下的错误:
    C:\was80A\bin>WASPreUpgrade c:\bkupWAS6.1.0.17June30B C:\was61B 
MIGR0385I: Starting to save profile AppSrv01. 
MIGR0215W: 迁移功能无法复制文件并打开目标文件 
c:\bkupWAS6.1.0.17June30B\migrated\C_\FSJune19\Log. 
MIGR0272E: The migration function cannot complete the command.
    如果您随后关闭该应用程序服务器和节点，那么 WASPreUpgrade 命令完成。
  • 在迁移 Apache Derby 数据库之前，确保正在使用 Apache 数据库的主管应用程序的任何应用程序服务器都已关闭。 否则，Apache Derby 迁移将失败。
  • 禁用凭证提示的过程已更改。

    要在 V 9.0中禁用凭证提示，请配置 ipc.client.props 以在从 V 6.1 迁移到 V 9.0之前禁用凭证提示。

  • 在迁移期间，某些应用程序元数据可能会被复位为缺省值，从而导致应用程序未按预期运行。

    如果在旧环境（使用来自二进制文件的元数据设置为 true）中安装了应用程序，并且在安装期间或在该应用程序以后的更新中对该应用程序的元数据（例如，JNDI 资源引用或数据库入口）进行了更改，那么该更改在迁移时可能会丢失。

    当使用来自二进制文件的元数据设置为 true 时，管理代码仅更新二进制 EAR 文件中的元数据。 此选项在混合单元中不受支持；因此，在迁移时它将自动变为 false。 发生此情况时，配置目录中经扩展的元数据优先于二进制 EAR 文件中的值。 这将导致来自原始 EAR 文件安装的值优先于您可能已进行的任何更新。

    请执行下列其中一项操作以解决此问题：
    • 在迁移之前，更新旧环境中的应用程序并将使用来自二进制文件的元数据设置为 false。 确保这些应用程序在新设置下能够正常工作，然后运行迁移。
    • 在迁移之后，更新应用程序并更正要使应用程序正常工作所必需的元数据。
  • 使用迁移工具迁移到 WebSphere Application Server V 9.0之后，可能需要执行迁移工具未自动执行的一些操作。
    • 检查您可能在 WebSphere Application Server V 7.0 或更高版本中使用的任何轻量级第三方认证 (LTPA) 安全性设置，并验证是否正确设置了 V 9.0 安全性。

      有关更多信息，请参阅 轻量级第三方认证 。

    • 检查 logs 目录中的 WASPostUpgrade.log 文件，以了解有关迁移工具未迁移的任何 JavaServer Pages (JSP) 对象的详细信息。

      如果 V 9.0 不支持为其配置 JSP 对象的级别，那么迁移工具会识别输出中的对象并记录这些对象。

    • 查看 Java™ 虚拟机 (JVM) 设置，以验证您是否正在使用至少 50 的堆大小来提高启动性能。

      有关更多信息，请参阅 Java 虚拟机设置 。

      如果以前使用较小的堆大小，那么现在可以使用缺省堆大小 50。

    • 验证自动执行的 Apache Derby 数据库迁移操作的结果，并手动迁移该工具未自动迁移的任何 Apache Derby 数据库。

      有关更多信息，请参阅 迁移 Apache Derby 数据库 。