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

本文是关于概要文件配置迁移。要将应用程序迁移到最新版本,请使用 WebSphere Application Server Migration Toolkit。有关更多信息,请参阅 WASdev 上的 Migration Toolkit。
sptcfg命令文件位于 app_server_root/bin 目录中,并且必须从此目录中运行。
权限
要运行此命令脚本,用户概要文件必须具有 *ALLOBJ 权限。
语法
WASPostUpgrade backupDirectory
[-properties properties_file_name]
[-username userID]
[-password password]
[-profileName profile_name]
[-setPorts useOld | generateNew | port_starting_number]
[-resolvePortConflicts incrementCurrent | port_starting_number]
[-backupConfig true | false]
[-includeApps true | false | script]
[-keepDmgrEnabled true | false]
[-requestTimeout seconds]
[-javaoption -Xms...m -javaoption -Xmx...m]
[[-appInstallDirectory user_specified_directory] |
[-keepAppDirectory true | false]]
[-traceString trace_spec [-traceFile file_name]]
WASPostUpgrade 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 值指定 WASPreUpgrade 工具用来存储已保存的配置和文件的目录以及 WASPostUpgrade 工具从其中读取配置和文件的目录的名称。
- 这是一个可选参数。值 properties_file_name 指定其中包含用于定义迁移工具(例如,WASPostUpgrade)的操作方式的参数属性的属性文件的路径。
可以在迁移属性文件中定义参数属性,而不是在命令行上指定大多数可选参数。如果在属性文件中定义了参数,并且在命令行上也指定了参数,那么在命令行上指定的参数优先。
注: 无法在属性文件中指定某些参数,例如,-properties 参数本身以及 -username 和 -password。有关无法定义为属性的参数的列表,请参阅 app_server_root/bin 目录中的模板 migration.properties 文件。 - 这是一个可选参数。userID 值指定当前 WebSphere Application Server V7.0 或更高版本 安装版本的管理用户名。如果以下条件成立,那么此参数为必需参数:
- 这是一个可选参数。password 值指定当前 WebSphere Application Server V7.0 或更高版本 安装版本的管理用户名的密码。
如果以下条件成立,那么此参数为必需参数:
- 这是一个可选参数,用于迁移到 WebSphere Application Server V9.0
中的特定概要文件。profile_name 值指定脚本要将配置迁移到的 V9.0
概要文件的名称。必须在创建此概要文件之后才能调用 WASPostUpgrade 命令。如果未指定 -profileName 参数,那么将使用缺省概要文件。如果未找到缺省概要文件,那么系统会报告错误。
避免故障: 如果未对 -profileName 指定特定的概要文件名称,那么将迁移任何指定的“缺省”概要文件。您可能必须使用 WASPostUpgrade 迁移后命令来迁移在迁移前创建的备份中的每个概要文件(对于客户机在新环境中需要的每个概要文件,指定相应的 -oldProfile 和 -profileName 参数)。如果旧概要文件除包含样本应用程序和系统应用程序以外还包含已安装的应用程序 (installedApps),那么迁移过程将自动迁移这些应用程序。gotcha
注: 从 V9.0 迁移独立应用程序服务器时,可以选择已向管理代理程序注册的独立应用程序服务器节点作为迁移目标。 - 这是一个可选参数,用来指定在 WASPostUpgrade 工具进行任何更改之前是否保存现有
WebSphere Application Server V9.0 配置。缺省值为 true - 即,使用 backupConfig 命令将当前配置的副本保存到 profile_name/temp 目录中。
若有必要,使用 restoreConfig 命令复原该配置。有关更多信息,请参阅 restoreConfig 命令。
- 这是一个可选参数,用来指定如何为新概要文件设置端口。此参数采用以下值:
如果对此参数指定了值,那么指定的任何新端口均根据此值设置。每次需要新端口值时,会根据此值来创建端口并递增种子值以便下一次使用。不会指定重复端口。
- 此可选参数用于指定如何映射端口值。当无法使用某个端口时,会将它的值从起始值增加,直到找到可用的端口为止。
- 可以包括业务级应用程序、资产和组合单元作为迁移的组成部分。您可以选择在 WASPostUpgrade 命令中使用
-IncludeApps 参数来迁移这些项。这是一个可选参数,可以下列方式指定它:
无论此参数设置的值为何,WebSphere Application Server 系统应用程序都将进行迁移。
- 这是可选参数,用于指定是否禁用现有的 WebSphere Application Server
V7.0 或更高版本 Deployment Manager。缺省值为 false。
如果将此参数指定为 true,那么完成迁移后,您可以使用现有的 V7.0 或更高版本 Deployment Manager。仅当您迁移 Deployment Manager 时此参数才有效;在所有其他迁移中都将忽略此参数。
注意: 请谨慎使用此参数。 - 这是一个可选参数,用来指定是否将所有应用程序安装至它们当前所在的目录。缺省值为 false。
如果将此参数指定为 true,那么每个应用程序都将安装在它当前所在的位置。
如果指定此参数,那么不能指定 -appInstallDirectory 参数。
限制: 如果将此参数指定为 true,那么该位置由现有 WebSphere Application Server V7.0 或更高版本 安装版本和 V9.0 安装版本共享。 如果将已迁移的应用程序放在先前版本应用程序所在的位置中,那么存在以下限制: - 这是一个可选参数,用来传递迁移期间在安装所有应用程序时要使用的目录名称。如果未指定此参数,那么会使用缺省值 profile_name\installedApps。
如果指定此参数,那么不能指定 -keepAppDirectory 参数。
如果目录名称中有一个或多个空格,那么必须用引号将该目录名称引起来。
如果使用此参数,那么迁移工具会在备份目录中调查所迁移节点的节点级别变量(旧发行版的变量)以及在目标概要文件中调查所迁移节点的节点级别变量(新发行版的变量)。如果路径是任一发行版中任何下列变量的一部分,那么这些工具会缩短路径信息以使用相关的变量:
例如:MIGR0341W: 应用程序安装目录已更新为 {0}。
或者MIGR0341W: 应用程序安装目录已更新为 ${USER_INSTALL_ROOT}\customAppDirectory。
MIGR0341W: 应用程序安装目录已更新为 ${APP_INSTALL_ROOT}\ cellName\customAppDirectory\。
- 这是一个可选参数。trace_spec 值指定您想收集的跟踪信息。
要收集所有跟踪信息,请指定 "*=all=enabled"(带有引号)。
如果未指定 -traceString 或 -traceFile 参数,那么缺省情况下该命令将创建一个跟踪文件并将它放入 backupDirectory/logs 目录中。
- 这是一个可选参数。file_name 值指定跟踪信息的输出文件的名称。
如果未指定 -traceString 或 -traceFile 参数,那么缺省情况下该命令将创建一个跟踪文件并将它放入 backupDirectory/logs 目录中。
- 这是一个可选参数。seconds 值表示在使所尝试的 wsadmin 连接失败前迁移等待的秒数。
在应用程序迁移期间,此值还用作超时参数。
- 这是一个可选参数。path to old admin agent 值表示原始管理代理程序的概要文件目录的文件系统路径。
仅当所迁移的应用程序服务器由管理代理程序管理时,此参数才是必需参数。
- 这是一个可选参数。soap port of old admin agent 值表示原始管理代理程序用于管理连接的 SOAP 端口。
仅当所迁移的应用程序服务器由管理代理程序管理时,此参数才是必需参数。
- 这是一个可选参数。hostname of old admin agent
值表示原始管理代理程序的主机名位置。如果未指定此参数,那么在缺省情况下,此值将设置为“localhost”。
仅当所迁移的应用程序服务器由管理代理程序管理时,此参数才是必需参数。
- 这是一个可选参数。login username for old admin agent 值表示原始管理代理程序的用户名。
仅当所迁移的应用程序服务器由启用了管理安全性的管理代理程序管理时,此参数才是必需参数。
- 这是一个可选参数。path to new admin agent 值表示新迁移的管理代理程序的概要文件目录的文件系统路径。
仅当所迁移的应用程序服务器由管理代理程序管理时,此参数才是必需参数。
- 这是一个可选参数。soap port of old admin agent 值表示新迁移的管理代理程序用于管理连接的 SOAP 端口。
仅当所迁移的应用程序服务器由管理代理程序管理时,此参数才是必需参数。
- 这是一个可选参数。hostname of old admin agent
值表示新管理代理程序的主机名位置。如果未指定此参数,那么在缺省情况下,此值将设置为“localhost”。
仅当所迁移的应用程序服务器由管理代理程序管理时,此参数才是必需参数。
- 这是一个可选参数。login username for old admin agent 值表示新管理代理程序的用户名。
仅当所迁移的应用程序服务器由启用了管理安全性的管理代理程序管理时,此参数才是必需参数。
- 这是一个可选参数。login password for old admin agent 值表示新管理代理程序的用户名。
仅当所迁移的应用程序服务器由启用了管理安全性的管理代理程序管理时,此参数才是必需参数。
- 这是一个可选参数。使用此参数可以指定 WASPostUpgrade 所使用的 Java
堆的内存大小。
“-Xms...m”值指定起始堆大小。请将“...”替换为所需的大小(以兆字节计)。例如,如果起始堆大小为 128 MB,请将此参数指定为:-javaoption -Xms128m
“-Xmx...m”值指定最大堆大小。请将“...”替换为所需的大小(以兆字节计)。例如,如果最大堆大小为 1024 MB,请将此参数指定为:-javaoption -Xmx1024m
安全性注意事项
迁移之前,必须在目标系统上禁用安全性。如果从启用了安全性的源配置进行迁移,那么在迁移期间,WASPostUpgrade 命令将自动对 V9.0 目标配置启用安全性。