级别: 中级 Mark Luchini, 软件工程师, IBM Dana Duffield, 高级软件工程师, IBM
2009 年 2 月 02 日 IBM® WebSphere® Application Server V7 包括一些简单易用的工具,可以将以前的 WebSphere Application Server 版本轻松地迁移到 7.0 版,省去了复杂的操作。此迁移过程概述将为您所需的操作以及希望的操作做准备,以便尽可能快速而方便地执行迁移。
引言
本文旨在帮助您着手将 IBM WebSphere Application Server 5.1.x 版本或 6.x 版本迁移到 WebSphere Application Server 7.0 版。本文简要概述了 WebSphere Application Server V7 迁移工具及其使用,并综述了在从特定版本(单台服务器和托管计算单元)迁移时需要注意的一些特殊事项。有关迁移过程中每个步骤的详细信息,请参考 WebSphere Application Server V7 信息中心。
本文档使用的术语
在开始之前,我们先介绍一下本文使用的一些术语的定义:
| 术语 | 在本文中的含义 |
|---|
|
备份目录
|
指 WASPreUpgrade 工具创建的目录结构,包含从 WebSphere Application Server 的以前版本进行迁移时所需的全部必要信息。
| |
计算单元
|
指由单个部署管理器控制的一个或多个节点的集合。
| |
convertScriptCompatibility
|
将 V7 配置从支持脚本兼容模式转换为不再支持脚本兼容模式的命令。例如,将 V5 的传输转换为通道。
| |
部署管理器概要 (dmgr)
|
此概要充当部署管理器的角色,而且是 V5.1 或 V6.x 部署管理器迁移的目的地。每个计算单元只能有一个部署管理器概要。
| |
联合或被联合
|
分别指将节点添加到计算单元的操作,以及已经成为计算单元一部分的节点。
| |
FirstSteps
|
V6 和 V7 中提供的工具,可以简化和组织需要在新安装的系统上执行的许多初始操作。可以在每个概要的 firststeps 目录下找到此工具,并且可以用于启动迁移向导。(在 IBM i 或 z/OS® 中不可用。)
| |
已迁移<项>
|
当用于描述 WebSphere Application Server 配置的元素时,指该项已在迁移过程中被迁移,目前已经位于目标概要中。
| |
迁移
|
就本文而言,迁移 一词仅限于与将 Java™ 2 Enterprise Edition (J2EE) 应用程序(EAR 文件)和 WebSphere Application Server 配置数据(如资源和安全设置)从以前版本的 WebSphere Application Server 移动到 V7 有关的操作。
| |
迁移向导
|
请参阅以交互方式执行迁移的图形用户界面 (GUI)。该 GUI 工具同时执行 WASPreUpgrade 和 WASPostUpgrade 步骤。(在 IBM i 或 z/OS 中不可用)。
| |
新<项>
|
当用于描述 WebSphere Application Server 配置的一个元素时,指该项已驻留在目标(或已迁移)概要中。
| |
以前的<项>
|
当用于描述 WebSphere Application Server 配置的一个元素时,指该项驻留在源概要中。
| |
概要
|
此概念扩展了 V5 中的实例思想,是指 WebSphere Application Server V6 和 V7 中所有配置数据的集合。WebSphere Application Server V7 只需安装一个二进制文件即可提供多个概要。对于从以前版本迁移的数据而言,需要使用单一概要作为目的地。
| |
源概要
|
指您的 V5.1 或 V6.x WebSphere Application Server 配置,其中的信息将转移到 V7。
| |
独立或 Application Server 概要
|
指与 WebSphere Application Server 单节点安装类似的概要。此类概要是计算单元内和计算单元外的节点的迁移目的地,但是对于联合节点建议使用自定义概要。
| |
目标概要
|
指要将您的配置迁移到的 V7 概要。与您的 WebSphere Application Server V7 配置类似。
| |
V6、V5 等
|
此类符号是指 WebSphere Application Server 的各种版本。例如,当所述信息同时适用于 WebSphere Application Server 版本 6.0.2 和 6.1 时,将使用 V6 表示。
| |
WASPreUpgrade
|
执行两步骤迁移过程的第一步的工具。此步骤提取 WebSphere Application Server 以前版本中的信息,并将其存储到备份目录中。此工具可以从命令行自行运行,也可以作为迁移向导的一部分运行。
| |
WASPostUpgrade
|
执行两步骤迁移过程的第二步的工具。此步骤提取通过 WASPreUpgrade 工具创建的目录中的信息,并将该信息导入到 V7 概要。此工具可以从命令行自行运行,也可以作为迁移向导的一部分运行。
|

 |

|
跨 WebSphere Application Server 迁移支持
迁移支持和工具的基本知识在 WebSphere Application Server V7 支持的所有操作系统上都类似。此工具的根在运行命令行工具中提供。不过,为某些操作系统提供的界面各不相同,而且有些特征是某些操作系统所独有的。下面简要概述了该支持:
z/OS
将 WebSphere Application Server for z/OS 迁移到 V7 涉及自定义一组批处理作业,然后运行这些作业来迁移节点。自定义是使用 z/OS 迁移管理工具完成的,该工具包括在针对 V7 的 WebSphere 自定义工具中。计算单元中的每个节点均将有自己的自定义作业;并且逐节点迁移计算单元,首先从 Deployment Manager 节点开始。
z/OS 迁移管理工具是在 z/OS 上进行迁移支持的唯一界面。z/OS 操作系统的独有特征以及针对 z/OS 的迁移步骤在以下白皮书中进行了介绍:Migrating to WebSphere z/OS V7,作者 Don Bagwell。此白皮书以及 WebSphere Application Server V7 信息中心中的信息很好地描述了对 z/OS 的迁移支持。本文不再赘述相关信息。
IBM i
将 WebSphere Application Server for IBM i 迁移到 V7 涉及调用一些工具,这些工具在运行命令行工具部分中进行了描述。使用这些命令行工具是在 IBM i 上进行迁移支持的唯一界面。您可以使用本文指导您的 IBM i 迁移,但是请注意,迁移向导部分中描述的支持不适用于 IBM i。而且,迁移 CD 对 IBM i 不可用。
分布式平台
分布式平台实质上包括 WebSphere Application Server(而非 z/OS 和 IBM i)支持的所有操作系统。请参阅 WebSphere Application Server V7 支持的软件列表,了解这些操作系统及其系统需求的完整列表。这些操作系统通过使用命令行工具或迁移向导进行支持。
1. 准备迁移
本部分涵盖在尝试从 WebSphere Application Server 的以前版本迁移到 V7 之前需要了解的重要问题。除非专门说明,此处讨论的所有观点在从 V5.1 或 V6 迁移时都适用。
-
确认必备的软件级别。请参阅 WebSphere Application Server V7 支持的软件列表,了解您的操作系统和关联软件所需的最小版本和修复程序级别要求。如果您现有的 WebSphere Application Server V5.1 或 V6 安装在不能满足 V7 的先决条件的操作系统(例如 AIX® 5.1 或 Sun™ Solaris™ 8)上,则需要先升级操作系统,才能在您的系统上安装 WebSphere Application Server V7。
-
收集信息。在使用命令行工具着手执行迁移过程之前,务必记下 V5.1 或 V6 计算单元的名称,以及计算单元中所有节点的名称。在为计算单元中的每个节点创建 V7 概要时将需要这些值。概要将在下一部分中详细讨论。
-
备份您的环境。在尝试任何迁移之前一定要备份您的 WebSphere Application Server 环境。这在执行增量计算单元升级时尤其重要。可以使用 WebSphere Application Server 备份工具来保存当前环境;要了解这方面的详细信息,请查看 V5.1 或 V6 信息中心中与 backupConfig 实用工具相关的文章(请参阅参考资料)。
-
完整保留以前版本的 WebSphere Application Server。这一点无需着重强调:不要卸载现有的 WebSphere Application Server V5.1 或 V6 配置,按原样保留即可。WebSphere Application Server V7 可以与这些以前版本安全地共存——假定在同一时间仅运行 WebSphere Application Server 的一个版本。除在迁移的第一步中需要这样做之外,完整保留以前版本的 WebSphere Application Server 还能在需要或必要时将您的环境回滚到以前的版本。
2. 安装 WebSphere Application Server V7
相对于 V5 的安装过程,V7 的安装过程发生了一些变化。一个重要的变化是迁移过程与安装程序分开了。上文已经提到,在安装 V7 之后,迁移向导(仅用于分布式操作环境)将指导您执行迁移过程。如果以前使用“静默”(Silent) 选项来安装并迁移以前的版本,您仍可以以静默方式安装,但在安装之后需要手动使用迁移命令行工具。
在 V6 中引入并在 WebSphere Application Server V7 中使用了概要概念,概要是 WebSphere Application Server 配置和应用程序文件集的独立实例。从本质上说,概要可以实现仅通过 WebSphere Application Server 核心二进制文件的一个副本来保存 V7 的多个配置。概要提供了对 V5.1 实例的改进,而且 V7 提供的工具可用于创建和管理这些概要。
您将使用 FirstSteps 工具来访问 Profile Management 工具,如图 1 所示。
图 1. Profile Management 工具
在 WebSphere Application Server Network Deployment V7(以下称为 Network Deployment)中,一共有五种类型的概要:
- 部署管理器
- 作业管理器
- 管理代理
- 自定义
- 应用服务器。
只有应用服务器概要在其他版本的 WebSphere Application Server V7 中提供。图 1 显示了 Network Deployment Profile Management 工具,其中有四种预定义的概要布局(称为环境)可供选择。
在运行迁移向导之前无需提供概要。但是,如果您计划使用迁移命令行工具,则需要为您的环境创建概要。
在为从以前版本进行迁移而创建概要时,某些特定的值在以前版本和新版本之间必须匹配。具体来说,在将部署管理器迁移到 V7 时,V7 概要的计算单元名称值必须与 V5.1 或 V6 的计算单元名称值匹配;在迁移到 V7 的联合节点时,V7 概要的节点名称必须与以前版本的联合节点的节点名称匹配,等等。对于不属于计算单元的节点(例如独立系统),V7 概要对其没有此类命名要求。
在所有情况下,如果新旧概要的节点和计算单元名称之间存在有效的不匹配情况,则将使用新概要的值,并且迁移将更新 WebSphere Application Server 拥有的所有配置信息以使用新概要名称。
如果您使用迁移向导或 z/OS 自定义作业来创建概要并进行迁移,则将为您自动填充这些值。
对于 Network Deployment 迁移,概要必须按以下特定顺序进行迁移:
-
部署管理器概要。在迁移计算单元时必须首先迁移此概要。V7 迁移的部署管理器概要可以管理计算单元中的所有 V5.1 和 V6 节点。WebSphere Application Server V7 将迁移的部署管理器限制为:让其仅管理在迁移之前位于计算单元中的 V5.1 节点。具体来说,V5.1 节点不能联合到 V7 部署管理器中——但可以将 V6.02 及更高版本的节点添加到 V7 部署管理器中。对于 V5.1 用户,部署管理器概要类似于 WebSphere Application Server Network Deployment V5.1 和部署管理器安装。每个计算单元必须正好具有一个部署管理器。
-
作业管理器概要。此概要是 V7 中的新增概要,没有与以前版本类似的概要,因此不能将任何配置迁移到 V7 作业管理器概要中。
-
管理代理概要。此概要是 V7 中的新增概要,没有与以前版本类似的概要,因此不能将任何配置迁移到 V7 管理代理概要中。
-
自定义概要。此概要非常适合于联合节点迁移。没有为此概要创建缺省的应用程序或应用服务器。以前版本的每个节点都可以正好迁移到一个自定义概要。这些节点将成为 V7 混合计算单元的成员,并且可以在任何时候迁移到 V7 节点。
-
应用服务器概要。此概要类似于 V5 或 V6 中安装的单个节点。此概要是使用名为 server1 的应用服务器和若干缺省应用程序创建的
3. 执行迁移
下面要执行的步骤取决于您选择的迁移方法。可选的迁移方法有:
-
运行迁移向导或者
-
运行命令行工具。
3a.运行迁移向导
迁移向导是一种新的迁移方法,并针对 V7 进行了改进,它替代了作为 Application Server V5.1 安装程序一部分的迁移面板。该迁移向导对 IBM i 或 z/OS 平台不可用。可以在 FirstSteps 面板中找到迁移向导。要运行迁移向导,请执行下列步骤:
-
从概要目录启动 FirstSteps(如果存在),例如:C:\WebSphere\AppServer\profiles\default\。在 Windows® 上,您可以从概要目录的 firststeps 文件夹或从 Start 菜单启动 FirstSteps。
-
在启动 FirstSteps 之后,请选择 Migration wizard 开始迁移过程(图 2)。
图 2. Firststeps 面板
-
在显示 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)。对于 V5,通常迁移 defaultinstance;但是,如果您创建了多个实例,则可以选择其他 V5 实例中的任何一个。对于 V6,您可以选择要迁移的概要,但是请记住,部署管理器必须始终在联合节点之前进行迁移。
图 4. 源概要选择面板
-
e. 如果您定义了一个或多个概要,例如,同一系统上的 V7 部署管理器和 V7 节点概要,则必须选择要用作目标概要的概要(图 5)。如果尚未创建 V7 概要,迁移向导可以为您创建一个(通过选择 <Create new profile>)。
图 5. 目标概要选择面板
-
如果想让迁移向导创建一个概要,则会显示如图 6 所示的面板。迁移向导将在必填字段中填入适当的值;例如,如果您要迁移部署管理器,则向导将从源 WebSphere Application Server 确定计算单元的名称,等等。
图 6. 概要创建面板
-
迁移工具使用备份目录将您以前版本的 WebSphere Application Server 迁移到 V7。请指定备份目录的位置,如果尚不存在,则请指定应在何处创建它(图 7)。
图 7. 迁移备份目录面板
-
图 8 和 9 显示了应用程序迁移设置的面板。这些面板使 V7 迁移向导能够使用 WASPostUpgrade 命令中的新参数。在这些面板中,您可以选择是要迁移和安装应用程序,还是要创建脚本以便在以后迁移应用程序。您还可以选择要安装应用程序的位置。
图 8. 应用程序安装迁移设置面板
-
在下一个面板中(图 9),您可以更改应用程序的安装位置。缺省情况下,迁移过程会将应用程序安装到 WebSphere Application Server V7 的配置目录中。如果需要将应用程序安装在 WebSphere 目录树结构外,则可以选中 Keep the same application directories as the previous version 选项。或者,您也可以输入要安装应用程序的新目录或其他目录。如果应用程序的安装目录对您并不重要,则请接受缺省目录。
图 9. 应用程序目录迁移设置面板
-
缺省情况下,V5 或 V6 部署管理器在迁移过程中是被禁用的,但是,如果必须启用,则可以选择 Do not disable the deployment manager of the previous version(图 10)。这可让您在迁移过程中使用以前版本的部署管理器。但是,这是一个不受支持的配置,因此一定要慎用此选项。停止和禁用以前的部署管理器是为了防止在相同的托管节点上运行多个部署管理器。如果没有禁用以前的部署管理器,则在启动新部署管理器之前,您需要禁用(不使用)以前的部署管理器。
图 10. 部署管理器禁用面板
-
指定要在端口值分配面板上使用的端口值(图 11)。您可以选择使用源安装中的端口值(缺省),在此情况下,将在迁移之前删除 V7 WebContainer 端口,从而避免与任何向前迁移的 WebContainer 端口冲突。您还可以选择用于在迁移过程中创建的所有端口的一组端口。
图 11. 端口值分配面板
-
管理控制台自定义的 My Tasks 是 V6.1 中的新内容,因此仅在从 V6.1 迁移时才显示图 12 中所示的面板。您可以选择使用缺省的工作区用户根位置,即 V6.1 概要 home 下的 wstemp,或者用户指定的工作区根位置。
图 12. 管理控制台自定义的“My tasks”面板
-
您需要在管理安全性面板中提供用户名和密码(图 13)。当在以前版本中启用了全局安全并且 security.xml 不包含相应的用户名和密码值时,才会显示此面板。当从 V6.1 迁移时通常会出现此问题。
图 13. 管理安全性面板
-
指示您是否要让迁移支持如图 14 所示的面板上的脚本兼容性。例如,如果您具有用于创建或修改配置定义的脚本或程序,则请选中 Migrate to support script compatibility。如果不选中此选项,则迁移工具将创建 V7 通道而非传输。有关 convertScriptCompatibility 命令的详细信息将在下一部分介绍。
图 14. 脚本兼容性面板
-
迁移摘要面板(图 15)是执行任何命令之前显示的最后一个面板。在此处可以确认您的选择,或者返回前面的步骤进行任何必要的更改。
图 15. 迁移摘要面板
-
如果您选择 <Create new profile>,则会看到与图 16 类似的面板。只要概要的创建过程成功完成,就可以继续执行迁移。如果在创建概要过程中出现问题,则向导将会终止。
图 16. 概要创建输出面板
-
在迁移概要面板(或概要创建输出面板)上选择 Next 以运行迁移。这时将运行 WASPreUpgrade 命令,然后运行 WASPostUpgrade 命令。从本质上讲,迁移过程是由这些命令执行的,这些命令将在下一部分中讨论。
-
在完成 WASPreUpgrade 和 WASPostUpgrade 之后,将显示迁移状态面板(图 17),其中提供迁移命令输出的摘要状态。
图 17. 迁移状态面板
3b.运行命令行工具
可以手动使用 WASPreUpgrade 和 WASPostUpgrade 命令将以前版本的 WebSphere Application Server 迁移到 V7。迁移向导将作为自动迁移过程的一部分调用这些工具。这些命令应始终从 V7 概要目录(而不是 V5.1 或 V6 目录)中调用,原因是这些命令已随每个版本进行了更改。还可以在 V7 概要的 bin 文件夹中找到这些命令,但是,如果您从此目录中选择使用这些命令,则需要指定命令应在哪个 V7 概要上运行。
-
WASPreUpgrade
WASPreUpgrade 命令将创建所有相关 V5 和 V6 WebSphere Application Server 配置信息的备份。备份的内容特定于版本和配置设置。
WASPreUpgrade 命令的语法是:
WASPreUpgrade backupDirectory
currentWebSphereDirectory
[-traceString trace_spec]
[-traceFile file_name]
[-machineChange true | false]
[-oldProfile old_profile_name]
[-workspaceRoot user_workspace_folder] |
仅需要前两个参数。可以对 V5.1 运行的代码示例为:
C:\IBM\WebSphere\AppServer7\profiles\default\bin\WASPreUpgrade.bat
C:\IBM\WebSphere\Backupv51Config
C:\IBM\WebSphere\AppServer51 |
如果成功运行,WASPreUpgrade 输出的最后两行将是:
MIGR0303I: The existing WebSphere Application Server environment is saved.
MIGR0420I: The first step of migration completed successfully. |
有关使用 WASPreUpgrade 命令的详细信息,请参阅 WebSphere Application Server V7 信息中心,或者不带任何参数运行 WASPreUpgrade 命令,以便显示该命令的语法。要诊断迁移问题,请参见 WASPreUpgrade 日志。
-
WASPostUpgrade
WASPostUpgrade 命令获取由 WASPreUpgrade 创建的备份,并使用该备份将以前的配置移动到 V7。
WASPostUpgrade 的语法是:
WASPostUpgrade backupDirectory
[-profileName profile_name]
[-oldProfile profile_name]
[-backupConfig true | false]
[-username username ]
[-password password ]
[-traceString trace_spec
[-traceFile file_name]]
[-portBlock port_starting_number]
[-replacePorts true | false]
[-includeApps true | false | script]
[-scriptCompatibility true | false]
[
[-appInstallDirectory user_specified_directory]
|
[-keepAppDirectory true | false]
]
[-keepDmgrEnabled true | false]
|
只有第一个参数是必需的。可以运行的代码示例为:
C:\IBM\WebSphere\AppServer7\profiles\default\bin\WASPostUpgrade.bat
C:\IBM\WebSphere\Backupv51Config |
如果存在多个 V7 概要,则请使用 –profileName 参数指定应更新哪个概要。这在从 WebSphere Application Server 主目录(而不是概要目录)运行此命令时特别重要。(例如,从 C:\IBM\WebSphere\AppServer7\bin 而不是从 C:\IBM\WebSphere\AppServer7\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 工具在对 V7 环境执行任何更改之前先创建该环境的备份,并在出现诸如以下错误时将尝试回滚任何更改:
MIGR0272E: The migration function cannot complete the command. |
有关使用 WASPostUpgrade 命令的详细信息,请参阅 WebSphere Application Server V7 信息中心,或者不带任何参数运行 WASPostUpgrade 命令,以便显示该命令的语法。要诊断迁移问题,请参见 WASPostUpgrade 日志。
-
convertScriptCompatibility
convertScriptCompatibility 命令将 V7 配置从支持脚本兼容模式转换为不支持脚本兼容模式。通过运行 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 |
如果存在多个 V7 概要,则请使用 –profileName 参数指定应更新哪个概要。这在从 WebSphere Application Server 主目录(而不是概要目录)运行此命令时特别重要。(例如,从 C:\IBM\WebSphere\AppServer7\bin 而不是从 C:\IBM\WebSphere\AppServer7\profiles\default\bin 运行此命令。)如果从 WebSphere Application Server 主目录运行此命令,并且没有使用 –profileName 参数,则该命令将使用缺省概要,而不一定是名称为“default”的概要。
在尝试对联合节点运行此转换时应注意一些特殊事项。应对 dmgr 概要运行此命令,该概要指定需要使用 -nodeName 参数进行转换的联合节点。在运行 convertScriptCompatibility 之后,您需要手动与刚转换的联合节点进行同步,以便将这些更改下载到该节点。
如果成功,convertScriptCompatibility 将以下列消息结束:
MIGR0259I: The migration has successfully completed. |
convertScriptCompatibility 工具在对 V7 环境执行任何更改之前先创建该环境的备份,并在出现诸如以下错误时将尝试回滚任何更改:
MIGR0272E: The migration function cannot complete the command. |
有关使用 convertScriptCompatibility 命令的详细信息,请参阅 WebSphere Application Server V7 信息中心,或者运行指定 -help 的 convertScriptCompatibility 命令,以显示该命令的语法。要诊断迁移问题,请参见 convertScriptCompatibility 日志。

 |

|
4. 查看日志文件
无论是通过手动还是通过向导进行迁移,查看日志文件来了解需要执行某种操作的任何错误或警告始终是一个好主意。缺省情况下,在所有平台(z/OS 除外)上均会生成跟踪文件,不过这些文件仅在需要时供 IBM 支持人员使用。
WASPreUpgrade 日志
在手动运行 WASPreUpgrade 命令时将创建以下日志文件:
<backupDirectory>/logs/WASPreUpgrade.<Date-Time>.log<
<backupDirectory>/logs/WASPreUpgrade.trace
在通过迁移向导迁移时,将创建以下日志文件和跟踪文件:
<backupDirectory>/logs/preMigrationOutput.log
<backupDirectory>/logs/WASPreMigrationSummary.log
WASPostUpgrade 日志
在手动运行 WASPostUpgrade 命令时将创建以下日志文件:
<backupDirectory>/logs/WASPostUpgrade.<profile>.<Date-Time>.log
<backupDirectory>/logs/WASPostUpgrade.<profile>.trace
<profileDirectory>/logs/<cloudscapeDBName><Log|Debug><Date-Time>.log
在通过迁移向导迁移时,将创建以下日志文件和跟踪文件:
<backupDirectory>/logs/WASPostMigrationSummary.log
<backupDirectory>/logs/<cloudscapeDBName><Log|Debug><Date-Time>.log
convertScriptCompatibility 日志
在手动运行 convertScriptCompatibility 命令时将创建以下日志文件:
<profileDirectory>/logs/convertScriptCompatibility.<Date-Time>.log
<profileDirectory>/logs/ConvertScriptCompatibility
差异和例外
无论是手动还是使用向导执行迁移,您都会发现新旧配置之间存在一些差异——当您指定 –scriptCompatibilty false 选项(非缺省值)或运行 convertScriptCompatibility 工具时,这种差异会更明显。下面是一般注意事项:
-
新端口和端口更改
WebSphere Application Server 的新版本通常随新服务一起推出,因此会提供一些新服务端点。这些服务端点可能与某个网络地址绑定,例如 IPC_INBOUND_CONNECTOR。这些新端口将被更新以确保它们不与迁移的配置冲突,但不会通过更新它们来解决同一物理硬件中多个概要的端口冲突。因此,您需要在创建概要过程中手动解决端口冲突问题,如果已使用迁移工具创建了概要,则在迁移之后手动解决冲突问题。
另外,基于您设置端口解决方案的方式(WASPostUpgrade 工具中的 –portBlock 和 –replacePorts),您的一些端口值可能从以前配置中的值更改或者作为 V7 概要创建的一部分而创建。对于绑定端口的每台服务器,迁移组件在标有时间戳的 WASPostUpgrade 日志文件中记录端口更新。有关如何定位此日志的信息,请参见前面的部分。摘要视图的标准格式如下所示:
MIGR0446I: Port conflicts were resolved during migration as shown below for
document: C:/workarea/WebSphere/v7/profiles/profile/config/cells/cellName/
nodes/nodeName/servers/dmgr/server.xml
Port Identifier Port Value
--------------- ----------
dmgr@transport_9090 9090
dmgr@transport_9043 9043
MIGR0446I: Port conflicts were resolved during migration as shown below for
document: C:/workarea/WebSphere/v7 /profiles/profile/config/cells/cellName/
nodes/nodeName/serverindex.xml
Port Identifier Port Value
--------------- ----------
dmgr@CSIV2_SSL_MUTUALAUTH_LISTENER_ADDRESS 9402
dmgr@SAS_SSL_SERVERAUTH_LISTENER_ADDRESS 9401
dmgr@WC_adminhost_secure 9044
dmgr@DRS_CLIENT_ADDRESS 7989
dmgr@DCS_UNICAST_ADDRESS 9352
dmgr@WC_adminhost 9060
dmgr@IPC_CONNECTOR_ADDRESS 9632
dmgr@DataPowerMgr_inbound_secure 5555
dmgr@CSIV2_SSL_SERVERAUTH_LISTENER_ADDRESS 9403
dmgr@CELL_DISCOVERY_ADDRESS 7277
dmgr@ORB_LISTENER_ADDRESS 9100
dmgr@BOOTSTRAP_ADDRESS 9809
dmgr@SOAP_CONNECTOR_ADDRESS 8879 |
-
节点和计算单元名称更改
当从以前版本迁移时,如果在节点和计算单元名称值之间存在不匹配,您应注意为什么会发生此情况:对于部署管理器迁移,V7 部署管理器节点名称将替换 V5.1 或 V6 节点名称。对于独立迁移,V7 节点和计算单元名称将替换 V5.1 或 V6 的值。对于联合节点迁移,V7 计算单元名称将替换为 V7 部署管理器中的计算单元名称,这意味着节点和计算单元名称将始终与其在 V5.1 或 V6 配置中的值相同。
-
Cloudscape 转换到 Derby
在 WebSphere Application Server V7 之前,Cloudscape 支持被替换为 Derby。迁移工具将自动在配置中检测 Cloudscape 数据库,并将数据迁移到类似的 Derby 数据库。由于不兼容性,一些数据库无法自动升级。在这些情况下,WASPostUpgrade 日志将显示未迁移数据库的警告,您需要通过手动从配置中删除 Derby 数据库或手动将数据从 Cloudscape 转换为 Derby 来解决此问题。
由于 Cloudscape 数据库在生产环境中不受支持,因此迁移 Cloudscape 数据库失败不会导致迁移工具失败或终止。该迁移将继续运行并保存配置,即使未迁移数据库也如此。
-
应用程序无法安装
如果在迁移过程中未能安装应用程序,则可能是该应用程序在 WebSphere Application Server V7 中不受支持,或者可能需要手动更新或迁移非 WebSphere 配置信息。安装应用程序失败不会导致迁移失败或终止。将向 WASPostUpgrade 摘要日志和标有时间戳的日志发送一个消息,详细记录遇到的错误。迁移工具还会保留迁移后的应用程序文件和 wsadmin 安装脚本,以便您可以解决问题和手动调用脚本来安装该应用程序。
迁移后的应用程序位于 V7 的 profile/installableApps 目录中,安装脚本位于迁移备份目录的根目录中。
有关 WebSphere Application Server 版本到版本迁移的完整信息集,请参阅 知识集锦:WebSphere Application Server 迁移计划。
结束语
本概述应为您提供了熟悉 WebSphere Application Server V7 中的迁移工具及其用法和选项的足够信息,以帮助您着手执行迁移过程。尽管该过程在很大程度上是自动执行的并且相当简单,但本文还包括了在从单台服务器或从托管的计算单元进行迁移时需要注意的一些特殊事项。我们希望这些信息能够对您有所帮助,并祝您的迁移工作顺利,还希望您能够喜欢使用这一新增和改进的 WebSphere Application Server V7。
参考资料 学习
获得产品和技术
作者简介  | |  | Mark Luchini 是 IBM 驻明尼苏达州罗彻斯特市的软件工程师。他在目前的迁移开发团队任职之前,曾经是发行 4 个 WebSphere Application Server 版本的系统验证测试 (SVT) 迁移团队的成员,而且是在 v6.0 版中测试 JDBC 3.0 的团队负责人、6.0.2 版迁移焦点人物以及用于 v6.1 的现有客户 SVT 的共同创始人和团队负责人。Mark 拥有密歇根州立大学计算机科学和工程学学士学位,以及德克萨斯州 SMU 大学软件工程学硕士学位。 |
 | |  | Dana Duffield 是一位高级软件工程师,现任 IBM 驻罗彻斯特市的 WebSphere Application Server 迁移和互操作性架构师。作为一名软件工程师,他在 IBM 罗彻斯特实验室工作了 24 年多,曾从事过各种项目开发。他拥有伊利诺伊大学尚佩恩-厄班纳分校计算机科学学士学位。他不仅在面向对象和分布式系统的体系结构开发方面拥有丰富的经验,还担任过多种开发和领导职位。在到 IBM 工作之前,他在伊利诺伊州内珀维尔市的贝尔实验室工作。 |
对本文的评价
|