迁移管理代理程序概要文件及其已注册的受管基本应用程序服务器集

管理代理程序概要文件用于管理开发环境、单元测试环境或驻留在单一机器上的服务器场之类的环境中的多个基本应用程序服务器。必须先迁移管理代理程序,然后才能将受管基本应用程序服务器从 V7.0 或更高版本 迁移到 V9.0

开始之前

支持的配置 支持的配置:

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

sptcfg

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

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

关于此任务

基本应用程序服务器在向单一管理代理程序注册时变为受管应用程序服务器。管理代理程序可以管理一个或多个基本应用程序服务器,并且必须与其管理的基本应用程序服务器处于同一发行版级别且位于同一机器上。由于存在此限制,因此旧发行版和新发行版的管理代理程序将同时运行,直到所有受管基本应用程序服务器都迁移完成为止。迁移管理代理程序并不会迁移它的旧端口值,但是,将迁移所有其他配置数据。

请使用新 V9.0 管理代理程序的 serverindex.xml 文件中定义的 WC_adminhost 或 WC_adminhost_ 安全端口来访问 V9.0 管理代理程序控制台。此外,在此过程中,不得关闭或禁用 V7.0 或更高版本 管理代理程序。

要在弹性管理环境中迁移受管基本应用程序服务器,请确保 V9.0 和先前发行版中的节点名相同。

避免故障 避免故障: 确保最大打开文件数设置为 10000 或更大的值。如果打开文件数太小,那么可能会引起各种迁移故障。gotcha

过程

  1. 请将 WebSphere Application Server V9.0 安装到目标主机上的新目录中。

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

  2. 创建将作为管理代理程序迁移目标的 V9.0 管理代理程序概要文件。

    附带适当的参数运行 manageprofiles 命令,以创建新的管理代理程序概要文件。

    例如:
    C:\WebSphere\AppServer90\bin>manageprofiles.bat -create -profileName AdminAgent01 -profilePath 
    C:\WebSphere\AppServer90\profiles\AdminAgent01 -templatePath C:\WebSphere\AppServer90\profileTemplates\management 
    -serverType ADMIN_AGENT -nodeName AdminAgentNode01 -cellName AdminAgentCell01 -hostName <myhostname>
  3. 请确保所有进行中的作业在受管概要文件上已完成。
  4. 对于要从作业管理器获取作业的概要文件,停止轮询作业管理器。

    在开始轮询作业之前,请对受管概要文件完成 WASPreUpgradeWASPostUpgrade。有关更多信息,请参阅 AdminTask 对象的 ManagedNodeAgent 命令组(使用 wsadmin 脚本编制方法)

  5. 通过从新的 WebSphere Application Server 安装根 bin 目录运行 WASPreUpgrade 命令将当前管理代理程序配置保存到迁移备份目录中。

    WASPreUpgrade 命令不会对旧配置进行任何更改。

    1. 运行 WASPreUpgrade 命令。

      有关命令参数的信息,请参阅WASPreUpgrade 命令

      例如:
      C:\WebSphere\AppServer90\bin>WASPreUpgrade.bat C:\WAS70AdminAgentbackup C:\WebSphere\AppServer70 -oldProfile AdminAgent01 
      -traceString *=all=enabled -tracefile C:\WAS70AdminAgentbackup\logs\WASPreMigrationSummary.log
    2. 查看控制台输出和 WASPreUpgrade 日志中的警告或错误。 完成 WASPreUpgrade 命令之后,请检查控制台输出中是否存在下列消息:失败,发生了错误或者已完成,但出现警告。然后,检查下列日志文件中是否存在任何警告或错误:
      • migration_backup_dir/logs/WASPreMigrationSummary.log
      • WASPreUpgrade.timestamp.log
      • WASPreUpgrade.trace

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

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

  6. 通过从新的 WebSphere Application Server 安装根 bin 目录运行 WASPostUpgrade 命令来复原先前的管理代理程序配置。
    1. 运行 WASPostUpgrade 命令,以便将保存的管理代理程序配置复原到新的 V9.0 管理代理程序概要文件中。 例如:
      C:\IBM\WebSphere\AppServer90\bin>WASPostUpgrade.bat C:\WAS70AdminAgentbackup -oldProfile AdminAgent01 -profileName AdminAgent01 
      -traceString *=all=enabled -tracefile C:\WAS70AdminAgentbackup\logs\WASPostMigrationSummary.log -username myuser -password mypass
    2. 查看控制台输出和 WASPostUpgrade 日志中的警告或错误。 完成 WASPostUpgrade 命令之后,请检查控制台输出中是否存在下列消息:失败,发生了错误或者已完成,但出现警告。然后,检查下列日志文件中是否存在任何警告或错误:
      • migration_backup_dir/logs/WASPostMigrationSummary.log
      • WASPostUpgrade.target_profile_name.timestamp.log
      • WASPostUpgrade.target_profile_name.trace

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

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

  7. 启动 V9.0 管理代理程序,并确保 V7.0 或更高版本V9.0 管理代理程序都在运行。
    1. 切换到新的 V9.0 管理代理程序概要文件 bin 目录。
    2. 运行 startServer adminagent 命令。
    3. 检查 SystemOut.log 文件中是否存在警告或错误。
      注: 本主题引用了一个或多个应用程序服务器日志文件。作为另一种建议采用的方法,您可以在分布式系统和 IBM® i 系统上配置服务器以使用高性能可扩展日志记录 (HPEL) 记录和跟踪基础结构,而不使用 SystemOut.logSystemErr.logtrace.logactivity.log 文件。您还可以将 HPEL 与本机 z/OS® 日志记录设施结合使用。如果要使用 HPEL,那么可从服务器概要文件 bin 目录使用 LogViewer 命令行工具来访问所有日志和跟踪信息。有关使用 HPEL 的更多信息,请参阅有关使用 HPEL 对应用程序进行故障诊断的信息。
  8. 迁移受管基本应用程序服务器。
    避免故障 避免故障: 要使迁移成功,必须满足以下条件:
    • 受管基本应用程序服务器必须位于相关管理代理程序所在的机器上。
    • V9.0 中的节点名与先前发行版中的节点名必须相同。
    • [Windows]如果您使用 Windows 平台并且计划迁移 SIB 组件,请先停止 AppSrv 服务器,然后再运行迁移。
    gotcha

    对于您计划迁移到 V9.0 的每个受管基本应用程序服务器,执行下列步骤:

    1. 创建目标基本应用程序服务器概要文件。运行带有相应参数的 manageprofiles 命令,以创建新的受管概要文件。 例如:
      C:\WebSphere\AppServer90\bin>manageprofiles.bat -create -profileName AppSrv01 
      -profilePath C:\WebSphere\AppServer90\profiles\AppSrv01
      -templatePath C:\WebSphere\AppServer90\profileTemplates\default 
      -serverType APPLICATION_SERVER -nodeName AppSrv01Node01 
      -cellName AppSrv01Cell01 -hostName <myhostname>
    2. 运行 WASPreUpgrade 命令,以便将当前受管基本应用程序服务器信息保存到迁移备份目录中。请选择新的目录来保存备份文件。 例如:
      C:\WebSphere\AppServer90\bin>WASPreUpgrade.bat C:\WAS70Appserver01backup 
      C:\WebSphere\AppServer70 -oldProfile Appserver01 -traceString *=all=enabled 
      -summaryLogName C:\WAS70Appserver01backup\logs\WASPreMigrationSummary.log
    3. 查看控制台输出和 WASPreUpgrade 日志中的警告或错误。 完成 WASPreUpgrade 命令之后,请检查控制台输出中是否存在下列消息:失败,发生了错误或者已完成,但出现警告。然后,检查下列日志文件中是否存在任何警告或错误:
      • migration_backup_dir/logs/WASPreMigrationSummary.log
      • WASPreUpgrade.timestamp.log
      • WASPreUpgrade.trace

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

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

    4. 运行 WASPostUpgrade 命令,以便将保存的受管应用程序服务器概要文件配置复原到新的 V9.0 基本应用程序服务器概要文件中。
      避免故障 避免故障: 此命令需要更多参数,并且,以下示例假定对这两个管理代理程序都启用了安全性。gotcha
      例如:
      C:\IBM\WebSphere\AppServer90\bin>WASPostUpgrade.bat C:\WAS70Appserver01backup 
      -oldProfile AppSrv01 -profileName AppSrv01 -traceString *=all=enabled 
      -summaryLogName C:\WAS70Appserver01backup\logs\WASPostMigrationSummary.log 
      -oldAdminAgentProfilePath C:\WebSphere\Appserver70\profiles\AdminAgent01
      -oldAdminAgentHostname myhostname -oldAdminAgentSoapPort 8879 -oldAdminAgentUsername 
      myusername -oldAdminAgentPassword mypassword -newAdminAgentProfilePath 
      C:\WebSphere\AppServer90\profiles\AdminAgent01 -newAdminAgentHostname 
      myhostname -newAdminAgentSoapPort 8887 -newAdminAgentUsername 
      myusername1 -newAdminAgentPassword mypassword1
    5. 查看控制台输出和 WASPostUpgrade 日志中的警告或错误。 完成 WASPostUpgrade 命令之后,请检查控制台输出中是否存在下列消息:失败,发生了错误或者已完成,但出现警告。然后,检查下列日志文件中是否存在任何警告或错误:
      • migration_backup_dir/logs/WASPostMigrationSummary.log
      • WASPostUpgrade.target_profile_name.timestamp.log
      • WASPostUpgrade.target_profile_name.trace

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

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

    6. 启动已迁移的 V9.0 受管应用程序服务器。
    7. 检查 V9.0 受管应用程序服务器的 SystemOut.log 中是否存在警告或错误。
      注: 本主题引用了一个或多个应用程序服务器日志文件。作为另一种建议采用的方法,您可以在分布式系统和 IBM i 系统上配置服务器以使用高性能可扩展日志记录 (HPEL) 记录和跟踪基础结构,而不使用 SystemOut.logSystemErr.logtrace.logactivity.log 文件。您还可以将 HPEL 与本机 z/OS 日志记录设施结合使用。如果要使用 HPEL,那么可从服务器概要文件 bin 目录使用 LogViewer 命令行工具来访问所有日志和跟踪信息。有关使用 HPEL 的更多信息,请参阅有关使用 HPEL 对应用程序进行故障诊断的信息。

结果

您已使用迁移工具将管理代理程序概要文件及其相关联受管基本应用程序服务器从 WebSphere Application Server V7.0 或更高版本 迁移到 V9.0。可以停止 V7.0 或更高版本 管理代理程序,并且可以将 V7.0 或更高版本 端口分配给 V9.0 管理代理程序。


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



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