WASPreUpgrade 命令
WebSphere® Application Server V9.0 的 WASPreUpgrade 命令会将先前安装的 WebSphere Application Server 版本的配置保存到特定于迁移的备份目录中。
位置
命令文件位于 V9.0 app_server_root/bin 目录中,并且必须从该目录运行。
权限
要运行此命令脚本,用户概要文件必须具有 *ALLOBJ 权限。
语法
WASPreUpgrade backupDirectory
currentWebSphereDirectory
[-properties properties_file_name]
[-traceString trace_spec [-traceFile file_name ]]
[-workspaceRoot profile1=user_workspace_folder_name_1;profile2=user_workspace_folder_name_2]
[-username < user name >]
[-password < password >]
[-javaoption < -Xms...m > -javaoption < -Xmx...m > ]
[-requireEmbeddedDBMigration true | false]
[-keepDmgrEnabled true | false]
参数
此命令具有以下参数:
- 这是一个必需参数,并且必须是您指定的第一个参数。backupDirectory 值指定命令脚本用来存储已保存的配置的目录的名称。
避免故障: WAS_INSTALL 和 USER_INSTALL 根目录是无效的目录,不能表示 WebSphere Application Server 备份目录的位置。gotcha
WASPostUpgrade 命令也是从该目录中读取配置。
如果该目录不存在,那么 WASPreUpgrade 命令脚本将创建它。
- 这是一个必需参数,并且必须是您指定的第二个参数。这可以是支持迁移的
WebSphere Application Server V7.0 或更高版本 的任何版本。currentWebSphereDirectory 值指定要迁移的源 WebSphere Application Server 实例 V7.0 或更高版本 概要文件的实例名称或概要文件根目录名称。
- 这是一个可选参数。值 properties_file_name 指定其中包含用于定义迁移工具(例如,WASPreUpgrade)的操作方式的参数属性的属性文件的路径。
可以在迁移属性文件中定义参数属性,而不是在命令行上指定大多数可选参数。如果在属性文件中定义了参数,并且在命令行上也指定了参数,那么在命令行上指定的参数优先。
注: 无法在属性文件中指定某些参数,例如,-properties 参数本身以及 -username 和 -password。有关无法定义为属性的参数的列表,请参阅 app_server_root/bin 目录中的模板 migration.properties 文件。 - 这是一个可选参数。trace_spec 值指定您想收集的跟踪信息。
要收集所有跟踪信息,请指定 "*=all=enabled"(带有引号)。
如果未指定 -traceString 或 -traceFile 参数,那么缺省情况下该命令将创建一个跟踪文件并将它放入 backupDirectory/logs 目录中。
- 这是一个可选参数。file_name 值指定跟踪信息的输出文件的名称。
如果未指定 -traceString 或 -traceFile 参数,那么缺省情况下该命令将创建一个跟踪文件并将它放入 backupDirectory/logs 目录中。
- 这是一个可选参数。user_workspace_folder_name_x 值用于指定管理控制台定制的一个或多个概要文件的“我的任务”的位置。
- 这是一个可选参数。user name 值指定当前 WebSphere Application Server 安装版本的管理用户名。如果以下条件成立,那么此参数为必需参数:
- 您正在迁移 Deployment Manager。
- 源安装版本中已启用管理或全局安全性。
- 作为迁移源的 WebSphere Application Server 安装处于 V8.0 或更高版本。
- 这是一个可选参数。password 值指定当前 WebSphere Application Server 安装版本的管理密码。如果以下条件成立,那么此参数为必需参数:
- 您正在迁移 Deployment Manager。
- 源安装版本中已启用管理或全局安全性。
- 作为迁移源的 WebSphere Application Server 安装处于 V8.0 或更高版本。
- 这是一个可选参数。使用此参数可指定 WASPreUpgrade 命令所使用的 Java™ 堆的内存大小。
“-Xms...m”值是指定的表示起始堆大小的参数。请将“...”替换为打算使用的大小(以兆字节计)。例如,如果起始堆大小为 128 MB,请将该参数指定为 -javaoption -Xms128m
“-Xmx...m”值是指定的表示最大堆大小的参数。请将“...”替换为打算使用的大小(以兆字节计)。例如,如果最大堆大小为 1024 MB,请将该参数指定为 -javaoption -Xmx1024m
- 这是一个用于迁移嵌入式数据库的可选参数。
如果将值指定为 true,那么在您迁移该嵌入式数据库时发生的任何异常都会导致 WASPreUpgrade 命令失败。如果将值指定为 false,那么在您迁移嵌入式数据库时发生的任何异常都会记录在跟踪文件中,并且会继续运行 WASPreUpgrade 命令。
缺省值为 true。
- 这是一个用于迁移 V8.0 Deployment Manager 概要文件的可选参数。
当 WASPreUpgrade 运行时,V8.0 Deployment Manager 概要文件会停止。缺省情况下,Deployment Manager 保持停止状态。如果将值指定为 true,那么在该命令运行完毕之前,WASPreUpgrade 将启动 Deployment Manager。
缺省值为 false。
日志记录
WASPreUpgrade 工具运行时会将它的状态显示在屏幕上。此工具还在写入 backupDirectory 目录的 WASPreUpgrade.time_stamp.log 文件中保存一组更广泛的记录信息,其中 backupDirectory 是为 backupDirectory 参数指定的值。您可以用文本编辑器查看 WASPreUpgrade.time_stamp.log 文件。
迁移的资源
WASPreUpgrade 会保存所有资源,但是不会迁移 classes 目录中的条目。