WASPostUpgrade 命令

WebSphere® Application Server 的 WASPostUpgrade 命令从您指定的 backupDirectory 检索由 WASPreUpgrade 命令创建的已保存配置。 WebSphere Application Server 的 WASPostUpgrade 脚本从该目录读取配置以迁移到 WebSphere Application Server V 9.0 ，并将所有迁移的应用程序添加到 V 9.0 安装的 app_server_root/installedApps 目录中。

受支持的配置:

本主题阐述概要文件配置迁移。要将应用程序迁移到最新版本，请使用 WebSphere Application Server Migration Toolkit。

位置

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

语法

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]
                     [-requestTimeout seconds]
                     [-javaoption -Xms...m -javaoption -Xmx...m]
                     [[-appInstallDirectory user_specified_directory] | 
                     [-keepAppDirectory true | false]]
                     [-traceString trace_spec [-traceFile file_name]]

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]
                     [-requestTimeout seconds]
                     [-javaoption -Xms...m -javaoption -Xmx...m]
                     [[-appInstallDirectory user_specified_directory] | 
                     [-keepAppDirectory true | false]]
                     [-traceString trace_spec [-traceFile file_name]]

在为目标和源管理代理程序启用安全性的情况下迁移已注册的应用程序服务器时，请使用以下参数: [Linux]

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 ]

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 V 7.0 或更高版本安装的管理用户名。

-password

这是一个可选参数。值 password 指定当前 WebSphere Application Server V 7.0 或更高版本安装的管理用户名的密码。

提示: 需要在迁移向导中指定密码时，或者在命令行上使用带有-password 参数的 WASPostUpgrade 命令时，可以纯文本输入密码或使用 xor-ciphered 值。要使用经过异或加密的值，请输入整个密码（包括 {xor} 前缀）作为此参数的值。可以在先前配置的多个 WebSphere Application Server 配置文件 (包括 soap.client.props， ssl.client.props和 security.xml 文件) 中的任何一个配置文件中指定此 xor 加密值。

提示: 在命令行上使用带有-password 参数的 WASPostUpgrade 命令时，可以纯文本输入密码或使用 xor-ciphered 值。要使用经过异或加密的值，请输入整个密码（包括 {xor} 前缀）作为此参数的值。可以在先前配置的多个 WebSphere Application Server 配置文件 (包括 soap.client.props， ssl.client.props和 security.xml 文件) 中的任何一个配置文件中指定此 xor 加密值。

-oldProfile

这是用于从先前 WebSphere Application Server 版本迁移实例或概要文件的可选参数。在运行此命令之前，迁移备份目录中必须已存在实例或概要文件。

如果没有指定 -oldProfile 参数，将使用缺省概要文件。如果未找到缺省概要文件，那么系统会报告错误。

避免麻烦：如果您没有在 -oldProfile, 上指定具体的配置文件名称，那么指定的 "默认 "配置文件将被迁移。你可能需要迁移预迁移时备份中的每个配置文件，使用 WASPostUpgrade 后迁移命令，为客户希望在新版本 9.0 环境中使用的每个配置文件指定 -oldProfile 和 -profileName 参数。如果旧概要文件除了包含样本应用程序和系统应用程序，也包含已安装的应用程序 (installedApps)，那么迁移过程自动迁移这些应用程序。

-profileName

这是用于迁移到 WebSphere Application Server V 9.0中的特定概要文件的可选参数。值 profile_name 指定脚本将配置迁移到的 V 9.0 概要文件的名称。必须在创建此概要文件之后才能调用 WASPostUpgrade 命令。

如果未指定 -profileName 参数，那么会使用缺省概要文件。如果未找到缺省概要文件，那么系统会报告错误。

避免麻烦：如果您没有在 -profileName, 上指定具体的配置文件名称，那么指定的 "默认 "配置文件将被迁移。您可能必须使用 WASPostUpgrade 迁移后命令，为新环境中客户机需要的每个概要文件指定 -oldProfile 和 -profileName 参数，来迁移在迁移之前生成的备份中的每个概要文件。如果旧概要文件除了包含样本应用程序和系统应用程序，也包含已安装的应用程序 (installedApps)，那么迁移过程自动迁移这些应用程序。

注: 从版本 9.0迁移独立应用程序服务器时，可以选择已向管理代理程序注册为迁移目标的独立应用程序服务器节点。

-backupConfig

这是一个可选参数，用于指定在 WASPostUpgrade 工具进行任何更改之前是否保存现有 WebSphere Application Server V 9.0 配置。缺省值为 true，即，使用 backupConfig 命令将当前配置的副本保存到 profile_name/temp 目录中。

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

-setPorts

这是可选参数，用来指定如何为新概要文件设置端口。此参数采用以下值：

useOld（缺省值）：使用旧概要文件所使用的端口。对于本地迁移，此值不能与 -clone true 选项一起使用。
generateNew：根据缺省端口分配来生成新端口。
port_starting_number：生成新端口（从指定的值增加）。

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

-resolvePortConflicts

此可选参数用于指定如何映射端口值。当无法使用某个端口时，会将它的值从起始值增加，直到找到可用的端口为止。

incrementCurrent（缺省值）：从有冲突的端口值递增。
port_starting_number：从指定的公共起始端口值递增。

-includeApps

您可以将业务级应用程序、资产和组合单元包含为迁移的一部分。（可选）您可以在 WASPostUpgrade 命令上使用 -IncludeApps 参数来迁移这些项。这是一个可选参数，可以下列方式指定它：

是
将用户企业应用程序、业务级应用程序、资产和组合单元包含为迁移的一部分。

此值是缺省值。
错
在 WASPostUpgrade 处理期间，不对用户企业应用程序、业务级应用程序、资产和组合单元进行任何操作。
脚本
- 企业应用程序
  准备用户企业应用程序以在 WebSphere Application Server V 9.0 installableApps 目录中进行安装，而无需在 WASPostUpgrade 处理期间进行安装。
  
  可以用来安装这些应用程序的脚本是在 backupDirectory 目录中生成的，并且保存在该目录中。在完成 WASPostUpgrade 命令之后，可以在任何时候以任何组合形式运行这些文件。您还可以识别并组合这些文件以提高应用程序安装的效率。
- 业务级应用程序、资产和组合单元
  install_all_BLAs.jy 脚本已生成并放置在备份目录中。该脚本可以将位于备份目录中的所有业务级应用程序、资产和组合单元迁移到目标概要文件。 WASPostUpgradeBLAHelper. bat/.sh 脚本位于 <WAS_PROFILE_ROOT>/bin 目录中，用于迁移 install_all_BLAs.txt 文件中的业务级应用程序、资产和组成单元。
  
  避免麻烦: 要迁移业务级应用程序，资产和组合单元，必须首先创建其依赖关系。

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

-clone

此可选参数指示是否执行克隆迁移，这意味着您可以在将源概要文件迁移到 V 9.0 环境之后继续使用源概要文件。默认值为 false。

[9.0.5.11 或更高版本] 您可以将 WebSphere Application Server V 9.0 概要文件从一个 WebSphere Application Server V 9.0 安装迁移到另一个安装，包括迁移到另一台机器上的安装。要执行此操作，请将 WASPreUpgrade 命令上的 -allowSameRelease 参数和 -clone 参数设置为 true。

当 -clone 参数为 true 时，只能对远程迁移（以其他机器作为目标的迁移）指定 -setPorts useold。对于本地迁移，不能指定 -setPorts useold。新的概要文件配置必须使用唯一端口号，以免现在共存的新旧配置发生端口冲突。

-keepAppDirectory

这是可选参数，用于指定是否将所有应用程序安装在它们当前所在的目录中。缺省值为 false。

如果该参数设置为 "true"，则每个应用程序都会保留其位置。

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

限制: 如果将此参数指定为 true ，那么该位置由现有 WebSphere Application Server V 7.0 或更高版本安装和 V 9.0 安装共享。如果将迁移后的应用程序放在先前版本应用程序所在的位置中，那么存在以下限制：

必须遵循 WebSphere Application Server V 9.0 混合节点支持限制。这意味着，在调用 wsadmin 命令时，无法使用以下支持：
- 预编译 JSP
- 使用二进制配置
- 部署 EJB
如果稍后在管理 V 7.0 或更高版本安装时从这些位置删除应用程序，那么可能会意外丢失迁移的应用程序。

-appInstallDirectory

这是一个可选参数，用来传递迁移期间在安装所有应用程序时要使用的目录名称。如果未指定此参数，那么会使用缺省值 profile_name\installedApps。

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

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

如果使用此参数，那么迁移工具会在备份目录中调查所迁移节点的节点级别变量（旧发行版的变量）以及在目标概要文件中调查所迁移节点的节点级别变量（新发行版的变量）。如果路径是任一发行版中任何下列变量的一部分，那么这些工具会缩短路径信息以使用相关的变量：

APP_INSTALL_ROOT
USER_INSTALL_ROOT
WAS_INSTALL_ROOT

在缩短路径信息时，您将收到以下警告消息，这些消息告知您这些工具更改了指定的值并告知您缩短后的值：

MIGR0341W: Application install directory has been updated to {0}.

例如：

MIGR0341W: Application install directory has been updated to ${USER_INSTALL_ROOT}\customAppDirectory.

或

MIGR0341W: Application install directory has been updated to ${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 命令会在迁移期间自动对 V 9.0 目标配置启用安全性。