WASMigrationAppInstaller 命令
WebSphere® Application Server 版本 9.0 的 WASMigrationAppInstaller 命令将应用程序从先前安装的 WebSphere Application Server 版本迁移到新版本。 只会迁移尚未安装的应用程序。
位置
命令文件位于 V 9.0 profile_root/bin 目录中,并且必须从该目录运行。
权限
要运行此命令脚本,用户概要文件必须具有 *ALLOBJ 权限。
语法
参数
该命令的参数如下所示:
- 这是一个必需参数,并且必须是您指定的第一个参数。 值 backupDirectory 指定该命令从其中装入配置数据以及运行用于安装应用程序的脚本的目录名称。避免麻烦: WAS_INSTALL 和 USER_INSTALL 根目录对于 WebSphere Application Server 备份目录的位置是无效的目录。
它也是 WASPostUpgrade 命令从中读取配置的目录。
- 这是一个可选参数。 值 properties_file_name 指定其中包含用于定义迁移工具(例如,WASMigrationAppInstaller)的操作方式的参数属性的属性文件的路径。
可以在迁移属性文件中定义参数属性,而不是在命令行上指定大多数可选参数。 如果在属性文件中定义了参数,并且在命令行上也指定了参数,那么在命令行上指定的参数优先。
注: 不能在属性文件中指定某些参数,例如 -properties 参数本身和 -javaoption。 要获取无法定义为属性的参数列表,请参阅 app_server_root/bin 目录中的模板 migration.properties 文件。 - 这是一个可选参数。 trace_spec 值指定您想收集的跟踪信息。
要收集所有跟踪信息,请指定 "*=all=enabled"(带引号)。
如果不指定 -traceString 或 -traceFile 参数,那么该命令在缺省情况下将创建跟踪文件并将该文件放入 backupDirectory/logs 目录。
- 这是一个可选参数。 值 file_name 指定跟踪信息的输出文件的名称。
如果不指定 -traceString 或 -traceFile 参数,那么该命令在缺省情况下将创建跟踪文件并将该文件放入 backupDirectory/logs 目录。
- 这是一个可选参数。 使用此参数来指定 WASPreUpgrade 命令所使用的 Java™ 堆的内存大小。
值“-Xms...m”是为了指示起始堆大小而指定的参数。 替换 "..." 使用您打算使用的大小 (以兆字节计)。 例如,如果起始堆大小为 128 MB,请将此参数指定为 -javaoption -Xms128m
值“-Xmx...m”是为了指示最大堆大小而指定的参数。 替换 "..." 使用您打算使用的大小 (以兆字节计)。 例如,如果最大堆大小为 1024 MB,请将此参数指定为 -javaoption -Xmx1024m
- 这是一个可选参数。 使用此参数可以仅指定该命令所要处理的应用程序。 这些应用程序以逗号分隔的列表形式指定,应用程序名称不包含其 .ear 扩展名。
backupDirectory 可能包含许多应用程序。 如果未指定 -appName 参数,那么将部署所有应用程序。
日志记录
WASMigrationAppInstaller 工具在运行时会将其状态显示在屏幕上。 该工具还会在写入 backupDirectory 目录的 WASMigrationAppInstaller.time_stamp.log 文件中保存一组更广泛的日志记录信息,其中 backupDirectory 是对 backupDirectory 参数指定的值。 您可以用文本编辑器查看 WASMigrationAppInstaller.time_stamp.log 文件。
迁移的资源
WASMigrationAppInstaller 工具只会迁移目标发行版中尚未安装的应用程序。 如果未成功安装任何应用程序,那么您可以根据需要多次重新运行该工具,而不用反复重新安装相同的应用程序。
该工具还会自动安装业务级别的应用程序 (BLA)。