使用 zmmt 命令迁移 z/OS 独立应用程序服务器时使用的配置变量
迁移 WebSphere® Application Server for z/OS® 前,必须创建实际迁移期间将运行的作业控制语言 (JCL) 作业(CNTL 和 DATA 数据集)。可以对响应文件使用 zmmt 命令以创建适当的迁移作业。迁移响应文件包含一组配置变量,可使用这些配置变量来创建用于迁移独立应用程序服务器的作业。

本文是关于概要文件配置迁移。要将应用程序迁移到最新版本,请使用 WebSphere Application Server Migration Toolkit。有关更多信息,请参阅 WASdev 上的 Migration Toolkit。
sptcfg响应文件变量
- 指示创建新迁移定义的必需关键字
- 是否设置中间符号链接
如果指定中间符号链接,那么会创建从配置文件系统到该中间符号链接的符号链接;否则,会创建直接指向产品文件系统的链接。
- 中间符号链接的路径名
此链接将由定制作业创建,并指向产品文件系统目录。
- 中间符号链接的路径名
- 迁移期间创建的概要文件的名称
在 z/OS 平台上,此变量总是取值“default”。
- 生成的迁移定义输出应写至的标准路径
- 模板路径下列其中一个值:
- 将包含配置文件系统的 MVS™ 数据集的名称
用于创建配置文件系统的迁移作业将此名称作为输入。
- 将为配置文件系统分配的主柱面数
在应用程序服务器中,此数据集所需的总空间随所安装的应用程序的大小和数量增加而增加。
建议: 最小建议大小是 420 个柱面。 - 将为配置文件系统分配的辅柱面数建议: 最小建议大小是 100 个柱面。
- 要包含上述数据集的 DASD 卷序列号,或者使用“*”以让 SMS 选择卷
使用“*”则要求 SMS 自动类选择 (ACS) 例程在原位以选择卷。如果未设置 SMS 来自动处理数据集分配,那么会显式地列出卷。
- 写入应用程序数据和环境文件的文件系统目录安装点
配置文件系统是所迁移节点的配置的物理存储位置。如果要迁移的节点上已具有适当的文件系统,那么可以选择使用现有的 V9.0 文件系统。如果选择使用现有的 V9.0 文件系统,那么需要先确保此处指定的安装点已存在,然后才运行通过使用此工具创建的迁移作业。如果您选择在要迁移的节点上创建新的 V9.0 文件系统,那么在实际迁移过程中运行可选的 BBOMBHFS 或 BBOMBZFS 作业之后,才会实际创建这个新文件系统。在任何情况下,都必须在此处指定安装点的正确值。
- 文件系统的类型下列其中一个值:
- HFS
使用分层文件系统分配和安装配置文件系统数据集
- ZFS
使用 zSeries 文件系统分配和安装配置文件系统数据集
- HFS
- 将用于已生成的迁移作业的可定制作业语句
为您定制的所有迁移作业都需要一个作业语句。 请输入对于您的安装而言有效的作业语句。迁移创建过程将更新所有已生成作业中的作业名,因此您不需要参与作业语句的该部分。如果需要续行,那么用续行替换注释行。
- 目标 z/OS 数据集(将包含生成的作业和指示信息)的高级限定词
注: 可将多级别高级限定词指定为数据集高级限定词。
- 想要如何迁移已安装的应用程序
下列其中一个值:注: 无论此处设置的值如何,WebSphere Application Server 系统应用程序都将迁移。
- 用于启动已迁移控制器的 JCL 已启动过程的名称
迁移到 V9.0 时,必须升级 JCL 已启动过程。在迁移期间,将生成新的已启动过程。可为该控制器过程指定新名称,也可以使用旧名称。
- 用于启动已迁移服务方的 JCL 已启动过程的名称
迁移到 V9.0 时,必须升级 JCL 已启动过程。在迁移期间,将生成新的已启动过程。可为该服务方过程指定新名称,也可以使用旧名称。
- 用于启动已迁移守护程序的 JCL 已启动过程的名称
迁移到 V9.0 时,必须升级 JCL 已启动过程。在迁移期间,将生成新的已启动过程。可为该守护程序过程指定新名称,也可以使用旧名称。
- 用于启动已迁移附件的 JCL 已启动过程的名称
迁移到 V9.0 时,必须升级 JCL 已启动过程。在迁移期间,将生成新的已启动过程。可为该附件过程指定新名称,也可以使用旧名称。
- 是使用指定的新名称来更新配置中的 START 命令 (true) 还是保留同一名称 (false)。
如果为 JCL 过程指定新的名称,那么必须更新 WebSphere Application Server 配置中相应的 START 命令以便与新过程名称相匹配。对此变量指定 true 以执行此配置更新。
如果选择使用相同的过程名称,那么对此变量指定 false。如果未将一致过程名称用于要迁移节点的给定进程类型(例如,所有服务方)的所有服务器,那么建议您对此变量指定 false。在这种情况下,将需要保留相同的 START 命令并将使用迁移时生成的过程用作模板来手动替换过程。
注意: - 在 WASPostUpgrade 过程中启用 (true) 或禁用 (false) 跟踪
- 在 WASPreUpgrade 过程中启用 (true) 或禁用 (false) 跟踪
- 在创建概要文件期间启用 (true) 或禁用 (false) 跟踪
- 启用 (true) 或禁用 (false) 对主目录创建、概要文件和迁移工具调用以及迁移的最后处理阶段的跟踪
- 从中进行迁移的配置的安装点
- 从中进行迁移的配置的主目录
- 这是为 JVM 堆分配的初始内存。
- 安装包含 Snoop、Hello 和 HitCount 这些 Servlet 的缺省应用程序
- 指定是否部署样本应用程序。注: 这些应用程序在 WebSphere Application Server Network Deployment 单元中不受支持。
安装样本应用程序以使用应用程序服务器并评估最新的技术进展。建议不要将样本应用程序部署到生产应用程序服务器环境。
- 这是一个 Java 临时目录,Java 虚拟机在迁移期间使用该目录来创建和存储临时文件。
- 指示是否向管理代理程序注册源概要文件。
- 这是可为 JVM 堆分配的最大堆大小。
- 源管理代理程序的主机名。
- 如果已启用安全,那么这是源管理代理程序的管理安全密码。
- 这是源管理代理程序的文件系统路径。
- 这是源管理代理程序用于 SOAP 连接的端口。
- 如果已启用安全,那么这是源管理代理程序的用户名。
- 这是目标管理代理程序的主机名。
- 如果已启用安全,那么这是目标管理代理程序的管理安全密码。
- 这是目标管理代理程序的文件系统路径。
- 这是目标管理代理程序用于 SOAP 连接的端口。
- 如果已启用安全,那么这是目标管理代理程序的用户名。
- 要将 WebSphere Application Server for z/OS 已编目过程复制到的现有过程库
- 通过指定下列其中一个值来定义如何处理端口冲突。
- 通过指定下列其中一个值来定义要在新概要文件中使用的端口值。
- WebSphere Application Server V9.0 已安装产品文件系统的位置
- 在其中写入先前配置和迁移跟踪的备份的目录。
迁移期间,需要旧版本配置的备份副本。此备份的缺省位置为 /tmp/migrate。 如果 /tmp 文件系统没有足够的空间用来存储备份配置,那么您可以指定另一个位置。 如果选择覆盖备份副本的缺省位置,那么最好的做法是继续使用原有命名约定,而只是将 /tmp 部分替换为另一个路径(例如 /myTemp/migrate)。
- 将用于在临时目录下创建目录的标识,该临时目录将包含临时迁移数据集和备份配置数据
- 迁移到的配置的安装点
这是与对 zConfigMountPoint 变量指定的值相同的值。
- 迁移到的配置的主目录
- 是要迁移缺省工作空间用户根位置 (D) 中保存的“我的任务”设置还是要迁移保存在用户定义的工作空间根位置 (U) 中保存的设置
- 用户定义的工作空间根位置
- 是否设置中间符号链接
如果指定中间符号链接,那么会创建从配置文件系统到该中间符号链接的符号链接;否则,会创建直接指向产品文件系统的链接。
- 中间符号链接的路径名
此链接将由定制作业创建,并指向产品文件系统目录。
- 中间符号链接的路径名
用于迁移独立应用程序服务器的响应文件样本
create
EnableIntermediateSymlink=false
EnableJavaTmpDir=true
intermediateSymlinkPreference=N
profileName=default
profilePath=<root>/profiles/ZMigSASrv01
templatePath=<root>/profileTemplates/zos-migStandalone
zConfigHfsName=OMVS.WAS90.CONFIG.HFS
zConfigHfsPrimaryCylinders=420
zConfigHfsSecondaryCylinders=100
zConfigHfsVolume=*
zConfigMountPoint=/wasv9config
zFilesystemType=HFS
zJobStatement1=(ACCTNO,ROOM),'USERID',CLASS=A,REGION=0M
zJobStatement2=//*
zJobStatement3=//*
zJobStatement4=//*
zTargetHLQ=SAS
zmbAdjunctProcName=BBO9CRA
zmbAppInstallDirLine1=/wasv9config/AppServer/profiles/default/installedApps
zmbAppInstallDirLine2=
zmbAppMigrationPreference=D
zmbControllerProcName=BBO9ACR
zmbDaemonProcName=BBO9DMN
zmbEnablePostUpgradeTrace=0
zmbEnablePreUpgradeTrace=0
zmbEnableProfileTrace=0
zmbEnableScriptingTrace=0
zmbFromConfigRoot=/WebSphere/V7R0
zmbFromWASHomeDir=AppServer
zmbInitialHeapSize=512
zmbInstallDefaultApp=false
zmbInstallSamples=false
zmbJavaTempDirectory=/tmp
zmbManagedBaseNode=true
zmbMaxHeapSize=768
zmbNewAdminAgentHostname=localhost
zmbNewAdminAgentProfilePath=/WebSphere/V9R0/AdminAgent
zmbNewAdminAgentSoapPort=8880
zmbOldAdminAgentHostname=localhost
zmbOldAdminAgentProfilePath=/WebSphere/V7R0/AdminAgent
zmbOldAdminAgentSoapPort=8879
zmbProclibName=SYS1.PROCLIB
zmbReplaceStartedProcedureNames=true
zmbResolvePortConflicts=incrementCurrent
zmbSMPEHome=/usr/lpp/WebSphere/AppServer/V9R0
zmbServantProcName=BBO9ASR
zmbSetPorts=useOld
zmbTempDirectory=/tmp/migrate
zmbTimestamp=05160419
zmbToConfigRoot=/wasv9config
zmbToWASHomeDir=AppServer
zmbWorkspaceRootPreference=D