WebSphere Application Server 上配置 Rational Publishing Engine 文件產生的負載平衡

學習如何在叢集環境中配置 Rational® Publishing Engine 應用程式。

開始之前

如需 WebSphere® Application Server 負載平衡運作方式的一般相關資訊,請參閱 WebSphere Application Server 8.0 資訊中心裡的簡介:叢集建立叢集主題。

關於這項作業

1:檢閱 WebSphere 拓蹼

如果要設定叢集環境,首先,請建立一個分散式 IBM WebSphere Application Server Network Deployment 拓蹼。請設定下列主機:

關於這項作業

下表顯示設定叢集環境時的角色:
表 1. 主機名稱
機器 角色 主機
Machine1 部署管理程式、Node1 dm.example.org
Machine2 Node2 和 Node3 nodes.example.org
Machine3 IBM HTTP Server (IHS) 和 IBM Web 伺服器外掛程式 ihs.example.org
Machine4 MCSERVER mcserver.example.org
Machine5 儲存體位置 storage.example.org
Machine6 RPE 用戶端 rpeclient.example.org
註:
  • dm.example.org:這部伺服器管理 IBM WebSphere Application Server Network Deployment 8.0.0.5 版 64 位元的安裝架構(其中含有「部署管理程式」和「節點代理程式」)。
  • nodes.example.org:這部伺服器管理 IBM WebSphere Application Server Network Deployment 8.0.0.5 版 64 位元的安裝架構(其中含有「節點代理程式」)。
  • ihs.example.org:這部伺服器管理 IBM WebSphere Application Server Network Deployment 8.0.0.5 版 64 位元的安裝架構(其中含有「節點代理程式」)和 IBM HTTP Server 8.0.0.5 版 64 位元的安裝架構(其中含有 WebSphere IHS 外掛程式 8.0.0.5 版)。
  • mcserver.example.org:這部伺服器管理 IBM WebSphere Application Server Network Deployment 8.0.0.5 版 64 位元的安裝架構(其中會部署「Rational Publishing Engine 遠端服務」)。
  • storage.example.org:這部伺服器用來儲存輸出檔。建立共用位置 \\storage\rpe\files,它必須使用一個網域帳戶,該帳戶有權存取正在執行 MCSERVER 的使用者以及正在執行 WAS 實例的所有節點。
    註: 所有文件產生節點和 MCSERVER 必須使用相同的檔案儲存位置。執行 WebSphere Application Server 的使用者帳戶必須具備這個檔案儲存位置的存取權。
  • rpeclient.example.org:這部機器當作 Rational Publishing Engine 用戶端,用來產生文件。
負載平衡環境的拓蹼圖

2:完成部署叢集環境的必要條件

您必須符合若干必要條件,才能使用 WebSphere Application Server Network Deployment 來部署叢集環境。

程序

3:安裝

3.1:安裝部署管理程式和節點

安裝 WebSphere Application Server Network Development 第 8 版,並升級至 Fix Pack 5。

開始之前

請確定已安裝 IBM Installation Manager 1.7.1 版。

程序

  1. Passport Advantage® 下載 WebSphere Application Server Network Deployment 第 8 版。
  2. 將下載的檔案解壓縮至您磁碟機上的位置。 範例:C:\was\software\was80nd
  3. http://www.ibm.com 下載 WebSphere Application Server Fix Pack 5。
  4. 將下載的檔案解壓縮至您磁碟機上的位置。 範例:C:\was\software\was80nd\8.0.0-WS-WAS-FP0000005
  5. 啟動 Installation Manager,並按一下檔案 > 喜好設定
  6. 按一下新增儲存庫,然後將 WebSphere Application Server Fix Pack repository.config 檔新增至清單。範例:C:\was\software\was80nd\8.0.0-WS-WAS-FP0000005\repository.config
  7. 按一下確定,然後按一下安裝
  8. 選取 IBM WebSphere Application Server Network Deployment8.0.0.5 版勾選框。按下一步
  9. 閱讀並接受授權合約中的條款。按下一步
  10. 選取建立新的套件群組,並選取安裝目錄。按下一步
  11. 選擇性的: 選取要安裝的語言,然後按下一步
  12. 確定已選取下列要安裝之特性的勾選框:
    • EJB 3.0 之前模組的 EJBDeploy 工具
    • 獨立式小型用戶端、資源配接器和可內嵌的儲存器
    • 獨立式小型用戶端和資源配接器
    • 可內嵌的 EJB 儲存器
    • 適用於 Java™ 第 6 版的 IBM 64 位元 SDK
  13. 在「摘要」頁面中,檢閱摘要資訊,然後按一下安裝
  14. 安裝完成之後,在您想啟動哪一個程式區段中,選取,以防在安裝完成時建立設定檔。按一下完成

3.1.1:建立部署管理程式設定檔

建立部署管理程式設定檔 dm.example.org,並指派使用者名稱及密碼,來啟用管理安全。
程序
  1. 按一下 IBM WebSphere > IBM WebSphere Application Server Network Deployment 8.0 版 > 工具 > 設定檔管理工具,來啟動「設定檔管理工具」。
  2. 按一下建立
  3. 在「環境選擇」畫面中,選取 Cell(部署管理程式及聯合應用程式伺服器)作為設定檔類型,然後按下一步
  4. 選取建立進階設定檔,然後按下一步
  5. 確定已選取部署管理主控台(建議),然後按下一步
  6. 請勿變更預設設定檔名稱和設定檔目錄,但記下它們供稍後使用。按下一步
  7. 確定主機名稱正確。主機名稱用來指定部署管理程式的位址。對於節點名稱和 Cell 名稱,請選擇有意義又好記的名稱。會在配置中使用這些名稱。按下一步
  8. 請務必選取啟用管理安全勾選框,並輸入 admin,同時作為使用者名稱與密碼。您可以在稍後設定廣域安全時變更使用者名稱和密碼。按下一步
  9. 在「安全憑證(第 1 部分)」頁面中,選取預設選項,並按下一步
  10. 在「安全憑證(第 2 部分)」頁面中,更新預設金鑰儲存庫密碼,並按下一步
  11. 在「埠值指派」頁面中,仔細記下預設埠。如果您基於任何原因而必須變更預設埠(例如:SOAP 埠或 HTTP 安全埠),請務必記下埠號。按下一步
  12. 在「Web 伺服器定義」頁面中,不要選取任何選項。按下一步
  13. 在「設定檔建立摘要」頁面中,檢閱配置,然後按一下建立
  14. 當安裝完成時,請清除啟動「首要步驟」主控台勾選框,然後按一下完成
結果
您已建立部署管理程式設定檔。

3.1.2:建立 Node1、Node2 和 Node3 的設定檔

dm.example.org 主機中建立 Node1 的設定檔。然後在 nodes.example.org 中,針對 Node2 和 Node3 重複這些步驟。
程序
  1. 按一下 IBM WebSphere > IBM WebSphere Application Server Network Deployment 8.0 版 > 工具 > 設定檔管理工具,來啟動「設定檔管理工具」。
  2. 按一下建立
  3. 在「環境選擇」畫面中,選取 自訂設定檔作為設定檔類型,然後按下一步
  4. 選取建立進階設定檔,然後按下一步
  5. 輸入 Custom01 作為設定檔名稱,然後按下一步
  6. 在「節點和主機名稱」頁面上,確定主機名稱正確。按下一步
  7. 確定主機名稱正確。主機名稱用來指定部署管理程式的位址。按下一步
  8. 指定您在建立部署管理程式設定檔時,所指定的部署管理程式的主機名稱、SOAP 埠號、使用者名稱與密碼。如果您打算之後要聯合節點,請選取稍後聯合這個節點勾選框。按下一步
  9. 在「安全憑證(第 1 部分)」頁面中,選取預設選項。按下一步
  10. 在「安全憑證(第 2 部分)」頁面中,更新預設金鑰儲存庫密碼,並按下一步
  11. 在「埠值指派」頁面中,仔細記下預設埠。如果您基於任何原因而必須變更預設埠(例如:SOAP 埠或 HTTP 安全埠),請務必記下埠號。按下一步
  12. 在「設定檔建立摘要」頁面中,檢閱配置,然後按一下建立
  13. 安裝完成時,請按一下完成
  14. nodes.example.org 中,針對 Node2 重複這些步驟。
  15. nodes.example.org 中,針對 Node3 重複這些步驟。

3.1.3:聯合 Node2 和 Node3

先後針對 Node2 和 Node3 完成這些步驟。
開始之前
建立 Node2 和 Node3 的設定檔。
程序
  1. 在指令行公用程式中,導覽至 Node2 的 bin 目錄。範例:C:\Program Files (x86)\IBM\WebSphere\AppServer\profiles\Custom02\bin
  2. 執行下列指令:addNode.bat <Deployment Manager IP Address> <Port>
  3. 等待指令完成和顯示已順利聯合節點訊息。
  4. 針對 Node3 重複這些步驟。

3.2:安裝 WebSphere Application Server 的 IBM HTTP Server 和 Web 伺服器外掛程式

對於您的叢集環境,您可以安裝 IBM HTTP Server 或 IBM WebSphere Proxy Server 的實例,並放在 ihsproxy.example.org 上管理,來充當 Proxy 伺服器。以下指示是安裝 WebSphere Application Server 8.0.0.5 版的 IBM HTTP Server 8.0.0.5 版和 Web 伺服器外掛程式,來充當 Proxy。

開始之前

請確定已安裝 IBM Installation Manager 1.7.1 版。

程序

  1. Passport Advantage 下載 WebSphere Application Server Network Deployment Supplements 第 8 版。
  2. 將下載的檔案解壓縮至您磁碟機上的位置: 範例:C:\was\software\was80ndSupp
  3. 啟動 Installation Manager,並按一下檔案 > 喜好設定
  4. 按一下新增儲存庫,然後將下列 repository.config 檔新增至清單:C:\was\software\was80ndSupp\repository.config
  5. 按一下確定,然後按一下安裝
  6. 選取 WebSphere Application ServerIBM HTTP Server 和 IBM WebSphere Application Server 套件的 IBM Web 伺服器外掛程式來安裝。按一下檢查其他版本、修正程式和延伸,並確定已選取 8.0.0.5 版或更新的版本。按下一步
  7. 閱讀並接受授權合約中的條款。按下一步
  8. 選取建立新的套件群組,並選取安裝目錄。記下安裝目錄供稍後使用。按下一步
  9. 確定已選取下列要安裝之特性的勾選框:
    • 含有 Java 第 6 版的 IBM HTTP Server 64 位元
    • 適用於 Java 第 6 版的 IBM 64 位元執行時期環境
  10. 接受預設 HTTP 埠 80。稍後您將在埠 443 上設定安全虛擬主機。按下一步
  11. 在「摘要」頁面中,檢閱摘要資訊,然後按一下安裝
  12. 安裝完成之後,按一下完成

3.3:建立和配置叢集

建立 IBM WebSphere Application Server 叢集。

開始之前

您必須設定伺服器和 Proxy 伺服器。

程序

  1. 開啟瀏覽器視窗,並移至 Integrated Solutions Console (https://dm.example.org:port/ibm/console),其中 dm.example.org 是管理部署管理程式之伺服器的主機名稱,port 是管理主控台安全埠。
  2. 登入時請使用您在建立部署管理程式設定檔時所建立的使用者名稱與密碼。
  3. 按一下伺服器 > 叢集 > WebSphere Application Server 叢集。然後按一下新建
  4. 輸入叢集的名稱,例如 RPE Cluster,並清除偏好本端勾選框。按下一步
  5. 在下一頁中,建立叢集的第一個成員,且該成員以應用程式伺服器為基礎。
    1. 成員名稱欄位中輸入名稱,例如 RPEWS1
    2. 選取節點欄位中,從下拉清單中選取 Node1
    3. 針對加權,選取 2
    4. 下一步
  6. 選擇性的: 在下一頁,您可以新增成員。如果您選擇之後再新增成員,請遵循 4.3.2 小節的指示。如果您選擇現在新增成員,請輸入 RPE WS2 作為成員名稱,並在「選取節點」下拉清單中,選取 Node2。然後按一下新增成員
  7. 檢閱「摘要」,然後按一下完成
  8. 按一下直接儲存到主要配置
  9. 選取叢集,並按一下啟動。綠色箭頭表示叢集已啟動。當您將應用程式伺服器轉換成叢集之後,原始應用程式伺服器上已安裝的應用程式的目標會轉換成以叢集為目標。
  10. 如果要檢查此轉換,請開啟預設應用程式的「管理模組」區段:
    • 按一下應用程式 > 應用程式類型 > WebSphere 企業應用程式,並按一下 DefaultApplication
    • 在「模組」區段中,按一下管理模組
    • 請確定 RPE Cluster 已列在「伺服器」直欄中。

3.3.1:新增叢集成員

建立節點叢集之後,您可以新增叢集成員。
程序
  1. 開啟瀏覽器視窗,並移至 Integrated Solutions Console (https://dm.example.org:port/ibm/console),其中 dm.example.org 是管理部署管理程式之伺服器的主機名稱,port 是管理主控台安全埠。
  2. 登入時請使用您在建立部署管理程式設定檔時所建立的使用者名稱與密碼。
  3. 按一下伺服器 > 叢集 > Websphere Application Server 叢集,然後按一下您建立的叢集名稱。
  4. 其他內容區段中,按一下叢集成員
  5. 在「叢集成員」頁面中,按一下新建
  6. 成員名稱欄位中,輸入成員的名稱。 範例:RPEWS2
  7. 針對個別的節點,選取您所建立的節點叢集。
  8. 按一下新增成員
  9. 下一步,然後按一下完成
  10. 確定 Rational Publishing Engine 成員已列在伺服器 > 伺服器類型 > WebSphere Application Server 頁面中。
  11. 選取節點的勾選框,然後按一下啟動
  12. 按一下直接儲存到主要配置
  13. 移至位於 https://proxy_host/snoop 的探查頁面,以測試新增的成員節點。 探查頁面會列出 Web 應用程式的多種相關資訊,例如伺服器名稱與埠。

4:與節點同步變更

開始之前

啟動所有的節點。

程序

  1. 開啟瀏覽器視窗,並移至 Integrated Solutions Console (https://dm.example.org:port/ibm/console),其中 dm.example.org 是管理部署管理程式之伺服器的主機名稱,port 是管理主控台安全埠。
  2. 登入時請使用您在建立部署管理程式設定檔時所建立的使用者名稱與密碼。
  3. 依序按下系統管理 > 儲存主儲存庫的變更
  4. 在儲存頁面中,選取與節點同步變更勾選框。
  5. 按一下儲存

5:將「遠端服務」應用程式部署在部署管理程式上

開始之前

在「部署管理程式」中,新增叢集和相關聯的成員。

程序

  1. 開啟瀏覽器視窗,並移至 Integrated Solutions Console (https://dm.example.org:port/ibm/console),其中 dm.example.org 是管理部署管理程式之伺服器的主機名稱,port 是管理主控台安全埠。
  2. 登入時請使用您在建立部署管理程式設定檔時所建立的使用者名稱與密碼。
  3. 部署「遠端服務」應用程式。請參閱手動將「遠端服務」應用程式部署在 WebSphere Application Server 上,以取得詳細資料。
    註: 在您部署「遠端服務」應用程式時(這是上述資訊中心主題中關於「將模組對映至伺服器」視窗的步驟 8),請在叢集和節點選項中,選取您按照 3.3:建立和配置叢集的說明來建立的叢集,然後繼續進行正常部署。

6:將「遠端服務」應用程式部署在 MCSERVER 主機上

程序

部署「遠端服務」應用程式。請參閱手動將「遠端服務」應用程式部署在 WebSphere Application Server 上,以取得詳細資料。

7:在 Java 虛擬機器 (JVM) 自訂內容中定義旗標

開始之前

將「遠端服務」應用程式安裝在部署管理程式和 MCSERVER 機器上。

程序

  1. 開啟瀏覽器視窗,並移至 Integrated Solutions Console (https://dm.example.org:port/ibm/console),其中 dm.example.org 是管理部署管理程式之伺服器的主機名稱,port 是管理主控台安全埠。
  2. 登入時請使用您在建立部署管理程式設定檔時所建立的使用者名稱與密碼。
  3. 展開伺服器 > 伺服器類型
  4. 按一下 WebSphere Application Server。會列出成員與相關聯的節點和叢集。
  5. 按一下伺服器名稱(例如 RPEWS1),來開啟 member1 的伺服器內容。
  6. 在「伺服器基礎架構」區段中,展開 Java 和程序管理
  7. 按一下程序定義
  8. 其他內容區段中,按一下 Java 虛擬機器
  9. 按一下新建,新增每一個編碼旗標:
    1. 管理單一 MC 實例之「遠端服務」節點 (MCSERVER) 的設定:
      • com.ibm.rational.rpe.remote.filestore=\\storage\rpe\files
    2. 使用單獨 MC 實例之「遠端服務」節點 (MCCLIENT) 的設定:
      • com.ibm.rational.rpe.remote.filestore=\\storage\rpe\files
      • com.ibm.rational.rpews.url=http://<mcserver IP address>:<port>/rpews/monitor
      • -Dcom.ibm.rational.rpews.usr=user
      • -Dcom.ibm.rational.rpews.pwd=password
      • com.ibm.rational.rpe.remote.debug=true
      • com.ibm.ws.classloader.encodeResourceURLs=false
      註: 在所有節點(Node1、Node2、Node3)中定義這些旗標。所有文件產生節點和 MCSERVER 必須使用相同的檔案儲存位置。執行 WebSphere Application Server 的使用者帳戶必須具備這個檔案儲存位置的存取權。
  10. 按一下確定
  11. 重新啟動「遠端服務」應用程式。

範例

註: 如果建立於相同 WebSphere Application Server 實例之下的節點會共用相同的 Derby 資料庫,請在每一個節點中設定以下的 Java 執行時期環境旗標,讓該節點建立個別的資料庫實例。如果沒有在 WebSphere Application Server 中定義這些旗標,當存取遠端服務的「監視和控制」的 URL 時,有可能會發生 500 錯誤。

some node A: com.ibm.rational.rpe.monitor.dbconnectionurl=jdbc:derby:rpe_monitor1;create=true

some other node: com.ibm.rational.rpe.monitor.dbconnectionurl=jdbc:derby:rpe_monitor2;create=true

8:配置 IBM HTTP Server

開始之前

請確定 IBM HTTP Server 已安裝在 ihs.example.orghost 中。此外,請確定含有「節點代理程式」的 IBM WebSphere Application Server Network Deployment 8.0.0.5 版 64 位元已安裝在 ihs.example.orghost 中,且節點已聯合至部署管理程式。
  • 完成 4.1 小節,以安裝 WebSphere Application Server Network Deployment。
  • 完成 4.1.2 小節,以建立設定檔。
  • 完成 4.1.4 小節,以便將節點聯合至部署管理程式。

程序

  1. 開啟瀏覽器視窗,並移至 Integrated Solutions Console (https://dm.example.org:port/ibm/console),其中 dm.example.org 是管理部署管理程式之伺服器的主機名稱,port 是管理主控台安全埠。
  2. 登入時請使用您在建立部署管理程式設定檔時所建立的使用者名稱與密碼。
  3. 按一下伺服器 > 伺服器類型 > Web 伺服器
  4. 按一下新建
  5. 輸入伺服器名稱,例如 webserver1
  6. ihs.example.orghost 選取要聯合的節點,並選取 IBM HTTP Server 作為類型。
  7. 下一步
  8. 選取 Web 伺服器範本 IHS。按下一步
  9. 指向對應的 IHS 和外掛程式安裝位置路徑。按下一步
  10. 確認新的 Web 伺服器。
  11. 按一下完成

9:配置 IHS WebSphere 外掛程式

開始之前

請確定已配置 IBM HTTP Server。

程序

  1. 在指令行公用程式中,導覽至 WebSphere 外掛程式的 bin 目錄。範例:C:\IBM\WebSphere\Plugins\bin
  2. 執行下列指令:ConfigureIHSPlugin.bat -plugin.home <pluginInstallRoot> -plugin.config.xml <PluginConfigFile> -ihs.conf <httpdConfFile>

    範例:ConfigureIHSPlugin.bat -plugin.home C:\IBM\WebSphere\Plugins -plugin.config.xml C:\IBM\WebSphere\Plugins\config\webserver1\plugin-cfg.xml -ihs.conf C:\IBM\HTTPServer\conf\httpd.conf

  3. 在順利完成指令之後,請透過 IHS 存取 WebSphere Application Server 預設應用程式,作法是檢查位於 https://<ihs host IP address> /snoop 的探查頁面,來測試新增的成員節點。

範例

只要使用者部署或修改 installedApps,您都必須透過管理主控台重新產生外掛程式,而這會修改 plugin-cfg.xml
  1. 登入 https://dm.example.org:port/ibm/console
  2. 按一下伺服器 > 伺服器類型 > Web 伺服器
  3. 選取 Web 伺服器,並按一下產生外掛程式

有時在重新產生之後,plugin-cfg.xml 檔並不會更新到外掛程式位置中。如果 plugin-cfg.xml 檔沒有更新,請手動將 plugin-cfg.xml 檔從產生的位置複製到 WebSphere Application Server 外掛程式目錄位置中。

dm.example.org 中的部署管理程式位置

<WAS_HOME>\profiles\Dmgr01\config\cells\<DMGR_NODE>\nodes\<IHS_Node>\servers\<Web server name>

ihs.example.org 中的 WebSphere Application Server Web 伺服器位置

<WAS_HOME>\plugins\config\<webserver>

範例:

plugin-cfg.xml 檔從 C:\Program Files (x86)\IBM\WebSphere\AppServer\profiles\Dmgr01\config\cells\cldegddeCell01\nodes\cldegddmNode01\servers\webserver1 目錄複製到 C:\IBM\WebSphere\Plugins\config\webserver1 目錄。

請確定產生的 plugin-cfg.xml 檔含有 UriGroupVirtualHostGroup NameServer Name 等之類的項目。若有項目遺漏,請手動複製和貼上它們。

plugin-cfg.xml 範例:遠端服務的 URI 群組:

<Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid" Name="/rpews/*"/>

<PrimaryServers>
	<Server Name="cldegddeNode02_RPEWS1"/>
	<Server Name="cldegddfNode02_RPEWS2"/>
	<Server Name="cldegddfNode03_RPEWS3"/>
</PrimaryServers>

10:測試負載平衡

開始之前

  1. 請確定所有節點的「遠端服務」應用程式已順利啟動且正在執行。
  2. 請確定 MCSERVER 已啟動且正在執行。
  3. 用來儲存輸出檔的共用位置是供正在執行 MCSERVER 的使用者和執行 WebSphere Application Server 實例的所有節點共用。
  4. 準備一些 Rational Publishing Engine 用戶端。例如:14 個 .dsx 檔。每一個用戶端都指向 IHS URL。範例:http://<ihs machine IP address>/rpews/docgen

程序

使用批次檔來同時啟動所有的 Rational Publishing Engine 用戶端。

結果

我們可以看到現在要求已達到負載平衡。當 14 項要求均命中伺服器時,有 7 項要求開始產生文件,其餘的要求則在佇列中。在這項測試中,所有的節點(Node1、Node2 和 Node3)皆已啟動且正在執行。

11:疑難排解叢集拓蹼的問題

如果您遇到 SRVE0255E,請使用這些步驟來更正問題。

關於這項作業

SRVE0255E: 未定義用來處理 /rpews 的 Web 群組/虛擬主機。

SRVE0255E 錯誤指出未定義用來處理 /{ApplicationContext}/admin 的 Web 群組/虛擬主機。當 WC_defaulthost_secure 伺服器的埠號未登錄在虛擬主機清單時,就會發生這個錯誤。

程序

如果要疑難排解這個問題,請執行下列動作:

  1. 在管理主控台中,按一下環境 > 虛擬主機
  2. 按一下預設主機。在「其他內容」區段中,按一下主機別名
  3. 按一下新建。將 WC_defaulthost_secure 伺服器的主機名稱和埠號新增至清單。按一下確定
  4. 按一下直接儲存到主要配置並重新啟動 WebSphere Application Server 節點。

結果

現在,您已完成負載平衡的配置。

下一步

配置列在 http://server:port/rpews/ 頁面上的遠端服務。 請參閱遠端服務 URL,以取得每個 URL 的使用方式及每個特性的配置作業的說明。

意見