级别: 中级 Diane Chalmers , 软件工程师, IBM Mark Luchini , 软件工程师, IBM
2005 年 8 月 11 日 本指南概述了从 IBM® WebSphere® Application Server Version 4 或 Version 5 到 WebSphere Application Server V6 的迁移过程。 引言 本指南旨在帮助您着手从 IBM WebSphere Application Server Version 4 或 5 迁移到 WebSphere Application Server V6。IBM 红皮书提供了有关整个迁移过程的更多细节(请参阅参考资料),这些详细信息还可以在 WebSphere Application Server V6.0 Information Center 中找到。本指南概述了整个过程。 本指南包括向 WebSphere Application Server(以下称为 Application Server)Version 6 (V6) 迁移中的改变和从 Version 4 或 5(以下称为 V4 和 V5,其中 V5 指的是 5.0 和 5.1 版本)迁移时的注意事项,并且还概述了迁移到 V6 单元时的命令行工具和提示。 本文档中使用的术语 本文档中使用的术语的定义: - 迁移
- 这一术语有很多定义且范围很广。在本文档中,迁移的含义仅限于将 Java™ 2 Enterprise Edition (J2EE™) 应用程序 (EAR) 和 Application Server 配置数据(如资源和安全设置)从 Application Server 的先前版本迁移到 V6 过程中的相关操作。
WASPreUpgrade(工具)- 指两步迁移过程的第一步。与该步骤有关的工具将从 Application Server 的先前版本中提取信息,然后将其存储在备份目录中。此工具可以从命令行单独运行,也可以作为迁移向导的一部分运行。
WASPostUpgrade(工具)- 指两步迁移过程的第二步。与该步骤有关的工具将从 WASPreUpgrade 工具创建的目录中获得信息,然后将其导入到一个 V6 配置文件中。此工具可以从命令行单独运行,也可以作为迁移向导的一部分运行。
备份目录- 指 WASPreUpgrade 工具所创建的目录结构,它包含从 Application Server 的先前版本迁移所需的全部信息。
迁移向导- 指以交互方式执行迁移的图形用户界面(graphical user interface,GUI)。该 GUI 工具执行 WASPreUpgrade 和 WASPostUpgrade 步骤。
FirstSteps(工具)- 它是 V6 中提供的工具,用于简化和组织客户可能期望使用最新安装的系统执行的许多操作。此工具可以在每个配置文件下的 firststeps 目录中找到,并且可以用于启动迁移向导。
配置文件- 这一概念是对 V5 中“实例”概念的扩展。它指 V6 中的应用服务器的所有配置数据的集合。Application Server V6 支持一个二进制安装配合多个配置文件使用。在迁移过程中,需要一个配置文件作为先前版本数据的目的地。(请参阅安装 Application Server V6。)
单元- 指由一个部署管理器控制的一个或多个节点的集合。
联盟或联合- 它指将一个节点添加到单元中的操作;还可以指作为单元的一部分的节点。对该术语进行扩展后,它也可以指多节点 V4 域中的节点。
部署管理器配置文件(dmgr 配置文件)- 该配置文件充当部署管理器,它是迁移 V5 部署管理器的目的地,并且用作 V4 迁移的新部署管理器。每一个单元只能有一个部署管理器配置文件。(请参阅安装 Application Server V6。)
独立配置文件或 Application Server 配置文件- 它指类似于 Application Server 的单节点安装的配置文件。此类型的配置文件是迁移单元内(非单元内)的节点的目的地。
集群- 这一术语取代了 V4 中 ServerGroups 的概念。集群是单元内用于分配工作负载的服务器组。
 |
准备迁移 这一部分介绍了下面的重要问题,在尝试从 Application Server 的先前版本迁移到 V6 之前应该考虑所有这些问题。除非另有说明,否则所有这些问题都适用于从 V4 或者 V5 迁移: - 应用所需的 V4 修补程序
- 检查和安装 V6 所需的操作系统以及相关软件的级别
- 收集现有的单元或域信息
- 备份环境
- 保持现有 Application Server 配置的完整性
- V4 的特殊迁移要求
1. 应用所需的 V4 修补程序 在进行迁移之前,必须将表 1 中列出的修补程序应用于 V4 环境。 | APAR 号 | 问题描述 | 包含该修补程序的版本 | | PQ55064 | XMLConfig 无法导出/导入特定于 bean 的数据。 | V 4.0.1 | | PQ52555 | XMLConfig 无法导出克隆属性配置。 | V 4.0.2 | | PQ55064 | XMLConfig 无法将 EJB 导出到 DataSource 级映射。 | V 4.0.2 | | PQ58038 | 执行 XMLConfig 导出会产生一个额外的 CRLF。 | V 4.0.3 | | PQ62103 | 在一个多节点环境中,XMLConfig 的完整导出失败,并抛出 NullPointerException 异常。 | V 4.0.5 | | PQ62471 | 在 XML 导出期间,安全的 AdminRoles 没有被导出。 | V 4.0.5 | | PQ63815 | “=”不是 XMLConfig 中值字符串的有效字符。 | V 4.0.5 |
2. 检查和安装 V6 所需的操作系统以及相关软件的级别 一定要阅读 WebSphere Application Server V6 requirements document 来了解操作系统和相关软件的最低版本和修补程序级别要求。如果现有的 Application Server V4 或 V5 安装在一个不满足 V6 先决条件的操作系统版本上(如 IBM AIX® 4.3.3 或 Sun® Solaris™ 7),则在该系统上安装 Application Server V6 之前需要进行操作系统升级。(请参阅作为迁移工作的一部分升级操作系统。) 3. 收集现有的单元或域信息 开始迁移过程之前,必须跟踪 V5 单元或 V4 域中所有节点的名称,包括 V5 单元的名称。没有与 V4 中的单元名称等价的名称。在为单元中的每个节点创建 V6 配置文件时要使用这些值。(请参阅安装 Application Server V6。) 4. 备份环境 在尝试任何迁移之前都要备份 Application Server 环境。这在客户进行增量单元升级时尤为重要。(请参阅将 V5 单元迁移到 V6。)V5 备份工具可以用于保存 V5 环境。要获得有关该工具的详细信息,请阅读 WebSphere Application Server V5 Information Center 中的有关 backupConfig 实用工具的文章(请参阅参考资料)。 5. 保持现有 Application Server 配置的完整性 这一点怎么强调都不为过:不要卸载 Application Server 的先前版本。假如某个时间只有 Application Server 的一个版本正在运行,Application Server V6 可以与先前版本安全共存。这也是一个迁移要求。术语共存指的是 Application Server 的多个版本同时运行时的情况。如果需要设置共存环境,请参考 WebSphere Application Server Information Centers 中的希望共存的 Application Server 的两个版本(请参阅参考资料)。 此外,迁移的第一步需要 Application Server 的先前版本。保持现有安装的完整性还使您能够在必要时将环境回滚到先前版本。 6. V4 的特殊迁移要求 当从 WebSphere Application Server V4(高级版)迁移时,WASPreUpgrade 工具必须从管理储存库库数据库中提取所有的配置数据。执行该操作最简便的方法是启动 V4 管理服务器与管理控制台。当 WASPreUpgrade 日志指示命令已成功完成时,请转到 V4 的管理控制台并停止节点。这将关闭控制台并停止管理服务器。
安装 Application Server V6 V6 的安装自 V4 和 V5 起就已经更改了。一个重要的变化是已将迁移从安装程序中分离出来。现在,安装 V6 以后,会有一个迁移向导指导用户迁移。如果以前使用 Silent 选项进行安装和迁移,则它仍可以执行静默安装,之后就可以手动调用迁移命令行工具了。 V6 中的一个新内容是配置文件的概念,配置文件是 Application Server 配置和应用程序文件组中的独立实例。实际上,配置文件允许 V6 的多种配置只有一个 Application Server 核心二进制文件的副本,这是对 V5 实例的改进。V6 还具备可以用于创建和管理这些配置文件的工具。可以在配置文件创建向导中使用 FirstSteps 访问配置文件创建工具(Profile Creation Tool,PCT),如图 1 所示。 图 1. 配置文件创建向导

V6 中包括多达三种类型的配置文件,如图 1 所示。(可能会有较少的配置文件选项,这取决于您运行的 Application Server V6。) 当创建用于先前版本迁移的配置文件时,某些值必须匹配。具体来说: - 当将 V5 部署管理器迁移到 V6 时,V6 配置文件的单元名称的值必须与 V5 的单元名称相匹配。
- 当迁移到 V6 联合节点时,V6 配置文件的节点名称必须与 V4 或 V5 的联合节点的节点名称相匹配。
- 对于不作为单元的一部分的 V5 节点来说(如独立系统),在 V6 配置文件的名称方面没有要求。
无论何时迁移 V5 单元,部署管理器配置文件都必须是迁移的第一个配置文件。迁移到 V6 的部署管理器配置文件可以管理单元中的所有 V5 节点。Application Server V6 通过只允许迁移的部署管理器在迁移前管理单元中的 V5 节点来对其进行约束。具体地说,V5 节点不能与版本 6.0.0.0 部署管理器联盟(以后的维护版本将纠正这个问题)。对于 V5 的用户来说,部署管理器配置文件类似于 V5 Application Server Network Deployment 和部署管理器安装。每一个单元必须只有一个部署管理器。 对于 V4 用户来说,部署管理器配置文件是一个新的概念。该配置文件可以运行管理控制台以及取代 V4 管理客户机的 Web 接口,它还可以管理单元中所有其他节点上的配置。这和 V4 不同,在 V4 中单元内的任何节点都可以运行管理客户机。(请参阅将 V4 多节点迁移到 V6 单元。) 让迁移用户感兴趣的第二个配置文件是独立配置文件。该配置文件类似于 V5 和 V4 中的单节点安装(虽然在 V4 中它与 Advanced Single Server Edition 非常相似)。先前版本的每一个节点都将迁移到某一个独立配置文件中。对于大的 V5 单元,V5 节点可以一个一个地进行迁移。V5 节点将是 V6 单元中的成员,并且任何时候都可以迁移到 V6 节点。(请参阅将 V5 单元迁移到 V6。)然而,V4 用户必须迁移所有的 V4 节点才能在 V6 单元中利用它们。
迁移向导 迁移向导是 V6 中的一个新内容,它取代了先前版本中作为 Application Server 安装程序的一部分的迁移面板。迁移向导可以在 FirstSteps 面板上找到。应该始终从配置文件目录(如 C:\WebSphere\AppServer\profiles\default\)启动命令(如 FirstSteps)。在 Windows® 中,从配置文件目录的 firststeps 文件夹或者“Start”菜单启动 FirstSteps。 启动 FirstSteps 后: - 通过选择“Migration wizard”开始使用迁移向导,如图 2 所示。
图 2. First steps 面板

将显示一个欢迎面板,它表明在使用向导之前必须安装 Application Server 并且必须创建配置文件。
- 接下来,从检测到的版本的列表中选择要迁移的 Application Server 的先前版本(图 3)。通过确认 Installation root directory of the previous version 字段中列出的先前版本的位置来确保此位置是正确的,这一点非常重要。
- 对于 V4 Advanced Single Server Edition,在有多个配置文件时请指定使用哪一个配置文件。
图 3. 检测到的 WebSphere Application Server 版本面板

- 在下一个面板中(图 4)指定应该在何处创建备份目录。迁移工具使用该目录将先前版本迁移到 V6。如果该目录尚不存在,则进行创建。
图 4. 迁移备份目录面板

- 下一个面板(图 5)是配置文件选择面板。如果定义了多个配置文件(如同一个系统上的 V6 部署管理器和 V6 节点配置文件),则选择要使用的配置文件。
图 5. 目标配置文件选择面板

- 在开始实际迁移之前的最后一个面板是“Port Value Assignment”对话框(图 6)。可以选择让端口分配保持与在 Application Server 的先前版本中的相同,也可以让端口分配作为目标配置文件中定义的新的分配。
图 6. 端口值分配面板

- 在“Port value assignment”面板上单击“Next”后,将会调用 WASPreUpgrade 命令,然后调用 WASPostUpgrade 命令。(在下一部分中可以找到有关这些命令的详细信息。)
- 最后显示的面板是“Migration status”面板(图 7),它提供了迁移的摘要状态。
图 7. 迁移状态面板

迁移命令行工具 WASPreUpgrade 和 WASPostUpgrade 命令可以用于手动将先前版本迁移到 V6。当使用迁移向导来迁移先前版本时,该迁移向导将调用这些工具。应该始终从 V6 配置文件目录而不是 V4 或 V5 目录中调用这些命令。这些命令可以在 V6 配置文件的 bin 文件夹中找到。 WASPreUpgrade WASPreUpgrade 命令创建现有的 V4 或 V5 Application Server 的备份。具体来说,它为 V4 和 V5 备份以下内容: - 类(不包括 iSeries)
- config
- installableApps
- installedApps
- 属性(从 V5.1 开始包括 iSeries)
- bin/setupCmdLine.sh 或者 bin/setupCmdLine.bat。
另外,它还专门针对 V4 高级版备份 installedConnectors。 而对于 V5,它还将备份 libraries.xml 中引用的任何类、JAR 或 dll 以及 resources.xml 中引用的任何 RAR 文件。 WASPreUpgrade 的语法是:
WASPreUpgrade backupDirectory
currentWebSphereDirectory
[adminNodeName]
[-nameServiceHost host_name
[-nameServicePort port_number ]]
[-import xmiDataFile ]
[-traceString trace_spec [-traceFile file_name ]]
|
只有前面两个参数是必需的。下面是一个可以为 V5 运行的示例:
C:\IBM\WebSphere\AppServer60\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 Information Center,或者不带任何参数运行 WASPreUpgrade 命令来显示命令的语法。 WASPostUpgrade WASPostUpgrade 命令获得 WASPreUpgrade 创建的备份,并使用该备份将先前的配置迁移到 V6。 WASPostUpgrade 的语法是:
WASPostUpgrade backupDirectory
[-oldProfile profile_name]
[-profileName profile_name]
[-import xmi_data_file]
[-scriptCompatibility true | false]
[-portBlock port_starting_number]
[-backupConfig true | false]
[-replacePorts true | false]
[-substitute "key1=value1[;key2=value2;[...]]"]
[-instance instanceName -hostName hostname]
[-includeApps true | false]
[-traceString trace_spec
[-traceFile file_name]]
[-scriptCompatibility true | false ]
[-connectionTimeout <TimeoutInMinutes>]
|
只有第一个参数是必需的。下面是一个可以运行的示例:
C:\IBM\WebSphere\AppServer60\profiles\default\bin\WASPostUpgrade.bat C:\IBM\WebSphere\BackupV5Config
|
当有多个 V6 配置文件时,请确保使用 -profileName 参数来指定应该更新哪一个 V6 配置文件。当从主 Application Server 目录(而不是配置文件目录)运行该命令时,这尤为重要。举例来说,从 C:\IBM\WebSphere\AppServer60\bin 运行该命令,而不是 C:\IBM\WebSphere\AppServer60\profiles\default\bin。如果从主 Application Server 目录运行命令且没有使用 -profileName 参数,则该命令将使用缺省的配置文件,它不必是名称为 Default 的配置文件。 WASPostUpgrade 命令可能以警告结束但仍是成功的。检查日志文件以了解出现警告的原因、以及是否需要任何其他操作。WASPostUpgrade 命令的最后输出应该是: MIGR0259I: The migration has successfully completed.
或者 MIGR0271W: The migration completed with warnings.
WASPostUpgrade 工具在进行任何更改之前创建 V6 环境的备份。如果在资源配置期间和应用程序安装之前出现错误,则 WASPostUpgrade 将回滚所有更改。如果迁移的过程中出现任何错误,则下面显示的消息将是 WASPostUpgrade 日志文件中的最终消息,并且该消息还会出现在系统输出或 GUI 摘要中(当分别使用命令行或迁移向导时)。如果资源配置完成,则 WASPostUpgrade 将保存配置。如果在安装所迁移的企业应用程序的过程中出现错误,则应用服务器将回滚到该保存的状态,即已完全迁移了所有的企业应用程序,但没有进行任何安装。出现此情况的原因是,迁移企业应用程序期间出现的错误通常表明必须对应用程序进行手动更改,因而使您能够在完全迁移的应用服务器上进行更改并安装应用程序。 MIGR0272E: The migration function cannot complete the command.
如果在 WASPostUpgrade 方面需要更多的帮助,请参考 WebSphere Applicaton Server V6 Information Center,或者不带任何参数运行 WASPostUpgrade 命令来显示命令的语法。
迁移日志文件 无论您是在执行手动迁移还是使用迁移向导,都应该始终阅读日志文件以了解可能需要某些操作的错误或警告。 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/WASPostUpgrade.<Date-Time>.log
- <profileDirectory>/logs/postMigrationOutput.log
- <profileDirectory>/logs/WASPostMigration.log
当迁移联合节点时,将在部署管理器上创建另一个 WASPostUpgrade 日志文件,该日志文件位于部署管理器的配置文件目录中: - <profileDirectory>/temp/<nodeName>_migration_temp/
WASPostUpgrade_<nodeName>_phase2.<Date-Time>.log
作为迁移工作的一部分升级操作系统  | | 当需要进行操作系统升级时,您将无法在环境中使用迁移向导。 |
|
许多与 Application Server 的先前版本相兼容的操作系统针对 V6 的新要求进行了更新。在某些情况下,操作系统版本并不能满足 V6 的最低要求,需要对操作系统进行升级。当需要这种升级时,请遵循下面概述的迁移步骤: - 执行下面某一个 WASPreUpgrade 步骤,执行哪一个步骤取决于从什么操作系统迁移:如果从 AIX 4.3.3 或者 Solaris 7 迁移,请遵循步骤 B,否则遵循步骤 A:
- 如果不是从 AIX 4.3.3 或者 Solaris 7 迁移,则在进行任何操作系统升级之前执行 WASPreUpgrade 步骤。这将允许在已知状态下捕获先前版本中的信息。为此,可以直接从 CD 或安装映像运行 WASPreUpgrade 工具(该工具位于安装映像根目录的 migration/bin 目录中)。有关手动调用 WASPreUpgrade 工具的详细信息,请参阅迁移命令行工具。
- 由于 JDK 的要求,无法在 AIX 4.3.3 和 Solaris 7 上运行 WASPreUpgrade 工具。因此,如果您在这两个操作系统的某一个中运行 V4,则必须手动创建备份目录。WebSphere Application Server V6 Information Center 包括一篇提供了创建该目录的具体说明的文章。在 Information Center 中搜索“migration os upgrade”或者沿图 8 所示的路径导航。
图 8:V6 Information Center 搜索

- 卸载 Application Server 的先前版本。(可选的)在许多情况下,Application Server 的先前版本可以在更新的操作系统版本上运行。(有关 Application Server 的先前版本支持哪些新的操作系统版本的详细信息,请参阅参考资料中相关的详细中心。)
- 执行操作系统升级。参考操作系统供应商提供的文档以获得完成该步骤的说明。
- 安装 Application Server V6,并创建所需的配置文件。
- 执行 WASPostUpgrade 步骤:将 1A 或 1B 步骤中创建的目录作为迁移备份目录。有关手动调用 WASPostUpgrade 工具的详细信息,请参阅迁移命令行工具。
阅读 WebSphere Application Server V6 requirements document 以了解操作系统以及相关软件的最低版本和修补程序级别要求。
将 V4 多节点迁移到 V6 单元 部署管理器的概念是在 V5 中引入的。部署管理器管理单元中的所有节点。当从 V4 多节点配置迁移到 V6 单元时,有必要为部署管理器创建另一个配置文件,此配置文件可以与某个 V4 节点位于同一系统,也可以在自己的系统中。 对于从 V4 迁移时创建的配置文件有特殊约束。具体来说,V6 配置文件的节点名称必须与对应的 V4 联合节点的节点名称相匹配。对于部署管理器配置文件没有命名约束,这是由于 V4 中没有类似的对象。 将 V4 多节点配置迁移到 V6 单元:
- 将现有节点迁移到 V6 独立节点:
- 安装 V6 并创建 Application Server 配置文件。
- 使用迁移向导或迁移命令行工具将节点迁移到 V6 配置文件。
- 当从 Application Server V4(高级版)迁移时,V4 管理服务器必须在迁移的 WASPreUpgrade 阶段运行。
在 V4 环境中为每个节点重复第一步。
- 获得新的系统并安装 V6(图 9)或使用已安装 V6 的现有系统(图 10),然后创建 V6 部署管理器配置文件:
- 需要使用从任何 V4 节点获得的备份目录在该配置文件上运行 WASPostUpgrade 命令。这一过程与“作为迁移工作的一部分升级操作系统”中描述的过程(从步骤 4 开始)非常类似。
- 如果 V6 部署管理器配置文件在新的系统上,则需要将备份目录复制到该新的系统。
- 当从 V4 多节点配置迁移时,不能用迁移向导来迁移部署管理器,这一步必须手动完成。此外,您只需使用某个 V4 节点的备份目录运行 WASPostUpgrade 命令即可。该命令类似于下面的命令,其中 C:\IBM\WebSphere\BackupV4Config 是从某个 V4 节点获得的备份目录:
C:\IBM\WebSphere\AppServer60\profiles\Dmgr01\bin\WASPostUpgrade.bat
C:\IBM\WebSphere\BackupV4Config
|
图 9. 迁移到 V6 单元的 V4 多节点域,其中部署管理器位于新的系统上

图 10. 迁移到 V6 单元的 V4 多节点域,其中部署管理器位于现有系统上

- 现在需要将迁移的节点添加到部署管理器管理的 V6 单元中:
- 通过从部署管理器配置文件的 bin 目录中运行 startManager 启动部署管理器。(在 Windows 上,部署管理器还可以从“Start”菜单启动。)当显示与下面类似的消息时,部署管理器已成功启动:
ADMU3000I: Server dmgr open for e-business; process id is 1920
|
也可以查看部署管理器配置文件的 logs\dmgr 文件夹中的 startServer.log 文件中的消息。
- 在每一个迁移的节点上,运行 addNode 命令以使它们与 V6 单元联盟。该命令应该如下所示,其中 myDMgrHost 是 V6 部署管理器的主机名:
C:\IBM\WebSphere\AppServer60\profiles\default\bin\addNode.sh myDMgrHost 8879 -includeapps
|
最后一步,addNode 命令启动节点。(有关 addNode 命令的详细信息,请参阅参考资料中的 WebSphere Application Server V6 Information Center。)
此时,将出现一个功能齐全的 V6 单元。V4 ServerGroups 转换为 V6 集群。然而,V4 ServerGroup 中出现的所有应用程序可能需要重新安装到 V6 集群中。V4 ServerGroup 成员将迁移到 V6 集群成员。 使用 Web 浏览器访问 V6 管理控制台。缺省位置是: http://your_fully_qualified_server_name:9060/ibm/console
或者,当启用了安全性时,缺省位置是: https://your_fully_qualified_server_name:9043/ibm/console
其中 your_fully_qualified_server_name 是部署管理器服务器的完全限定名。在启用安全性之前,可以输入任何用户 ID 来访问管理控制台,因为它仅用于跟踪更改。 图 11 显示了 V6 管理控制台登录屏幕的示例。 图 11. 不安全的管理控制台登录

将 V5 单元迁移到 V6  | | 部署管理器必须始终具有单元中所有联合节点的最高版本和修补程序级别,因此必须首先迁移部署管理器。当尝试迁移联合节点时,已迁移的部署管理器必须正在运行。 |
|
部署管理器的概念是在 V5 中引入的。部署管理器是单元中的特殊服务器,它负责管理文件和资源,并向用户提供与单元的单点交互。每一个单元都需要部署管理器,而且每个单元只限于一个部署管理器。 对于作为 V5 联合节点的目的地或 V5 部署管理器的 V6 配置文件有一些限制。具体来说,V6 配置文件的节点名称的值必须与 V5 联合节点的节点名称相匹配。另外,V6 部署管理器配置文件的单元名称必须与 V5 部署管理器的单元名称相匹配。 V6 中继续使用这一概念,并没有显著的变化。因此,对于从 V5 向 V6 迁移,必须在 V6 创建部署管理器配置文件,只有 V5 部署管理器能够迁移到该配置文件。不能将单元中节点的任何备份目录用于部署管理器迁移,这是因为单元中的节点只包含该节点的全部信息以及其他节点的模板信息。部署管理器必须具有单元中所有节点的全部信息,因此备份目录必须来自于 V5 部署管理器节点。 V6 中的一个新概念是增量单元升级,它使用户能够一次将一台机器迁移到新的 Application Server 版本,在任何时候产生可以包含 V5 和 V6 节点的单元。请注意,让 6.0.0.0 版本单元包含 V5 节点的唯一方式就是使用此增量单元升级;目前不能将新的 V5 节点添加到 6.0.0.0 版本单元中。对迁移节点的顺序的唯一限制是部署管理器必须具有单元的最高版本级别,因此必须首先成功迁移部署管理器,并且在迁移 V5 联合节点之前必须启动 V6 部署管理器。 成功迁移部署管理器之后,可以选择立即启动 V5 节点,或者关闭某些 V5 节点并迁移到 V6。对于同时关闭和迁移的节点的数目没有限制。然而,联合节点迁移到 V6 以后,该节点的 V5 版本可能不会重新连接到新单元中的 V6 部署管理器。如果由于某种原因希望将节点返回到 V5 版本,则整个单元必须回滚到 V5 状态。请参阅回滚到 V5。
在 Linux 或 UNIX 上从以非根用户 ID 运行的配置迁移 在 V5 中,不要求 Linux® 或 UNIX® 以根用户 ID 运行应用服务器。这在迁移到 V6 时产生了一种新情况:由于 V6 中的配置文件是在迁移之前创建的,因此从 V5 配置进行的迁移可能会试图迁移到使用另一个用户 ID 创建的配置文件。迁移工具允许这种情况,然而,如果在已迁移的配置文件中启用安全性,则可能需要一些手动步骤。具体来说,当在 V5 中指定了“run as user”值时,此值将迁移到 V6,如果用户没有访问 V6 配置文件的权限,则 Application Server 将无法启动。 为了解决这一问题,您必须授予用户(Application Server 安装试图以该用户的身份运行)访问特定配置文件目录中的文件的权限。例如,假设对 V5 进行了配置,其中: - 将 V5 设置为以非根用户“wasAdmin”的身份运行。
- 由根用户安装 V6,并创建一个名为“migratedServer”的配置文件。
- 使用 migratedServer 配置文件将 V5 迁移到 V6。
此时,硬盘上的 V6 migratedServer 配置文件具有操作系统设置的只允许根用户访问文件的权限。然而,从 V5 迁移的属性要求 migratedServer 以用户 wasAdmin 的身份运行。因此,试图启动、停止或与 migratedServer 进行交互都将由于权限问题而导致失败。 请按照 Information Center 的文章 Migrating a previously non-root configuration to root 中的说明进行操作。这些步骤可以用于更改权限,例如,在上面的示例中,wasAdmin 用户具有访问 migratedServer 配置文件中的文件的权限。文章 Running an Application Server and node agent from a non-root user 可能对您也有帮助。
回滚到 V5 对于从 WebSphere Application Server Network Deployment V5 迁移到 V6 的用户,可以逐步完成迁移: - 首先将部署管理器迁移到 V6。
- 然后可以将所有的 V5 应用服务器节点连接到 V6 部署管理器。
- 将每一个节点依次从 V5 迁移到 V6。迁移工具将禁用 V5 节点,并将已迁移的 V6 节点连接到单元。禁用 V5 联合节点的原因是为了防止 V5 节点在 V6 联合节点取代它后试图连接到单元;这样做将创建一个不受支持的配置。
Application Server V5 安装并没有卸载;更确切地说,只是禁用已迁移的节点。反转已迁移单元的唯一可行的方法是回滚整个单元。这会使配置返回到它在迁移之前的状态。回滚整个单元以后,可以根据您的选择重新启动迁移过程。 将已迁移的单元回滚到 V5: - 关闭单元。必须关闭所有迁移到 V6 的节点和已迁移的部署管理器,并且必须卸载配置文件。
- 还原已迁移的 V5 节点。已迁移的所有 V5 联合节点和部署管理器需要运行 JACL 脚本来重新启用 V5 节点:
- 使用 Application Server V5 根目录的 bin 目录中的 migrationDisablementReversal.jacl 脚本。例如:
C:\WebSphere\AppServer5\bin\migrationDisablementReversal.jacl.
- 使用 wsadmin 工具运行该脚本。例如:
在 Linux 或 UNIX 上:
$WAS_HOME/bin/wsadmin.sh -f migrationDisablementReversal.jacl -conntype NONE 在 Windows 上:
%WAS_HOME%\bin\wsadmin -f migrationDisablementReversal.jacl -conntypeNONE
- 重新启动 V5 单元:回滚所有 V5 联合节点、部署管理器并且反转禁用过程后,启动部署管理器,然后依次启动每一个节点。
结束语 现在,您应该对向 WebSphere Application Server V6 迁移中涉及到的改变(如迁移向导)有了大概的了解。无论您是执行作为迁移工作的一部分的操作系统升级,还是只迁移一个单元,现在都应该了解您有哪些选择以及如何开始。衷心希望您能够顺利地完成迁移,并且享受到使用新的且改进的 IBM WebSphere Application Server V6 的乐趣。
致谢 特别感谢 Wayne Beaton、Dana Duffield、Brian Stelzer 和 Mike Thelen 审阅了本文
参考资料
作者简介  | | Diane Chalmers 是 IBM 的一名软件工程师,在明尼苏达州罗彻斯特市工作。她是 WebSphere Application Server 的 System Verification Test (SVT) 小组迁移方面的联络人。Diane 有五年多的测试经验。 |
 | | Mark Luchini 是 IBM 的一名软件工程师,在明尼苏达州罗彻斯特市工作。他是 WebSphere Application Server 的 System Verification Test (SVT) 迁移小组的一名成员,同时还是 JDBC 3.0 兼容测试的主管,主要研究跨平台 eServer 测试(zSeries、iSeries 和 pSeries)。 |
|