利用 zmmt 指令來移轉 z/OS 獨立式應用程式伺服器的配置變數

在移轉 WebSphere® Application Server for z/OS® 之前,您必須建立一些要在實際移轉期間執行的「工作控制語言 (JCL)」工作(CNTL 和 DATA 資料集)。 您可以搭配使用 zmmt 指令與回應檔,來建立適當的移轉工作。移轉回應檔含有一組配置變數,可讓您用來建立獨立式應用程式伺服器的移轉工作。

支援的配置 支援的配置:

本文討論設定檔配置的移轉。 如果要將應用程式移轉至最新的版本,請使用 WebSphere Application Server Migration Toolkit。 如需相關資訊,請參閱 WASdev 上的 Migration Toolkit

sptcfg

回應檔變數

create
必要關鍵字,指出要建立新的移轉定義
intermediateSymlinkPreference
是否設定中間符號鏈結

如果您指定中間符號鏈結,就會建立從配置檔案系統指向中間符號鏈結的符號鏈結;否則,所建立的符號鏈結會直接指向產品檔案系統。

IntermediateSymlink
中間符號鏈結的路徑名稱

這條鏈結將由自訂工作建立,並且指向產品檔案系統目錄。

profileName
移轉期間建立的設定檔名稱

在 z/OS 平台上,一律是 "default"。

profilePath
應用來寫入產生之移轉定義輸出的完整路徑
templatePath
範本路徑
可為下列一值:
  • zos-migDmgr

    移轉部署管理程式

  • zos-migFederated

    移轉聯合節點

  • zos-migStandalone

    移轉獨立式應用程式伺服器

zConfigHfsName
將包含配置檔案系統的 MVS™ 資料集名稱

在移轉工作建立配置檔案系統時,就會輸入這個名稱。

zConfigHfsPrimaryCylinders
將配置給配置檔案系統的主要磁柱數

在應用程式伺服器中,這個資料集所需的總空間量,會隨所安裝的應用程式大小與數目而增加。

建議事項: 建議的大小下限是 420 個磁柱。
zConfigHfsSecondaryCylinders
將配置給配置檔案系統的次要磁柱數
建議事項: 建議的大小下限是 100 個磁柱。
zConfigHfsVolume
要包含上述資料集的 DASD 磁碟機序號,或是 "*",讓 SMS 選取一個磁區

使用 "*" 時,要求先備妥 SMS 自動類別選取 (ACS) 常式,才能選取磁區。如果您未將 SMS 設定成自動處理資料集配置,請明確列出磁區。

zConfigMountPoint
要寫入應用程式資料與環境檔案的檔案系統目錄裝載點

配置檔案系統是所要移轉之節點配置的實際儲存所在。如果移轉中的節點上已有適當的檔案系統,您可以選擇使用現有的 9.0 版檔案系統。 如果您選擇使用現有的 9.0 版檔案系統,在您執行利用這個工具建立的移轉工作之前,必須確定您在這裡指定的裝載點是存在的。 如果您選擇在移轉中的節點上建立新的 9.0 版檔案系統,必須等到實際移轉程序期間,您執行選用的 BBOMBHFS 或 BBOMBZFS 工作之後,才會實際建立新的檔案系統。 不論哪一種情況,您都必須在這裡指定裝載點的正確值。

zFilesystemType
檔案系統的類型
可為下列一值:
  • HFS

    使用「階層式檔案系統」來配置與裝載配置檔案系統資料集

  • ZFS

    使用「zSeries 檔案系統」來配置與裝載配置檔案系統資料集

zJobStatement1 . . . n
用於產生之移轉工作的可自訂「工作」陳述式

所有將為您自訂的移轉工作都需要一個工作陳述式。請針對您的安裝架構,輸入有效的工作陳述式。移轉建立程序會在所有產生的工作中,為您更新工作名稱,因此,您不需操心工作陳述式的那一部分。如果需要接續行,請用接續行取代備註行。

zTargetHLQ
將包含產生之工作與指示的目標 z/OS 資料集高階限定元
註: 您可以指定多層次高階限定元,來作為資料集的高階限定元。
zmbAppMigrationPreference
您要如何移轉已安裝的應用程式
可為下列一值:
  • D

    移轉過程中,將使用者企業應用程式安裝在預設應用程式安裝目錄中

  • Y

    移轉過程中,將使用者企業應用程式安裝在下列變數指定的目錄中

    zmbAppInstallDirLine1
    zmbAppInstallDirLine2
    WebSphere Application Server 安裝您的企業應用程式的位置

    當您指定要按照您的應用程式移轉喜好設定,來移轉與安裝應用程式時,就會使用這個位置。您可以選擇自訂的環境專用位置,或使用預設位置。

    如果位置路徑長度超過 60 個字元,必須按照所示指定成兩行;但總長度不得超過 120 個字元。

    除非您在 zmbAppMigrationPreference 中指定 Y,否則請將這兩個欄位留白。

  • S

    準備使用者企業應用程式,以便安裝在 WebSphere Application Server 9.0 版 installableApps 目錄中,而不在移轉期間實際安裝它們

    會產生可用來安裝這些應用程式的 Script,並儲存在移轉備份目錄中。對於 WebSphere Application Server for z/OS 而言,這個備份目錄的位置是相對於您指定給 zmbTempDirectory 變數的暫存目錄。 備份目錄的位置亦取決於衍生的移轉 ID 和要移轉的節點類型。例如,如果您指定 /tmp/migrate 作為暫存目錄,而衍生的移轉 ID 是 55449,產生之 Script 的位置為:
    /tmp/migrate/55449/nodetype_backup/
    視您要移轉的節點類型而定,其中的 nodetype 可以是 dmgr、fed 或 base。

    完成移轉之後,您就可以在任何時間點,以任何組合來執行這些檔案。您也可以為了提高應用程式安裝效率,重組和合併這些檔案。如需相關資訊,請參閱 Wsadmin 工具

  • P

    在移轉過程中安裝使用者企業應用程式,並保留與舊版相同的應用程式安裝目錄

    限制: 如果您選取這個選項,現有的 WebSphere Application Server 7.0 版或更新版本安裝架構及 9.0 版安裝架構會共用這個位置。如果您將移轉後的應用程式保留在與舊版相同的位置中,將會有下列若干限制:
    • 必須遵循 WebSphere Application Server 9.0 版混合式節點支援限制。 這表示呼叫 wsadmin 指令時,無法使用下列支援:
      • 預先編譯 JSP
      • 使用二進位配置
      • 部署 EJB
    • 日後在您管理 7.0 版或更新版本的安裝架構時,如果您刪除這些位置中的應用程式,會有無意中遺失移轉後應用程式的風險。
    • 如果應用程式安裝在 7.0 版或更新版本變數的相對位置,在 9.0 版中,將會安裝到指派給該變數的相對位置。換句話說,不會保留絕對位置—應用程式會移轉至 9.0 版新環境中的相對位置。
      如果移轉中的應用程式在 deployment.xml 檔中的 binariesURL,其路徑是相對於 WebSphere Application Server(換言之,它的開頭是 $(APP_INSTALL_ROOT)$(WAS_INSTALL_ROOT),等等),在將應用程式安裝到新位置時,會利用新的 WebSphere Application Server 變數值來解析路徑。 當您選取這個選項時,這會導致下列結果:
      • 任何安裝在相對於 WebSphere Application Server 變數之目錄位置的應用程式,在 9.0 版中,都會安裝在這個變數值之下。
      • 任何安裝所在目錄位置並非相對於 WebSphere Application Server 變數的應用程式,都會在這個相同目錄中進行移轉並遭到改寫。 例如,如果應用程式安裝在 /employee_records/retrieval_Apps 目錄,就會將應用程式移轉至 /employee_records/retrieval_Apps 目錄並且加以改寫。
  • N

    不對使用者企業應用程式採取任何動作

註: 不論這裡設定了什麼值,WebSphere Application Server 系統應用程式都會進行移轉。
zmbControllerProcName
用來啟動移轉後之控制器的 JCL 啟動程序名稱

當移轉至 9.0 版時,您必須升級您的 JCL 啟動程序。 移轉期間,會為您產生新的啟動程序。您可以指定控制器程序的新名稱,或使用舊名稱。

zmbServantProcName
用來啟動移轉後之服務者的 JCL 啟動程序名稱

當移轉至 9.0 版時,您必須升級您的 JCL 啟動程序。 移轉期間,會為您產生新的啟動程序。您可以指定服務者程序的新名稱,或使用舊名稱。

zmbDaemonProcName
用來啟動移轉後之常駐程式的 JCL 啟動程序名稱

當移轉至 9.0 版時,您必須升級您的 JCL 啟動程序。 移轉期間,會為您產生新的啟動程序。您可以指定常駐程式程序的新名稱,或使用舊名稱。

zmbAdjunctProcName
用來啟動移轉後之附屬項的 JCL 啟動程序名稱

當移轉至 9.0 版時,您必須升級您的 JCL 啟動程序。 移轉期間,會為您產生新的啟動程序。您可以指定附屬項程序的新名稱,或使用舊名稱。

zmbReplaceStartedProcedureNames
要以指定的新名稱 (true) 來更新配置中的 START 指令,或是保留相同的名稱 (false)。

如果您指定了 JCL 程序的新名稱,就必須將 WebSphere Application Server 配置中對應的 START 指令更新成符合新的程序名稱。 如果要執行這項配置更新,請將這個變數指定為 true。

如果您選擇使用相同的程序名稱,請將這個變數指定為 false。對於您要移轉的節點,如果您不希望具有給定程序類型(例如,所有服務者)的所有伺服器皆採用一致的程序名稱,建議您將這個變數指定為 false。在此情況下,必須保留相同的 START 指令,並手動使用移轉期間所產生作為範本的程序,來取代那些程序。

附註:
  • 您的 9.0 版配置所使用的 JCL 程序,必須有別於 7.0 版或更新版本配置所使用的 JCL 程序。移轉程序會利用這裡指定的程序名稱來建立新的 9.0 版 JCL 程序。
  • 如果您沿用您在 7.0 版或更新版本配置中使用的相同名稱,移轉程序會與現有程序重疊。如果您使用相同名稱,在執行移轉工作之前,請確定已備份現有的 7.0 版或更新版本程序,以防日後您需要回復。
  • 您的 9.0 版配置所使用的 JCL 程序,必須有別於 7.0 版或更新版本配置所使用的 JCL 程序。移轉程序會利用這裡指定的程序名稱來建立新的 9.0 版 JCL 程序。
  • 如果您沿用您在 7.0 版或更新版本配置中使用的相同名稱,移轉程序會與現有程序重疊。如果您使用相同名稱,在執行移轉工作之前,請確定已備份現有的 7.0 版或更新版本程序,以防日後您需要回復。
zmbEnablePostUpgradeTrace
WASPostUpgrade 程序期間,要啟用 (true) 或停用 (false) 追蹤
zmbEnablePreUpgradeTrace
WASPreUpgrade 程序期間,要啟用 (true) 或停用 (false) 追蹤
zmbEnableProfileTrace
建立設定檔期間,要啟用 (true) 或停用 (false) 追蹤
zmbEnableScriptingTrace
在建立起始目錄、呼叫設定檔與移轉工具,以及移轉的最終處理階段期間,要啟用 (true) 或停用 (false) 追蹤
zmbFromConfigRoot
移轉時之來源配置的裝載點
zmbFromWASHomeDir
移轉時之來源配置的起始目錄
zmbInitialHeapSize
配置給 JVM 資料堆的起始記憶體。
zmbInstallDefaultApp
安裝含有 Snoop、Hello 和 HitCount Servlet 的預設應用程式
zmbInstallSamples
指定是否部署範例應用程式。
註: WebSphere Application Server, Network Deployment Cell 中不支援這些應用程式。

請安裝範例應用程式,以使用應用程式伺服器,並評估最新的技術進展。不建議將範例應用程式部署至正式作業應用程式伺服器環境。

zmbJavaTempDirectory
在移轉期間,供 Java 虛擬機器用來建立和儲存暫存檔的 Java 暫存目錄。
zmbManagedBaseNode
指出來源設定檔是否向管理代理程式登錄。
zmbMaxHeapSize
配置給 JVM 資料堆的資料堆大小上限。
zmbNewAdminAgentHostname
來源管理代理程式的主機名稱。
zmbNewAdminAgentPassword
若有啟用安全,此為來源管理代理程式的管理安全密碼。
zmbNewAdminAgentProfilePath
來源管理代理程式的檔案系統路徑。
zmbNewAdminAgentSoapPort
來源管理代理程式使用的 SOAP 連線埠。
zmbNewAdminAgentUsername
若有啟用安全,此為來源管理代理程式的使用者名稱。
zmbOldAdminAgentHostname
目標管理代理程式的主機名稱。
zmbOldAdminAgentPassword
若有啟用安全,此為目標管理代理程式的管理安全密碼。
zmbOldAdminAgentProfilePath
目標管理代理程式的檔案系統路徑。
zmbOldAdminAgentSoapPort
目標管理代理程式使用的 SOAP 連線埠。
zmbOldAdminAgentUsername
若有啟用安全,此為目標管理代理程式的使用者名稱。
zmbProclibName
WebSphere Application Server for z/OS 編目程序將複製到其中的現有的程序檔案庫
zmbResolvePortConflicts
指定下列其中一值,來定義如何處理埠衝突。
  • incrementCurrent

    如果偵測到埠衝突,會從衝突埠來增量埠值,以成為下一個可用的埠值。

  • startingPort
    如果偵測到埠衝突,會從指定值來增量埠值,以成為下一個可用的埠值。
    註: 如果 zmbResolvePortConflictszmbSetPorts 都設為 startingPort,會忽略 zmbResolvePortConflicts 變數。
    zmbStartingPort
    要藉以產生新埠的起始埠值。
zmbSetPorts
指定下列其中一值,來定義要在新設定檔中使用哪些埠值。
  • useOld

    重複使用定義在來源設定檔中的埠值。

  • generateNew

    在目標設定檔中,為每一埠設定自訂值。

  • startingPort

    從指定的埠值增量,來產生新埠。系統會自動解決衝突埠。

    zmbStartingPort
    要藉以產生新埠的起始埠值。
zmbSMPEHome
WebSphere Application Server 9.0 版安裝的產品檔案系統的位置
zmbTempDirectory
寫入先前配置的備份和移轉追蹤的目錄。

移轉期間,需要舊版配置的備份副本。這個備份的預設位置為 /tmp/migrate。 如果 /tmp 檔案系統沒有足夠的空間來儲存備份配置,您可以指定另一個位置。 如果您選擇置換備份副本的預設位置,最佳作法是保留相同的命名慣例,而只用另一個路徑來取代 /tmp 部分,例如 /myTemp/migrate

zmbTimestamp
在暫存目錄下建立目錄,以包含暫時移轉資料集與備份配置資料時,要使用的 ID
zmbToConfigRoot
移轉時之目標配置的裝載點

此值與指定給 zConfigMountPoint 變數的值相同。

zmbToWASHomeDir
移轉時之目標配置的起始目錄
zmbWorkspaceRootPreference
要移轉儲存在預設工作區使用者根目錄位置 (D) 中的管理主控台自訂「我的作業」設定,或是移轉儲存在使用者定義之工作區根目錄位置 (U) 中的設定
zmbUserWorkspaceRoot
使用者定義的工作區根目錄位置
intermediateSymlinkPreference
是否設定中間符號鏈結

如果您指定中間符號鏈結,就會建立從配置檔案系統指向中間符號鏈結的符號鏈結;否則,所建立的符號鏈結會直接指向產品檔案系統。

IntermediateSymlink
中間符號鏈結的路徑名稱

這條鏈結將由自訂工作建立,並且指向產品檔案系統目錄。

移轉獨立式應用程式伺服器的回應檔範例

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

指出主題類型的圖示 概念主題



時間戳記圖示 前次更新: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-zos&topic=cmig_zmmt_cmd_sappservar
檔名:cmig_zmmt_cmd_sappservar.html