WASPreUpgrade 命令

WebSphere® Application Server 版本 9.0 的 WASPreUpgrade 命令将先前安装的 WebSphere Application Server 版本的配置保存到特定于迁移的备份目录中。

位置

命令文件位于 V 9.0 app_server_root/bin 目录中，并且必须从该目录运行。

语法

WASPreUpgrade.sh backupDirectory 
                 currentWebSphereDirectory
                 [-properties properties_file_name]
                 [-traceString trace_spec [-traceFile file_name ]]
                 [-machineChange true | false]
                 [-oldProfile profile_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]
                 [-allowSameRelease < true | false >]

WASPreUpgrade.bat backupDirectory 
                  currentWebSphereDirectory
                  [-properties properties_file_name]
                  [-traceString trace_spec [-traceFile file_name ]]
                  [-machineChange true | false]
                  [-oldProfile profile_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]
                  [-allowSameRelease < true | false >]

参数

该命令的参数如下所示：

backupDirectory

这是一个必需参数，并且必须是您指定的第一个参数。值 backupDirectory 指定目录名，命令脚本会将保存的配置存储在其中。

避免麻烦: WAS_INSTALL 和 USER_INSTALL 根目录对于 WebSphere Application Server 备份目录的位置是无效的目录。

WASPostUpgrade 命令也是从该目录中读取配置。

如果该目录不存在，那么 WASPreUpgrade 命令脚本将创建它。

currentWebSphereDirectory

这是一个必需参数，并且必须是您指定的第二个参数。这可以是支持迁移的任何版本的 WebSphere Application Server 版本 7.0 或更高版本。

该 currentWebSphereDirectory 值指定源安装根目录的名称。 WebSphere Application Server 安装根目录的名称。

-属性

这是一个可选参数。值 properties_file_name 指定其中包含用于定义迁移工具（例如，WASPreUpgrade）的操作方式的参数属性的属性文件的路径。

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

注: 无法在属性文件中指定某些参数，例如 -properties 参数本身以及 -username 和 -password。要获取无法定义为属性的参数列表，请参阅 app_server_root/bin 目录中的模板 migration.properties 文件。

-traceString

这是一个可选参数。值 trace_spec 指定要收集的跟踪信息。

要收集所有跟踪信息，请指定 "*=all=enabled"（带引号）。

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

-traceFile

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

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

-machineChange

这是可选参数，用于涉及跨操作系统和机器边界的迁移。如果指定为 true ，那么此参数通过备份存储在 WebSphere Application Server 安装或概要文件文件夹层次结构外部的项来支持在迁移时更改物理硬件。如果指定为 false ，那么在迁移期间，仅将存储在 WebSphere Application Server 安装文件夹或概要文件文件夹下的文件复制到备份目录。

缺省值为 false。

如果此值为 false ，那么迁移将假定新的和旧的 WebSphere Application Server 安装位于具有对文件系统的共享访问权的同一物理机器上。因此，任何位于 WebSphere 目录外部的文件都是共有的并且可以被共享。当为假时，迁移不会将 WebSphere Application Server-machineChange 树外的文件复制到备份目录中。当使用迁移向导时，false 是唯一选项。如果选择 -machineChange=false，那么必须在同一物理硬件上运行 WASPostUpgrade 命令。

如果打算在另一台机器或另一个文件系统上运行 WASPostUpgrade 命令，那么应该运行带 -machineChange=true 参数的 WASPreUpgrade 命令。如果选择 -machineChange=true, ，迁移将在迁移备份目录中创建一个额外的子目录（/migrated/ ），其中包含由配置引用的、位于产品或配置文件目录之外的任何文件。 WebSphere Application Server 配置所引用的、位于产品或配置文件目录之外的文件。运行 WASPostUpgrade 命令时，这些文件在新机器上就会回到它们的原始路径中。

性能注意事项:

如果迁移配置了文件系统文件存储库的服务集成总线 (SIB)，那么在迁移堆和迁移备份目录中需要额外的空间。每个总线有三个文件存储值 - log、tempspace 和 repository。这三个文件大小不等，但是每一个文件的大小可以达到 100-500MB。当迁移正在运行时，它会在升级前过程中备份 WebSphere Application Server 树中的任何文件存储器。为了执行此操作，文件系统上需要有足够的空间。如果在升级后过程中文件存储已存在于目标位置，那么迁移会将文件存储备份在内存中以支持回滚。

如果运行带 -machineChange=true 参数的 WASPreUpgrade 命令，那么会生成包含共享文件存储对象的备份目录，您可能会发现升级后过程发生内存不足异常，因为缺省的最大堆太小，而无法包含支持回滚所需的文件存储备份。要解决此问题，请执行以下三个任务中的一个：

如果系统位置处的文件存储有效，那么在运行 WASPostUpgrade 命令前，从备份目录删除这些文件存储的副本。
在运行 WASPostUpgrade 命令之前，从迁移备份目录中删除整个 /migrated/ 子目录，就可以将升级前的备份从 -machineChange=true 转换为 -machineChange=false。
如果备份目录中的文件存储副本有效，那么删除目标位置处的版本。
这会更改回滚支持，因此目标文件不存在并且在迁移期间将不会占用内存空间。
如果需要回滚支持并且需要备份目录中的文件以及文件系统上的文件，那么对升级后过程增加最大堆大小值，以使其可以支持所有冲突的 SIB 文件。

-oldProfile

这是用于从先前版本的 WebSphere Application Server迁移特定实例或概要文件的可选参数。

-workspaceRoot

这是一个可选参数。 user_workspace_folder_name_x 值用于指定管理控制台定制的一个或多个概要文件的“我的任务”的位置。

-username

这是一个可选参数。值 user name 指定当前 WebSphere Application Server 安装的管理用户名。

如果以下条件成立，那么此参数为必需参数：

您在迁移 Deployment Manager。
源安装版本中已启用管理或全局安全性。
要从中迁移的 WebSphere Application Server 安装版本为 8.0 或更高版本。

-password

这是一个可选参数。值 password 指定当前 WebSphere Application Server 安装的管理密码。

如果以下条件成立，那么此参数为必需参数：

您在迁移 Deployment Manager。
源安装版本中已启用管理或全局安全性。
要从中迁移的 WebSphere Application Server 安装版本为 8.0 或更高版本。

-javaoption

这是一个可选参数。使用此参数来指定 WASPreUpgrade 命令所使用的 Java™ 堆的内存大小。

值“-Xms...m”是为了指示起始堆大小而指定的参数。替换 "..." 使用您打算使用的大小 (以兆字节为单位)。例如，如果起始堆大小为 128 MB，请将此参数指定为 -javaoption -Xms128m

值“-Xmx...m”是为了指示最大堆大小而指定的参数。替换 "..." 以及您打算使用的大小 (以兆字节计)。例如，如果最大堆大小为 1024 MB，请将该参数指定为 -javaoption -Xmx1024m

-requireEmbeddedDBMigration

这是用于迁移嵌入式数据库的可选参数。

如果该值指定为 true，那么迁移嵌入式数据库时发生的任何异常都会导致 WASPreUpgrade 命令失败。如果该值指定为 false，那么迁移嵌入式数据库时发生的任何异常都会记录在跟踪文件中，并且 WASPreUpgrade 命令会继续运行。

缺省值为 true。

-keepDmgrEnabled

这是可选参数，用于迁移 Deployment Manager 概要文件。

当 WASPreUpgrade 运行时，Deployment Manager 概要文件会停止。缺省情况下，Deployment Manager 会保持停止。如果该值指定为 true，那么 WASPreUpgrade 会在命令完成运行前启动 Deployment Manager。

缺省值为 false。

-allowSameRelease

此参数是可选的。当此参数设置为 true时，可以将 WebSphere Application Server V 9.0 概要文件从一个 WebSphere Application Server V 9.0 安装迁移到另一个安装，包括迁移到另一台机器上的安装。当 -allowSameRelease 参数设置为 true时， WASPostUpgrade 命令上的 -clone 参数必须设置为 true。

日志记录

WASPreUpgrade 工具运行时会将它的状态显示在屏幕上。该工具还会在写入 backupDirectory 目录的 WASPreUpgrade.time_stamp.log 文件中保存一组更广泛的日志记录信息，其中 backupDirectory 是对 backupDirectory 参数指定的值。您可以用文本编辑器查看 WASPreUpgrade.time_stamp.log 文件。

迁移的资源

WASPreUpgrade 会保存所有资源，但是不会迁移 classes 目录中的条目。

进行迁移时会将下列文件保存在 backupDirectory 目录中。

classes
config
properties