WASPostUpgrade 命令

WebSphere® Application ServerWASPostUpgrade 命令用于从指定的 backupDirectory 中检索已保存的由 WASPreUpgrade 命令创建的配置。WebSphere Application ServerWASPostUpgrade 脚本用于从此目录中读取要迁移到 WebSphere Application Server V9.0 的配置,并将迁移的所有应用程序添加到 V9.0 安装的 app_server_root/installedApps 目录中。

位置

支持的配置 支持的配置:

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

sptcfg

命令文件位于 app_server_root/bin 目录中,并且必须从此目录中运行。

语法

[AIX][HP-UX][Linux][Solaris]
WASPostUpgrade.sh backupDirectory
                     [-properties properties_file_name]
                     [-username userID]
                     [-password password]
                     [-oldProfile profile_name]
                     [-profileName profile_name]
                     [-setPorts useOld | generateNew | port_starting_number]
                     [-resolvePortConflicts incrementCurrent | port_starting_number]
                     [-backupConfig true | false]
                     [-includeApps true | false | script]
                     [-clone true | false]
                      [-newDmgrHostname host_name]
                      [[-newDmgrSoapPort port_number] | [-newDmgrRmiPort port_number]]
                     [-keepDmgrEnabled true | false]
                     [-requestTimeout seconds]
                     [-javaoption -Xms...m -javaoption -Xmx...m]
                     [[-appInstallDirectory user_specified_directory] | 
                      [-keepAppDirectory true | false]]
                     [-traceString trace_spec [-traceFile file_name]]
[Windows]
WASPostUpgrade.bat backupDirectory
                     [-properties properties_file_name]
                     [-username userID]
                     [-password password]
                     [-oldProfile profile_name]
                     [-profileName profile_name]
                     [-setPorts useOld | generateNew | port_starting_number]
                     [-resolvePortConflicts incrementCurrent | port_starting_number]
                     [-backupConfig true | false]
                     [-includeApps true | false | script]
                     [-clone true | false]
                      [-newDmgrHostname host_name]
                      [[-newDmgrSoapPort port_number] | [-newDmgrRmiPort port_number]]
                     [-keepDmgrEnabled true | false]
                     [-requestTimeout seconds]
                     [-javaoption -Xms...m -javaoption -Xmx...m]
                     [[-appInstallDirectory user_specified_directory] | 
                      [-keepAppDirectory true | false]]
                     [-traceString trace_spec [-traceFile file_name]]
在对目标和源管理代理程序同时启用了安全性的情况下迁移已注册的应用程序服务器时,请使用这些参数:[AIX][HP-UX][Linux][Solaris]
WASPostUpgrade.sh backupDirectory
[-oldAdminAgentProfilePath path to old admin agent]
[-oldAdminAgentSoapPort soap port of old admin agent]
[-oldAdminAgentHostname hostname of old admin agent, defaults to localhost ]
[-oldAdminAgentUsername login username for old admin agent, if admin security is enabled ]
[-oldAdminAgentPassword login password for old admin agent, if admin security is enabled ]
[-newAdminAgentProfilePath path to new admin agent ]
[-newAdminAgentSoapPort soap port of new admin agent ]
[-newAdminAgentHostname hostname of new admin agent, defaults to localhost ]
[-newAdminAgentUsername login username for new admin agent, if admin security is enabled ]
[-newAdminAgentPassword login password for new admin agent, if admin security is enabled ]
[Windows]
WASPostUpgrade.bat backupDirectory
[-oldAdminAgentProfilePath path to old admin agent]
[-oldAdminAgentSoapPort soap port of old admin agent]
[-oldAdminAgentHostname hostname of old admin agent, defaults to localhost ]
[-oldAdminAgentUsername login username for old admin agent, if admin security is enabled ]
[-oldAdminAgentPassword login password for old admin agent, if admin security is enabled ]
[-newAdminAgentProfilePath path to new admin agent ]
[-newAdminAgentSoapPort soap port of new admin agent ]
[-newAdminAgentHostname hostname of new admin agent, defaults to localhost ]
[-newAdminAgentUsername login username for new admin agent, if admin security is enabled ]
[-newAdminAgentPassword login password for new admin agent, if admin security is enabled ]

参数

此命令具有以下参数:

backupDirectory
这是一个必需参数。backupDirectory 值指定 WASPreUpgrade 工具用来存储已保存的配置和文件的目录以及 WASPostUpgrade 工具从其中读取配置和文件的目录的名称。
-properties
这是一个可选参数。值 properties_file_name 指定其中包含用于定义迁移工具(例如,WASPostUpgrade)的操作方式的参数属性的属性文件的路径。

可以在迁移属性文件中定义参数属性,而不是在命令行上指定大多数可选参数。如果在属性文件中定义了参数,并且在命令行上也指定了参数,那么在命令行上指定的参数优先。

注: 无法在属性文件中指定某些参数,例如,-properties 参数本身以及 -username-password。有关无法定义为属性的参数的列表,请参阅 app_server_root/bin 目录中的模板 migration.properties 文件。
-username
这是一个可选参数。userID 值指定当前 WebSphere Application Server V7.0 或更高版本 安装版本的管理用户名。
如果以下条件成立,那么此参数为必需参数:
  • 正在迁移 Deployment Manager 或联合节点。
  • 源安装版本中已启用管理或全局安全性。
  • security.xml 文件中未定义管理或全局安全性用户标识。
-password
这是一个可选参数。password 值指定当前 WebSphere Application Server V7.0 或更高版本 安装版本的管理用户名的密码。
如果以下条件成立,那么此参数为必需参数:
  • 正在迁移 Deployment Manager 或联合节点。
  • 源安装版本中已启用管理或全局安全性。
  • security.xml 文件中未定义管理或全局安全性密码。
提示: 需要在迁移向导中指定密码或在命令行上使用带 -password 参数的 WASPostUpgrade 命令时,可以输入明文密码或使用经过异或加密的值。要使用经过异或加密的值,请输入整个密码(包括 {xor} 前缀)作为此参数的值。可以在先前配置的多个 WebSphere Application Server 配置文件的任何一个中指定这个经过异或加密的值,这些文件包括 soap.client.propsssl.client.propssecurity.xml 文件。
提示: 在命令行中使用带 -password 参数的 WASPostUpgrade 命令时,可以输入明文密码,也可以使用经过异或加密的值。要使用经过异或加密的值,请输入整个密码(包括 {xor} 前缀)作为此参数的值。可以在先前配置的多个 WebSphere Application Server 配置文件的任何一个中指定这个经过异或加密的值,这些文件包括 soap.client.propsssl.client.propssecurity.xml 文件。
-oldProfile
这是一个可选参数,用于从先前的 WebSphere Application Server 版本迁移实例或概要文件。 在运行此命令之前,迁移备份目录中必须已存在实例或概要文件。
如果未指定 -oldProfile 参数,那么将使用缺省概要文件。如果未找到缺省概要文件,那么系统会报告错误。
避免故障 避免故障: 如果未对 -oldProfile 指定特定的概要文件名称,那么将迁移任何指定的“缺省”概要文件。您可能必须使用 WASPostUpgrade 迁移后命令来迁移在迁移前创建的备份中的每个概要文件(对于客户机在新的 V9.0 环境中需要的每个概要文件,指定相应的 -oldProfile 和 -profileName 参数)。如果旧概要文件除包含样本应用程序和系统应用程序以外还包含已安装的应用程序 (installedApps),那么迁移过程将自动迁移这些应用程序。gotcha
-profileName
这是一个可选参数,用于迁移到 WebSphere Application Server V9.0 中的特定概要文件。profile_name 值指定脚本要将配置迁移到的 V9.0 概要文件的名称。必须在创建此概要文件之后才能调用 WASPostUpgrade 命令。
如果未指定 -profileName 参数,那么将使用缺省概要文件。如果未找到缺省概要文件,那么系统会报告错误。
避免故障 避免故障: 如果未对 -profileName 指定特定的概要文件名称,那么将迁移任何指定的“缺省”概要文件。您可能必须使用 WASPostUpgrade 迁移后命令来迁移在迁移前创建的备份中的每个概要文件(对于客户机在新环境中需要的每个概要文件,指定相应的 -oldProfile 和 -profileName 参数)。如果旧概要文件除包含样本应用程序和系统应用程序以外还包含已安装的应用程序 (installedApps),那么迁移过程将自动迁移这些应用程序。gotcha
注:V9.0 迁移独立应用程序服务器时,可以选择已向管理代理程序注册的独立应用程序服务器节点作为迁移目标。
-backupConfig
这是一个可选参数,用来指定在 WASPostUpgrade 工具进行任何更改之前是否保存现有 WebSphere Application Server V9.0 配置。缺省值为 true - 即,使用 backupConfig 命令将当前配置的副本保存到 profile_name/temp 目录中。

若有必要,使用 restoreConfig 命令复原该配置。有关更多信息,请参阅 restoreConfig 命令

-setPorts
这是一个可选参数,用来指定如何为新概要文件设置端口。此参数采用以下值:
  • useOld(缺省值):使用旧概要文件所使用的端口。此值无法用于克隆迁移。
  • generateNew:根据缺省端口分配来生成新端口。
  • port_starting_number:生成新端口(从指定的值增加)。

如果对此参数指定了值,那么指定的任何新端口均根据此值设置。每次需要新端口值时,会根据此值来创建端口并递增种子值以便下一次使用。不会指定重复端口。

-resolvePortConflicts
此可选参数用于指定如何映射端口值。当无法使用某个端口时,会将它的值从起始值增加,直到找到可用的端口为止。
  • incrementCurrent(缺省值):从有冲突的端口值增加。
  • port_starting_number:从指定的公共起始端口值增加。
-includeApps
可以包括业务级应用程序、资产和组合单元作为迁移的组成部分。您可以选择在 WASPostUpgrade 命令中使用 -IncludeApps 参数来迁移这些项。这是一个可选参数,可以下列方式指定它:
  • True

    包括业务级应用程序、资产和组合单元作为迁移的组成部分。

    此值是缺省值。

  • False

    WASPostUpgrade 处理期间,不对用户企业应用程序、业务级应用程序、资产和组合单元执行任何操作。

  • Script
    • 企业应用程序

      准备用户企业应用程序以便安装在 WebSphere Application Server V9.0 installableApps 目录中,而不用在 WASPostUpgrade 处理期间安装这些应用程序。

      可以用来安装这些应用程序的脚本是在 backupDirectory 目录中生成的,并且保存在该目录中。在完成 WASPostUpgrade 命令之后,可以在任何时候以任何组合形式运行这些文件。您还可以对这些文件进行重组及合并,以提高应用程序安装效率。

    • 业务级应用程序、资产和组合单元

      生成 install_all_BLAs.jy 脚本并将其放入备份目录。此脚本可以将备份目录中的所有业务级应用程序、资产和组合单元迁移到目标概要文件。位于 <WAS_PROFILE_ROOT>/bin 目录中的 WASPostUpgradeBLAHelper.bat/.sh 脚本用于迁移 install_all_BLAs.txt 文件中的业务级应用程序、资产和组合单元。

      避免故障 避免故障: 要迁移业务级应用程序、资产和组合单元,必须先建立它们的依赖关系。gotcha

无论此参数设置的值为何,WebSphere Application Server 系统应用程序都将进行迁移。

-clone
此可选参数指示是否执行克隆迁移,这意味着您在将源概要文件迁移到 V9.0 环境之后可以继续使用该源概要文件。缺省值为 false。

-clone 参数为 true 时,您无法指定 -setPorts useold。新的概要文件配置必须使用唯一端口号,以免现在共存的新旧配置发生端口冲突。

如果您克隆 Deployment Manager,那么还必须克隆它的联合节点;在未克隆 Deployment Manager 的情况下无法克隆联合节点。联合节点的克隆迁移要求您在下列参数中设置新的主机名以及节点 SOAP 端口或者 RMI 端口。
-newDmgrHostname
V9.0 Deployment Manager 的主机名
-newDmgrSoapPort
V9.0 Deployment Manager 的简单对象访问协议 (SOAP) 端口
-newDmgrRmiPort
V9.0 Deployment Manager 的远程方法调用 (RMI) 端口
-keepDmgrEnabled
这是可选参数,用于指定是否禁用现有的 WebSphere Application Server V7.0 或更高版本 Deployment Manager。除非 -clone 参数为 true(在这种情况下,-keepDmgrEnabled也设置为 true),否则缺省值为 false。

如果将此参数指定为 true,那么完成迁移后,您可以使用现有的 V7.0 或更高版本 Deployment Manager。仅当您迁移 Deployment Manager 时此参数才有效;在所有其他迁移中都将忽略此参数。

注意: 请谨慎使用此参数。
  • 停止并禁用 WebSphere Application Server V7.0 或更高版本 Deployment Manager 配置通常是为了防止多个 Deployment Manager 管理相同的节点。在开始使用 V9.0 Deployment Manager 之前,必须先停止 V7.0 或更高版本 Deployment Manager。如果不这样做,那么最有可能发生的错误情况是启动 Deployment Manager 的第二个实例时产生端口冲突。
  • 如果将此参数指定为 true,那么意味着在迁移期间可能不会迁移在旧配置中所作的任何配置更改。
-keepAppDirectory
这是一个可选参数,用来指定是否将所有应用程序安装至它们当前所在的目录。缺省值为 false。

如果将此参数指定为 true,那么每个应用程序都将安装在它当前所在的位置。

如果指定此参数,那么不能指定 -appInstallDirectory 参数。

限制: 如果将此参数指定为 true,那么该位置由现有 WebSphere Application Server V7.0 或更高版本 安装版本和 V9.0 安装版本共享。 如果将已迁移的应用程序放在先前版本应用程序所在的位置中,那么存在以下限制:
  • 必须遵守 WebSphere Application Server V9.0 混合节点支持限制。这意味着在调用 wsadmin 命令时不能使用下列支持:
    • 预编译 JSP
    • 使用二进制配置
    • 部署 EJB
  • 如果以后在管理 V7.0 或更高版本 的安装版本时,从这些位置中删除应用程序,那么会面临意外丢失这些已迁移的应用程序的风险。
-appInstallDirectory
这是一个可选参数,用来传递迁移期间在安装所有应用程序时要使用的目录名称。如果未指定此参数,那么会使用缺省值 profile_name\installedApps

如果指定此参数,那么不能指定 -keepAppDirectory 参数。

如果目录名称中有一个或多个空格,那么必须用引号将该目录名称引起来。

如果使用此参数,那么迁移工具会在备份目录中调查所迁移节点的节点级别变量(旧发行版的变量)以及在目标概要文件中调查所迁移节点的节点级别变量(新发行版的变量)。如果路径是任一发行版中任何下列变量的一部分,那么这些工具会缩短路径信息以使用相关的变量:
  • APP_INSTALL_ROOT
  • USER_INSTALL_ROOT
  • WAS_INSTALL_ROOT
在缩短路径信息时,您将收到以下警告消息,这些消息告知您这些工具更改了指定的值并告知您缩短后的值:
MIGR0341W: 应用程序安装目录已更新为 {0}。
例如:
MIGR0341W: 应用程序安装目录已更新为 ${USER_INSTALL_ROOT}\customAppDirectory。
或者
MIGR0341W: 应用程序安装目录已更新为 ${APP_INSTALL_ROOT}\
cellName\customAppDirectory\。
-traceString
这是一个可选参数。trace_spec 值指定您想收集的跟踪信息。

要收集所有跟踪信息,请指定 "*=all=enabled"(带有引号)。

如果未指定 -traceString 或 -traceFile 参数,那么缺省情况下该命令将创建一个跟踪文件并将它放入 backupDirectory/logs 目录中。

-traceFile
这是一个可选参数。file_name 值指定跟踪信息的输出文件的名称。

如果未指定 -traceString 或 -traceFile 参数,那么缺省情况下该命令将创建一个跟踪文件并将它放入 backupDirectory/logs 目录中。

-requestTimeout
这是一个可选参数。seconds 值表示在使所尝试的 wsadmin 连接失败前迁移等待的秒数。

在应用程序迁移期间,此值还用作超时参数。

-oldAdminAgentProfilePath
这是一个可选参数。path to old admin agent 值表示原始管理代理程序的概要文件目录的文件系统路径。

仅当所迁移的应用程序服务器由管理代理程序管理时,此参数才是必需参数。

-oldAdminAgentSoapPort
这是一个可选参数。soap port of old admin agent 值表示原始管理代理程序用于管理连接的 SOAP 端口。

仅当所迁移的应用程序服务器由管理代理程序管理时,此参数才是必需参数。

-oldAdminAgentHostname
这是一个可选参数。hostname of old admin agent 值表示原始管理代理程序的主机名位置。如果未指定此参数,那么在缺省情况下,此值将设置为“localhost”。

仅当所迁移的应用程序服务器由管理代理程序管理时,此参数才是必需参数。

-oldAdminAgentUsername
这是一个可选参数。login username for old admin agent 值表示原始管理代理程序的用户名。

仅当所迁移的应用程序服务器由启用了管理安全性的管理代理程序管理时,此参数才是必需参数。

-newAdminAgentProfilePath
这是一个可选参数。path to new admin agent 值表示新迁移的管理代理程序的概要文件目录的文件系统路径。

仅当所迁移的应用程序服务器由管理代理程序管理时,此参数才是必需参数。

-newAdminAgentSoapPort
这是一个可选参数。soap port of old admin agent 值表示新迁移的管理代理程序用于管理连接的 SOAP 端口。

仅当所迁移的应用程序服务器由管理代理程序管理时,此参数才是必需参数。

-newAdminAgentHostname
这是一个可选参数。hostname of old admin agent 值表示新管理代理程序的主机名位置。如果未指定此参数,那么在缺省情况下,此值将设置为“localhost”。

仅当所迁移的应用程序服务器由管理代理程序管理时,此参数才是必需参数。

-newAdminAgentUsername
这是一个可选参数。login username for old admin agent 值表示新管理代理程序的用户名。

仅当所迁移的应用程序服务器由启用了管理安全性的管理代理程序管理时,此参数才是必需参数。

-newAdminAgentPassword
这是一个可选参数。login password for old admin agent 值表示新管理代理程序的用户名。

仅当所迁移的应用程序服务器由启用了管理安全性的管理代理程序管理时,此参数才是必需参数。

-javaoption < -Xms...m > -javaoption < -Xmx...m >
这是一个可选参数。使用此参数可以指定 WASPostUpgrade 所使用的 Java 堆的内存大小。

“-Xms...m”值指定起始堆大小。请将“...”替换为所需的大小(以兆字节计)。例如,如果起始堆大小为 128 MB,请将此参数指定为:-javaoption -Xms128m

“-Xmx...m”值指定最大堆大小。请将“...”替换为所需的大小(以兆字节计)。例如,如果最大堆大小为 1024 MB,请将此参数指定为:-javaoption -Xmx1024m

日志记录

WASPostUpgrade 工具运行时会将它的状态显示在屏幕上。此工具还在 backupDirectory/logs 目录的 WASPostUpgrade.time_stamp.log 文件中保存一组更广泛的记录信息。您可以用文本编辑器查看 WASPostUpgrade.time_stamp.log 文件。

安全性注意事项

迁移之前,必须在目标系统上禁用安全性。如果从启用了安全性的源配置进行迁移,那么在迁移期间,WASPostUpgrade 命令将自动对 V9.0 目标配置启用安全性。


指示主题类型的图标 参考主题



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