使用指令行工具來移轉 Cell

開始之前

支援的配置 支援的配置:

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

sptcfg

請檢閱 Knowledge Collection: Migration planning for WebSphere Application Server 中的移轉規劃資訊。

提示: 您可以指定 -properties file_name.properties 參數來輸入內容檔,而不在移轉指令上指定個別參數。 如需相關資訊,請參閱透過內容定義移轉

關於這項作業

您可以使用指令行工具,將 Cell 從舊版 WebSphere Application Server 移轉至 9.0 版。Cell 配置由備有一或多個節點的部署管理程式、一部 Web 伺服器及一個應用程式用戶端組成。 所有埠都會移轉至新的配置。 這個程序假設先前配置在執行中。

避免困難 避免困難: 請確定開啟檔案的數目上限設定不低於 10000。 如果開啟的檔案數目太少,可能導致各種移轉失敗。gotcha

程序

  1. 備份部署管理程式和所有的舊節點。

    如果移轉期間失敗,請使用 backupConfig 指令,將現行部署管理程式和節點配置,儲存到之後能夠使用來進行回復的檔案中。如需相關資訊,請參閱backupConfig 指令

    1. 切換至 deployment_manager_profile_root/bin 目錄。
    2. 設定適當的參數來執行 backupConfig 指令,將現行設定檔配置儲存在檔案中。 例如:
      /QIBM/UserData/WebSphere/AppServer/V7/ND/profiles/v70dmgr01/bin/backupConfig /mybackupdir/
      v70dmgr01backupBeforeV90migration.zip -username myuser -password mypass -nostop
    3. 對於配置中的每個節點,請切換至 node_profile_root/bin 目錄。
    4. 設定適當的參數來執行 backupConfig 指令,將現行設定檔配置儲存在檔案中。 例如:
      /QIBM/UserData/WebSphere/AppServer/V7/ND/profiles/v70node01/bin/backupConfig 
      /mybackupdir/v70node01rbackupBeforeV90migration.zip -username myuser -password mypass -nostop
  2. 在每一部目標機器上,將 WebSphere Application Server 9.0 版安裝在新目錄中。

    如需相關資訊,請參閱安裝說明文件。

  3. 設定適當的參數來執行 manageprofiles 指令,以建立目標部署管理程式設定檔。

    目標部署管理程式設定檔是一個作為移轉目標的新部署管理程式設定檔。

    避免困難 避免困難: 9.0 版設定檔的 nodeNamecellName 必須符合先前的 7.0 版或更新版本 nodeNamecellName。如果 9.0 版 部署管理程式的 cellNamenodeName 不同,移轉會失敗。gotcha
    例如:
    /QIBM/ProdData/WebSphere/AppServer/V9/ND/bin/manageprofiles -create -profileName 
    currentDmgrProfileName -templatePath /QIBM/ProdData/WebSphere/AppServer/V9/ND/
    profileTemplates/management -serverType DEPLOYMENT_MANAGER -nodeName
    currentDmgrNodeName -cellName currentCellName -hostName mydmgrhost.company.com
  4. 從新的部署管理程式設定檔 bin 目錄執行 WASPreUpgrade 指令,將現行部署管理程式配置儲存到移轉備份目錄。

    WASPreUpgrade 指令不會變更 7.0 版或更新版本配置。如需相關資訊,請參閱WASPreUpgrade 指令

    註: 如果您是從 8.0 版或更新版本移轉至 9.0 版,且設定檔是部署管理程式,當您執行 WASPreUpgrade 指令時,會停止 8.0 版設定檔。只有當您在指令行中提供 -keepDmgrEnabled true,或在移轉精靈中指定對應的選項,部署管理程式才會在 WASPreUpgrade 完成之前啟動。
    1. 執行 WASPreUpgrade 指令。 例如:
      /QIBM/ProdData/WebSphere/AppServer/V9/ND/bin/WASPreUpgrade /mybackup/v70toV90dmgr01 
      /QIBM/UserData/WebSphere/AppServer/V9/ND/profiles/myCurrentDmgrProfile 
    2. 檢閱主控台輸出和 WASPreUpgrade 日誌中的警告或錯誤。

      WASPreUpgrade 指令完成之後,請檢查主控台輸出中是否有出現錯誤,失敗已完成,但出現警告訊息。然後檢查 WASPreUpgrade.old_Profile.timestamp.logWASPreUpgrade.trace 日誌檔中是否有任何的警告或錯誤。

      若有錯誤,請修正錯誤,並重新執行 WASPreUpgrade 指令。請檢查警告是否影響 9.0 版上的其他任何移轉或執行時期活動。

      如果指令順利完成,就不需要檢查日誌中有無錯誤或警告。

  5. 執行 WASPostUpgrade 指令來還原您儲存在移轉備份目錄中的先前的部署管理程式配置。

    如果您使用下列範例所示的選項,就會歸入所有埠,關閉及停用舊的部署管理程式,並安裝所有應用程式。

    如需相關資訊,請參閱WASPostUpgrade 指令

    1. 執行 WASPostUpgrade Script。 例如:
      /QIBM/ProdData/WebSphere/AppServer/V9/ND/bin/WASPostUpgrade /mybackup/v70toV90dmgr01 
      -profileName myCurrentDmgrProfile -oldProfile myCurrentDmgrProfile -resolvePortConflicts incrementCurrent 
      -backupConfig TRUE -includeApps TRUE -keepDmgrEnabled FALSE
      -username myuser -password mypass
      在您建立設定檔時,每個安裝架構只會認定一個設定檔為預設設定檔。

      您可以查看 WAS_HOME/properties 目錄中的 profileRegistry.xml 檔,來識別預設設定檔。在執行 WASPreUpgrade 指令期間,會將來源 profileRegistry.xml 複製到移轉備份目錄。

      避免困難 避免困難: 在您執行 WASPostUpgrade 指令時,請一律指定 -oldProfile-profileName 參數。gotcha
    2. 檢閱主控台輸出和 WASPostUpgrade 日誌中的警告或錯誤。WASPostUpgrade 指令完成之後,請檢查主控台輸出中是否有出現錯誤,失敗已完成,但出現警告訊息。然後檢查 migration_backup_dir/logs/WASPostUpgrade.target_profile_name.timestamp.logmigration_backup_dir/logs/WASPostUpgrade.target_profile_name.trace 日誌檔中是否有任何警告或錯誤。若有錯誤,請修正錯誤,並重新執行 WASPostUpgrade 指令。請檢查警告是否影響 9.0 版上的其他任何移轉或執行時期活動。

      如果已正確移轉配置,但未安裝任何應用程式,您可以執行 WASMigrationAppInstaller 指令,只安裝未移轉的應用程式。 如需相關資訊,請參閱WASMigrationAppInstaller 指令

      如果指令順利完成,就不需要檢查日誌中有無錯誤或警告。

  6. 9.0 版部署管理程式上執行 backupConfig 指令,以便將 9.0 版部署管理程式配置備份到檔案。
    避免困難 避免困難: 這是 Cell 移轉計劃中的一個重要步驟。如果發生任何的節點移轉失敗,您可以將 Cell 配置還原到失敗之前的點、套用改善動作,再重新嘗試移轉節點。gotcha
    1. 切換至 deployment_manager_profile_root/bin 目錄
    2. 設定適當的參數來執行 backupConfig 指令。 例如:
      /QIBM/UserData/WebSphere/AppServer/V9/ND/profiles/myCurrentDmgrProfile/bin/
      backupConfig.sh /mybackupdir/v70toV90dmgr01backupMigratedDmgrOnly.zip 
      -username myuser -password mypass
  7. 啟動 9.0 版部署管理程式。

    請確定舊版的部署管理程式不在執行中。

    1. 切換至新的 9.0 版部署管理程式設定檔 bin 目錄。
    2. 執行 startManager 指令。
    3. 當部署管理程式在執行中,檢查 SystemOut.log 檔,看看是否有警告或錯誤。
      註: 這個主題參照一或多個應用程式伺服器日誌檔。 此外,在分散式和 IBM® i 系統上,另外也建議您可以配置伺服器來使用「高效能可延伸記載 (HPEL)」日誌和追蹤基礎架構,而不使用 SystemOut.logSystemErr.log, trace.logactivity.log 檔案。HPEL 與原生 z/OS® 記載機能也可以一起使用。如果您使用 HPEL,則可以從伺服器設定檔 bin 目錄,利用 LogViewer 指令行工具來存取您所有的日誌和追蹤資訊。請參閱有關利用 HPEL 疑難排解應用程式的資訊,以取得更多使用 HPEL 的相關資訊。
    4. 檢查節點的所有節點代理程式和應用程式伺服器日誌,看看是否有新的警告或錯誤。 若有啟用「自動同步化」,請讓節點同步化、讓應用程式重新啟動,然後檢查日誌中是否有新的警告或錯誤。
  8. 移轉 Web 伺服器的外掛程式。
    1. 確定 9.0 版部署管理程式在執行中。
    2. 升級 Cell 所用 Web 伺服器外掛程式的版本。
    3. 請參閱適用於您的 Web 伺服器類型和版本的支援資訊。
  9. 移轉應用程式用戶端安裝架構。

    將用戶端資源移轉至 9.0 版層次的資源。

    1. 安裝 WebSphere 9.0 版應用程式用戶端。

      如需相關資訊,請參閱安裝說明文件。

    2. 執行 9.0 版 WASPreUpgrade 指令,將應用程式用戶端安全設定儲存在移轉備份目錄中。 例如:
      /opt/AppClientV90/bin/WASPreUpgrade.sh /mybackup/v70clientToV90 /opt/AppClientV70
    3. 執行 9.0 版 WASPostUpgrade 指令,將應用程式用戶端安全設定還原至新的 9.0 版用戶端。 例如:
      /opt/AppClientV90/bin/WASPostUpgrade.sh /mybackup/v70clientToV90 
  10. 移轉節點。

    請利用移轉工具,將配置中的舊版節點移轉至 9.0 版。請針對您打算移轉至 9.0 版的每一個節點,執行下列程序。

    避免困難 避免困難: 您移轉到 9.0 版的每個節點,都必須使用相同的來源節點名稱但不同的暫時 Cell 名稱。gotcha
    1. 確定 9.0 版部署管理程式在執行中。
    2. 建立目標節點設定檔。設定適當的參數來執行 manageprofiles 指令,以建立新的受管理設定檔。 例如:
      /QIBM/ProdData/WebSphere/AppServer/V9/ND/bin/manageprofiles -create 
      -profileName currentNode1Name -templatePath /QIBM/ProdData/WebSphere/AppServer
      /V9/ND/profileTemplates/managed -nodeName currentNode1Name -cellName currentCellName 
      -hostName mynode1host.company.com
    3. 執行 WASPreUpgrade 指令,將現行節點配置資訊儲存到移轉備份目錄中。 請選擇一個新的備份檔目錄。 例如:
      /QIBM/ProdData/WebSphere/AppServer/V9/ND/bin/WASPreUpgrade /mybackup/
      v70toV90node1 /QIBM/UserData/WebSphere/AppServer/V7/ND/profiles/currentNode1Name  
    4. 檢閱主控台輸出和 WASPreUpgrade 日誌中的警告或錯誤。

      檢查 WASPreUpgrade 主控台輸出中是否有下列訊息:出現錯誤,失敗已完成,但出現警告

      查看下列日誌,看看是否有警告或錯誤:
      • migration_backup_dir/logs/WASPreUpgrade.old_profile.timestamp.log
      • migration_backup_dir/logs/WASPreUpgrade.trace

      如果 WASPreUpgrade 指令已完成且「成功」,就不需要檢查日誌中是否有錯誤或警告。

    5. 停止節點代理程式。 如果移轉至 9.0 版期間,有 7.0 版或更新版本的節點正在執行,您必須停止所移轉節點上的節點代理程式。 如果您沒有停止節點代理程式,可能會出現毀損問題。
    6. 執行 WASPostUpgrade 指令,將儲存的節點配置還原到新的 9.0 版受管理設定檔中。 例如:
      /QIBM/ProdData/WebSphere/AppServer/V9/ND/bin/WASPostUpgrade /mybackup/v70toV90node1
      -profileName currentNode1Name -oldProfile 70node1 -resolvePortConflicts incrementCurrent
      -backupConfig TRUE -username myuser -password mypass
    7. 檢閱主控台輸出和 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 指令

      如果指令已完成且「成功」,就不需要檢查日誌中是否有錯誤或警告。

    8. 檢查 9.0 版部署管理程式的 SystemOut.log 檔中是否有警告或錯誤。
      註: 這個主題參照一或多個應用程式伺服器日誌檔。 此外,在分散式和 IBM i 系統上,另外也建議您可以配置伺服器來使用「高效能可延伸記載 (HPEL)」日誌和追蹤基礎架構,而不使用 SystemOut.logSystemErr.log, trace.logactivity.log 檔案。HPEL 與原生 z/OS 記載機能也可以一起使用。如果您使用 HPEL,則可以從伺服器設定檔 bin 目錄,利用 LogViewer 指令行工具來存取您所有的日誌和追蹤資訊。請參閱有關利用 HPEL 疑難排解應用程式的資訊,以取得更多使用 HPEL 的相關資訊。
    9. 啟動已移轉的 9.0 版節點代理程式。
    10. 檢查 9.0 版部署管理程式和節點的 SystemOut.log 檔中是否有警告或錯誤。
    11. 將 Cell 同步化。
    12. 9.0 版已移轉的節點上,停止所有應用程式伺服器。
    13. 9.0 版已移轉的節點上,啟動適當的應用程式伺服器。
    14. 設定適當的參數來執行 backupConfig 指令,將 9.0 版 設定檔配置儲存至檔案。 例如:
      /QIBM/UserData/WebSphere/AppServer/V9/profiles/v70toV90node1/bin/backupConfig 
      /mybackupdir/v70toV90node1.zip -username myuser -password mypass -nostop  
      每當執行 backupConfig 指令時,請使用新的備份檔名稱。
    15. 設定適當的參數來執行 backupConfig 指令,將部署管理程式配置儲存至檔案。 在執行指令之前,請先切換至 9.0 版部署管理程式主機上的 deployment_manager_profile_root/bin 目錄。
      註: 針對移轉的每一個節點,將 9.0 版部署管理程式配置備份至新的備份檔。
      例如:
      /QIBM/UserData/WebSphere/AppServer/V9/profiles/currentDmgrName/bin/
      backupConfig.sh /mybackupdir/v70toV90dmgr01backupMigratedDmgrPlusNodeX.zip 
      -username myuser -password mypass

結果

您已利用移轉工具,從舊版移轉至 WebSphere Application Server 9.0 版


指出主題類型的圖示 作業主題



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