使用「z/OS 移轉管理工具」來移轉獨立式應用程式伺服器時所用的配置變數

WebSphere® Application Server for z/OS® 7.0 版或更新版本節點移轉至 9.0 版之前,您必須先建立一些在實際移轉期間,要在 z/OS 上執行的「工作控制語言 (JCL)」工作(CNTL 和 DATA 資料集)。您可以使用「z/OS 移轉管理工具」來建立移轉定義,以及上傳適當的移轉工作。「z/OS 移轉管理工具」會在您建立獨立式應用程式伺服器的移轉定義時,為您顯示一組配置變數。

支援的配置 支援的配置:

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

sptcfg

選取移轉節點類型

移轉節點類型
要移轉的 WebSphere Application Server 節點類型

移轉定義名稱

這一節識別移轉定義名稱和目錄路徑,其中含有用來移轉 WebSphere Application Server for z/OS 節點的批次工作和指示。
移轉定義名稱
z/OS 移轉定義的名稱

這個名稱僅僅用在工作站中,以識別所產生的移轉工作與指示。所選的名稱對 WebSphere Application Server for z/OS 配置沒有影響。

回應檔路徑名稱(選用)
含有工具中要預載之預設值的回應檔完整路徑名稱

每當建立 z/OS 移轉定義,就會寫入回應檔。它含有用來建立移轉定義的所有變數資料,並且可在定義類似的移轉定義時,用來預載預設值。給定移轉定義的回應檔會寫到移轉定義根目錄的 migration_definition_name.responseFile 檔中。

一般而言,應該從其類型與您要定義之回應檔相同的移轉定義,來指定回應檔。

註: 在您要上傳至 z/OS 目標系統的移轉定義中,.DATA 資料集會包含一份回應檔副本。雖然在 z/OS 系統上不會使用這個回應檔,但仍可供參考用。資料集的成員名稱是 ZMMTBASE。

目標資料集

高階限定元 (HLQ)
將包含產生之工作與指示的目標 z/OS 資料集高階限定元
在您將 z/OS 移轉定義上傳至目標 z/OS 系統時,會將移轉工作與檔案寫入一對分割資料集中。雖然這些資料集可以重複使用,最安全的作法是為每一個要移轉的 z/OS 系統,建立個別的資料集。
  • HLQ.CNTL - 具有固定區塊 80 個位元組記錄的分割資料集,用來包含移轉工作
  • HLQ.DATA - 具有可變長度資料的分割資料集,用來包含移轉定義中所含的其他資料
註: 您可以指定多層次高階限定元,來作為資料集的高階限定元。

資料集名稱與產品目錄

JCL 程序檔案庫資料集名稱
WebSphere Application Server for z/OS 編目程序將複製到其中的現有的程序檔案庫
WebSphere Application Server 產品目錄
WebSphere Application Server 9.0 版安裝的產品檔案系統的位置
中間符號鏈結
選取這個選項,以容許設定中間符號鏈結,並指定該鏈結的路徑名稱(如果您選取此項的話)。

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

選取這個選項,可讓您指定中間符號鏈結的路徑名稱。這條鏈結將由自訂工作建立,並且指向產品檔案系統目錄。
中間符號鏈結的路徑名稱
中間符號鏈結的路徑名稱

配置檔案系統

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

如需有關設定配置裝載點的正確所有權與許可權的特定資訊,請參閱這個工具產生的自訂指示。如需指定這些變數的相關資訊,請參閱產生的指示以及在 z/OS 作業系統上移轉獨立式應用程式伺服器

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

如果這個裝載點尚未存在,移轉程序會在您執行選用的 BBOMBHFS 或 BBOMBZFS 工作時建立它。

名稱
您要建立與裝載在上述裝載點中的檔案系統資料集
磁區或 '*'(若為 SMS)
指定要包含上述資料集的 DASD 磁區序號,或是指定 "*",讓 SMS 選取一個磁區。

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

磁柱中的主要配置
磁柱中配置給配置檔案系統資料集的起始大小

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

建議事項: 建議的大小下限是 420 個磁柱。
磁柱中的次要配置
磁柱中每一個次要範圍的大小
建議事項: 建議的大小下限是 100 個磁柱。
檔案系統類型
階層式檔案系統 (HFS)
使用 HFS 來配置與裝載配置檔案系統資料集
zSeries 檔案系統 (ZFS)
使用 ZFS 來配置與裝載配置檔案系統資料集

伺服器自訂作業(第 1 部分)

來源配置位置
裝載點
移轉時之來源配置的裝載點
起始目錄
移轉時之來源配置的起始目錄
目標配置位置
裝載點
移轉時之目標配置的裝載點

先前是在配置檔案系統畫面上指定此項。

起始目錄
移轉時之目標配置的起始目錄
常駐程式程序名稱
用來啟動移轉後之常駐程式的 JCL 啟動程序名稱

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

控制器程序名稱
用來啟動移轉後之控制器的 JCL 啟動程序名稱

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

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

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

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

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

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

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

附註:
  • 您的 9.0 版配置所使用的 JCL 程序,必須有別於 7.0 版或更新版本配置所使用的 JCL 程序。移轉程序會利用這裡指定的程序名稱來建立新的 9.0 版 JCL 程序。
  • 如果您沿用您在 7.0 版或更新版本配置中使用的相同名稱,移轉程序會與現有程序重疊。如果您使用相同名稱,在執行移轉工作之前,請確定已備份現有的 7.0 版或更新版本程序,以防日後您需要回復。
選用的應用程式部署
部署預設應用程式
指定是否要部署預設應用程式。
部署範例應用程式
指定是否部署範例應用程式。
註: WebSphere Application Server, Network Deployment Cell 中不支援這些應用程式。

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

伺服器自訂作業(第 2 部分)

應用程式移轉喜好設定
您要如何移轉已安裝的應用程式
註: 不論這裡設定了什麼值,WebSphere Application Server 系統應用程式都會進行移轉。
移轉應用程式,並使用預設應用程式安裝目錄
移轉過程中,將使用者企業應用程式安裝在預設應用程式安裝目錄中
移轉應用程式,並使用指定的應用程式安裝目錄
移轉過程中,將使用者企業應用程式安裝在指定的應用程式安裝目錄中
應用程式安裝目錄
WebSphere Application Server 安裝您的企業應用程式的位置

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

移轉並產生管理 Script,以便稍後再安裝應用程式
準備使用者企業應用程式,以便安裝在 WebSphere Application Server 9.0 版 installableApps 目錄中,而不在移轉期間實際安裝它們
會產生可用來安裝這些應用程式的 Script,並儲存在移轉備份目錄中。對於 WebSphere Application Server for z/OS 而言,這個備份目錄的位置是相對於您在這個相同畫面中指定的暫存目錄。 備份目錄的位置亦取決於衍生的移轉 ID 和要移轉的節點類型。例如,如果您指定 /tmp/migrate 作為暫存目錄,而衍生的移轉 ID 是 55449,產生之 Script 的位置為:
/tmp/migrate/55449/nodetype_backup/
視您要移轉的節點類型而定,其中的 nodetype 可以是 dmgr、fed 或 base。

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

移轉應用程式,並使用先前的應用程式安裝目錄
在移轉過程中安裝使用者企業應用程式,並保留與舊版相同的應用程式安裝目錄
限制: 如果您選取這個選項,現有的 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 目錄並且加以改寫。
不移轉應用程式
不對使用者企業應用程式採取任何動作
移轉管理主控台自訂「我的作業」設定
只有 WebSphere Application Server 7.0 版或更新版本才支援「我的作業」。
移轉儲存在預設工作區使用者根目錄位置 (wstemp) 中的「我的作業」設定
移轉儲存在使用者定義之工作區根目錄位置中的「我的作業」設定
使用者定義的工作區根目錄位置

移轉處理程序選項

移轉追蹤選項

如果您選擇啟用追蹤,在整個移轉程序期間會維持啟用狀態。

啟用 Script 追蹤
在建立起始目錄、呼叫設定檔與移轉工具,以及移轉的最終處理階段期間,啟用或停用追蹤
建立設定檔時啟用追蹤
建立設定檔期間,啟用或停用追蹤
前置升級期間啟用追蹤
WASPreUpgrade 程序期間,啟用或停用追蹤
後置升級期間啟用追蹤
WASPostUpgrade 程序期間,啟用或停用追蹤
移轉程序的 JVM 選項
起始資料堆大小 (MB)
配置給 JVM 資料堆的起始記憶體。
資料堆大小上限 (MB)
配置給 JVM 資料堆的資料堆大小上限。
暫存目錄位置
寫入先前配置的備份和移轉追蹤的目錄。

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

移轉定義 ID
在暫存目錄下建立目錄,以包含暫時移轉資料集與備份配置資料時,要使用的 ID
Java 暫存目錄
您可以指定 Java 暫存目錄,以便在移轉期間,供 Java 虛擬機器用來建立和儲存暫存檔。
設定 Java 暫存目錄
Java 暫存目錄位置

埠值

定義要在新設定檔中使用哪些埠值,以及如何處理埠衝突。如果您重複使用舊設定檔中的埠值,新設定檔無法與舊設定檔同時執行,因為會發生埠衝突。如果您打算同時執行這兩個設定檔,請確定每一個設定檔使用的埠不同。

使用舊設定檔使用的相同埠
重複使用定義在來源設定檔中的埠值。
手動選取埠
在下列畫面中,在目標設定檔中為每一埠設定自訂值。
產生新埠,並從一般起始埠值開始增量
從指定的埠值產生新埠。系統會自動解決衝突埠。
解決埠衝突
選擇如何解決埠衝突。
從衝突的埠值開始增量
如果偵測到埠衝突,會從衝突埠來增量埠值,以成為下一個可用的埠值。
從一般的起始埠值開始增量
如果偵測到埠衝突,會從指定值來增量埠值,以成為下一個可用的埠值。

管理代理程式登錄

如果來源設定檔已向管理代理程式登錄,在移轉任何已登錄的設定檔之前,請先移轉管理代理程式。請提供下列資訊,從來源管理代理程式中,將來源設定檔取消登錄。移轉所有已登錄的設定檔之後,請停止來源管理代理程式。最後,手動向目標管理代理程式登錄每一個已移轉的設定檔,且該目標管理代理程式的版本層次必須與已移轉的設定檔相同或更新。
向管理代理程式登錄
指出來源設定檔是否向管理代理程式登錄。
來源管理代理程式
來自管理代理程式中的設定
設定檔路徑
來源管理代理程式的檔案系統路徑。
SOAP 埠
來源管理代理程式使用的 SOAP 連線埠。
使用者名稱
若有啟用安全,此為來源管理代理程式的使用者名稱。
密碼
若有啟用安全,此為來源管理代理程式的管理安全密碼。

工作陳述式定義

所有將為您自訂的移轉工作都需要一個工作陳述式。

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


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



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