使用命令行工具迁移单元

开始之前

支持的配置 支持的配置:

本文是关于概要文件配置迁移。要将应用程序迁移到最新版本,请使用 WebSphere® Application Server Migration Toolkit。有关更多信息,请参阅 WASdev 上的 Migration Toolkit

sptcfg

请查看知识库:WebSphere Application Server 的迁移规划中的迁移规划信息。

提示: 可以指定 -properties file_name.properties 参数来输入属性文件,而不对迁移命令指定各个参数。有关更多信息,请参阅通过属性定义迁移

本方案涵盖在同一主机上迁移单元。如果您打算将单元迁移到另一主机,请参阅“使用命令行工具将单元迁移到新的主机”

关于此任务

可以使用命令行工具将单元从先前版本的 WebSphere Application Server 迁移到 V9.0。单元配置由 Deployment Manager 以及一个或多个节点、Web 服务器和应用程序客户机组成。所有端口都将迁移到新配置中。此过程假定先前配置处于运行状态。

避免故障 避免故障: 确保最大打开文件数设置为 10000 或更大的值。如果打开的文件数太少,那么可能会导致各种迁移故障。gotcha
对于转换用户 对于转换用户: 以下产品先前需要单独的迁移工具,但现在却作为标准迁移过程的一部分进行迁移:
  • WebSphere Extended Deployment Compute Grid 或 Feature Pack for Modern Batch
  • WebSphere Virtual Enterprise 或 Intelligent Management
有关这些更改的更多信息,请参阅针对迁移的新增内容trns

过程

  1. 备份 Deployment Manager 和所有旧节点。

    为了预防迁移期间发生故障,请使用 backupConfig 命令将当前 Deployment Manager 和节点配置保存到稍后可用于执行恢复的文件中。有关更多信息,请参阅backupConfig 命令

    1. 切换到 deployment_manager_profile_root/bin 目录。
    2. 运行带有相应参数的 backupConfig 命令,并将当前概要文件配置保存到文件中。 例如:
      /opt/WebSphereV70/profiles/v70dmgr01/bin/backupConfig.sh /mybackupdir/v70dmgr01backupBeforeV90migration.zip 
      -username myuser -password mypass -nostop
    3. 对于配置中的每个节点,切换到 node_profile_root/bin 目录。
    4. 运行带有适当参数的 backupConfig 命令,并将当前概要文件配置保存到文件中。 例如:
      /opt/WebSphereV70/profiles/v70node01/bin/backupConfig.sh /mybackupdir/
      v70node01backupBeforeV90migration.zip -username myuser -password mypass -nostop
  2. WebSphere Application Server V9.0 安装到每台目标机器上的新目录中。

    有关更多信息,请参阅安装文档。

  3. 通过附带适当的参数运行 manageprofiles 命令来创建目标 Deployment Manager 概要文件。

    目标 Deployment Manager 概要文件是将作为迁移目标的新 Deployment Manager 概要文件。

    避免故障 避免故障: V9.0 概要文件 nodeNamecellName 必须与先前的 V7.0 或更高版本 nodeNamecellName 相匹配。如果 V9.0 Deployment Manager cellNamenodeName 不同,那么迁移将失败。gotcha
    例如:
    /opt/WebSphereV90/bin/manageprofiles.sh -create -profileName v70toV90dmgr01 
    -templatePath /opt/WebSphereV90/profileTemplates/management -serverType 
    DEPLOYMENT_MANAGER -nodeName currentDmgrNodeName -cellName currentCellName 
    -hostName mydmgrhost.company.com
  4. 通过从新的 Deployment Manager 概要文件 bin 目录运行 WASPreUpgrade 命令,将当前 Deployment Manager 配置保存到迁移备份目录中。

    WASPreUpgrade 命令不会更改 V7.0 或更高版本 配置。有关更多信息,请参阅WASPreUpgrade 命令

    注: 如果要从 V8.0 或更高版本迁移到 V9.0 并且概要文件为 Deployment Manager,那么 V8.0 概要文件在您运行 WASPreUpgrade 命令时会停止。仅当您在命令行上提供 -keepDmgrEnabled true 或者在迁移向导中指定相应的选项时,Deployment Manager 才会在 WASPreUpgrade 完成之前启动。
    1. 运行 WASPreUpgrade 命令。 例如:
      /opt/WebSphereV90/bin/WASPreUpgrade.sh /mybackup/v70toV90dmgr01 /opt/WebSphereV70 -oldProfile 70dmgr01
    2. 查看控制台输出和 WASPreUpgrade 日志中的警告或错误。

      完成 WASPreUpgrade 命令之后,请检查控制台输出中是否存在下列消息:失败,发生了错误或者已完成,但出现警告。然后,检查 WASPreUpgrade.old_Profile.timestamp.logWASPreUpgrade.trace 日志文件中是否存在任何警告或错误。

      如果存在错误,请更正错误,然后再次运行 WASPreUpgrade 命令。请检查警告是否会影响 V9.0 上的任何其他迁移或者运行时活动。

      如果成功完成此命令,那么不需要检查日志中是否存在错误或警告。

  5. 通过运行 WASPostUpgrade 命令来恢复您保存在迁移备份目录中的先前 Deployment Manager 配置。

    如果您使用以下示例中所显示的选项,那么会转发所有端口,会关闭并禁用旧的 Deployment Manager,并且安装所有应用程序。

    有关更多信息,请参阅WASPostUpgrade 命令

    1. 运行 WASPostUpgrade 命令。 例如:
      /opt/WebSphereV90/bin/WASPostUpgrade.sh /mybackup/v70toV90dmgr01 -profileName 
      v70toV90dmgr01 -oldProfile 70dmgr01 -resolvePortConflicts incrementCurrent -backupConfig TRUE 
      -includeApps TRUE -keepDmgrEnabled FALSE 
      -username myuser -password mypass
      当您创建概要文件时,每次安装只将一个概要文件视为缺省概要文件。

      您可以通过查看 WAS_HOME/properties 目录中的 profileRegistry.xml 文件来确定缺省概要文件。执行 WASPreUpgrade 命令的过程中,会将源 profileRegistry.xml 复制到迁移备份目录中。

      如果您想要在迁移旧的概要文件之后继续使用该概要文件,请指定 -clone TRUE 参数。如果您指定对 Deployment Manager 进行克隆迁移,那么还必须克隆它的所有联合节点。指定自动进行克隆迁移会将 -keepDmgrEnabled 设置为 true。

      避免故障 避免故障: 运行 WASPostUpgrade 命令时,始终指定 -oldProfile-profileName 参数。gotcha
    2. 查看控制台输出和 WASPostUpgrade 日志中的警告或错误。 完成 WASPostUpgrade 命令之后,请检查控制台输出中是否存在下列消息:失败,发生了错误或者已完成,但出现警告。然后,检查 migration_backup_dir/logs/WASPostUpgrade.target_profile_name.timestamp.logmigration_backup_dir/logs/WASPostUpgrade.target_profile_name.trace 日志文件中是否存在任何警告或错误。如果存在错误,请更正错误,然后再次运行 WASPostUpgrade 命令。请检查警告是否会影响 V9.0 上的任何其他迁移或者运行时活动。

      如果正确迁移了配置,但是未安装任何应用程序,那么可以运行 WASMigrationAppInstaller 命令来仅安装未迁移的应用程序。有关更多信息,请参阅WASMigrationAppInstaller 命令

      如果成功完成此命令,那么不需要检查日志中是否存在错误或警告。

  6. 通过在 V9.0 Deployment Manager 上运行 backupConfig 命令,将 V9.0 Deployment Manager 配置备份到文件。
    避免故障 避免故障: 在单元迁移计划中,这是一个非常重要的步骤。如果存在任何节点迁移故障,那么可以将单元配置恢复到发生故障之前的状态,执行补救操作,然后再次尝试迁移该节点。gotcha
    1. 切换到 deployment_manager_profile_root/bin 目录
    2. 附带适当的参数运行 backupConfig 命令。 例如:
      /opt/WebSphereV90/profiles/v70toV90dmgr01/bin/backupConfig.sh /mybackupdir/
      v70toV90dmgr01backupMigratedDmgrOnly.zip -username myuser -password mypass
  7. 启动 V9.0 Deployment Manager。

    请确保先前版本的 Deployment Manager 未运行。

    1. 切换到新的 V9.0 Deployment Manager 概要文件 bin 目录。
    2. 运行 startManager 命令。
    3. 在 Deployment Manager 运行时,检查 SystemOut.log 文件中是否存在警告或错误。
      注: 本主题引用了一个或多个应用程序服务器日志文件。作为另一种建议采用的方法,您可以在分布式系统和 IBM® i 系统上配置服务器以使用高性能可扩展日志记录 (HPEL) 记录和跟踪基础结构,而不使用 SystemOut.logSystemErr.logtrace.logactivity.log 文件。您还可以将 HPEL 与本机 z/OS® 日志记录设施结合使用。如果要使用 HPEL,那么可从服务器概要文件 bin 目录使用 LogViewer 命令行工具来访问所有日志和跟踪信息。有关使用 HPEL 的更多信息,请参阅有关使用 HPEL 对应用程序进行故障诊断的信息。
    4. 检查节点的所有 Node Agent 日志和应用程序服务器日志中是否存在新的警告或错误。 如果启用了自动同步,请允许节点进行同步,允许应用程序重新启动,然后检查日志中是否存在新的警告或错误。
  8. 对于 Compute Grid 或 Feature Pack for Modern Batch,请验证是否已正确迁移作业调度程序,以及您是否可以将作业分派给主管批处理应用程序的先前版本的服务器。

    要验证作业调度程序迁移,在 Deployment Manager 重新启动之后,通过 Web 浏览器访问作业管理控制台。

    要验证用于主管批处理应用程序的先前版本的服务器是否正确工作,请完成下列步骤:
    1. 验证已迁移的服务器或集群上的批处理应用程序是否已启动。请检查服务器日志或集群日志中是否存在任何错误。
    2. 通过从已迁移的作业调度程序服务器中提交作业来验证您是否可以将批处理作业分派给已迁移的服务器。可以使用作业管理控制台、WSGrid 实用程序、EJB 接口或者 Web Service 接口来提交作业。
  9. 迁移 Web 服务器的插件。
    1. 请确保 V9.0 Deployment Manager 正在运行。
    2. 对单元中使用的 Web 服务器插件版本进行升级。
    3. 查看适用于您使用的 Web 服务器类型和版本的支持信息。
  10. 迁移应用程序客户机安装。

    将客户机资源迁移为 V9.0 级别的资源。

    1. 安装 WebSphere V9.0 应用程序客户机。

      有关更多信息,请参阅安装文档。

    2. 运行 V9.0 WASPreUpgrade 命令,以将应用程序客户机安全设置保存到迁移备份目录中。 例如:
      /opt/AppClientV90/bin/WASPreUpgrade.sh /mybackup/v70clientToV90 /opt/AppClientV70
    3. 运行 V9.0 WASPostUpgrade 命令,以将应用程序客户机安全设置复原到新的 V9.0 客户机。 例如:
      /opt/AppClientV90/bin/WASPostUpgrade.sh /mybackup/v70clientToV90 
  11. 迁移节点。

    使用迁移工具将配置中先前版本的节点迁移到 V9.0。对于您计划迁移到 V9.0 的每个节点执行以下过程。

    避免故障 避免故障: 对于迁移到 V9.0 的每个节点,您必须使用相同的源节点名,但使用不同的临时单元名。gotcha
    1. 请确保 V9.0 Deployment Manager 正在运行。
    2. 创建目标节点概要文件。运行带有相应参数的 manageprofiles 命令,以创建新的受管概要文件。 例如:
      /opt/WebSphereV90/manageprofiles.sh -create -profileName node1 
      -templatePath /opt/WebSphereV90/profileTemplates/managed -nodeName currentNode1Name 
      -cellName currentCellName -hostName mynode1host.company.com
    3. 运行 WASPreUpgrade 命令以将当前节点配置信息保存到迁移备份目录。请选择新的目录来保存备份文件。 例如:
      /opt/WebSphereV90/bin/WASPreUpgrade.sh /mybackup/v70toV90node1 /opt/WebSphereV70 
      -oldProfile 70node1
    4. 查看控制台输出和 WASPreUpgrade 日志中的警告或错误。

      检查 WASPreUpgrade 控制台输出中是否存在下列消息:失败,发生了错误或者已完成,但出现警告

      检查下列日志中是否存在警告或错误:
      • migration_backup_dir/logs/WASPreUpgrade.old_profile.timestamp.log
      • migration_backup_dir/logs/WASPreUpgrade.trace

      如果成功完成 WASPreUpgrade 命令,那么不必检查日志中是否存在错误或警告。

    5. 停止 Node Agent。 在迁移到 V9.0 期间,如果有 V7.0 或更高版本 节点处于运行状态,那么必须停止所迁移的节点上的 Node Agent。如果不停止 Node Agent,那么您可能会遇到损坏问题。
    6. 运行 WASPostUpgrade 命令以将所保存的节点配置复原到新的 V9.0 受管概要文件。 例如:
      /opt/WebSphereV90/bin/WASPostUpgrade.sh /mybackup/v70toV90node1 
      -profileName currentNode1Name -oldProfile 70node1 -resolvePortConflicts incrementCurrent 
      -backupConfig TRUE -username myuser -password mypass
      如果您已克隆 Deployment Manager,那么您还必须克隆所有联合节点。指定 -clone TRUE 参数以及新的 Deployment Manager 主机名和 SOAP 或 RMI 端口。除非还克隆了 Deployment Manager,否则请勿克隆联合节点。
      /opt/WebSphereV90/bin/WASPostUpgrade.sh /mybackup/v70toV90node1 
      -profileName currentNode1Name -oldProfile 70node1 -resolvePortConflicts incrementCurrent 
      -backupConfig TRUE -username myuser -password mypass
      -clone TRUE -newDmgrHostName myV90DmgrHost.mycompany.com -newDmgrSoapPort 8879
    7. 查看控制台输出和 WASPostUpgrade 日志中的警告或错误。

      检查 WASPostUpgrade 控制台输出中是否存在下列消息:失败,发生了错误或者已完成,但出现警告

      检查下列日志中是否存在错误或警告:
      • migration_backup_dir/logs/WASPostUpgrade.target_profile.timestamp.log
      • migration_backup_dir/logs/WASPostUpgrade.target_profile.trace
      注: 如果 WASPostUpgrade 命令失败,您可能不得不根据 backupConfig 文件复原 V9.0 Deployment Manager。如果 WASPostUpgrade 命令处理运行了 syncNode 命令,那么 Deployment Manager 将知道已迁移节点。直到您将 Deployment Manager 复原到迁移节点之前所处的状态之后,才能再次迁移节点。

      如果正确迁移了配置,但是未安装任何应用程序,那么可以运行 WASMigrationAppInstaller 命令来仅安装未迁移的应用程序。有关更多信息,请参阅WASMigrationAppInstaller 命令

      如果此命令成功完成,那么不必检查日志中是否存在错误或警告。

    8. 检查 V9.0 Deployment Manager SystemOut.log 文件中是否存在警告或错误。
      注: 本主题引用了一个或多个应用程序服务器日志文件。作为另一种建议采用的方法,您可以在分布式系统和 IBM i 系统上配置服务器以使用高性能可扩展日志记录 (HPEL) 记录和跟踪基础结构,而不使用 SystemOut.logSystemErr.logtrace.logactivity.log 文件。您还可以将 HPEL 与本机 z/OS 日志记录设施结合使用。如果要使用 HPEL,那么可从服务器概要文件 bin 目录使用 LogViewer 命令行工具来访问所有日志和跟踪信息。有关使用 HPEL 的更多信息,请参阅有关使用 HPEL 对应用程序进行故障诊断的信息。
    9. 启动已迁移的 V9.0 Node Agent。
    10. 检查 V9.0 Deployment Manager 和节点的 SystemOut.log 文件中是否存在警告或错误。
    11. 对该单元进行同步。
    12. 停止已迁移的 V9.0 节点上的所有应用程序服务器。
    13. 启动已迁移的 V9.0 节点上的相应应用程序服务器。
    14. 对于 Compute Grid 或 Feature Pack for Modern Batch,请验证是否已正确迁移作业调度程序,以及您是否可以将作业分派给主管批处理应用程序的已迁移的服务器。

      要验证作业调度程序迁移,在已迁移的应用程序服务器或集群重新启动之后,通过 Web 浏览器访问作业管理控制台。

      要验证用于主管批处理应用程序的 V9.0 服务器是否正确工作,请完成下列步骤:
      1. 验证已迁移的服务器或集群上的批处理应用程序是否已启动。请检查服务器日志或集群日志中是否存在任何错误。
      2. 通过从已迁移的作业调度程序服务器中提交作业来验证您是否可以将批处理作业分派给已迁移的服务器。可以使用作业管理控制台、WSGrid 实用程序、EJB 接口或者 Web Service 接口来提交作业。
    15. 通过附带适当的参数运行 backupConfig 命令将 V9.0 概要文件配置保存到文件中。 例如:
      /opt/WebSphereV90/profiles/v70toV90node1/bin/backupConfig.sh /mybackupdir/
      v70toV90node1.zip -username myuser -password mypass -nostop
      每次运行 backupConfig 命令时,都请使用新的备份文件名。
    16. 通过附带适当的参数运行 backupConfig 命令将 Deployment Manager 配置保存到文件中。 运行此命令之前,在 V9.0 Deployment Manager 主机上,切换到 deployment_manager_profile_root/bin 目录。
      注: 对于已迁移的每个节点,请将 V9.0 Deployment Manager 配置备份到新的备份文件。
      例如:
      /opt/WebSphereV90/profiles/v70toV90dmgr01/bin/backupConfig.sh /mybackupdir/
      v70toV90dmgr01backupMigratedDmgrPlusNodeX.zip -username myuser -password mypass
      注: 如果要将节点迁移到另一主机,请参阅“使用命令行工具将单元迁移到新的主机”中有关迁移节点的信息。

结果

您已使用迁移工具从先前版本迁移到 WebSphere Application Server V9.0


指示主题类型的图标 任务主题



时间戳记图标 最近一次更新时间: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-dist&topic=tmig_migrate_cells_commandline
文件名:tmig_migrate_cells_commandline.html