移轉管理代理程式設定檔及其已登錄的一組受管理的基本應用程式伺服器

管理代理程式設定檔會管理開發、單元測試之類環境中的多個基本應用程式伺服器,或伺服器陣列在單一機器上的這個部分。 您必須先移轉管理代理程式,才能將受管理的基本應用程式伺服器從 7.0 版或更新版本移轉至 9.0 版

開始之前

支援的配置 支援的配置:

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

sptcfg

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

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

關於這項作業

當基本應用程式伺服器登錄於單一管理代理程式時,它會進入受管理的狀態。 管理代理程式可以管理一或多個基本應用程式伺服器,且必須與所管理的基本應用程式伺服器在同一部機器上,版本層次相同。 由於這項限制,新舊版本上的管理代理程式會同時執行,直到所有受管理的基本應用程式伺服器都已移轉。 管理代理程式的移轉並不包括舊有的埠值,不過,仍會移轉所有其他配置資料。

請依照新的 9.0 版管理代理程式 serverindex.xml 檔所定義,利用 WC_ adminhost 或 WC_ adminhost_ 安全埠來存取 9.0 版管理代理程式主控台。 此外,在這個程序期間,不能關閉或停用 7.0 版或更新版本管理代理程式。

如果是在彈性管理環境中移轉受管理的基本應用程式伺服器時,請確定 9.0 版與舊版上的節點名稱相同。

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

程序

  1. 在目標主機上,將 WebSphere Application Server 9.0 版安裝在新目錄中。

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

  2. 建立一個 9.0 版管理代理程式設定檔來作為管理代理程式移轉的目標。

    設定適當的參數來執行 manageprofiles 指令,以建立新的管理代理程式設定檔。

    例如:
    C:\WebSphere\AppServer90\bin>manageprofiles.bat -create -profileName AdminAgent01 -profilePath 
    C:\WebSphere\AppServer90\profiles\AdminAgent01 -templatePath C:\WebSphere\AppServer90\profileTemplates\management
    -serverType ADMIN_AGENT -nodeName AdminAgentNode01 -cellName AdminAgentCell01 -hostName <myhostname>
  3. 確定在受管理的設定檔上所有進行中的工作都已完成。
  4. 在從工作管理程式取得工作的設定檔上,停止輪詢工作管理程式。

    在開始輪詢工作之前,請先針對受管理的設定檔,完成 WASPreUpgradeWASPostUpgrade。如需相關資訊,請參閱使用 wsadmin Scripting 之 AdminTask 物件的 ManagedNodeAgent 指令群組

  5. 從新的 WebSphere Application Server 安裝根目錄的 bin 目錄中執行 WASPreUpgrade 指令,將現行管理代理程式配置儲存到移轉備份目錄中。

    WASPreUpgrade 指令不會變更舊的配置。

    1. 執行 WASPreUpgrade 指令。

      如需指令參數的相關資訊,請參閱WASPreUpgrade 指令

      例如:
      C:\WebSphere\AppServer90\bin>WASPreUpgrade.bat C:\WAS70AdminAgentbackup C:\WebSphere\AppServer70 -oldProfile AdminAgent01
      -traceString *=all=enabled -tracefile C:\WAS70AdminAgentbackup\logs\WASPreMigrationSummary.log
    2. 檢閱主控台輸出和 WASPreUpgrade 日誌中的警告或錯誤。WASPreUpgrade 指令完成之後,請檢查主控台輸出中是否有出現錯誤,失敗已完成,但出現警告訊息。然後,檢查下列日誌檔中是否有任何警告或錯誤:
      • migration_backup_dir/logs/WASPreMigrationSummary.log
      • WASPreUpgrade.timestamp.log
      • WASPreUpgrade.trace

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

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

  6. 從新的 WebSphere Application Server 安裝根目錄的 bin 目錄執行 WASPostUpgrade 指令,以還原先前的管理代理程式配置。
    1. 執行 WASPostUpgrade 指令,將儲存的管理代理程式配置還原到新的 9.0 版管理代理程式設定檔中。 例如:
      C:\IBM\WebSphere\AppServer90\bin>WASPostUpgrade.bat C:\WAS70AdminAgentbackup -oldProfile AdminAgent01 -profileName AdminAgent01
      -traceString *=all=enabled -tracefile C:\WAS70AdminAgentbackup\logs\WASPostMigrationSummary.log -username myuser -password mypass
    2. 檢閱主控台輸出和 WASPostUpgrade 日誌中的警告或錯誤。WASPostUpgrade 指令完成之後,請檢查主控台輸出中是否有出現錯誤,失敗已完成,但出現警告訊息。然後,檢查下列日誌檔中是否有任何警告或錯誤:
      • migration_backup_dir/logs/WASPostMigrationSummary.log
      • WASPostUpgrade.target_profile_name.timestamp.log
      • WASPostUpgrade.target_profile_name.trace

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

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

  7. 啟動 9.0 版 管理代理程式,確定 7.0 版或更新版本9.0 版管理代理程式在執行中。
    1. 切換至新的 9.0 版管理代理程式設定檔 bin 目錄。
    2. 執行 startServer adminagent 指令。
    3. 檢查 SystemOut.log 檔中是否有警告或錯誤。
      註: 這個主題參照一或多個應用程式伺服器日誌檔。 此外,在分散式和 IBM® i 系統上,另外也建議您可以配置伺服器來使用「高效能可延伸記載 (HPEL)」日誌和追蹤基礎架構,而不使用 SystemOut.logSystemErr.log, trace.logactivity.log 檔案。HPEL 與原生 z/OS® 記載機能也可以一起使用。如果您使用 HPEL,則可以從伺服器設定檔 bin 目錄,利用 LogViewer 指令行工具來存取您所有的日誌和追蹤資訊。請參閱有關利用 HPEL 疑難排解應用程式的資訊,以取得更多使用 HPEL 的相關資訊。
  8. 移轉受管理的基本應用程式伺服器。
    避免困難 避免困難: 移轉若要成功,請執行下列動作:
    • 受管理的基本應用程式伺服器與相關聯的管理代理程式必須在同一部機器上。
    • 9.0 版和舊版上的節點名稱必須相同。
    • [Windows]如果您有 Windows 平台,且打算移轉 SIB 元件,執行移轉之前,請先停止 AppSrv 伺服器。
    gotcha

    對於每個您打算移轉至 9.0 版的受管理的基本應用程式伺服器,請執行下列步驟:

    1. 建立目標基本應用程式伺服器設定檔。 設定適當的參數來執行 manageprofiles 指令,以建立新的受管理設定檔。 例如:
      C:\WebSphere\AppServer90\bin>manageprofiles.bat -create -profileName AppSrv01
      -profilePath C:\WebSphere\AppServer90\profiles\AppSrv01
      -templatePath C:\WebSphere\AppServer90\profileTemplates\default 
      -serverType APPLICATION_SERVER -nodeName AppSrv01Node01
      -cellName AppSrv01Cell01 -hostName <myhostname>
    2. 執行 WASPreUpgrade 指令,將現行受管理的基本應用程式伺服器資訊儲存到移轉備份目錄中。請選擇一個新的備份檔目錄。 例如:
      C:\WebSphere\AppServer90\bin>WASPreUpgrade.bat C:\WAS70Appserver01backup
      C:\WebSphere\AppServer70 -oldProfile Appserver01 -traceString *=all=enabled
      -summaryLogName C:\WAS70Appserver01backup\logs\WASPreMigrationSummary.log
    3. 檢閱主控台輸出和 WASPreUpgrade 日誌中的警告或錯誤。WASPreUpgrade 指令完成之後,請檢查主控台輸出中是否有出現錯誤,失敗已完成,但出現警告訊息。然後,檢查下列日誌檔中是否有任何警告或錯誤:
      • migration_backup_dir/logs/WASPreMigrationSummary.log
      • WASPreUpgrade.timestamp.log
      • WASPreUpgrade.trace

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

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

    4. 執行 WASPostUpgrade 指令,將儲存的受管理應用程式伺服器設定檔配置,還原到新的 9.0 版基本應用程式伺服器設定檔中。
      避免困難 避免困難: 這個指令需要其他參數,下列範例假設兩個管理代理程式都已啟用安全。gotcha
      例如:
      C:\IBM\WebSphere\AppServer90\bin>WASPostUpgrade.bat C:\WAS70Appserver01backup
      -oldProfile AppSrv01 -profileName AppSrv01 -traceString *=all=enabled
      -summaryLogName C:\WAS70Appserver01backup\logs\WASPostMigrationSummary.log
      -oldAdminAgentProfilePath C:\WebSphere\Appserver70\profiles\AdminAgent01
      -oldAdminAgentHostname myhostname -oldAdminAgentSoapPort 8879 -oldAdminAgentUsername
      myusername -oldAdminAgentPassword mypassword -newAdminAgentProfilePath
      C:\WebSphere\AppServer90\profiles\AdminAgent01 -newAdminAgentHostname 
      myhostname -newAdminAgentSoapPort 8887 -newAdminAgentUsername
      myusername1 -newAdminAgentPassword mypassword1
    5. 檢閱主控台輸出和 WASPostUpgrade 日誌中的警告或錯誤。WASPostUpgrade 指令完成之後,請檢查主控台輸出中是否有出現錯誤,失敗已完成,但出現警告訊息。然後,檢查下列日誌檔中是否有任何警告或錯誤:
      • migration_backup_dir/logs/WASPostMigrationSummary.log
      • WASPostUpgrade.target_profile_name.timestamp.log
      • WASPostUpgrade.target_profile_name.trace

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

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

    6. 啟動已移轉的 9.0 版受管理的應用程式伺服器。
    7. 檢查 9.0 版受管理的應用程式伺服器 SystemOut.log 檔中是否有警告或錯誤。
      註: 這個主題參照一或多個應用程式伺服器日誌檔。 此外,在分散式和 IBM i 系統上,另外也建議您可以配置伺服器來使用「高效能可延伸記載 (HPEL)」日誌和追蹤基礎架構,而不使用 SystemOut.logSystemErr.log, trace.logactivity.log 檔案。HPEL 與原生 z/OS 記載機能也可以一起使用。如果您使用 HPEL,則可以從伺服器設定檔 bin 目錄,利用 LogViewer 指令行工具來存取您所有的日誌和追蹤資訊。請參閱有關利用 HPEL 疑難排解應用程式的資訊,以取得更多使用 HPEL 的相關資訊。

結果

您已利用移轉工具,將管理代理程式設定檔及其相關聯的受管理基本應用程式伺服器,從 WebSphere Application Server 7.0 版或更新版本移轉至 9.0 版。您可以停止 7.0 版或更新版本管理代理程式,且可以將 7.0 版或更新版本的埠指派給 9.0 版管理代理程式。


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



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