將 Web 應用程式部署在 WebSphere Application Server

您可以將 Rational® Publishing Engine Web 應用程式部署在使用 IBM® DB2®WebSphere® Application Server 8.x 版或更新版本上。

開始之前

部署 Web 應用程式之前,您必須先安裝 WebSphere Application Server 8.x 版或更新版本,以及具有「RPE 遠端服務」特性的 Rational Publishing Engine
您必須能夠存取 RPE_HOME\remote-services 目錄中的下列 Web 應用程式檔案:
  • com.ibm.rpe.web.app.ear(或 rpeng.wardgaas.war 檔)
記住: com.ibm.rpe.web.app.ear 企業應用程式是由下列兩個 Web 應用程式組成的軟體組:rpeng.wardgaas.war。您的部署選項可以是下列之一:
  • 部署單一 com.ibm.rpe.web.app.ear 企業應用程式
  • rpeng.wardgaas.war Web 應用程式部署在一起
部署實務和範例說明如何部署單一 com.ibm.rpe.web.app.ear 企業應用程式。

程序

  1. 設定廣域安全
  2. 設定 JVM
  3. 設定階段作業管理
  4. 設定環境變數
  5. 重新啟動伺服器
  6. 將 Web 應用程式部署在伺服器上
  7. dgaas 應用程式建立共用程式庫
  8. WebSphere Application Server 上配置 Web 應用程式的使用者
  9. 將共用程式庫與應用程式產生關聯
  10. 配置授權變數

WebSphere Application Server 上設定廣域安全

程序

  1. 啟動 WebSphere Application Server
  2. 在瀏覽器中開啟管理主控台:https://server:port/ibm/console

    例如:https://localhost:9043/ibm/console

  3. 展開安全,並按一下廣域安全
  4. 在「應用程式安全」區段中,驗證已選取啟用應用程式安全勾選框。
  5. 在 Java™ 2 安全區段中,清除所有選項。 如果已選取授與自訂許可權給應用程式時發出警告選項且無法編輯,請執行下列動作:
    1. 選取使用 Java 2 安全來限制應用程式存取本端資源選項。 如此即會啟用授與自訂許可權給應用程式時發出警告
    2. 清除授與自訂許可權給應用程式時發出警告選項。
    3. 清除使用 Java 2 安全來限制應用程式存取本端資源選項。
  6. 按一下套用
  7. 按一下儲存,將變更直接儲存到主要配置。

結果

這是 WebSphere Application Server 廣域安全頁面的畫面擷取

設定 JVM

關於這項作業

在您應用程式伺服器的自訂內容中,定義下列 Java 虛擬機器 (JVM) 設定:
  • com.ibm.websphere.jaxrs.server.DisableIBMJAXRSEngine=true
  • org.eclipse.emf.common.util.URI.archiveSchemes=wsjar wszip jar zip

程序

  1. 在瀏覽器中開啟管理主控台:https://server:port/ibm/console

    例如:https://localhost:9043/ibm/console

  2. 展開伺服器 > 伺服器類型,並按一下 WebSphere 應用程式伺服器
  3. 在「應用程式伺服器」區段中,按一下您的伺服器鏈結,例如 server1
  4. 在「配置」標籤中的伺服器基礎架構區段之下,展開 Java 和程序管理,並按一下程序定義鏈結。
  5. 在「其他內容」區段之下,按一下 Java 虛擬機器鏈結。
  6. 在「其他內容」區段之下,按一下自訂內容鏈結。
  7. 在「自訂內容」表格中,按一下新建
  8. 在「一般內容」區段之下,針對每一個項目指定下列值,並按一下確定
    表 1. WebSphere Application Server 自訂 JVM 內容
    名稱 說明
    com.ibm.websphere.jaxrs.server.DisableIBMJAXRSEngine true 停用 IBM JAXRS
    org.eclipse.emf.common.util.URI.archiveSchemes wsjar wszip jar zip  
  9. 按一下儲存,將變更直接儲存到主要配置。

結果

這是 WebSphere Application Server 管理主控台中之「自訂內容」頁面的畫面擷取

設定階段作業管理

關於這項作業

在應用程式伺服器的自訂內容中,定義下列「階段作業管理」設定:
  • InvalidateOnUnauthorizedSessionRequestException=true

程序

  1. 在瀏覽器中開啟管理主控台:https://server:port/ibm/console

    例如:https://localhost:9043/ibm/console

  2. 展開伺服器 > 伺服器類型,並按一下 WebSphere 應用程式伺服器
  3. 在「應用程式伺服器」區段中,按一下您的伺服器鏈結,例如 server1
  4. 在「配置」標籤中的儲存器設定區段之下, 按一下階段作業管理鏈結。
  5. 在「其他內容」區段之下,按一下自訂內容鏈結。
  6. 在「自訂內容」表格中,按一下新建
  7. 在「一般內容」區段之下指定下列值,並按一下確定
    表 2. WebSphere Application Server 的「階段作業管理」自訂內容
    名稱 說明
    InvalidateOnUnauthorizedSessionRequestException true 對於未獲授權的要求,階段作業管理程式的回應是使階段作業失效,而不是發出 UnauthorizedSessionRequestException 錯誤訊息。
  8. 按一下儲存,將變更直接儲存到主要配置。

結果

這是 WebSphere Application Server 管理主控台中之「階段作業管理內容」頁面的畫面擷取

設定環境變數

程序

  1. 在瀏覽器中開啟管理主控台:https://server:port/ibm/console

    例如:https://localhost:9043/ibm/console

  2. 展開伺服器 > 伺服器類型,並按一下 WebSphere 應用程式伺服器
  3. 在「應用程式伺服器」區段中,按一下您的伺服器鏈結,例如 server1
  4. 在「配置」標籤中的伺服器基礎架構區段之下,展開 Java 和程序管理,並按一下程序定義鏈結。
  5. 在「配置」標籤中的其他內容區段之下,按一下環境項目鏈結。
  6. 在「環境項目」表格中,按一下新建
  7. 在「一般內容」區段之下,針對每一個項目指定下列值,並按一下確定
    表 3. WebSphere Application Server 環境變數內容
    名稱 說明
    DGAAS_URL http://<server IP>:<port>/dgaas/ 文件產生服務環境變數
    VCAP_SERVICES {"sqldb": [{}]} 當您使用 DB2 作為資料庫時,必須設定這個環境變數。
    這是 WebSphere Application Server 管理主控台中之「環境項目」頁面的畫面擷取。
  8. 按一下儲存,將變更直接儲存到主要配置。

重新啟動 WebSphere Application Server

關於這項作業

重新啟動您想部署 Web 應用程式(com.ibm.rpe.web.app.ear, 或是 rpeng.wardgaas.war 檔)的 WebSphere Application Server 設定檔:

程序

  1. 停止 WebSphere Application Server
  2. 啟動 WebSphere Application Server

將 Web 應用程式部署在 WebSphere Application Server

開始之前

  • Rational Publishing EngineDB2 中建立資料庫
  • 建立 rpeng 資料來源,且 JNDI 名稱是:RPENG_DB
  • 建立 DGAAS 資料來源,且名稱是:DGAAS_DB
如需詳細資料,請參閱將 WebSphere Application Server 配置成以 DB2 作為資料來源

程序

  1. 在瀏覽器中開啟管理主控台:https://server:port/ibm/console

    例如:https://localhost:9043/ibm/console

  2. 展開應用程式,然後按一下新建應用程式
  3. 按一下新建企業應用程式
  4. 在「準備安裝應用程式」視窗中,指定 com.ibm.rpe.web.app.ear 在本端或遠端檔案系統上的路徑:
    • 如果您是使用本端檔案,請選取本端檔案系統
    • 如果您是使用遠端檔案,請選取遠端檔案系統
    輸入或按一下瀏覽,以指定 com.ibm.rpe.web.app.ear 檔的路徑。依預設,這個保存檔位於 RPE_HOME\remote-services\com.ibm.rpe.web.app.ear
  5. 下一步
  6. 選取捷徑 - 僅於需要其他資訊時提示,然後按下一步
  7. 在「選取這些安裝選項」頁面中,接受預設值,並按下一步
    這是 WebSphere Application Server 管理主控台中之「選取這些安裝選項」頁面的畫面擷取
  8. 在「將模組對映至伺服器」頁面中,選取 Rational Publishing EngineDGaaS 模組,然後按下一步
  9. 在「將資源參照對映至資源」頁面中,您必須指定 Rational Publishing EngineDGaaS 模組的資料來源。
    提示: 如果要繼續進行這個步驟,您必須完成將 WebSphere Application Server 配置成以 DB2 作為資料來源主題中的步驟。
    1. 對於 Rational Publishing Engine 模組項目, 請在目標資源 JNDI 名稱直欄中,按一下瀏覽
      這是 WebSphere Application Server 管理主控台中之「將資源參照對映至資源」頁面的畫面擷取。
    2. 在「新建應用程式」頁面中,選取 JNDI 名稱設為 RPENG_DBrpeng 選項。
      這是 WebSphere Application Server 管理主控台之「新建應用程式」頁面的畫面擷取。
    3. 按一下套用
    4. DGaaS 模組項目重複類似的步驟, 並在目標資源 JNDI 名稱直欄中,按一下瀏覽
    5. 在「新建應用程式」頁面中,選取 JNDI 名稱設為 DGAAS_DBDGAAS 選項。
    6. 按一下套用
    7. 下一步
    這是 WebSphere Application Server 管理主控台中之「將資源參照對映至資源」頁面的畫面擷取。
  10. 在「對映 Web 模組的虛擬主機」頁面中,選取 Rational Publishing EngineDGaaS,然後按下一步
  11. 檢閱「摘要」,然後按一下完成
    這是 WebSphere Application Server 管理主控台中之「摘要」頁面的畫面擷取。
  12. 為了確認 Web 應用程式已順利部署在伺服器上,請搜尋顯示在程序日誌中的下列輸出訊息:
    com.ibm.rpe.web.app 應用程式已順利安裝。
  13. 按一下儲存,將變更直接儲存到主要配置。
    這是 WebSphere Application Server 管理主控台中之「程序日誌」頁面的畫面擷取。
  14. 展開應用程式 > 應用程式類型,並按一下 WebSphere 企業應用程式 會以您輸入的應用程式名稱,列出您新增的 com.ibm.rpe.web.app 應用程式。
  15. 在「名稱」直欄中,按一下 com.ibm.rpe.web.app 鏈結。
    這是 WebSphere Application Server 管理主控台中之「企業應用程式」頁面的畫面擷取。
  16. 在「詳細內容」區段中,按一下類別載入和更新偵測鏈結。
  17. 在「類別載入器順序」區段中, 選取載入類別時,先使用本端類別載入器(母項最後),並按一下確定
    這是 WebSphere Application Server 管理主控台中之「類別載入器」頁面的畫面擷取。
  18. 驗證 com.ibm.rpe.web.app 應用程式的環境定義根目錄:
    1. 在「Web 模組內容」區段之下,按一下 Web 模組的環境定義根目錄
    2. 驗證指定給 Web 模組的環境定義根目錄符合下列值,然後按一下確定
      表 4. 驗證 com.ibm.rpe.web.app 應用程式的環境定義根目錄
      Web 模組 URI 環境定義根目錄
      Rational Publishing Engine com.ibm.rpe.web.ui.war, WEB-INF/web.xml rpeng
      DGaaS com.ibm.rpe.web.service.docgen.war, WEB-INF/web.xml dgaas
      這是 WebSphere Application Server 管理主控台中之「環境定義根目錄」頁面的畫面擷取
    3. 在「配置」標籤中,按一下確定
  19. 按一下儲存,將變更直接儲存到主要配置。
  20. 啟動伺服器上的 Web 應用程式:
    1. 選取 com.ibm.rpe.web.app 勾選框,然後按一下啟動
    2. 如果 Web 應用程式順利在伺服器上啟動,會顯示下列訊息:
      位於伺服器 server_name 和節點 node_name 上的 com.ibm.rpe.web.app 應用程式順利啟動。可能需要重新整理集合,以顯示現行狀態。
      這是 WebSphere Application Server 管理主控台之「企業應用程式」頁面的畫面擷取。

WebSphere Application Server 上配置 Web 應用程式的使用者

關於這項作業

如果要完成這項作業,您必須完成在 WebSphere Application Server 上配置 Web 應用程式的使用者中的步驟

dgaas 應用程式建立共用程式庫

程序

  1. 移至「共用程式庫」頁面
  2. 在主控台導覽樹狀結構中,按一下環境 > 共用程式庫
  3. 選取共用程式庫範圍。變更集合表格的範圍,查看特定 Cell、節點或伺服器中有哪些共用程式庫。選取節點伺服器選項。
    「共用程式庫範圍」頁面
  4. 按一下新建
  5. 指定名稱,例如 dgaas.ear
  6. 指定下列 HTTP .jar 檔的類別路徑:
    <WAS_HOME>\profiles\AppSrv01\installedApps\<cell Name>\com.ibm.rpe.web.app.ear\dgaas.war\WEB-INF\lib\org.apache.httpcomponents.httpclient_<version>.jar
    <WAS_HOME>\profiles\AppSrv01\installedApps\<cell Name>\com.ibm.rpe.web.app.ear\dgaas.war\WEB-INF\lib\org.apache.httpcomponents.httpcore_<version>.jar
  7. 選取在這個共用程式庫中使用隔離的類別載入器類別載入選項,並按一下確定
    其中顯示儲存器層面之共用程式庫的「共用程式庫」頁面
  8. 按一下儲存來更新您對主要配置的變更。

下一步

提示:Rational Publishing Engine 2.0.1 版開始,您不再需要建立其他共用程式庫 rpe.lib 來使用授權。 產品現在會自動執行這個作業。

使共用程式庫與應用程式相關聯

程序

  1. 按一下應用程式 > 應用程式類型 > WebSphere 企業應用程式 > com.ibm.rpe.web.app > 共用程式庫參照,以存取「共用程式庫參照」頁面。
    rpe.lib 的「共用程式庫」頁面
  2. 在「共用程式庫參照」頁面中,選取要與共用程式庫相關聯的應用程式,就本例來說,是 com.ibm.rpe.web.app
  3. 按一下參照共用程式庫
    「共用程式庫參照」頁面
  4. 在「共用程式庫對映」頁面中,選取應用程式或模組所用的 dgaas.ear 共用程式庫。
  5. 按一下 >>, 將程式庫從可用清單移至選取清單。
    「共用程式庫對映」頁面
  6. 在「共用程式庫參照」頁面中,按一下確定
  7. 將變更儲存到主要配置。

配置授權變數

程序

  1. 驗證 TELELOGIC_LICENSE_FILE 環境變數。
  2. 重新啟動 WebSphere Application Server

結果

您可以在瀏覽器中開啟下列 URL,來確認 Web 應用程式已部署:http://server:port/rpeng/
提示: 您可能在 Web 瀏覽器中遇到下列錯誤訊息:
錯誤 500: com.ibm.websphere.servlet.session.UnauthorizedSessionRequestException:
    SESN0008E: 以匿名身分接受鑑別的使用者嘗試存取 user:defaultWIMFileBasedRealm/uid=rpe_designer,o=defaultWIMFileBasedRealm 擁有的階段作業。
如果要解決這則錯誤訊息, 請驗證您已在 WebSphere Application Server 的自訂內容中, 將 InvalidateOnUnauthorizedSessionRequestException 階段作業管理內容設為 true。如需詳細資料, 請參閱這個主題中的設定階段作業管理一節。

您可以在登入時提供適當使用者的使用者名稱與密碼, 例如 rpe_adminrpe_designerrpe_user, 並按一下登入

這是 Web 應用程式登入畫面的畫面擷取。

下列 Rational Publishing Engine Web 應用程式應該會顯示在您的瀏覽器中:

Web 應用程式首頁

您可以在瀏覽器中輸入 http://server:port/dgaas/debug,驗證文件產生服務的狀態。

Web 應用程式首頁

下一步

您可以選擇性地部署和執行 Newskeeper 範例應用程式, 這個範例應用程式使用文件產生服務技術來產生文件,並提供用於文件產生服務資產和文件的儲存介面。如需詳細資料,請參閱執行 Newskeeper 範例

配置 Rational Publishing Engine Web 應用程式(該 Web 應用程式列在 http://server:port/rpeng/ 頁面中)。請參閱 Web 應用程式 URL,以取得每個 URL 的使用方式及每個特性的配置作業的說明。