管理代理程式設定檔會管理開發、單元測試之類環境中的多個基本應用程式伺服器,或伺服器陣列在單一機器上的這個部分。
您必須先移轉管理代理程式,才能將受管理的基本應用程式伺服器從 7.0 版或更新版本移轉至 9.0 版。
關於這項作業
這個作業說明如何利用「z/OS 配置移轉管理工具」,將管理代理程式及其相關聯的一組受管理基本應用程式伺服器,從 WebSphere Application Server 7.0 版或更新版本移轉至 9.0 版。
當基本應用程式伺服器登錄於單一管理代理程式時,它會進入受管理的狀態。
管理代理程式可以管理一或多個基本應用程式伺服器,且必須與所管理的基本應用程式伺服器在同一部機器上,版本層次相同。
z/OS 限制不論任何時候,都只能執行 7.0 版或更新版本或 9.0 版管理代理程式。下列指示說明何時啟動及停止舊的和新的管理代理程式。
這個限制要求所有受管理的基本應用程式伺服器都必須同時移轉。
避免困難: 當在彈性管理環境中移轉受管理的基本應用程式伺服器時,請確定
9.0 版及舊版上的節點名稱相同。
gotcha
程序
- 執行 backupConfig 指令來備份來源管理代理程式和節點配置。
backupConfig 指令會將管理代理程式和節點配置儲存到檔案中,以便稍後能夠用於回復。
- 切換至 administrative_agent_profile_root/bin 目錄。
- 在管理代理程式及所有受管理的基本應用程式伺服器上,設定適當的參數來執行 backupConfig 指令。 例如:
/opt/WebSphereV70/profiles/v70dmgr01/bin/backupConfig.sh
/mybackupdir/v70dmgr01backupBeforeV90migration.zip
-username myuser -password mypass -nostop
- 對於配置中的每個節點,請切換至 profile_root/bin 目錄。
- 設定適當的參數來執行 backupConfig 指令,將現行設定檔配置儲存在檔案中。 例如:
/opt/WebSphereV70/profiles/v70mas01/bin/backupConfig.sh
/mybackupdir/v70mas01rbackupBeforeV90migration.zip
-username myuser -password mypass -nostop
另外,您也可以利用 PAX 指令來備份所有 HFS 檔案。
如需相關資訊,請參閱使用 z/OS UNIX PAX 指令。
- 將 WebSphere Application Server for z/OS® 9.0 版安裝在每一部目標主機上。
如需相關資訊,請參閱安裝說明文件。
- 在「z/OS 移轉管理工具」中,指定新的管理代理程式移轉配置。
請利用「z/OS 移轉管理工具」來建立移轉定義,以及上傳管理代理程式的移轉工作。
避免困難: 9.0 版 Cell 名稱必須符合
7.0 版或更新版本配置中的 Cell 名稱。如果您利用新的 Cell 名稱來建立設定檔,移轉會失敗。
gotcha
- 填妥下列工作表: 在「z/OS 移轉管理工具」中指定部署管理程式的移轉配置:工作表
- 在「選取移轉節點類型」畫面中,選取移轉管理代理程式。
- 利用工作表中的值來完成後續畫面中的欄位。
- 檢閱管理代理程式的移轉定義,確定所有值都正確。
- 在 WebSphere Application Server for z/OS 移轉定義表中,選取您要檢閱的移轉定義。
- 按一下檢視。
- 如需移轉定義的相關資訊,請按一下摘要、指示或回應檔標籤。
- 將移轉工作上傳至目標 z/OS 系統。
- 確定在受管理的設定檔上所有進行中的工作都已完成。
在受管理的應用程式伺服器或部署管理程式上執行 WASPreUpgrade 指令之前,所有進行中的工作都必須已完成。
- 如果管理代理程式登錄在工作管理程式中,請停止輪詢工作管理程式。
如需如何停止工作管理程式的相關資訊,請參閱使用 wsadmin Scripting 之 AdminTask 物件的 ManagedNodeAgent 指令群組。
- 在「z/OS 移轉管理工具」的「移轉指示」視圖中,或在您上傳到目標 z/OS 系統之 CNTL 資料集的 BBOMAINS 成員中,遵循指示來執行管理代理程式的移轉工作。
CRPROF(建立設定檔)、PREUPGRD (preUpgrade) 和 UPGRADE 步驟都是在這個程序期間執行。
- 請驗證 HFS/ZFS 的工作目錄中所建立的所有輸出(指定在 ZMMT 中),以及批次工作所建立的所有 MVS 工作輸出。
驗證您取得的回覆碼是 0,並檢閱配置檔案系統之移轉暫存目錄中的日誌檔。
移轉暫存目錄是
temporary_directory_location/nnnnn,其中 temporary_directory_location 是指定給暫存目錄位置的目錄,nnnnn 是您在產生移轉工作時,針對移轉 ID 所產生的數值。預設暫存目錄位置是
/tmp/migrate。
- 在「z/OS 移轉管理工具」中指定受管理的應用程式移轉配置。
利用「z/OS 移轉管理工具」來建立移轉定義,並上傳工作,來移轉受管理的基本應用程式伺服器。
避免困難: 9.0 版 Cell 名稱必須符合
7.0 版或更新版本配置中的 Cell 名稱。如果您利用新的 Cell 名稱來建立設定檔,移轉會失敗。
gotcha
- 填妥下列工作表: 在「z/OS 移轉管理工具」中指定聯合節點的移轉配置:工作表
- 在「選取移轉節點類型」畫面中,選取移轉受管理的基本應用程式伺服器。
- 利用工作表中的值來完成後續畫面中的欄位。
- 檢閱聯合節點的移轉定義,確定所有的值皆正確。
- 在 WebSphere Application Server for z/OS 移轉定義表中,選取您要檢閱的移轉定義。
- 按一下檢視。
- 如需移轉定義的相關資訊,請按一下摘要、指示或回應檔標籤。
- 將移轉工作上傳至目標 z/OS 系統。
- 在「z/OS 移轉管理工具」的「移轉指示」視圖中,或在您上傳到目標 z/OS 系統之 CNTL 資料集的 BBOMDINS 成員中,遵循指示來執行受管理基本應用程式伺服器的移轉工作。
CRPROF(建立設定檔)、PREUPGRD (preUpgrade) 和 UPGRADE 步驟都是在這個程序期間執行。
避免困難: - 確定來源管理代理程式在執行中,以便能以管理代理程式將應用程式伺服器取消登錄。
- 如果受管理的應用程式伺服器也登錄在工作管理程式中,您必須先從工作管理程式取消登錄,然後才執行受管理應用程式伺服器的移轉。
移轉完成之後,請重新登錄於管理代理程式和工作管理程式。
gotcha
- 請驗證 HFS 的工作目錄中所建立的所有輸出(指定在 ZMMT 中),以及批次工作所建立的所有 MVS 工作輸出。
驗證您取得的回覆碼是 0,並檢閱配置檔案系統之移轉暫存目錄中的日誌檔。
移轉暫存目錄是
temporary_directory_location/nnnnn,其中 temporary_directory_location 是指定給暫存目錄位置的目錄,nnnnn 是您在產生移轉工作時,針對移轉 ID 所產生的數值。預設暫存目錄位置是
/tmp/migrate。
- 變更至新的 9.0 版已移轉的管理代理程式
避免困難: 請確定登錄於舊的管理代理程式的所有受管理應用程式伺服器都已移轉。
在移轉程序中,這些應該都已取消登錄。
gotcha
- 停止舊有 7.0 版或更新版本管理代理程式。
- 啟動新的 9.0 版管理代理程式。
- 啟動受管理的應用程式伺服器。
- 啟動每個受管理的基本應用程式伺服器。
- 向新的管理代理程式登錄每個受管理的應用程式伺服器。
檢查「節點代理程式」日誌是否有錯誤。
- 開始輪詢工作管理程式。
如需相關資訊,請參閱使用 wsadmin Scripting 之 AdminTask 物件的 ManagedNodeAgent 指令群組。
結果
您已利用移轉工具,將管理代理程式設定檔及其相關聯的受管理基本應用程式伺服器,從 WebSphere Application Server 7.0 版或更新版本移轉至 9.0 版。