利用 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 設定成自動處理資料集配置,請明確列出磁區。
- 要寫入應用程式資料與環境檔案的檔案系統目錄裝載點
配置檔案系統是所要移轉之節點配置的實際儲存所在。如果移轉中的節點上已有適當的檔案系統,您可以選擇使用現有的 9.0 版檔案系統。 如果您選擇使用現有的 9.0 版檔案系統,在您執行利用這個工具建立的移轉工作之前,必須確定您在這裡指定的裝載點是存在的。 如果您選擇在移轉的節點上建立新的 9.0 版檔案系統,必須等到實際移轉程序期間,您執行選用的 BBOMDHFS 或 BBOMDZFS 工作後,才會實際建立新的檔案系統。 不論哪一種情況,您都必須在這裡指定裝載點的正確值。
- 檔案系統的類型可為下列一值:
- HFS
使用「階層式檔案系統」來配置與裝載配置檔案系統資料集
- ZFS
使用「zSeries 檔案系統」來配置與裝載配置檔案系統資料集
- HFS
- 用於產生之移轉工作的可自訂「工作」陳述式
所有將為您自訂的移轉工作都需要一個工作陳述式。請針對您的安裝架構,輸入有效的工作陳述式。移轉建立程序會在所有產生的工作中,為您更新工作名稱,因此,您不需操心工作陳述式的那一部分。如果需要接續行,請用接續行取代備註行。
- 將包含產生之工作與指示的目標 z/OS 資料集高階限定元註: 您可以指定多層次高階限定元,來作為資料集的高階限定元。
- 管理所移轉的節點時,要使用的管理者使用者 ID
必須提供此項,才能在移轉程序期間執行必要的管理動作。
- 管理所移轉的節點時,要使用的管理者使用者 ID 密碼
必須提供此項,才能在移轉程序期間執行必要的管理動作。
- 您要如何移轉已安裝的應用程式可為下列一值:註: 不論這裡設定了什麼值,WebSphere Application Server 系統應用程式都會進行移轉。
- 用來啟動移轉後之控制器的 JCL 啟動程序名稱
當移轉至 9.0 版時,您必須升級您的 JCL 啟動程序。 移轉期間,會為您產生新的啟動程序。您可以指定控制器程序的新名稱,或使用舊名稱。
- 用來啟動移轉後之服務者的 JCL 啟動程序名稱
當移轉至 9.0 版時,您必須升級您的 JCL 啟動程序。 移轉期間,會為您產生新的啟動程序。您可以指定服務者程序的新名稱,或使用舊名稱。
- 用來啟動移轉後之常駐程式的 JCL 啟動程序名稱
當移轉至 9.0 版時,您必須升級您的 JCL 啟動程序。 移轉期間,會為您產生新的啟動程序。您可以指定常駐程式程序的新名稱,或使用舊名稱。
- 要以指定的新名稱 (true) 來更新配置中的 START 指令,或是保留相同的名稱 (false)。
如果您指定了 JCL 程序的新名稱,就必須將 WebSphere Application Server 配置中對應的 START 指令更新成符合新的程序名稱。 如果要執行這項配置更新,請將這個變數指定為 true。
如果您選擇使用相同的程序名稱,請將這個變數指定為 false。對於您要移轉的節點,如果您不希望具有給定程序類型(例如,所有服務者)的所有伺服器皆採用一致的程序名稱,建議您將這個變數指定為 false。在此情況下,必須保留相同的 START 指令,並手動使用移轉期間所產生作為範本的程序,來取代那些程序。
附註: - 移轉期間是 (true) 否 (false) 要停用先前的部署管理程式如果未停用 7.0 版部署管理程式,移轉完成時,您可以繼續使用它。警告: 請謹慎使用這個選項。通常會停止及停用 WebSphere Application Server 7.0 版部署管理程式的原因,是為了防止多個部署管理程式管理相同的節點。您必須先停止 7.0 版部署管理程式,再開始使用 9.0 版部署管理程式。取消選取這個選項,表示移轉期間在舊配置中所作的任何配置變更,都不會被移轉。
- WASPostUpgrade 程序期間,要啟用 (true) 或停用 (false) 追蹤
- WASPreUpgrade 程序期間,要啟用 (true) 或停用 (false) 追蹤
- 建立設定檔期間,要啟用 (true) 或停用 (false) 追蹤
- 在建立起始目錄、呼叫設定檔與移轉工具,以及移轉的最終處理階段期間,要啟用 (true) 或停用 (false) 追蹤
- 移轉時之來源配置的裝載點
- 移轉時之來源配置的起始目錄
- 配置給 JVM 資料堆的起始記憶體。
- 在移轉期間,供 Java 虛擬機器用來建立和儲存暫存檔的 Java 暫存目錄。
- 配置給 JVM 資料堆的資料堆大小上限。
- WebSphere Application Server for z/OS 編目程序將複製到其中的現有的程序檔案庫
- 指定下列其中一值,來定義如何處理埠衝突。
- 指定下列其中一值,來定義要在新設定檔中使用哪些埠值。
- WebSphere Application Server 9.0 版安裝的產品檔案系統的位置
- 寫入先前配置的備份和移轉追蹤的目錄。
移轉期間,需要舊版配置的備份副本。這個備份的預設位置為 /tmp/migrate。 如果 /tmp 檔案系統沒有足夠的空間來儲存備份配置,您可以指定另一個位置。 如果您選擇置換備份副本的預設位置,最佳作法是保留相同的命名慣例,而只用另一個路徑來取代 /tmp 部分,例如 /myTemp/migrate。
- 在暫存目錄下建立目錄,以包含暫時移轉資料集與備份配置資料時,要使用的 ID
- 移轉時之目標配置的裝載點
此值與指定給 zConfigMountPoint 變數的值相同。
- 移轉時之目標配置的起始目錄
- 要移轉儲存在預設工作區使用者根目錄位置 (D) 中的管理主控台自訂「我的作業」設定,或是移轉儲存在使用者定義之工作區根目錄位置 (U) 中的設定
- 使用者定義的工作區根目錄位置
移轉部署管理程式用的回應檔範例
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