使用指令行工具來移轉 Cell
開始之前

本文討論設定檔配置的移轉。 如果要將應用程式移轉至最新的版本,請使用 WebSphere® Application Server Migration Toolkit。 如需相關資訊,請參閱 WASdev 上的 Migration Toolkit。
sptcfg請檢閱 Knowledge Collection: Migration planning for WebSphere Application Server 中的移轉規劃資訊。
這個實務涵蓋在相同主機上移轉 Cell。如果您打算將 Cell 移轉至不同的主機,請參閱利用指令行工具將 Cell 移轉至新的主機。
關於這項作業
您可以使用指令行工具,將 Cell 從舊版 WebSphere Application Server 移轉至 9.0 版。Cell 配置由備有一或多個節點的部署管理程式、一部 Web 伺服器及一個應用程式用戶端組成。 所有埠都會移轉至新的配置。 這個程序假設先前配置在執行中。


- WebSphere Extended Deployment Compute Grid 或 Feature Pack for Modern Batch
- WebSphere Virtual Enterprise 或「智慧型管理」
程序
- 備份部署管理程式和所有的舊節點。
如果移轉期間失敗,請使用 backupConfig 指令,將現行部署管理程式和節點配置,儲存到之後能夠使用來進行回復的檔案中。如需相關資訊,請參閱backupConfig 指令。
- 切換至 deployment_manager_profile_root/bin 目錄。
- 設定適當的參數來執行 backupConfig 指令,將現行設定檔配置儲存在檔案中。 例如:
/opt/WebSphereV70/profiles/v70dmgr01/bin/backupConfig.sh /mybackupdir/v70dmgr01backupBeforeV90migration.zip -username myuser -password mypass -nostop
- 對於配置中的每個節點,請切換至 node_profile_root/bin 目錄。
- 設定適當的參數來執行 backupConfig 指令,將現行設定檔配置儲存在檔案中。 例如:
/opt/WebSphereV70/profiles/v70node01/bin/backupConfig.sh /mybackupdir/ v70node01backupBeforeV90migration.zip -username myuser -password mypass -nostop
- 在每一部目標機器上,將 WebSphere Application Server 9.0 版安裝在新目錄中。
如需相關資訊,請參閱安裝說明文件。
- 設定適當的參數來執行 manageprofiles 指令,以建立目標部署管理程式設定檔。
目標部署管理程式設定檔是一個作為移轉目標的新部署管理程式設定檔。
例如:避免困難: 9.0 版設定檔的 nodeName 和 cellName 必須符合先前的 7.0 版或更新版本 nodeName 和 cellName。如果 9.0 版 部署管理程式的 cellName 或 nodeName 不同,移轉會失敗。gotcha
/opt/WebSphereV90/bin/manageprofiles.sh -create -profileName v70toV90dmgr01 -templatePath /opt/WebSphereV90/profileTemplates/management -serverType DEPLOYMENT_MANAGER -nodeName currentDmgrNodeName -cellName currentCellName -hostName mydmgrhost.company.com
- 從新的部署管理程式設定檔 bin 目錄執行 WASPreUpgrade 指令,將現行部署管理程式配置儲存到移轉備份目錄。
WASPreUpgrade 指令不會變更 7.0 版或更新版本配置。如需相關資訊,請參閱WASPreUpgrade 指令。
註: 如果您是從 8.0 版或更新版本移轉至 9.0 版,且設定檔是部署管理程式,當您執行 WASPreUpgrade 指令時,會停止 8.0 版設定檔。只有當您在指令行中提供 -keepDmgrEnabled true,或在移轉精靈中指定對應的選項,部署管理程式才會在 WASPreUpgrade 完成之前啟動。- 執行 WASPreUpgrade 指令。 例如:
/opt/WebSphereV90/bin/WASPreUpgrade.sh /mybackup/v70toV90dmgr01 /opt/WebSphereV70 -oldProfile 70dmgr01
- 檢閱主控台輸出和 WASPreUpgrade 日誌中的警告或錯誤。
在 WASPreUpgrade 指令完成之後,請檢查主控台輸出中是否有出現錯誤,失敗或已完成,但出現警告訊息。然後檢查 WASPreUpgrade.old_Profile.timestamp.log 和 WASPreUpgrade.trace 日誌檔中是否有任何的警告或錯誤。
若有錯誤,請修正錯誤,並重新執行 WASPreUpgrade 指令。請檢查警告是否影響 9.0 版上的其他任何移轉或執行時期活動。
如果指令順利完成,就不需要檢查日誌中有無錯誤或警告。
- 執行 WASPreUpgrade 指令。 例如:
- 執行 WASPostUpgrade 指令來還原您儲存在移轉備份目錄中的先前的部署管理程式配置。
如果您使用下列範例所示的選項,就會歸入所有埠,關閉及停用舊的部署管理程式,並安裝所有應用程式。
如需相關資訊,請參閱WASPostUpgrade 指令。
- 執行 WASPostUpgrade Script。 例如:
在您建立設定檔時,每個安裝架構只會認定一個設定檔為預設設定檔。/opt/WebSphereV90/bin/WASPostUpgrade.sh /mybackup/v70toV90dmgr01 -profileName v70toV90dmgr01 -oldProfile 70dmgr01 -resolvePortConflicts incrementCurrent -backupConfig TRUE -includeApps TRUE -keepDmgrEnabled FALSE -username myuser -password mypass
您可以查看 WAS_HOME/properties 目錄中的 profileRegistry.xml 檔,來識別預設設定檔。在執行 WASPreUpgrade 指令期間,會將來源 profileRegistry.xml 複製到移轉備份目錄。
如果您想在移轉之後,繼續使用舊的設定檔,請指定 -clone TRUE 參數。 如果您指定進行部署管理程式的複本移轉,您也必須複製它的所有聯合節點。 指定複本移轉會自動將 -keepDmgrEnabled 設為 true。
避免困難: 在您執行 WASPostUpgrade 指令時,請一律指定 -oldProfile 和 -profileName 參數。gotcha
- 檢閱主控台輸出和 WASPostUpgrade 日誌中的警告或錯誤。 在 WASPostUpgrade 指令完成之後,請檢查主控台輸出中是否有出現錯誤,失敗或已完成,但出現警告訊息。然後檢查 migration_backup_dir/logs/WASPostUpgrade.target_profile_name.timestamp.log 和 migration_backup_dir/logs/WASPostUpgrade.target_profile_name.trace 日誌檔中是否有任何警告或錯誤。若有錯誤,請修正錯誤,並重新執行 WASPostUpgrade 指令。請檢查警告是否影響 9.0 版上的其他任何移轉或執行時期活動。
如果已正確移轉配置,但未安裝任何應用程式,您可以執行 WASMigrationAppInstaller 指令,只安裝未移轉的應用程式。 如需相關資訊,請參閱WASMigrationAppInstaller 指令。
如果指令順利完成,就不需要檢查日誌中有無錯誤或警告。
- 執行 WASPostUpgrade Script。 例如:
- 在 9.0 版部署管理程式上執行 backupConfig 指令,以便將 9.0 版部署管理程式配置備份到檔案。
避免困難: 這是 Cell 移轉計劃中的一個重要步驟。如果發生任何的節點移轉失敗,您可以將 Cell 配置還原到失敗之前的點、套用改善動作,再重新嘗試移轉節點。gotcha
- 切換至 deployment_manager_profile_root/bin 目錄
- 設定適當的參數來執行 backupConfig 指令。 例如:
/opt/WebSphereV90/profiles/v70toV90dmgr01/bin/backupConfig.sh /mybackupdir/ v70toV90dmgr01backupMigratedDmgrOnly.zip -username myuser -password mypass
- 啟動 9.0 版部署管理程式。
請確定舊版的部署管理程式不在執行中。
- 切換至新的 9.0 版部署管理程式設定檔 bin 目錄。
- 執行 startManager 指令。
- 當部署管理程式在執行中,檢查 SystemOut.log 檔,看看是否有警告或錯誤。 註: 這個主題參照一或多個應用程式伺服器日誌檔。 此外,在分散式和 IBM® i 系統上,另外也建議您可以配置伺服器來使用「高效能可延伸記載 (HPEL)」日誌和追蹤基礎架構,而不使用 SystemOut.log、SystemErr.log, trace.log 及 activity.log 檔案。HPEL 與原生 z/OS® 記載機能也可以一起使用。如果您使用 HPEL,則可以從伺服器設定檔 bin 目錄,利用 LogViewer 指令行工具來存取您所有的日誌和追蹤資訊。請參閱有關利用 HPEL 疑難排解應用程式的資訊,以取得更多使用 HPEL 的相關資訊。
- 檢查節點的所有節點代理程式和應用程式伺服器日誌,看看是否有新的警告或錯誤。 若有啟用「自動同步化」,請讓節點同步化、讓應用程式重新啟動,然後檢查日誌中是否有新的警告或錯誤。
- 對於 Compute Grid for Modern Batch 或 Feature Pack for Modern Batch,驗證已正確移轉工作排程器,且您已將工作分派給代管批次應用程式的舊版伺服器。
如果要進行工作排程器的移轉驗證,請在部署管理程式重新啟動之後,透過 Web 瀏覽器來存取工作管理主控台。
如果要驗證代管批次應用程式的舊版伺服器運作正確,請執行下列動作:- 驗證已啟動已移轉的伺服器或叢集上的批次應用程式。請檢查伺服器或叢集日誌中是否有任何錯誤。
- 從已移轉的工作排程器伺服器提交工作,驗證您可以將批次工作分派給已移轉的伺服器。您可以利用「工作管理主控台」、WSGrid 公用程式、EJB 介面或 Web 服務介面來提交工作。
- 移轉 Web 伺服器的外掛程式。
- 確定 9.0 版部署管理程式在執行中。
- 升級 Cell 所用 Web 伺服器外掛程式的版本。
- 請參閱適用於您的 Web 伺服器類型和版本的支援資訊。
- 移轉應用程式用戶端安裝架構。
將用戶端資源移轉至 9.0 版層次的資源。
- 安裝 WebSphere 9.0 版應用程式用戶端。
如需相關資訊,請參閱安裝說明文件。
- 執行 9.0 版
WASPreUpgrade 指令,將應用程式用戶端安全設定儲存在移轉備份目錄中。 例如:
/opt/AppClientV90/bin/WASPreUpgrade.sh /mybackup/v70clientToV90 /opt/AppClientV70
- 執行 9.0 版
WASPostUpgrade 指令,將應用程式用戶端安全設定還原至新的 9.0 版用戶端。 例如:
/opt/AppClientV90/bin/WASPostUpgrade.sh /mybackup/v70clientToV90
- 安裝 WebSphere 9.0 版應用程式用戶端。
- 移轉節點。
請利用移轉工具,將配置中的舊版節點移轉至 9.0 版。請針對您打算移轉至 9.0 版的每一個節點,執行下列程序。
避免困難: 您移轉到 9.0 版的每個節點,都必須使用相同的來源節點名稱但不同的暫時 Cell 名稱。gotcha
- 確定 9.0 版部署管理程式在執行中。
- 建立目標節點設定檔。設定適當的參數來執行 manageprofiles 指令,以建立新的受管理設定檔。 例如:
/opt/WebSphereV90/manageprofiles.sh -create -profileName node1 -templatePath /opt/WebSphereV90/profileTemplates/managed -nodeName currentNode1Name -cellName currentCellName -hostName mynode1host.company.com
- 執行 WASPreUpgrade 指令,將現行節點配置資訊儲存到移轉備份目錄中。
請選擇一個新的備份檔目錄。 例如:
/opt/WebSphereV90/bin/WASPreUpgrade.sh /mybackup/v70toV90node1 /opt/WebSphereV70 -oldProfile 70node1
- 檢閱主控台輸出和 WASPreUpgrade 日誌中的警告或錯誤。
檢查 WASPreUpgrade 主控台輸出中是否有下列訊息:出現錯誤,失敗或已完成,但出現警告。
查看下列日誌,看看是否有警告或錯誤:- migration_backup_dir/logs/WASPreUpgrade.old_profile.timestamp.log
- migration_backup_dir/logs/WASPreUpgrade.trace
如果 WASPreUpgrade 指令已完成且「成功」,就不需要檢查日誌中是否有錯誤或警告。
- 停止節點代理程式。 如果移轉至 9.0 版期間,有 7.0 版或更新版本的節點正在執行,您必須停止所移轉節點上的節點代理程式。 如果您沒有停止節點代理程式,可能會出現毀損問題。
- 執行 WASPostUpgrade 指令,將儲存的節點配置還原到新的 9.0 版受管理設定檔中。 例如:
/opt/WebSphereV90/bin/WASPostUpgrade.sh /mybackup/v70toV90node1 -profileName currentNode1Name -oldProfile 70node1 -resolvePortConflicts incrementCurrent -backupConfig TRUE -username myuser -password mypass
如果您已複製部署管理程式,您也必須複製所有聯合節點。 請指定 -clone TRUE 參數及新的部署管理程式主機名稱,以及 SOAP 或 RMI 埠。 除非也複製了部署管理程式,否則,請勿複製聯合節點。/opt/WebSphereV90/bin/WASPostUpgrade.sh /mybackup/v70toV90node1 -profileName currentNode1Name -oldProfile 70node1 -resolvePortConflicts incrementCurrent -backupConfig TRUE -username myuser -password mypass -clone TRUE -newDmgrHostName myV90DmgrHost.mycompany.com -newDmgrSoapPort 8879
- 檢閱主控台輸出和 WASPostUpgrade 日誌中的警告或錯誤。
檢查 WASPostUpgrade 主控台輸出中是否有出現錯誤,失敗或已完成,但出現警告訊息。
查看下列日誌,看看是否有錯誤或警告:- migration_backup_dir/logs/WASPostUpgrade.target_profile.timestamp.log
- migration_backup_dir/logs/WASPostUpgrade.target_profile.trace
註: 如果 WASPostUpgrade 指令失敗,您可能需要從 backupConfig 檔中還原 9.0 版部署管理程式。如果 WASPostUpgrade 處理程序已執行 syncNode 指令,部署管理程式會知道節點已經移轉。 您必須將部署管理程式還原到節點移轉之前的狀態,才能再次移轉節點。如果已正確移轉配置,但未安裝任何應用程式,您可以執行 WASMigrationAppInstaller 指令,只安裝未移轉的應用程式。 如需相關資訊,請參閱WASMigrationAppInstaller 指令。
如果指令已完成且「成功」,就不需要檢查日誌中是否有錯誤或警告。
- 檢查 9.0 版部署管理程式的 SystemOut.log 檔中是否有警告或錯誤。 註: 這個主題參照一或多個應用程式伺服器日誌檔。 此外,在分散式和 IBM i 系統上,另外也建議您可以配置伺服器來使用「高效能可延伸記載 (HPEL)」日誌和追蹤基礎架構,而不使用 SystemOut.log、SystemErr.log, trace.log 及 activity.log 檔案。HPEL 與原生 z/OS 記載機能也可以一起使用。如果您使用 HPEL,則可以從伺服器設定檔 bin 目錄,利用 LogViewer 指令行工具來存取您所有的日誌和追蹤資訊。請參閱有關利用 HPEL 疑難排解應用程式的資訊,以取得更多使用 HPEL 的相關資訊。
- 啟動已移轉的 9.0 版節點代理程式。
- 檢查 9.0 版部署管理程式和節點的 SystemOut.log 檔中是否有警告或錯誤。
- 將 Cell 同步化。
- 在 9.0 版已移轉的節點上,停止所有應用程式伺服器。
- 在 9.0 版已移轉的節點上,啟動適當的應用程式伺服器。
- 對於 Compute Grid for Modern Batch 或 Feature Pack for Modern Batch,驗證已正確移轉工作排程器,且您已將工作分派給代管批次應用程式的已移轉的伺服器。
如果要進行工作排程器的移轉驗證,請在已移轉的應用程式伺服器或叢集重新啟動之後,透過 Web 瀏覽器來存取工作管理主控台。
如果要驗證代管批次應用程式的 9.0 版伺服器運作正確,請執行下列動作:- 驗證已啟動已移轉的伺服器或叢集上的批次應用程式。請檢查伺服器或叢集日誌中是否有任何錯誤。
- 從已移轉的工作排程器伺服器提交工作,驗證您可以將批次工作分派給已移轉的伺服器。您可以利用「工作管理主控台」、WSGrid 公用程式、EJB 介面或 Web 服務介面來提交工作。
- 設定適當的參數來執行 backupConfig 指令,將 9.0 版 設定檔配置儲存至檔案。 例如:
每當執行 backupConfig 指令時,請使用新的備份檔名稱。/opt/WebSphereV90/profiles/v70toV90node1/bin/backupConfig.sh /mybackupdir/ v70toV90node1.zip -username myuser -password mypass -nostop
- 設定適當的參數來執行 backupConfig 指令,將部署管理程式配置儲存至檔案。 在執行指令之前,請先切換至 9.0 版部署管理程式主機上的 deployment_manager_profile_root/bin 目錄。註: 針對移轉的每一個節點,將 9.0 版部署管理程式配置備份至新的備份檔。例如:
/opt/WebSphereV90/profiles/v70toV90dmgr01/bin/backupConfig.sh /mybackupdir/ v70toV90dmgr01backupMigratedDmgrPlusNodeX.zip -username myuser -password mypass
註: 如果您要將節點移轉至不同的主機,請參閱利用指令行工具將 Cell 移轉至新的主機中有關移轉節點的資訊。
結果
您已利用移轉工具,從舊版移轉至 WebSphere Application Server 9.0 版。


http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-dist&topic=tmig_migrate_cells_commandline
檔名:tmig_migrate_cells_commandline.html