部署一個主題 WAR 檔案到 IBM WebSphere Portal V6.1

簡介： 本文旨在顯示門戶管理員如何在 IBM® WebSphere® Portal V6.1 環境下建立和部署一個主題 WAR 檔案。附有一個樣例主題 WAR 檔案。

簡介

隨著 WebSphere Portal V6.1 的出現，許多管理功能已經改變。一個關鍵的變化涉及如何處理主題和皮膚。它們不再是檔案系統構件。現在它們可以作為一個 WAR 檔案匯出和匯入。此功能使得管理主題和皮膚、在不同版本之間遷移的任務有所不同。門戶管理員現在必須對建立 WAR 檔案很熟悉。本文采用逐步的方法來幫助有經驗的管理員理解如何利用這個新特性。

要使用這個新特性，需要滿足以下先決條件：

• 理解 IBM WebSphere Application Server 和 WebSphere Portal V6.1 目錄結構
• 理解 WebSphere Portal 管理控制檯的基本功能
• 理解基本作業系統命令

本文包括兩個樣例檔案，可在下載部分找到：

• sample_DeployYourTheme.xml 是 WebSphere Portal V6.1 中一個用於匯入和建立主題的樣例檔案。參考 “匯入主題” 小節，更進一步理解匯入主題的方式。
• MyTheme.war 是 WebSphere Portal V6.1 的一個樣例主題。參考 “建立一個主題 WAR 檔案” 小節，進一步理解如何建立 WAR 檔案。

部署主題 WAR 檔案的第一步是建立一個主題 WAR 檔案。這個建立過程是一個樣例過程。其中一個方法是建立一個目錄，並將其命名為 /home/MyTheme，接下來，向其中複製一個已存主題，這有一個有用的 UNIX® 命令可以處理這一任務：

cd /wps.war/themes/html/Portal
tar cf . - | (cd /home/MyTheme; tar xvfBp -)

這個命令遞迴檢查 /html/Portal 子檔案，並將每一項複製到 /home/MyTheme。

現在您可以進行改變，識別您的個性化主題。如果您想看看並感受一下您的定製主題，它看起來更像 web 2.0。那麼將源目標從 /Portal 改為 /Portal2。

在以下步驟列表中您可以省略步驟 14。

如果想要從頭開始建立您的主題，按照下列步驟操作：

1. 建立一個名為 MyTheme 的目錄。
2. 在 MyTheme 目錄下，建立兩個其他目錄，themes 和 WEB-INF：
   
   MyTheme/themes
   MyTheme/WEB-INF
3. 從初始主題位置複製 WebSphere Portal dojo 目錄及其內容，貼上到 MyTheme/theme 目錄：
   
   cp –r /wps.war/themes/dojo MyTheme/themes/
   MyTheme/themes/dojo/*
4. 在 themes 目錄下建立一個 HTML 目錄：
   
   MyTheme/themes/html
5. 複製初始 WebSphere Portal 主題的 psw 目錄到 HTML 目錄：
   
   cp –r /wps.war/themes/html/psw MyTheme/themes/html/
   MyTheme/themes/html/psw
6. 在 HTML 目錄下建立 MyTheme 目錄：
   
   MyTheme/themes/html/MyTheme
7. 將您的新主題插入到最新建立的 MyTheme 目錄。
   
   

   注意：
   

   • 如果此刻您沒有一個主題，複製初始 WebSphere Portal 主題到最新建立的 MyTheme 目錄：
     
     cp –r /wps.war/themes/html/Portal/* MyTheme/theme/html/MyTheme
   • 最好從初始 WebSphere Portal 主題啟動，並進行修改。

8. 在 MyTheme/WEB-INF 目錄下，建立檔案 web.xml： MyTheme/WEB-INF/web.xml
9. web.xml 必須包含清單 1 中顯示的資訊。
   
   
   
   清單 1. 樣例 web.xml
   

   MyTheme

   
   

   注意：如果程式碼是從 WebSphere Portal Information Center 複製的，確認您已經刪除了每行開頭部分的所有空格。如果空格未被刪除，在 WAR 檔案被安裝之後，WebSphere Application Server 確定 web.xml 檔案中出現錯誤。

10. 通過使用您的主題替換 MyTheme 變數來更新 web.xml 檔案。
11. 在 WEB-INF 目錄下建立 tld 目錄：
    
    MyTheme/WEB-INF/tld
12. 將所有 tld 檔案從初始 wps.war 檔案複製到最新建立的 tld 目錄：
    
    cp –r /wps.war/WEB-INF/tld* MyTheme/WEB-INF/tld
    
    MyTheme/WEB-INF/tld/portal-v6-core.tld
    MyTheme/WEB-INF/tld/portal-v6-dynamicui.tld
    MyTheme/WEB-INF/tld/portal-v6-fmt.tld
    MyTheme/WEB-INF/tld/portal-v6-logic.tld
    MyTheme/WEB-INF/tld/portal-v6-navigation.tld
    MyTheme/WEB-INF/tld/portal-v6-showtools.tld
    MyTheme/WEB-INF/tld/portal-v6-skin.tld
    MyTheme/WEB-INF/tld/portal-v6-theme-ext.tld
    MyTheme/WEB-INF/tld/portal-v601-web20.tld
13. 將您定製的 tld 檔案放在 MyTheme/WEB-INF/tld 目錄下。
14. 將 MThemey 目錄下的檔案壓縮成一個 ZIP 檔案，名為 MyTheme.zip，其中包含以下檔案：
    
    themes/html/MyTheme/*
    themes/html/psw/*
    themes/dojo/*
    WEB-INF/web.xml
    WEB-INF/tld/*
15. 將 MyTheme.zip 重新命名為 MyTheme.war。

部署主題 WAR 檔案的第二個步驟就是將主題 WAR 檔案部署到門戶伺服器。可通過以下步驟完成這項任務：

1. 開啟瀏覽器，設定 WebSphere Application Server 管理控制檯 URL：
   
   http://:/admin 例如：
   
   http://MyHostName.raleigh.ibm.com:10027/admin
2. 選擇 Applications - Install New Application，如圖 1 所示。
   
   
   
   圖 1. WebSphere Application Server 控制檯左導航皮膚
   
   
   
3. 在 “Preparing for the application installation” 視窗，選擇 Local 檔案系統，單擊 Browse 並瀏覽 MyTheme.war。在 Context 根欄位輸入 /MyTheme。單擊 Next。見圖 2。
   
   
   
   圖 2. 準備應用程式安裝
   
   
   
4. 在圖 2 所示的 Install New Application 視窗，選擇步驟 1：選擇安裝選項，然後在 Application Name 欄位刪除應用程式名中的 “_war”。預設檔名是 WAR 檔案的第一部分，並將 “_war” 附加在其後。單擊 Next。見圖 3。
   
   
   
   圖 3. 選擇安裝選項
   
   
   
5. 在 Install New Application 視窗，選擇步驟 2：對映模型到伺服器，在 Clusters 和 Servers 欄位選擇 WebSphere Portal 伺服器和門戶叢集（如果有叢集），並選擇 MyTheme 模式。單擊 Apply，然後單擊 Next。見圖 4。
   
   
   
   圖 4. 對映模式到伺服器
   
   
   
6. 選擇步驟 3 ：為 web 模型對映虛擬主機，選擇 web 模型，並在 Virtual 主機欄位選擇 default_host。單擊 Next。見圖 5。
   
   
   
   圖 5. 為 Web 模型對映虛擬主機
   
   
   
7. 在此視窗顯示步驟 4 ：摘要，確認顯示在安裝選項摘要中的所有資訊是正確的。單擊 Finish。見圖 6。
   
   
   
   圖 6. 摘要
   
   
   
8. 在圖 7 所示的安裝訊息視窗中，單擊 Save 連結，將這些選項儲存到主配置檔案。返回主 WebSphere Application Server 管理控制檯。
   
   
   
   圖 7. 安裝訊息
   
   
   
9. 在管理控制檯中，選擇 Applications - Enterprise Applications 開啟標題為 Enterprise Applications 的視窗，如圖 8 所示。
   
   
   
   圖 8. WebSphere Application Server 管理控制檯的左導航皮膚
   
   
   
10. 在圖 9 所示的 Enterprise Applications 視窗中，選擇緊挨著應用程式 MyTheme 的輸入框，單擊 Start。
    
    
    
    圖 9. Enterprise Applications
    
    
    

使用以下步驟將您的主題匯入 WebSphere Portal 伺服器，要想使這個過程變得簡單，一個方法是使用 XML 檔案。下面將演示此方法，首先建立一個 XML 檔案，我們已經包含了樣例程式碼，您可以用來做參考。見清單 2。

1. 建立一個名為 DeployYourTheme.xml 的檔案。
2. 輸入清單 2 中所示的程式碼。
   
   
   清單 2. 部署主題的樣例 XML 檔案
   

   <!-- Sample for deploying themes and skins in an XML script. Note that this created only the database entries; you still need to provide the rendering JSPs under the resource root directories specified in the XML. --&gt A skin with no skin <!-- There's only one skin that can be combined with this theme. --&gt

   
   
3. 修改 DeployYourTheme.xml 檔案，更改 MyTheme 以及您主題的名稱來使其和檔案的其餘部分保持一致。
4. 開啟一個瀏覽器併為 WebSphere Portal 設定 URL：
   
   http://:/wps/portal 例如：
   
   http://MyHostName.example.com:10040/wps/portal
5. 用一個管理 ID 登入 WebSphere Portal 網站，如圖 10 所示。
   
   
   
   圖 10. WebSphere Portal Login 螢幕
   
   
   
6. 在標題欄選擇 Administration 選項卡。如圖 11 所示。
   
   
   
   圖 11. WebSphere Portal Welcome 頁面
   
   
   
7. 選擇 Portal Settings - Import XML，如圖 12 所示。
   
   
   
   圖 12. WebSphere Portal Administration 選項卡
   
   
   
8. 單擊 Browse，找出檔案 DeployYourTheme.xml。
9. 單擊 Import。
10. 選擇 Portal User Interface - Themes and Skins，如圖 13 所示。
    
    
    
    圖 13. WebSphere Portal Themes and Skins 管理頁面
    
    
    
11. 在 Themes 部分，選擇 MyTheme 並單擊 Edit 按鈕。
12. 在圖中顯示的 All 皮膚部分，預設選擇 IBM – portal。見圖 14。
    
    
    
    圖 14. Themes and Skins 編輯頁面
    
    
    
13. 單擊將 IBM 皮膚移到視窗右面，主題的這部分標題為 Skins。
14. 在右選擇框選擇 IBM。
15. 預設選擇 Set，提示時單擊 OK。

您已經建立一個新主題，將其轉換成一個 WAR 檔案，將 WAR 匯入 WebSphere Application Server 並啟動 Enterprise Application（WAR 檔案）。啟動 Enterprise Application（ WAR 檔案）之後，就可以使用 XML 檔案將主題匯入 WebSphere Portal，然後啟用 WebSphere Portal 來使用最新新增的主題。以下步驟將指導您完成 WebSphere Portal 中主題的測試過程。

測試新主題的步驟是最簡單的。

1. 用一個管理 ID 登入 WebSphere Portal 網站，如圖 10 所示。
2. 在標題欄選擇 Administration 選項卡，如圖 11 所示。
3. 選擇 Portal User Interface - Manage Pages，如圖 15 所示。
   
   
   
   圖 15. WebSphere Portal Administration Manage Pages 視窗
   
   
   
4. 在顯示視窗中，選擇 Content Root。
5. 在顯示視窗中, 單擊 New Page，如圖 16 所示。
   
   
   
   圖 16. 選擇 Content Root 之後出現 Manage Pages 視窗
   
   
   
6. 如圖 17 所示，在 Page Properties 中，完成以下步驟：
   
   • 在 Title 欄位，輸入 NewPage。
   • 在 Theme 欄位，從下拉選單選擇 MyTheme。
   
   
   圖 17. 最新建立頁面的 Page Properties 視窗
   
   
   
7. 單擊 OK。頁面建立之後，您要返回到 Administrative 選項卡的 Manage Pages 頁面。見圖 18。
   
   
   
   圖 18. WebSphere Portal Administrative 選項卡 – Manage Pages
   
   
   
8. 在標題欄選擇 More。
9. 在圖 19 中，您可以看到 NewPage 的 Page Menu，選項 New Page。
   
   
   
   圖 19. 選擇 More 之後的 WebSphere Portal 頁面
   
   
   

圖 20 顯示您剛才建立的最新頁面（NewPage），使用新主題（MyTheme）。

圖 20. 顯示 NewPage 視窗的 WebSphere Portal

在本文中，我們介紹了在 WebSphere Portal V6.1 中建立、部署、安裝和使用一個主題（作為 WAR 檔案）的必要步驟。在以下參考網站，我們也提供了 WebSphere Portal Server Information Center 中這部分的連結，討論主題和皮膚的效能指南。對於想要建立並設計主題和皮膚的人來說是 “必讀” 的。

我們感謝 Shannon Pixley 給我們提供 web.xml 檔案，感謝 Morgan Johnsonfor 為我們提供主題樣例。

原文連結：http://www.ibm.com/developerworks/cn/websphere/library/techarticles/1006_fitzgerald/1006_fitzgerald.html

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