將 Server Community Edition 應用程式方便地遷移到 WebSphere Application Server

alphaWorks 提供的新工具可以幫助您將現有的 J2EE™ V1.4 應用程式從基於 Apache Geronimo 的 IBM® WebSphere® Application Server Community Edition V2.0.x 遷移到 IBM WebSphere Application Server V6.1。

引言

遷移為 IBM WebSphere Application Server Community Edition 編寫的應用程式，並使該應用程式像在 IBM WebSphere Application Server V6.1 上執行的那樣需要一系列步驟，其中一些步驟是自動的，還有一些步驟是手動的。IBM 的新增 Migration Assistant for WebSphere Application Server Community Edition 工具是為執行自動化步驟和幫助減少所需的手動工作而建立的。本文將簡要概述此新的遷移工具（在 alphaWorks 中提供），以幫助輕鬆地遷移到 WebSphere Application Server。

本文並不探索在使用該工具時可能遇到的任何具體問題，但是本文將提供一些總體指南，以幫助您使用和解釋所得到的結果。

截至到撰寫本文時為止，Migration Assistant for WebSphere Application Server Community Edition（以下稱為 Migration Assistant）支援將開發的應用程式遷移到 WebSphere Application Server Community Edition V2.0.x 的 J2EE 1.4 規範。遷移應用程式目前支援的目標環境是 WebSphere Application Server V6.1（未安裝任何功能包）。在本文中，對 WebSphere Application Server 的所有參考特別適合於版本 6.1.x。

端到端的遷移概述

Migration Assistant 可通過以下方法簡化應用程式從 WebSphere Application Server Community Edition（以下稱為 Community Edition）到 WebSphere Application Server 的遷移：

• 生成應用程式的標準和特定於 Geronimo 的部署描述符的 WebSphere Application Server 等效項。
• 基於標準的內容和特定於 Geronimo 的部署描述符生成準確指定需要執行哪些其他工作（對未遷移的內容）才能完成遷移的動態輸出。

下面從較高層次概述了使用 Migration Assistant 執行遷移時涉及的步驟：

1. 執行 Migration Assistant 命令列實用工具（wasma.bat 或 wasma.sh），並作為輸入傳入應用程式和任何外部引用的、特定於 Geronimo 的部署計劃。此操作的結果是建立以下兩項可交付內容：
   • 一個幾乎與 WebSphere Application Server 相容的 EAR 或 WAR 檔案：正如前面提到的，Migration Assistant 不會自動遷移所有內容（最簡單的 EAR 或 WAR 除外），因此在大多數情況下，仍需要執行其他步驟才能完成遷移；因此這裡使用了“幾乎”。
   • 特定於應用程式環境的動態文件 (.html)：每個應用程式都會產生自己的不同輸出，該輸出僅包含完成該應用程式遷移所需的操作項。Migration Assistant 生成的輸出是根據 J2EE 定義的角色構造的；為開發人員（適用於應用程式元件提供人員和應用程式組裝人員角色）提供的步驟與為部署人員（適用於部署人員和系統管理員角色）提供的步驟各不相同。
2. 應用程式元件提供人員或應用程式組裝人員將檢視為任何操作項生成的文件的開發人員部分。解析所有開發人員的操作項後，應用程式將與 WebSphere Application Server 相容。此時，可以將應用程式和生成的文件傳送到部署人員或系統管理員來執行其他遷移工作。
3. 部署人員或系統管理員將解析開發人員部分列出的任何操作項。儘管開發人員操作項將特定於應用程式（如繫結其他庫和重新包裝外部資源介面卡），部署人員部分中的操作項將特定於 WebSphere Application Server V6.1 環境（如建立資料來源和將資源引用繫結到物理資源）。
4. 將應用程式安裝到 WebSphere Application Server 環境，並開始測試。

安裝和執行工具

1. 從 alphaWorks 下載 Migration Assistant。通過將下載的 .zip 檔案解壓縮到選擇的目錄來安裝工具。此目錄稱為 WASMA_HOME。

2. 遷移工具使用一些 WebSphere Application Server 二進位制檔案（JAR 檔案）分析您的應用程式 EAR 和 WAR 檔案，並建立用於在 WebSphere Application Server 上部署的 EAR 和 WAR 檔案。您必須在系統上安裝 WebSphere Application Server，並且必須將 WAS_INSTALL_ROOT 環境變數在您的系統上正確地設定為 WebSphere Application Server 根目錄。

   
   
   圖 1. 執行 Migration Assistant 之前的初始安裝
   
   
   

3. Migration Assistant 是分析 EAR 或 WAR 檔案的命令列工具。圖 2 顯示了由用法訊息提供的 wasma 命令語法。

   
   
   圖 2. WASMA 命令列語法
   
   
   

   該工具可生成兩個輸出：

   • 用於在 WebSphere Application Server 上部署的 EAR 或 WAR 檔案。
   • HTML 報告檔案，該檔案描述了讓 EAR 或 WAR 檔案在 WebSphere Application Server 上成功執行需要執行的任何其他工作。

   向 Migration Assistant 的主要輸入是需要遷移的 EAR 或 WAR 檔案。對於在 Community Edition 上部署 EAR 或 WAR，還可以指定可選的外部部署計劃；它會覆蓋 EAR 或 WAR 檔案中任何特定於 Geronimo 的部署計劃。預設情況下，Migration Assistant 將其輸出放入包含輸入 EAR 或 WAR 檔案的目錄。您可以使用 -o 和 -a 標誌將輸出放在更方便的位置。WASMA crack 可開啟 tmp-dir 的輸入存檔，如果需要，您可以使用 -t 指定它。

   
   
   圖 3. 呼叫 WASMA
   
   
   

   在圖 3 的示例中，wasma 命令在基於 J2EE 1.4 的 PlantsByWebSphere.ear 示例應用程式上執行。命令列控制檯輸出相當簡單。其中的遷移狀態訊息簡要地指示需要多少工作，後跟提供輸出報告 HTML 檔案位置的訊息。在本呼叫中採用了預設值，因此，圖 4 所示的輸出檔案所在的目錄與輸入檔案相同。在瀏覽器中開啟 .html 檔案。

   
   
   圖 4. WASMA 生成的輸出
    
   
   

檢視輸出報告

圖 5 顯示了生成的 .html 報告檔案的頂部，它與瀏覽器中顯示的一樣。Input 部分顯示了該工具用來生成此報告的輸入引數。它提供輸入和輸出存檔的位置、可選的外部部署計劃（如果提供）和日誌檔案的位置。通常，您不需要參考日誌檔案。如果您的工具存在問題，則需要檢視此檔案進行除錯。

Status 部分提供遷移結果的簡要總結。存在以下三種可能性：

• 成功，不需要任何其他工作。
• 成功，但需要更多的工作。（這是本示例中的狀態。）
• 失敗。

Deployment Plans 部分列出了 Migration Assistant 在遷移輸入存檔時處理的部署計劃。

圖 5. 工具輸出：Overview 部分

報告的其餘部分列出了使輸出存檔在 WebSphere Application Server 中成功執行需要的其他手動配置的項。正如前面描述的，按照角色將這些項分組為以下部分：面向開發人員的 Application Component Provider/Application Assembler 部分和麵向部署人員的 Deployer/System Administrator 部分。Section Summary and Links 就像一個目錄，它提供所需的工作概要和指向下面報告中每個部分的連結。

圖 6 顯示了從所生成輸出的 Developer 部分提取的示例項。此處的操作項是將應用程式部署到 WebSphere Application Server 環境之前需要對它執行的步驟。您預期可以在本部分下發現的一些操作包括：

• 使用 EAR 重新包裝外部引用的 Web 模組。
• 生成特定於 WebSphere Application Server 的 EJB 到 DB 對映。
• 根據需要，使用 EAR 訪問任何依賴項和包。

圖 6. 工具輸出：Developer 部分

圖 7 包含所生成輸出的 Deployer 部分的示例項。此處的操作項是在安裝遷移應用程式之前需要在 WebSphere Application Server 環境中執行的步驟。您預期可以在本部分中發現的一些操作包括：

• 繫結資源引用。
• 建立物理資源（如資料來源）。
• 設定安全和繫結安全形色。

圖 7. 工具輸出：Deployer 部分
 

進一步瞭解

現在讓我們瞭解一下報告中的某些個別項。

將為需要手動干預的每個元素的例項生成日誌記錄，生成順序是 Migration Assistant 在遷移存檔時遇到元素的順序。在輸出報告中，每個元素列出一次，並提供一個表，記錄每個例項的值或在存檔中發現此元素的次數。元素按部分分組，該部分與通常負責執行工作的人員角色（開發人員或部署人員）相關。根據手動遷移元素所需的工作多少，元素大致按降序顯示。

圖 8 顯示了突出顯示的 Message 部分的項。這是每個元素的日誌檔案中的訊息文字，簡要描述了 Migration Assistant 遇到的問題元素。訊息的變數資料用於元素的每個例項或每次出現，標識修復問題所需的精確資源和其他資料。每個變數都標有名稱、以粗體顯示，並用 {} 號括上。

圖 8. 工具輸出：Message 部分

圖 9 顯示了突出顯示的 Values 部分中的項。本部分在一個表中列出了每條訊息或元素例項的變數資料。變數名稱位於列標題中，以粗體顯示，並匹配 Message 部分中的名稱。

圖 9. 工具輸出：Values 部分

圖 10 顯示了突出顯示的 Explanation 部分中的項。本部分提供了此元素要解決的問題的較完整的描述。

圖 10. 工具輸出：Explanation 部分

圖 11 顯示了突出顯示的 User Action 部分中的項。本部分描述瞭如何解決此問題，一般提供一個指向 WebSphere Application Server V6.1 資訊中心的連結，連結內容提供瞭解決問題的完整資訊和具體步驟。

圖 10. 工具輸出：User Action 部分
 

結束語

IBM 的 Migration Assistant for WebSphere Application Server Community Edition 可以幫助減小將簡單的 J2EE 1.4 應用程式從 WebSphere Application Server Community Edition V2.0.x 遷移到 WebSphere Application Server V6.1 所需的大量手動工作。對於更復雜的應用程式（如使用 EJB V2.1 或依賴於伺服器獨特功能和資源的那些應用程式），該工具將生成開發人員和部署人員進行手動遷移步驟所需的文件，對每個顯示的角色都提供要遷移的部署構件，並提供詳細的解釋和使用者操作以及指向 WebSphere Application Server V6.1 資訊中心的上下文相關的連結。

Migration Assistant 工具在不斷改進。如果在使用此工具時，提示您建立所需的遷移功能列表，請一定將意見和建議釋出到本文或與此工具相關的論壇。

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