WebSphere Application Server V7 快速遷移指南

引言

本文旨在幫助您著手將 IBM WebSphere Application Server 5.1.x 版本或 6.x 版本遷移到 WebSphere Application Server 7.0 版。本文簡要概述了 WebSphere Application Server V7 遷移工具及其使用，並綜述了在從特定版本（單臺伺服器和託管計算單元）遷移時需要注意的一些特殊事項。有關遷移過程中每個步驟的詳細資訊，請參考 WebSphere Application Server V7 資訊中心。

本文件使用的術語

在開始之前，我們先介紹一下本文使用的一些術語的定義：

術語	在本文中的含義
備份目錄	指 WASPreUpgrade 工具建立的目錄結構，包含從 WebSphere Application Server 的以前版本進行遷移時所需的全部必要資訊。
計算單元	指由單個部署管理器控制的一個或多個節點的集合。
convertScriptCompatibility	將 V7 配置從支援指令碼相容模式轉換為不再支援指令碼相容模式的命令。例如，將 V5 的傳輸轉換為通道。
部署管理器概要 (dmgr)	此概要充當部署管理器的角色，而且是 V5.1 或 V6.x 部署管理器遷移的目的地。每個計算單元只能有一個部署管理器概要。
聯合或被聯合	分別指將節點新增到計算單元的操作，以及已經成為計算單元一部分的節點。
FirstSteps	V6 和 V7 中提供的工具，可以簡化和組織需要在新安裝的系統上執行的許多初始操作。可以在每個概要的 firststeps 目錄下找到此工具，並且可以用於啟動遷移向導。（在 IBM i 或 z/OS® 中不可用。）
已遷移	當用於描述 WebSphere Application Server 配置的元素時，指該項已在遷移過程中被遷移，目前已經位於目標概要中。
遷移	就本文而言，遷移 一詞僅限於與將 Java™ 2 Enterprise Edition (J2EE) 應用程式（EAR 檔案）和 WebSphere Application Server 配置資料（如資源和安全設定）從以前版本的 WebSphere Application Server 移動到 V7 有關的操作。
遷移向導	請參閱以互動方式執行遷移的圖形使用者介面 (GUI)。該 GUI 工具同時執行 WASPreUpgrade 和 WASPostUpgrade 步驟。（在 IBM i 或 z/OS 中不可用）。
新	當用於描述 WebSphere Application Server 配置的一個元素時，指該項已駐留在目標（或已遷移）概要中。
以前的	當用於描述 WebSphere Application Server 配置的一個元素時，指該項駐留在源概要中。
概要	此概念擴充套件了 V5 中的例項思想，是指 WebSphere Application Server V6 和 V7 中所有配置資料的集合。WebSphere Application Server V7 只需安裝一個二進位制檔案即可提供多個概要。對於從以前版本遷移的資料而言，需要使用單一概要作為目的地。
源概要	指您的 V5.1 或 V6.x WebSphere Application Server 配置，其中的資訊將轉移到 V7。
獨立或 Application Server 概要	指與 WebSphere Application Server 單節點安裝類似的概要。此類概要是計算單元內和計算單元外的節點的遷移目的地，但是對於聯合節點建議使用自定義概要。
目標概要	指要將您的配置遷移到的 V7 概要。與您的 WebSphere Application Server V7 配置類似。
V6、V5 等	此類符號是指 WebSphere Application Server 的各種版本。例如，當所述資訊同時適用於 WebSphere Application Server 版本 6.0.2 和 6.1 時，將使用 V6 表示。
WASPreUpgrade	執行兩步驟遷移過程的第一步的工具。此步驟提取 WebSphere Application Server 以前版本中的資訊，並將其儲存到備份目錄中。此工具可以從命令列自行執行，也可以作為遷移向導的一部分執行。
WASPostUpgrade	執行兩步驟遷移過程的第二步的工具。此步驟提取通過 WASPreUpgrade 工具建立的目錄中的資訊，並將該資訊匯入到 V7 概要。此工具可以從命令列自行執行，也可以作為遷移向導的一部分執行。

跨 WebSphere Application Server 遷移支援

遷移支援和工具的基本知識在 WebSphere Application Server V7 支援的所有作業系統上都類似。此工具的根在執行命令列工具中提供。不過，為某些作業系統提供的介面各不相同，而且有些特徵是某些作業系統所獨有的。下面簡要概述了該支援：

z/OS

將 WebSphere Application Server for z/OS 遷移到 V7 涉及自定義一組批處理作業，然後執行這些作業來遷移節點。自定義是使用 z/OS 遷移管理工具完成的，該工具包括在針對 V7 的 WebSphere 自定義工具中。計算單元中的每個節點均將有自己的自定義作業；並且逐節點遷移計算單元，首先從 Deployment Manager 節點開始。

z/OS 遷移管理工具是在 z/OS 上進行遷移支援的唯一介面。z/OS 作業系統的獨有特徵以及針對 z/OS 的遷移步驟在以下白皮書中進行了介紹：Migrating to WebSphere z/OS V7，作者 Don Bagwell。此白皮書以及 WebSphere Application Server V7 資訊中心中的資訊很好地描述了對 z/OS 的遷移支援。本文不再贅述相關資訊。

IBM i

將 WebSphere Application Server for IBM i 遷移到 V7 涉及呼叫一些工具，這些工具在執行命令列工具部分中進行了描述。使用這些命令列工具是在 IBM i 上進行遷移支援的唯一介面。您可以使用本文指導您的 IBM i 遷移，但是請注意，遷移向導部分中描述的支援不適用於 IBM i。而且，遷移 CD 對 IBM i 不可用。

分散式平臺

分散式平臺實質上包括 WebSphere Application Server（而非 z/OS 和 IBM i）支援的所有作業系統。請參閱 WebSphere Application Server V7 支援的軟體列表，瞭解這些作業系統及其系統需求的完整列表。這些作業系統通過使用命令列工具或遷移向導進行支援。

1. 準備遷移

本部分涵蓋在嘗試從 WebSphere Application Server 的以前版本遷移到 V7 之前需要了解的重要問題。除非專門說明，此處討論的所有觀點在從 V5.1 或 V6 遷移時都適用。

1. 確認必備的軟體級別。請參閱 WebSphere Application Server V7 支援的軟體列表，瞭解您的作業系統和關聯軟體所需的最小版本和修復程式級別要求。如果您現有的 WebSphere Application Server V5.1 或 V6 安裝在不能滿足 V7 的先決條件的作業系統（例如 AIX® 5.1 或 Sun™ Solaris™ 8）上，則需要先升級作業系統，才能在您的系統上安裝 WebSphere Application Server V7。

2. 收集資訊。在使用命令列工具著手執行遷移過程之前，務必記下 V5.1 或 V6 計算單元的名稱，以及計算單元中所有節點的名稱。在為計算單元中的每個節點建立 V7 概要時將需要這些值。概要將在下一部分中詳細討論。

3. 備份您的環境。在嘗試任何遷移之前一定要備份您的 WebSphere Application Server 環境。這在執行增量計算單元升級時尤其重要。可以使用 WebSphere Application Server 備份工具來儲存當前環境；要了解這方面的詳細資訊，請檢視 V5.1 或 V6 資訊中心中與 backupConfig 實用工具相關的文章（請參閱參考資料）。

4. 完整保留以前版本的 WebSphere Application Server。這一點無需著重強調：不要解除安裝現有的 WebSphere Application Server V5.1 或 V6 配置，按原樣保留即可。WebSphere Application Server V7 可以與這些以前版本安全地共存——假定在同一時間僅執行 WebSphere Application Server 的一個版本。除在遷移的第一步中需要這樣做之外，完整保留以前版本的 WebSphere Application Server 還能在需要或必要時將您的環境回滾到以前的版本。

   2. 安裝 WebSphere Application Server V7

   相對於 V5 的安裝過程，V7 的安裝過程發生了一些變化。一個重要的變化是遷移過程與安裝程式分開了。上文已經提到，在安裝 V7 之後，遷移向導（僅用於分散式操作環境）將指導您執行遷移過程。如果以前使用“靜默”(Silent) 選項來安裝並遷移以前的版本，您仍可以以靜默方式安裝，但在安裝之後需要手動使用遷移命令列工具。

   在 V6 中引入並在 WebSphere Application Server V7 中使用了概要概念，概要是 WebSphere Application Server 配置和應用程式檔案集的獨立例項。從本質上說，概要可以實現僅通過 WebSphere Application Server 核心二進位制檔案的一個副本來儲存 V7 的多個配置。概要提供了對 V5.1 例項的改進，而且 V7 提供的工具可用於建立和管理這些概要。

   您將使用 FirstSteps 工具來訪問 Profile Management 工具，如圖 1 所示。

   
   圖 1. Profile Management 工具
   
   

   在 WebSphere Application Server Network Deployment V7（以下稱為 Network Deployment）中，一共有五種型別的概要：

   • 部署管理器
   • 作業管理器
   • 管理代理
   • 自定義
   • 應用伺服器。

   只有應用伺服器概要在其他版本的 WebSphere Application Server V7 中提供。圖 1 顯示了 Network Deployment Profile Management 工具，其中有四種預定義的概要佈局（稱為環境）可供選擇。

   在執行遷移向導之前無需提供概要。但是，如果您計劃使用遷移命令列工具，則需要為您的環境建立概要。

   在為從以前版本進行遷移而建立概要時，某些特定的值在以前版本和新版本之間必須匹配。具體來說，在將部署管理器遷移到 V7 時，V7 概要的計算單元名稱值必須與 V5.1 或 V6 的計算單元名稱值匹配；在遷移到 V7 的聯合節點時，V7 概要的節點名稱必須與以前版本的聯合節點的節點名稱匹配，等等。對於不屬於計算單元的節點（例如獨立系統），V7 概要對其沒有此類命名要求。

   在所有情況下，如果新舊概要的節點和計算單元名稱之間存在有效的不匹配情況，則將使用新概要的值，並且遷移將更新 WebSphere Application Server 擁有的所有配置資訊以使用新概要名稱。

   如果您使用遷移向導或 z/OS 自定義作業來建立概要並進行遷移，則將為您自動填充這些值。

   對於 Network Deployment 遷移，概要必須按以下特定順序進行遷移：

   1. 部署管理器概要。在遷移計算單元時必須首先遷移此概要。V7 遷移的部署管理器概要可以管理計算單元中的所有 V5.1 和 V6 節點。WebSphere Application Server V7 將遷移的部署管理器限制為：讓其僅管理在遷移之前位於計算單元中的 V5.1 節點。具體來說，V5.1 節點不能聯合到 V7 部署管理器中——但可以將 V6.02 及更高版本的節點新增到 V7 部署管理器中。對於 V5.1 使用者，部署管理器概要類似於 WebSphere Application Server Network Deployment V5.1 和部署管理器安裝。每個計算單元必須正好具有一個部署管理器。

   2. 作業管理器概要。此概要是 V7 中的新增概要，沒有與以前版本類似的概要，因此不能將任何配置遷移到 V7 作業管理器概要中。

   3. 管理代理概要。此概要是 V7 中的新增概要，沒有與以前版本類似的概要，因此不能將任何配置遷移到 V7 管理代理概要中。

   4. 自定義概要。此概要非常適合於聯合節點遷移。沒有為此概要建立預設的應用程式或應用伺服器。以前版本的每個節點都可以正好遷移到一個自定義概要。這些節點將成為 V7 混合計算單元的成員，並且可以在任何時候遷移到 V7 節點。

   5. 應用伺服器概要。此概要類似於 V5 或 V6 中安裝的單個節點。此概要是使用名為 server1 的應用伺服器和若干預設應用程式建立的

      3. 執行遷移

      下面要執行的步驟取決於您選擇的遷移方法。可選的遷移方法有：

      1. 執行遷移向導或者
      2. 執行命令列工具。

      3a.執行遷移向導

      遷移向導是一種新的遷移方法，並針對 V7 進行了改進，它替代了作為 Application Server V5.1 安裝程式一部分的遷移皮膚。該遷移向導對 IBM i 或 z/OS 平臺不可用。可以在 FirstSteps 皮膚中找到遷移向導。要執行遷移向導，請執行下列步驟：

      1. 從概要目錄啟動 FirstSteps（如果存在），例如：C:\WebSphere\AppServer\profiles\default\。在 Windows® 上，您可以從概要目錄的 firststeps 資料夾或從 Start 選單啟動 FirstSteps。

      2. 在啟動 FirstSteps 之後，請選擇 Migration wizard 開始遷移過程（圖 2）。

         
         
         圖 2. Firststeps 皮膚
         
         
         

      3. 在顯示 Welcome 皮膚之後，從檢測到的版本列表中選擇需要遷移的 WebSphere Application Server 的以前版本（圖 3）。確保以前版本的位置正確非常重要，可以驗證 Installation root directory of the previous version 欄位中顯示的位置。如果嚮導沒有檢測到要遷移的以前版本，請在首先選中 Specify the installation location if your existing product is not listed 之後使用此欄位指定其位置。

         
         
         圖 3. WebSphere Application Server 檢測到的版本
         
         
         

      4. 選擇需要遷移的以前版本中的概要（圖 4）。對於 V5，通常遷移 defaultinstance；但是，如果您建立了多個例項，則可以選擇其他 V5 例項中的任何一個。對於 V6，您可以選擇要遷移的概要，但是請記住，部署管理器必須始終在聯合節點之前進行遷移。

         
         
         圖 4. 源概要選擇皮膚
         
         
         

      5. e. 如果您定義了一個或多個概要，例如，同一系統上的 V7 部署管理器和 V7 節點概要，則必須選擇要用作目標概要的概要（圖 5）。如果尚未建立 V7 概要，遷移向導可以為您建立一個（通過選擇 ）。

         
         
         圖 5. 目標概要選擇皮膚
         
         
         

      6. 如果想讓遷移向導建立一個概要，則會顯示如圖 6 所示的皮膚。遷移向導將在必填欄位中填入適當的值；例如，如果您要遷移部署管理器，則嚮導將從源 WebSphere Application Server 確定計算單元的名稱，等等。

         
         
         圖 6. 概要建立皮膚
         
         
         

      7. 遷移工具使用備份目錄將您以前版本的 WebSphere Application Server 遷移到 V7。請指定備份目錄的位置，如果尚不存在，則請指定應在何處建立它（圖 7）。

         
         
         圖 7. 遷移備份目錄皮膚
         
         
         

      8. 圖 8 和 9 顯示了應用程式遷移設定的皮膚。這些皮膚使 V7 遷移向導能夠使用 WASPostUpgrade 命令中的新引數。在這些皮膚中，您可以選擇是要遷移和安裝應用程式，還是要建立指令碼以便在以後遷移應用程式。您還可以選擇要安裝應用程式的位置。

         
         
         圖 8. 應用程式安裝遷移設定皮膚
         
         
         

      9. 在下一個皮膚中（圖 9），您可以更改應用程式的安裝位置。預設情況下，遷移過程會將應用程式安裝到 WebSphere Application Server V7 的配置目錄中。如果需要將應用程式安裝在 WebSphere 目錄樹結構外，則可以選中 Keep the same application directories as the previous version 選項。或者，您也可以輸入要安裝應用程式的新目錄或其他目錄。如果應用程式的安裝目錄對您並不重要，則請接受預設目錄。

         
         
         圖 9. 應用程式目錄遷移設定皮膚
         
         
         

      10. 預設情況下，V5 或 V6 部署管理器在遷移過程中是被禁用的，但是，如果必須啟用，則可以選擇 Do not disable the deployment manager of the previous version（圖 10）。這可讓您在遷移過程中使用以前版本的部署管理器。但是，這是一個不受支援的配置，因此一定要慎用此選項。停止和禁用以前的部署管理器是為了防止在相同的託管節點上執行多個部署管理器。如果沒有禁用以前的部署管理器，則在啟動新部署管理器之前，您需要禁用（不使用）以前的部署管理器。

          
          
          圖 10. 部署管理器禁用皮膚
          
          
          

      11. 指定要在埠值分配皮膚上使用的埠值（圖 11）。您可以選擇使用源安裝中的埠值（預設），在此情況下，將在遷移之前刪除 V7 WebContainer 埠，從而避免與任何向前遷移的 WebContainer 埠衝突。您還可以選擇用於在遷移過程中建立的所有埠的一組埠。

          
          
          圖 11. 埠值分配皮膚
          
          
          

      12. 管理控制檯自定義的 My Tasks 是 V6.1 中的新內容，因此僅在從 V6.1 遷移時才顯示圖 12 中所示的皮膚。您可以選擇使用預設的工作區使用者根位置，即 V6.1 概要 home 下的 wstemp，或者使用者指定的工作區根位置。

          
          
          圖 12. 管理控制檯自定義的“My tasks”皮膚
          
          
          

      13. 您需要在管理安全性皮膚中提供使用者名稱和密碼（圖 13）。當在以前版本中啟用了全域性安全並且 security.xml 不包含相應的使用者名稱和密碼值時，才會顯示此皮膚。當從 V6.1 遷移時通常會出現此問題。

          
          
          圖 13. 管理安全性皮膚
          
          
          

      14. 指示您是否要讓遷移支援如圖 14 所示的皮膚上的指令碼相容性。例如，如果您具有用於建立或修改配置定義的指令碼或程式，則請選中 Migrate to support script. compatibility。如果不選中此選項，則遷移工具將建立 V7 通道而非傳輸。有關 convertScriptCompatibility 命令的詳細資訊將在下一部分介紹。

          
          
          圖 14. 指令碼相容性皮膚
          
          
          

      15. 遷移摘要皮膚（圖 15）是執行任何命令之前顯示的最後一個皮膚。在此處可以確認您的選擇，或者返回前面的步驟進行任何必要的更改。

          
          
          圖 15. 遷移摘要皮膚
          
          
          

      16. 如果您選擇 ，則會看到與圖 16 類似的皮膚。只要概要的建立過程成功完成，就可以繼續執行遷移。如果在建立概要過程中出現問題，則嚮導將會終止。

          
          
          圖 16. 概要建立輸出皮膚
          
          
          

      17. 在遷移概要皮膚（或概要建立輸出皮膚）上選擇 Next 以執行遷移。這時將執行 WASPreUpgrade 命令，然後執行 WASPostUpgrade 命令。從本質上講，遷移過程是由這些命令執行的，這些命令將在下一部分中討論。

      18. 在完成 WASPreUpgrade 和 WASPostUpgrade 之後，將顯示遷移狀態皮膚（圖 17），其中提供遷移命令輸出的摘要狀態。

          
          
          圖 17. 遷移狀態皮膚
          
          
          

      3b.執行命令列工具

      可以手動使用 WASPreUpgrade 和 WASPostUpgrade 命令將以前版本的 WebSphere Application Server 遷移到 V7。遷移向導將作為自動遷移過程的一部分呼叫這些工具。這些命令應始終從 V7 概要目錄（而不是 V5.1 或 V6 目錄）中呼叫，原因是這些命令已隨每個版本進行了更改。還可以在 V7 概要的 bin 資料夾中找到這些命令，但是，如果您從此目錄中選擇使用這些命令，則需要指定命令應在哪個 V7 概要上執行。

      1. WASPreUpgrade

         WASPreUpgrade 命令將建立所有相關 V5 和 V6 WebSphere Application Server 配置資訊的備份。備份的內容特定於版本和配置設定。

         WASPreUpgrade 命令的語法是：

         WASPreUpgrade backupDirectory currentWebSphereDirectory [-traceString trace_spec] [-traceFile file_name] [-machineChange true | false] [-oldProfile old_profile_name] [-workspaceRoot user_workspace_folder]

         
         

         僅需要前兩個引數。可以對 V5.1 執行的程式碼示例為：

         C:\IBM\WebSphere\AppServer7\profiles\default\bin\WASPreUpgrade.bat C:\IBM\WebSphere\Backupv51Config C:\IBM\WebSphere\AppServer51

         
         

         如果成功執行，WASPreUpgrade 輸出的最後兩行將是：

         MIGR0303I: The existing WebSphere Application Server environment is saved. MIGR0420I: The first step of migration completed successfully.

         
         

         有關使用 WASPreUpgrade 命令的詳細資訊，請參閱 WebSphere Application Server V7 資訊中心，或者不帶任何引數執行 WASPreUpgrade 命令，以便顯示該命令的語法。要診斷遷移問題，請參見 WASPreUpgrade 日誌。

      2. WASPostUpgrade

         WASPostUpgrade 命令獲取由 WASPreUpgrade 建立的備份，並使用該備份將以前的配置移動到 V7。

         WASPostUpgrade 的語法是：

         WASPostUpgrade backupDirectory [-profileName profile_name] [-oldProfile profile_name] [-backupConfig true | false] [-username username ] [-password password ] [-traceString trace_spec [-traceFile file_name]] [-portBlock port_starting_number] [-replacePorts true | false] [-includeApps true | false | script] [-scriptCompatibility true | false] [ [-appInstallDirectory user_specified_directory] | [-keepAppDirectory true | false] ] [-keepDmgrEnabled true | false]

         
         

         只有第一個引數是必需的。可以執行的程式碼示例為：

         C:\IBM\WebSphere\AppServer7\profiles\default\bin\WASPostUpgrade.bat C:\IBM\WebSphere\Backupv51Config

         
         

         如果存在多個 V7 概要，則請使用 –profileName 引數指定應更新哪個概要。這在從 WebSphere Application Server 主目錄（而不是概要目錄）執行此命令時特別重要。（例如，從 C:\IBM\WebSphere\AppServer7\bin 而不是從 C:\IBM\WebSphere\AppServer7\profiles\default\bin 執行此命令。）如果從 WebSphere Application Server 主目錄執行此命令，並且沒有使用 –profileName 引數，則該命令將使用預設概要，而不一定是名稱為“default”的概要。

         WASPostUpgrade 命令可能以 warnings 結尾並且仍然成功執行，因此請檢視日誌檔案，瞭解為什麼出現警告，以及是否有必要執行其他操作。WASPostUpgrade 命令的最終輸出應為以下兩種情況：

         MIGR0259I: The migration has successfully completed.

         
         

         或者

         MIGR0271W: Migration completed successfully, with one or more warnings.

         
         

         WASPostUpgrade 工具在對 V7 環境執行任何更改之前先建立該環境的備份，並在出現諸如以下錯誤時將嘗試回滾任何更改：

         MIGR0272E: The migration function cannot complete the command.

         
         

         有關使用 WASPostUpgrade 命令的詳細資訊，請參閱 WebSphere Application Server V7 資訊中心，或者不帶任何引數執行 WASPostUpgrade 命令，以便顯示該命令的語法。要診斷遷移問題，請參見 WASPostUpgrade 日誌。

      3. convertScriptCompatibility

         convertScriptCompatibility 命令將 V7 配置從支援指令碼相容模式轉換為不支援指令碼相容模式。通過執行 WASPostUpgrade 並將 -scriptCompatibility 設定為 True，或者採用預設值將獲得指令碼相容模式。

         convertScriptCompatibility 的語法是：

         convertScriptCompatibility [-help] [-backupConfig true | false] [-profileName profile_name] [-nodeName node_name [-serverName server_name]] [-traceString trace_spec [-traceFile file_name]]

         
         

         不存在必需的引數。可以執行的程式碼示例為：

         C:\IBM\WebSphere\AppServer61\profiles\default\bin\convertScriptCompatibility.bat

         
         

         如果存在多個 V7 概要，則請使用 –profileName 引數指定應更新哪個概要。這在從 WebSphere Application Server 主目錄（而不是概要目錄）執行此命令時特別重要。（例如，從 C:\IBM\WebSphere\AppServer7\bin 而不是從 C:\IBM\WebSphere\AppServer7\profiles\default\bin 執行此命令。）如果從 WebSphere Application Server 主目錄執行此命令，並且沒有使用 –profileName 引數，則該命令將使用預設概要，而不一定是名稱為“default”的概要。

         在嘗試對聯合節點執行此轉換時應注意一些特殊事項。應對 dmgr 概要執行此命令，該概要指定需要使用 -nodeName 引數進行轉換的聯合節點。在執行 convertScriptCompatibility 之後，您需要手動與剛轉換的聯合節點進行同步，以便將這些更改下載到該節點。

         如果成功，convertScriptCompatibility 將以下列訊息結束：

         MIGR0259I: The migration has successfully completed.

         
         

         convertScriptCompatibility 工具在對 V7 環境執行任何更改之前先建立該環境的備份，並在出現諸如以下錯誤時將嘗試回滾任何更改：

         MIGR0272E: The migration function cannot complete the command.

         
         

         有關使用 convertScriptCompatibility 命令的詳細資訊，請參閱 WebSphere Application Server V7 資訊中心，或者執行指定 -help 的 convertScriptCompatibility 命令，以顯示該命令的語法。要診斷遷移問題，請參見 convertScriptCompatibility 日誌。

         4. 檢視日誌檔案

         無論是通過手動還是通過嚮導進行遷移，檢視日誌檔案來了解需要執行某種操作的任何錯誤或警告始終是一個好主意。預設情況下，在所有平臺（z/OS 除外）上均會生成跟蹤檔案，不過這些檔案僅在需要時供 IBM 支援人員使用。

         WASPreUpgrade 日誌

         在手動執行 WASPreUpgrade 命令時將建立以下日誌檔案：

         /logs/WASPreUpgrade..log<
         /logs/WASPreUpgrade.trace

         在通過遷移向導遷移時，將建立以下日誌檔案和跟蹤檔案：

         /logs/preMigrationOutput.log
         /logs/WASPreMigrationSummary.log

         WASPostUpgrade 日誌

         在手動執行 WASPostUpgrade 命令時將建立以下日誌檔案：

         /logs/WASPostUpgrade...log
         /logs/WASPostUpgrade..trace
         /logs/.log

         在通過遷移向導遷移時，將建立以下日誌檔案和跟蹤檔案：

         /logs/WASPostMigrationSummary.log
         /logs/.log

         convertScriptCompatibility 日誌

         在手動執行 convertScriptCompatibility 命令時將建立以下日誌檔案：

         /logs/convertScriptCompatibility..log
         /logs/ConvertScriptCompatibility

         差異和例外

         無論是手動還是使用嚮導執行遷移，您都會發現新舊配置之間存在一些差異——當您指定 –scriptCompatibilty false 選項（非預設值）或執行 convertScriptCompatibility 工具時，這種差異會更明顯。下面是一般注意事項：

         • 新埠和埠更改

           WebSphere Application Server 的新版本通常隨新服務一起推出，因此會提供一些新服務端點。這些服務端點可能與某個網路地址繫結，例如 IPC_INBOUND_CONNECTOR。這些新埠將被更新以確保它們不與遷移的配置衝突，但不會通過更新它們來解決同一物理硬體中多個概要的埠衝突。因此，您需要在建立概要過程中手動解決埠衝突問題，如果已使用遷移工具建立了概要，則在遷移之後手動解決衝突問題。

           另外，基於您設定埠解決方案的方式（WASPostUpgrade 工具中的 –portBlock 和 –replacePorts），您的一些埠值可能從以前配置中的值更改或者作為 V7 概要建立的一部分而建立。對於繫結埠的每臺伺服器，遷移元件在標有時間戳的 WASPostUpgrade 日誌檔案中記錄埠更新。有關如何定位此日誌的資訊，請參見前面的部分。摘要檢視的標準格式如下所示：

           MIGR0446I: Port conflicts were resolved during migration as shown below for document: C:/workarea/WebSphere/v7/profiles/profile/config/cells/cellName/ nodes/nodeName/servers/dmgr/server.xml Port Identifier Port Value --------------- ---------- dmgr@transport_9090 9090 dmgr@transport_9043 9043 MIGR0446I: Port conflicts were resolved during migration as shown below for document: C:/workarea/WebSphere/v7 /profiles/profile/config/cells/cellName/ nodes/nodeName/serverindex.xml Port Identifier Port Value --------------- ---------- dmgr@CSIV2_SSL_MUTUALAUTH_LISTENER_ADDRESS 9402 dmgr@SAS_SSL_SERVERAUTH_LISTENER_ADDRESS 9401 dmgr@WC_adminhost_secure 9044 dmgr@DRS_CLIENT_ADDRESS 7989 dmgr@DCS_UNICAST_ADDRESS 9352 dmgr@WC_adminhost 9060 dmgr@IPC_CONNECTOR_ADDRESS 9632 dmgr@DataPowerMgr_inbound_secure 5555 dmgr@CSIV2_SSL_SERVERAUTH_LISTENER_ADDRESS 9403 dmgr@CELL_DISCOVERY_ADDRESS 7277 dmgr@ORB_LISTENER_ADDRESS 9100 dmgr@BOOTSTRAP_ADDRESS 9809 dmgr@SOAP_CONNECTOR_ADDRESS 8879

           
           

         • 節點和計算單元名稱更改

           當從以前版本遷移時，如果在節點和計算單元名稱值之間存在不匹配，您應注意為什麼會發生此情況：對於部署管理器遷移，V7 部署管理器節點名稱將替換 V5.1 或 V6 節點名稱。對於獨立遷移，V7 節點和計算單元名稱將替換 V5.1 或 V6 的值。對於聯合節點遷移，V7 計算單元名稱將替換為 V7 部署管理器中的計算單元名稱，這意味著節點和計算單元名稱將始終與其在 V5.1 或 V6 配置中的值相同。

         • Cloudscape 轉換到 Derby

           在 WebSphere Application Server V7 之前，Cloudscape 支援被替換為 Derby。遷移工具將自動在配置中檢測 Cloudscape 資料庫，並將資料遷移到類似的 Derby 資料庫。由於不相容性，一些資料庫無法自動升級。在這些情況下，WASPostUpgrade 日誌將顯示未遷移資料庫的警告，您需要通過手動從配置中刪除 Derby 資料庫或手動將資料從 Cloudscape 轉換為 Derby 來解決此問題。

           由於 Cloudscape 資料庫在生產環境中不受支援，因此遷移 Cloudscape 資料庫失敗不會導致遷移工具失敗或終止。該遷移將繼續執行並儲存配置，即使未遷移資料庫也如此。

         • 應用程式無法安裝

           如果在遷移過程中未能安裝應用程式，則可能是該應用程式在 WebSphere Application Server V7 中不受支援，或者可能需要手動更新或遷移非 WebSphere 配置資訊。安裝應用程式失敗不會導致遷移失敗或終止。將向 WASPostUpgrade 摘要日誌和標有時間戳的日誌傳送一個訊息，詳細記錄遇到的錯誤。遷移工具還會保留遷移後的應用程式檔案和 wsadmin 安裝指令碼，以便您可以解決問題和手動呼叫指令碼來安裝該應用程式。

           遷移後的應用程式位於 V7 的 profile/installableApps 目錄中，安裝指令碼位於遷移備份目錄的根目錄中。

         有關 WebSphere Application Server 版本到版本遷移的完整資訊集，請參閱 知識集錦：WebSphere Application Server 遷移計劃。

來自 “ ITPUB部落格 ” ，連結：http://blog.itpub.net/14789789/viewspace-589258/，如需轉載，請註明出處，否則將追究法律責任。