使用 zmmt 命令迁移 z/OS Deployment Manager 时使用的配置变量

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

支持的配置 支持的配置:

本文是关于概要文件配置迁移。要将应用程序迁移到最新版本,请使用 WebSphere Application Server Migration Toolkit。有关更多信息,请参阅 WASdev 上的 Migration Toolkit

sptcfg

响应文件变量

create
指示创建新迁移定义的必需关键字
intermediateSymlinkPreference
是否设置中间符号链接

如果指定中间符号链接,那么会创建从配置文件系统到该中间符号链接的符号链接;否则,会创建直接指向产品文件系统的链接。

IntermediateSymlink
中间符号链接的路径名

此链接将由定制作业创建,并指向产品文件系统目录。

profileName
迁移期间创建的概要文件的名称

在 z/OS 平台上,此变量总是取值“default”。

profilePath
生成的迁移定义输出应写至的标准路径
templatePath
模板路径
下列其中一个值:
  • zos-migDmgr

    迁移 Deployment Manager

  • zos-migFederated

    迁移联合节点

  • zos-migStandalone

    迁移独立应用程序服务器

zConfigHfsName
将包含配置文件系统的 MVS™ 数据集的名称

用于创建配置文件系统的迁移作业将此名称作为输入。

zConfigHfsPrimaryCylinders
将为配置文件系统分配的主柱面数

在应用程序服务器中,此数据集所需的总空间随所安装的应用程序的大小和数量增加而增加。

建议: 最小建议大小是 420 个柱面。
zConfigHfsSecondaryCylinders
将为配置文件系统分配的辅柱面数
建议: 最小建议大小是 100 个柱面。
zConfigHfsVolume
要包含上述数据集的 DASD 卷序列号,或者使用“*”以让 SMS 选择卷

使用“*”则要求 SMS 自动类选择 (ACS) 例程在原位以选择卷。如果未设置 SMS 来自动处理数据集分配,那么会显式地列出卷。

zConfigMountPoint
写入应用程序数据和环境文件的文件系统目录安装点

配置文件系统是所迁移节点的配置的物理存储位置。如果要迁移的节点上已具有适当的文件系统,那么可以选择使用现有的 V9.0 文件系统。如果选择使用现有的 V9.0 文件系统,那么需要先确保此处指定的安装点已存在,然后才运行通过使用此工具创建的迁移作业。如果您选择在要迁移的节点上创建新的 V9.0 文件系统,那么在实际迁移过程中运行可选的 BBOMBHFS 或 BBOMBZFS 作业之后,才会实际创建这个新文件系统。在任何情况下,都必须在此处指定安装点的正确值。

zFilesystemType
文件系统的类型
下列其中一个值:
  • HFS

    使用分层文件系统分配和安装配置文件系统数据集

  • ZFS

    使用 zSeries 文件系统分配和安装配置文件系统数据集

zJobStatement1 . . . n
将用于已生成的迁移作业的可定制作业语句

为您定制的所有迁移作业都需要一个作业语句。 请输入对于您的安装而言有效的作业语句。迁移创建过程将更新所有已生成作业中的作业名,因此您不需要参与作业语句的该部分。如果需要续行,那么用续行替换注释行。

zTargetHLQ
目标 z/OS 数据集(将包含生成的作业和指示信息)的高级限定词
注: 可将多级别高级限定词指定为数据集高级限定词。
zmbAdminUserid
用于管理要迁移的节点的管理员用户标识

这是在迁移过程中执行所需的管理操作所必需的。

zmbAdminPassword
用于管理要迁移的节点的管理员用户标识的密码

这是在迁移过程中执行所需的管理操作所必需的。

zmbAppMigrationPreference
想要如何迁移已安装的应用程序
下列其中一个值:
  • D

    在迁移过程中,将用户企业应用程序安装到缺省的应用程序安装目录中

  • Y

    在迁移过程中,将用户企业应用程序安装到在下列变量中指定的目录中

    zmbAppInstallDirLine1
    zmbAppInstallDirLine2
    WebSphere Application Server 安装企业应用程序的位置

    此位置在指定想要迁移和安装应用程序作为应用程序迁移首选项时使用。您可以选择特定于定制环境的位置,也可以使用缺省位置。

    如果位置路径长度超过 60 个字符,那么必须将其指定为在两行上显示;但是其总长度不得超过 120 个字符。

    除非将 zmbAppMigrationPreference 指定为 Y,否则请将这两个字段留空。

  • S

    WebSphere Application Server V9.0 installableApps 目录中准备要安装的用户企业应用程序,而不在迁移期间对它们进行实际安装

    这将生成可用于安装这些应用程序的脚本,并且会将这些脚本保存在迁移备份目录中。对于 WebSphere Application Server for z/OS,此备份目录的位置相对于您对 zmbTempDirectory 变量指定的临时目录。该备份目录的位置同时还由派生的迁移标识及正被迁移的节点类型确定。例如,如果您指定 /tmp/migrate 作为临时目录,而且派生的迁移标识是 55449,那么生成的脚本的位置是:
    /tmp/migrate/55449/nodetype_backup/
    其中 nodetype 是 dmgr、fed 或 base,具体情况取决于您正在迁移的节点的类型。

    完成迁移后,可以随时按任意组合运行这些脚本文件。您还可以对这些文件进行重组和合并以便提高应用程序安装效率。有关更多信息,请参阅文档中的“Wsadmin 工具”一文。

  • P

    在迁移过程中安装用户企业应用程序,并保留先前版本所用的应用程序安装目录

    限制: 如果选择此选项,那么该位置将由现有的 WebSphere Application Server V7.0 安装版本与 V9.0 安装版本共享。如果将已迁移的应用程序放在先前版本应用程序所在的位置中,那么存在以下限制:
    • 必须遵守 WebSphere Application Server V9.0 混合节点支持限制。这意味着在调用 wsadmin 命令时不能使用下列支持:
      • 预编译 JSP
      • 使用二进制配置
      • 部署 EJB
    • 如果以后在管理(例如,卸载)V7.0 安装版本时,从这些位置中删除应用程序,那么会面临意外丢失这些已迁移的应用程序的风险。
    • 相对于 V7.0 变量安装的任何应用程序将相对于在 V9.0 中指定给该变量的位置进行安装。换句话说,不保留绝对路径 - 将应用程序迁移到新 V9.0 环境中的相对位置。
      如果所迁移应用程序的 deployment.xml 文件中的 binariesURL 的路径相对于 WebSphere Application Server(即,该路径以 $(APP_INSTALL_ROOT)$(WAS_INSTALL_ROOT) 等开头),那么在将该应用程序安装到新位置时,会使用新的 WebSphere Application Server 变量值来解析该路径。如果您选择此选项,那么会导致以下结果:
      • V9.0 中,在相对于 WebSphere Application Server 变量的目录位置中安装的任何应用程序都会使用该变量值来安装。
      • 在不相对于 WebSphere Application Server 变量的目录位置中安装的任何应用程序都会被迁移,并在同一个目录中被覆盖。例如,如果应用程序安装在 /employee_records/retrieval_Apps 目录中,那么将迁移并覆盖 /employee_records/retrieval_Apps 目录中的该应用程序。
  • N

    不处理用户企业应用程序

注: 无论此处设置的值如何,WebSphere Application Server 系统应用程序都将迁移。
zmbControllerProcName
用于启动已迁移控制器的 JCL 已启动过程的名称

迁移到 V9.0 时,必须升级 JCL 已启动过程。在迁移期间,将生成新的已启动过程。可为该控制器过程指定新名称,也可以使用旧名称。

zmbServantProcName
用于启动已迁移服务方的 JCL 已启动过程的名称

迁移到 V9.0 时,必须升级 JCL 已启动过程。在迁移期间,将生成新的已启动过程。可为该服务方过程指定新名称,也可以使用旧名称。

zmbDaemonProcName
用于启动已迁移守护程序的 JCL 已启动过程的名称

迁移到 V9.0 时,必须升级 JCL 已启动过程。在迁移期间,将生成新的已启动过程。可为该守护程序过程指定新名称,也可以使用旧名称。

zmbReplaceStartedProcedureNames
是使用指定的新名称来更新配置中的 START 命令 (true) 还是保留同一名称 (false)。

如果为 JCL 过程指定新的名称,那么必须更新 WebSphere Application Server 配置中相应的 START 命令以便与新过程名称相匹配。对此变量指定 true 以执行此配置更新。

如果选择使用相同的过程名称,那么对此变量指定 false。如果未将一致过程名称用于要迁移节点的给定进程类型(例如,所有服务方)的所有服务器,那么建议您对此变量指定 false。在这种情况下,将需要保留相同的 START 命令并将使用迁移时生成的过程用作模板来手动替换过程。

注意:
  • V9.0 配置所使用的 JCL 过程必须与 V7.0 配置所使用的不同。迁移过程将使用此处指定的过程名称来创建新的 V9.0 JCL 过程。
  • 如果您使用 V7.0 配置中所使用的那些名称,那么迁移过程会覆盖现有过程。如果使用相同的名称,那么在运行这些迁移作业之前,务必先备份现有的 V7.0 过程,以便在将来需要回滚时使用。
zmbDisableDmgr
在迁移期间是禁用 (true) 还是不禁用 (false) 先前的 Deployment Manager
如果未禁用 V7.0 Deployment Manager,那么可以在迁移完成后继续使用。
注意: 务必谨慎地使用此选项。停止并禁用 WebSphere Application Server V7.0 Deployment Manager 通常是为了防止多个 Deployment Manager 管理相同的节点。在开始使用 V9.0 Deployment Manager 之前,必须先停止 V7.0 Deployment Manager。取消选择此选项意味着迁移期间对旧配置所作的任何更改都可能不会被迁移。
zmbEnablePostUpgradeTrace
在 WASPostUpgrade 过程中启用 (true) 或禁用 (false) 跟踪
zmbEnablePreUpgradeTrace
在 WASPreUpgrade 过程中启用 (true) 或禁用 (false) 跟踪
zmbEnableProfileTrace
在创建概要文件期间启用 (true) 或禁用 (false) 跟踪
zmbEnableScriptingTrace
启用 (true) 或禁用 (false) 对主目录创建、概要文件和迁移工具调用以及迁移的最后处理阶段的跟踪
zmbFromConfigRoot
从中进行迁移的配置的安装点
zmbFromWASHomeDir
从中进行迁移的配置的主目录
zmbInitialHeapSize
这是为 JVM 堆分配的初始内存。
zmbJavaTempDirectory
这是一个 Java 临时目录,Java 虚拟机在迁移期间使用该目录来创建和存储临时文件。
zmbMaxHeapSize
这是可为 JVM 堆分配的最大堆大小。
zmbProclibName
要将 WebSphere Application Server for z/OS 已编目过程复制到的现有过程库
zmbResolvePortConflicts
通过指定下列其中一个值来定义如何处理端口冲突。
  • incrementCurrent

    如果检测到端口冲突,那么会将端口值从有冲突的端口增大到下一个可用的端口值。

  • startingPort
    如果检测到端口冲突,那么会将端口值从指定的值增大到下一个可用的端口值。
    注: 如果 zmbResolvePortConflictszmbSetPorts 都设置为 startingPort,那么将忽略 zmbResolvePortConflicts 变量。
    zmbStartingPort
    这是从其生成新端口的起始端口值。
zmbSetPorts
通过指定下列其中一个值来定义要在新概要文件中使用的端口值。
  • useOld

    复用源概要文件中定义的端口值。

  • generateNew

    为目标概要文件中的每一个端口设置定制值。

  • startingPort

    通过从指定的端口值进行增加来生成新端口。 将自动解决有冲突的端口。

    zmbStartingPort
    这是从其生成新端口的起始端口值。
zmbSMPEHome
WebSphere Application Server V9.0 已安装产品文件系统的位置
zmbTempDirectory
在其中写入先前配置和迁移跟踪的备份的目录。

迁移期间,需要旧版本配置的备份副本。此备份的缺省位置为 /tmp/migrate。 如果 /tmp 文件系统没有足够的空间用来存储备份配置,那么您可以指定另一个位置。 如果选择覆盖备份副本的缺省位置,那么最好的做法是继续使用原有命名约定,而只是将 /tmp 部分替换为另一个路径(例如 /myTemp/migrate)。

zmbTimestamp
将用于在临时目录下创建目录的标识,该临时目录将包含临时迁移数据集和备份配置数据
zmbToConfigRoot
迁移到的配置的安装点

这是与对 zConfigMountPoint 变量指定的值相同的值。

zmbToWASHomeDir
迁移到的配置的主目录
zmbWorkspaceRootPreference
是要迁移缺省工作空间用户根位置 (D) 中保存的“我的任务”设置还是要迁移保存在用户定义的工作空间根位置 (U) 中保存的设置
zmbUserWorkspaceRoot
用户定义的工作空间根位置

用于迁移 Deployment Manager 的响应文件样本

create
EnableIntermediateSymlink=false
EnableJavaTmpDir=true
intermediateSymlinkPreference=N
profileName=default
profilePath=<root>/profiles/ZMigDmgr01
templatePath=<root>/profileTemplates/zos-migDmgr
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=DMR
zmbAdminPassword={xor}BwcHBwcHBwc=
zmbAdminUserid=XXXXXXXX
zmbAppInstallDirLine1=/wasv9config/DeploymentManager/profiles/default/installedApps
zmbAppInstallDirLine2= 
zmbAppMigrationPreference=D
zmbControllerProcName=BBO9DCR
zmbDaemonProcName=BBO9DMN
zmbDisableDmgr=true
zmbEnablePostUpgradeTrace=0
zmbEnablePreUpgradeTrace=0
zmbEnableProfileTrace=0
zmbEnableScriptingTrace=0
zmbFromConfigRoot=/WebSphere/V7R0
zmbFromWASHomeDir=DeploymentManager
zmbInitialHeapSize=512
zmbJavaTempDirectory=/tmp
zmbMaxHeapSize=768
zmbProclibName=SYS1.PROCLIB
zmbReplaceStartedProcedureNames=true
zmbResolvePortConflicts=incrementCurrent
zmbSMPEHome=/usr/lpp/WebSphere/AppServer/V9R0
zmbServantProcName=BBO9DSR
zmbSetPorts=useOld
zmbTempDirectory=/tmp/migrate
zmbTimestamp=05171857
zmbToConfigRoot=/wasv9config
zmbToWASHomeDir=DeploymentManager
zmbWorkspaceRootPreference=D

指示主题类型的图标 概念主题



时间戳记图标 最近一次更新时间: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-zos&topic=cmig_zmmt_cmd_depmanvar
文件名:cmig_zmmt_cmd_depmanvar.html