迁移到 WebSphere Application Server V6.1 快速指南

引言

本文旨在帮助您着手将 IBM WebSphere Application Server 版本 5.0.x、5.1.x 或 6.0.x 迁移到 WebSphere Application Server 版本 6.1。本文简要概述了 WebSphere Application Server V6.1 迁移工具及其使用，并综述了在从特定版本（单台服务器和托管计算单元）迁移时需要注意的一些特殊事项。有关迁移过程中每个步骤的详细信息，请参见 WebSphere Application Server V6.1 信息中心。

本文档使用的术语

在开始之前，我们先介绍一下本文使用的一些术语的定义：

回页首

跨 WebSphere Application Server 迁移支持

对于 WebSphere Application Server V6.1 支持的所有操作系统，基本迁移支持和工具套件都是相同的。此工具套件的基本内容在运行命令行工具中进行了描述。不过，为每个操作系统提供的界面各不相同，而且有些特征是某些操作系统所独有的。下面简要概述了该支持：

z/OS

将 WebSphere Application Server for z/OS 迁移到 V6.1 涉及自定义一组批处理作业，然后运行这些作业来迁移节点。自定义过程是通过一组 ISPF 对话框完成的。计算单元中的每个节点均将有自己的自定义作业；并且逐节点迁移计算单元，首先从 Deployment Manager 节点开始。

在 z/OS 上支持的唯一迁移界面是 ISPF 对话框。z/OS 操作系统的独有特征以及针对 z/OS 的迁移步骤在以下白皮书中进行了介绍：Migrating to WebSphere Application Server for z/OS Version 6.1。此白皮书以及 WebSphere Application Server V6.1 信息中心中的信息很好地描述了对 z/OS 的迁移支持。本文不再赘述相关信息。

i5/OS

将 WebSphere Application Server for i5/OS 迁移到 V6.1 涉及调用一些工具，这些工具在运行命令行工具部分中进行了描述。在 i5/OS 上支持的唯一迁移界面是这些命令行工具。使用本文提供的信息可以指导您进行 i5/OS 迁移，但是请注意，迁移向导部分中描述的支持对 i5/OS 不可用。

分布式平台

分布式平台实际上包括 WebSphere Application Server 支持的所有操作系统，但 z/OS 和 i5/OS 除外。请参阅 WebSphere Application Server V6.1 支持的软件列表，以查看这些操作系统及其系统要求的完整列表。这些操作系统通过使用命令行工具或迁移向导进行支持。

回页首

1. 准备迁移

该部分介绍在将以前版本的 WebSphere Application Server 迁移到 V6.1 之前需要注意的一些重要问题。除非有特殊说明，该部分讨论的所有要点均适用于从 V5 或 V6 迁移的情形。

1. 确认必备的软件级别。请参阅 WebSphere Application Server V6.1 支持的软件列表，了解您的操作系统和关联软件所需的最低版本和修复程序级别要求。如果您现有的 WebSphere Application Server V5 或 V6 安装在不能满足 V6.1 的先决条件的操作系统（例如 AIX® 5.1 或 Sun™ Solaris™ 8）上，则需要先升级操作系统，才能在您的系统上安装 WebSphere Application Server V6.1。

2. 收集信息。在使用命令行工具着手执行迁移过程之前，务必记下 V5 或 V6 计算单元的名称，以及计算单元中所有节点的名称。在为计算单元中的每个节点创建 V6.1 概要时将需要这些值。概要将在下一部分中详细讨论。

3. 备份您的环境。在尝试任何迁移之前一定要备份您的 WebSphere Application Server 环境。这在执行增量计算单元升级时尤其重要。可以使用备份工具来保存当前环境；要了解这方面的详细信息，请查看 V5 或 v6 信息中心中与 backupConfig 实用工具相关的文章（请参阅参考资料）。

4. 完整保留以前版本的 WebSphere Application Server。这一点无需着重强调：不要卸载现有的 WebSphere Application Server V5 或 V6 配置，按原样保留即可。WebSphere Application Server V6.1 可以与这些以前版本安全地共存——假定在同一时间仅运行 WebSphere Application Server 的一个版本。除在迁移的第一步中需要这样做之外，完整保留以前版本的 WebSphere Application Server 还能在需要或必要时将您的环境回滚到以前的版本。

回页首

2. 安装 WebSphere Application Server V6.1

相对于 V5 的安装过程，V6.1 的安装过程发生了一些变化。一个重要的变化是迁移过程与安装程序分开了。上文已经提到，在安装 V6.1 之后，迁移向导（仅用于分布式操作环境）将指导您执行迁移过程。如果以前使用“静默”(Silent) 选项来安装并迁移以前的版本，您仍可以以静默方式安装，但在安装之后需要手动使用迁移命令行工具。

在 V6 和 V6.1 中新增了概要概念，概要是 WebSphere Application Server 配置和应用程序文件集的独立实例。从本质上说，概要可以实现仅通过 WebSphere Application Server 核心二进制文件的一个副本来保存 V6.1 的多个配置。概要提供了对 V5 实例的改进，而且 V6.1 提供的新工具可用于创建和管理这些概要。

您将使用 FirstSteps 工具来访问 Profile Management 工具，如图 1 所示。

图 1. Profile Management 工具

在 WebSphere Application Server Network Deployment V6.1（以下称为 Network Deployment）中，一共有三种类型的概要：

• 部署管理器
• 自定义
• 应用服务器。

只有应用服务器概要在其他版本的 WebSphere Application Server V6.1 中提供。图 1 显示了 Network Deployment Profile Management 工具，其中有四种预定义的概要布局（称为环境）可供选择。

在运行迁移向导之前无需提供概要。但是，如果您计划使用迁移命令行工具，则需要为您的环境创建概要。

在为从以前版本进行迁移而创建概要时，某些特定的值在以前版本和新版本之间必须匹配。具体来说，在将部署管理器迁移到 V6.1 时，V6.1 概要的计算单元名称值必须与 V5 或 V6 的计算单元名称值匹配；在迁移到 V6.1 的联合节点时，V6.1 概要的节点名称必须与以前版本的联合节点的节点名称匹配，等等。对于不属于计算单元的节点（例如独立系统），V6.1 概要对其没有此类命名要求。如果您使用迁移向导或 z/OS 自定义作业来创建概要并进行迁移，则将为您自动填充这些值。

对于 Network Deployment 迁移，概要必须按以下特定顺序进行迁移：

1. 部署管理器概要。在迁移计算单元时必须首先迁移此概要。V6.1 迁移的部署管理器概要可以管理计算单元中的所有 V5 和 V6.0.2.x 节点。WebSphere Application Server V6.1 将迁移的部署管理器限制为，仅让其管理在迁移之前位于计算单元中的 V5 节点。具体来说，V5 节点不能联合到 V6.1 部署管理器中——但可以将 V6.0.2.x 节点添加到 V6.1 部署管理器中。对于 V5 用户，部署管理器概要类似于 WebSphere Application Server Network Deployment V5 和部署管理器安装。每个计算单元必须正好具有一个部署管理器。

2. 自定义概要。此概要非常适合于联合节点迁移。没有为此概要创建缺省的应用程序或应用服务器。以前版本的每个节点都可以正好迁移到一个自定义概要。如果具有较大的 V5 或 V6 计算单元，则可以一次迁移多个节点。这些节点将成为 V6.1 计算单元的成员，并且可以在任何时候迁移到 V6.1 节点。

3. 应用服务器概要。此概要类似于 V5 中安装的单个节点。此概要是使用名为 server1 的应用服务器和若干缺省应用程序创建的。

回页首

3. 执行迁移

下面要执行的步骤取决于您选择的迁移方法。可选的迁移方法有：

1. 运行迁移向导或者
2. 运行命令行工具。

3a.运行迁移向导

迁移向导是一种新的迁移方法，并针对 V6.1 进行了改进，它替代了作为 Application Server V5 安装程序一部分的迁移面板。迁移向导对 i5/OS 或 z/OS 平台不可用。可以在 FirstSteps 面板中找到迁移向导。要运行迁移向导，请执行下列步骤：

1. 从概要目录启动 FirstSteps（如果存在），例如：C:\WebSphere\AppServer\profiles\default\。在 Windows® 上，您可以从概要目录的 firststeps 文件夹或从开始菜单启动 FirstSteps。

2. 在启动 FirstSteps 之后，请选择 Migration wizard 开始迁移过程（图 2）。

   
   
   图 2. Firststeps 面板
   
   
   

3. 在显示 Welcome 面板之后，从检测到的版本列表中选择需要迁移的 WebSphere Application Server 的以前版本（图 3）。确保以前版本的位置正确非常重要，可以验证 Installation root directory of the previous version 字段中显示的位置。如果向导没有检测到要迁移的以前版本，请在首先选中 Specify the installation location if your existing product is not listed 之后使用此字段指定其位置。

   
   
   图 3. WebSphere Application Server 检测到的版本
   
   
   

4. 选择需要迁移的以前版本中的概要（图 4）。对于 V5，通常迁移 defaultinstance；但是，如果您创建了多个实例，则可以选择其他 V5 实例中的任何一个。对于 V6，您可以选择要迁移的概要，但是请记住，部署管理器必须始终在联合节点之前进行迁移。

   
   
   图 4. 源概要选择面板
   
   
   

5. 如果您定义了一个或多个概要，例如，同一系统上的 V6.1 部署管理器和 V6.1 节点概要，则必须选择要用作目标概要的概要（图 5）。如果尚未创建 V6.1 概要，迁移向导可以为您创建一个（通过选择 <Create new profile>）。

   
   
   图 5. 目标概要选择面板
   
   
   

6. 如果想让迁移向导创建一个概要，则会显示如图 6 所示的面板。迁移向导将在必填字段中填入适当的值；例如，如果您要迁移部署管理器，则向导将从源 WebSphere Application Server 确定计算单元的名称，等等。

   
   
   图 6. 概要创建面板
   
   
   

7. 迁移工具使用备份目录将您以前版本的 WebSphere Application Server 迁移到 V6.1。请指定备份目录的位置，如果尚未存在，则请指定应在何处创建它（图 7）。

   
   
   图 7. 迁移备份目录面板
   
   
   

8. 图 8 和 9 显示了应用程序迁移设置的面板。这些面板在 V6.1 迁移向导中是新增内容，通过这些面板可以使用 WASPostUpgrade 命令中的新参数。在这些面板中，您可以选择是要迁移和安装应用程序，还是要创建脚本以便在以后迁移应用程序。您还可以选择要安装应用程序的位置。

   
   
   图 8. 应用程序安装迁移设置面板
   
   
   

9. 在下一个面板中（图 9），您可以更改应用程序的安装位置。缺省情况下，迁移过程会将应用程序安装到 WebSphere Application Server V6.1 的配置目录中。如果需要将应用程序安装在 WebSphere 目录树结构外，则可以选中 Keep the same application directories as the previous version 选项。或者，您也可以输入要安装应用程序的新目录或其他目录。如果应用程序的安装目录对您并不重要，则请接受缺省目录。

   
   
   图 9. 应用程序目录迁移设置面板
   
   
   

10. 缺省情况下，V5 或 V6 部署管理器在迁移过程中是被禁用的，但是，如果必须启用，则可以选择 Do not disable the deployment manager of the previous version（图 10）。这可让您在迁移过程中使用以前版本的部署管理器。但是，这是一个不受支持的配置，因此一定要慎用此选项。停止和禁用以前的部署管理器是为了防止在相同的托管节点上运行多个部署管理器。如果没有禁用以前的部署管理器，则在启动新部署管理器之前，您需要禁用（不使用）以前的部署管理器。

    
    
    图 10. 部署管理器禁用面板
    
    
    

11. 指定要在端口值分配面板上使用的端口值（图 11）。您可以选择使用源安装中的端口值（缺省），在此情况下，将在迁移之前删除 V6.1 WebContainer 端口，从而避免与任何向前迁移的 WebContainer 端口冲突。您还可以选择用于在迁移过程中创建的所有端口的一组端口。

    
    
    图 11. 端口值分配面板
    
    
    

12. 指示您是否要让迁移支持如图 12 所示的面板上的脚本兼容性。例如，如果您具有用于创建或修改配置定义的脚本或程序，则请选中 Migrate to support script compatibility。如果不选中此选项，则迁移工具将创建 V6.1 通道而非传输。有关 convertScriptCompatibility 命令的详细信息将在下一部分介绍。

    
    
    图 12. 脚本兼容性面板
    
    
    

13. 迁移摘要面板（图 13）是执行任何命令之前显示的最后一个面板。在此处可以确认您的选择，或者返回前面的步骤进行任何必要的更改。

    
    
    图 13. 迁移摘要面板
    
    
    

14. 如果您选择 <Create new profile>，则会看到与图 14 类似的面板。只要概要的创建过程成功完成，就可以继续执行迁移。如果在创建概要过程中出现问题，则向导将会终止。

    
    
    图 14. 概要创建输出面板
    
    
    

15. 在迁移概要面板（或概要创建输出面板）上选择 Next 执行迁移。这时将执行 WASPreUpgrade 命令，然后执行 WASPostUpgrade 命令。从本质上讲，迁移过程是由这些命令执行的，这些命令将在下一部分中讨论。

16. 在执行 WASPreUpgrade 和 WASPostUpgrade 之后，将显示迁移状态面板（图 15），其中提供迁移命令输出的摘要状态。

    
    
    图 15. 迁移状态面板
    
    
    

3b.运行命令行工具

可以手动使用 WASPreUpgrade 和 WASPostUpgrade 命令将以前版本的 WebSphere Application Server 迁移到 V6.1。迁移向导将作为自动迁移过程的一部分调用这些工具。这些命令应始终从 V6.1 概要目录（而不是 V5 或 V6 目录）中调用，原因是这些命令已随每个版本进行了更改。还可以在 V6.1 概要的 bin 文件夹中找到这些命令，但是如果您选择使用这些命令，则需要指定命令应在哪个 V6.1 概要上运行。

1. WASPreUpgrade

   WASPreUpgrade 命令将创建所有相关 V5 和 V6 WebSphere Application Server 配置信息的备份。备份的内容特定于版本和配置设置。

   WASPreUpgrade 命令的语法是：

   WASPreUpgrade backupDirectory currentWebSphereDirectory [-traceString trace_spec [-traceFile file_name ]]

   
   

   仅需要前两个参数。可以对 V5 运行的代码示例是：

   C:\IBM\WebSphere\AppServer61\profiles\default\bin\WASPreUpgrade.bat C:\IBM\WebSphere\Backupv5Config C:\IBM\WebSphere\AppServer5

   
   

   如果成功运行，WASPreUpgrade 输出的最后两行将是：

   MIGR0303I: The existing WebSphere Application Server environment is saved. MIGR0420I: The first step of migration completed successfully.

   
   

   有关使用 WASPreUpgrade 命令的详细信息，请参阅 WebSphere Application Server V6 信息中心，或者不带任何参数运行 WASPreUpgrade 命令，以便显示该命令的语法。要诊断迁移问题，请参见 WASPreUpgrade 日志。

2. WASPostUpgrade

   WASPostUpgrade 命令获取由 WASPreUpgrade 创建的备份，并使用该备份将以前的配置移动到 V6。

   WASPostUpgrade 的语法是：

   WASPostUpgrade backupDirectory [-oldProfile profile_name] [-profileName profile_name] [-scriptCompatibility true | false] [-portBlock port_starting_number] [-backupConfig true | false] [-replacePorts true | false] [-includeApps true | false | script] [-keepAppDirectory true | false] [-appInstallDirectory user_specified_directory] [-traceString trace_spec [-traceFile file_name ]]

   
   

   只有第一个参数是必需的。可以运行的代码示例是：

   C:\IBM\WebSphere\AppServer61\profiles\default\bin\WASPostUpgrade.bat C:\IBM\WebSphere\Backupv5Config

   
   

   如果存在多个 V6.1 概要，则请使用 –profileName 参数指定应更新哪个概要。这在从 WebSphere Application Server 主目录（而不是概要目录）运行此命令时特别重要。（例如，从 C:\IBM\WebSphere\AppServer61\bin 而不是从 C:\IBM\WebSphere\AppServer61\profiles\default\bin 运行此命令。）如果从 WebSphere Application Server 主目录运行此命令，并且没有使用 –profileName 参数，则该命令将使用缺省概要，而不一定是名称为“default”的概要。

   WASPostUpgrade 命令可能以 warnings 结尾并且仍然成功执行，因此请查看日志文件，了解为什么出现警告，以及是否有必要执行其他操作。WASPostUpgrade 命令的最终输出应为以下两种情况：

   MIGR0259I: The migration has successfully completed.

   
   

   或者

   MIGR0271W: Migration completed successfully, with one or more warnings.

   
   

   WASPostUpgrade 工具在对 V6.1 环境执行任何更改之前先创建该环境的备份，并在出现诸如以下错误时将尝试回滚任何更改：

   MIGR0272E: The migration function cannot complete the command.

   
   

   有关使用 WASPostUpgrade 命令的详细信息，请参阅 WebSphere Application Server V6.1 信息中心，或者不带任何参数运行 WASPostUpgrade 命令，以便显示该命令的语法。要诊断迁移问题，请参见 WASPostUpgrade 日志。

3. convertScriptCompatibility

   convertScriptCompatibility 命令将 V6.1 配置从支持脚本兼容模式转换为不支持脚本兼容模式。通过运行 WASPostUpgrade 并将 -scriptCompatibility 设置为 True，或者采用缺省值将获得脚本兼容模式。

   convertScriptCompatibility 的语法是：

   convertScriptCompatibility [-help] [-backupConfig true | false] [-profileName profile_name] [-nodeName node_name [-serverName server_name]] [-traceString trace_spec [-traceFile file_name]]

   
   

   不存在必需的参数。可以运行的代码示例为：

   C:\IBM\WebSphere\AppServer61\profiles\default\bin\convertScriptCompatibility.bat

   
   

   如果存在多个 V6.1 概要，则请使用 –profileName 参数指定应更新哪个概要。这在从 WebSphere Application Server 主目录（而不是概要目录）运行此命令时特别重要。（例如，从 C:\IBM\WebSphere\AppServer61\bin 而不是从 C:\IBM\WebSphere\AppServer61\profiles\default\bin 运行此命令。）如果从 WebSphere Application Server 主目录运行此命令，并且没有使用 –profileName 参数，则该命令将使用缺省概要，而不一定是名称为“default”的概要。

   在尝试对联合节点运行此转换时应注意一些特殊事项。应对 dmgr 概要运行此命令，该概要指定需要使用 -nodeName 参数进行转换的联合节点。在运行 convertScriptCompatibility 之后，您需要手动与刚转换的联合节点进行同步，以便将这些更改下载到该节点。

   如果成功，convertScriptCompatibility 将以下列消息结束：

   MIGR0259I: The migration has successfully completed.

   
   

   convertScriptCompatibility 工具在对 V6.1 环境执行任何更改之前先创建该环境的备份，并在出现诸如以下错误时将尝试回滚任何更改：

   MIGR0272E: The migration function cannot complete the command.

   
   

   有关使用 convertScriptCompatibility 命令的详细信息，请参阅 WebSphere Application Server V6.1 信息中心，或者运行指定 -help 的 convertScriptCompatibility 命令，以显示该命令的语法。要诊断迁移问题，请参见 convertScriptCompatibility 日志。

回页首

4. 查看日志文件

无论是通过手动还是通过向导进行迁移，查看日志文件来了解错误或警告始终是一个好主意。这些错误或警告可能需要您执行某些操作。缺省情况下，在所有平台（z/OS 除外）上均会生成跟踪文件，不过这些文件仅在需要时供 IBM 支持人员使用。

WASPreUpgrade 日志

在手动运行 WASPreUpgrade 命令时将创建以下日志文件：

<backupDirectory>/WASPreUpgrade.<Date-Time>.log

在通过迁移向导迁移时，将创建以下日志文件和跟踪文件：

<backupDirectory>/WASPreUpgrade.<Date-Time>.log
<backupDirectory>/logs/preMigrationOutput.log
<backupDirectory>/logs/WASPreMigrationLog.log

WASPostUpgrade 日志

在手动运行 WASPostUpgrade 命令时将创建以下日志文件：

<profileDirectory>/logs/WASPostUpgrade.<Date-Time>.log
<profileDirectory>/logs/<cloudscapeDBName><Log|Debug><Date-Time>.log

在通过迁移向导迁移时，将创建以下日志文件和跟踪文件：

<profileDirectory>/logs/WASPostUpgrade.<Date-Time>.log
<backupDirectory>/logs/postMigrationOutput.log
<backupDirectory>/logs/WASPostMigration.log
<backupDirectory>/logs/<cloudscapeDBName><Log|Debug><Date-Time>.log

convertScriptCompatibility 日志

在手动运行 convertScriptCompatibility 命令时将创建以下日志文件：

<profileDirectory>/logs/convertScriptCompatibility.<Date-Time>.log

回页首

结束语

本概述应为您提供了熟悉 WebSphere Application Server Version V6.1 中的迁移工具及其使用和选项的大量信息，并向您介绍了如何着手执行迁移过程。尽管该过程在很大程度上是自动执行的并且相当简单，但本文还包括了在从单台服务器或从托管的计算单元进行迁移时需要注意的一些特殊事项。我们希望这些信息能够对您有所帮助，并祝您的迁移工作顺利完成，还希望您能够喜欢使用这一新的经过改进的 WebSphere Application Server V6.1。