管理代理程序概要文件用于管理开发环境、单元测试环境或驻留在单一机器上的服务器场之类的环境中的多个基本应用程序服务器。必须先迁移管理代理程序,然后才能将受管基本应用程序服务器从 V7.0 或更高版本 迁移到 V9.0。
关于此任务
本任务描述如何使用 z/OS 配置迁移管理工具将管理代理程序及其相关联的受管基本应用程序服务器集从
WebSphere Application Server V7.0 或更高版本 迁移到 V9.0。基本应用程序服务器在向单一管理代理程序注册时变为受管应用程序服务器。管理代理程序可以管理一个或多个基本应用程序服务器,并且必须与其管理的基本应用程序服务器处于同一发行版级别且位于同一机器上。z/OS 具有以下限制:在任意时刻,只能有 V7.0 或更高版本 或 V9.0 管理代理程序处于运行状态。以下指示信息说明何时启动和停止旧的以及新的管理代理程序。此限制要求所有受管基本应用程序服务器同时进行迁移。
避免故障: 在弹性管理环境中迁移受管基本应用程序服务器时,请确保
V9.0 和先前发行版中的节点名相同。
gotcha
过程
- 通过运行 backupConfig 命令来备份源管理代理程序和节点配置。
backupConfig 命令将管理代理程序和节点配置保存到一个文件中,稍后可将此文件用于执行恢复。
- 切换到 administrative_agent_profile_root/bin 目录。
- 对管理代理程序以及所有受管基本应用程序服务器运行带有适当参数的 backupConfig 命令。 例如:
/opt/WebSphereV70/profiles/v70dmgr01/bin/backupConfig.sh
/mybackupdir/v70dmgr01backupBeforeV90migration.zip
-username myuser -password mypass -nostop
- 对于配置中的每个节点,切换到 profile_root/bin 目录。
- 运行带有适当参数的 backupConfig 命令,并将当前概要文件配置保存到文件中。 例如:
/opt/WebSphereV70/profiles/v70mas01/bin/backupConfig.sh
/mybackupdir/v70mas01rbackupBeforeV90migration.zip
-username myuser -password mypass -nostop
另外,可以使用 PAX 命令来备份所有 HFS 文件。有关更多信息,请参阅使用 z/OS UNIX pax 命令。
- 将 WebSphere Application Server z/OS® 版 V9.0 安装到每台目标主机上。
有关更多信息,请参阅安装文档。
- 在 z/OS 迁移管理工具中指定新的管理代理程序迁移配置。
使用 z/OS 迁移管理工具可以创建迁移定义以及上载用于迁移管理代理程序的作业。
避免故障: V9.0 单元名必须与
V7.0 或更高版本 配置中的单元名相匹配。如果创建具有新单元名的概要文件,那么迁移将失败。
gotcha
- 完成以下工作表: 在“z/OS 迁移管理工具:工作表”中指定 Deployment Manager 迁移配置
- 在“选择迁移节点类型”面板上,选择迁移管理代理程序。
- 使用工作表中的值来填写后续面板上的字段。
- 复查管理代理程序迁移定义,以确保所有值均正确。
- 在 WebSphere Application Server z/OS 版 迁移定义表中,选择要复查的迁移定义。
- 单击查看。
- 有关迁移定义的信息,请单击摘要、指示信息或响应文件选项卡。
- 将迁移作业上载至目标 z/OS 系统。
- 请确保所有进行中的作业在受管概要文件上已完成。
必须先完成所有进行中的作业,然后才能对受管应用程序服务器或 Deployment Manager 运行 WASPreUpgrade 命令。
- 如果管理代理程序已向作业管理器注册,请停止轮询作业管理器。
有关如何停止作业管理器的更多信息,请参阅 AdminTask 对象的 ManagedNodeAgent 命令组(使用 wsadmin 脚本编制方法)。
- 遵循 z/OS 迁移管理工具的“迁移指示信息”视图中的指示信息或者您已上载到目标 z/OS 系统的 CNTL 数据集的 BBOMAINS 成员中的指示信息来对管理代理程序运行迁移作业。
CRPROF(概要文件创建)、PREUPGRD(升级前)和 UPGRADE(升级)步骤全都在此过程中执行。
- 验证在 ZMMT 中指定的 HFS/ZFS 工作目录中创建的所有输出以及批处理作业创建的所有 MVS 作业输出。
验证返回码是否为 0,然后查看配置文件系统上迁移临时目录中的日志文件。
迁移临时目录为 temporary_directory_location/nnnnn,其中 temporary_directory_location 是指定为临时目录位置的目录,nnnnn 是生成迁移作业时所生成的作为迁移标识的数值。缺省临时目录位置为 /tmp/migrate。
- 在 z/OS 迁移管理工具中指定受管应用程序迁移配置。
使用 z/OS 迁移管理工具可以创建迁移定义以及上载用于迁移受管基本应用程序服务器的作业。
避免故障: V9.0 单元名必须与
V7.0 或更高版本 配置中的单元名相匹配。如果创建具有新单元名的概要文件,那么迁移将失败。
gotcha
- 完成以下工作表: 在“z/OS 迁移管理工具:工作表”中指定联合节点迁移配置
- 在“选择迁移节点类型”面板上,选择迁移受管基本应用程序服务器。
- 使用工作表中的值来填写后续面板上的字段。
- 复查联合节点迁移定义以确保所有值均正确。
- 在 WebSphere Application Server z/OS 版 迁移定义表中,选择要复查的迁移定义。
- 单击查看。
- 有关迁移定义的信息,请单击摘要、指示信息或响应文件选项卡。
- 将迁移作业上载至目标 z/OS 系统。
- 遵循 z/OS 迁移管理工具的“迁移指示信息”视图中的指示信息或者您已上载到目标 z/OS 系统的 CNTL 数据集的 BBOMDINS 成员中的指示信息来对受管基本应用程序服务器运行迁移作业。
CRPROF(概要文件创建)、PREUPGRD(升级前)和 UPGRADE(升级)步骤全都在此过程中执行。
避免故障: - 请确保源管理代理程序正在运行,以便可以向管理代理程序注销应用程序服务器。
- 如果受管应用程序服务器还向作业管理器进行了注册,那么必须先从作业管理器中注销,然后再运行受管应用程序服务器迁移。在迁移完成后,请再次向管理代理程序和作业管理器注册。
gotcha
- 对 HFS 工作目录(在 ZMMT 中指定)中创建的所有输出以及批处理作业创建的所有
MVS 作业输出进行验证。
验证返回码是否为 0,然后查看配置文件系统上迁移临时目录中的日志文件。
迁移临时目录为 temporary_directory_location/nnnnn,其中 temporary_directory_location 是指定为临时目录位置的目录,nnnnn 是生成迁移作业时所生成的作为迁移标识的数值。缺省临时目录位置为 /tmp/migrate。
- 切换到已迁移的新 V9.0 管理代理程序
避免故障: 请确保迁移所有先前向旧管理代理程序注册的受管应用程序服务器。在这些受管应用程序服务器的迁移过程中,应该已将其全部注销。
gotcha
- 停止旧的 V7.0 或更高版本 管理代理程序。
- 启动新的 V9.0 管理代理程序。
- 启动受管应用程序服务器。
- 启动每个受管基本应用程序服务器。
- 向新的管理代理程序注册每个受管应用程序服务器。
请检查 Node Agent 日志中是否存在错误。
- 开始轮询作业管理器。
有关更多信息,请参阅 AdminTask 对象的 ManagedNodeAgent 命令组(使用 wsadmin 脚本编制方法)。
结果
您已使用迁移工具将管理代理程序概要文件及其相关联的受管基本应用程序服务器从 WebSphere
Application Server V7.0 或更高版本 迁移到 V9.0。