將「文件建置器」部署在 WebSphere Application Server

您可以將「Rational® Publishing Engine 文件建置器」部署在使用 IBM® DB2® 或 Oracle 的 WebSphere® Application Server 8.x 版或更新版本上。

開始之前

部署「文件建置器」之前,您必須先安裝 WebSphere Application Server 8.x 版或更新版本,以及具有「RPE 文件建置器」特性的 Rational Publishing Engine
您必須能夠存取 RPE_HOME\document-builder 目錄中的下列「文件建置器」檔案:
  • 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. 若為 DB2:WebSphere Application Server 配置成以 DB2 作為資料來源
  7. 若為 Oracle:WebSphere Application Server 配置成以 Oracle 作為資料來源
  8. 將「文件建置器」部署在伺服器上
  9. dgaas 應用程式建立共用程式庫
  10. WebSphere Application Server 上的「文件建置器」配置使用者
  11. 將共用程式庫與應用程式產生關聯
  12. 配置授權變數

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 或 Oracle 作為資料庫時,必須設定這個環境變數。
    這是 WebSphere Application Server 管理主控台中之「環境項目」頁面的畫面擷取。
  8. 按一下儲存,將變更直接儲存到主要配置。

重新啟動 WebSphere Application Server

關於這項作業

重新啟動您想部署「文件建置器」(com.ibm.rpe.web.app.ear,或是 rpeng.wardgaas.war 檔)的 WebSphere Application Server 設定檔:

程序

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

WebSphere Application Server 配置成以 DB2 作為資料來源

您必須在 WebSphere Application Server 上設定 DB2 資料庫,並配置與「文件建置器」之間的連線

開始之前

您必須為「Rational Publishing Engine 文件建置器」,建立 IBM DB2 資料庫。資料庫必須有 16K 分頁和 UTF-8 字碼集。例如,如果要建立一個稱為 rpedb2,並且使用 16K 分頁和 UTF-8 字碼集的資料庫,請使用下列指令:
db2 CREATE DATABASE rpedb1 AUTOMATIC STORAGE Yes USING CODESET UTF-8
    TERRITORY US COLLATE USING SYSTEM PAGESIZE 16384;
在本例中,資料庫的名稱是 rpedb1。如需建立資料庫的相關資訊,請參閱 DB2 產品說明文件

建立 JDBC 提供者

程序

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

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

  3. 選取資源 > JDBC > JDBC 提供者
  4. 將範圍設為 Cell。
    Cell
  5. 按一下新建
  6. 在「建立新 JDBC 提供者」精靈中,選取:
    1. 資料庫類型:DB2
    2. 提供者類型:DB2 Universal JDBC Driver 提供者
    3. 實作類型:XA 資料來源
    4. 實作類型:輸入名稱,例如 RPE
    建立新的 JDBC 提供者精靈
  7. 下一步
  8. 在「輸入資料庫類別路徑資訊」區段中,輸入類別路徑。以您 DB2 .jar 檔所在的目錄,取代 DB2UNIVERSAL_JDBC_DRIVER_PATH
    <DB2UNIVERSAL_JDBC_DRIVER_PATH>/db2jcc.jar
    <DB2UNIVERSAL_JDBC_DRIVER_PATH>/db2jcc_license_cu.jar
    <DB2UNIVERSAL_JDBC_DRIVER_PATH>/db2jcc_license_cisuz.jar
  9. 輸入儲存為 WebSphere 變數 ${DB2UNIVERSAL_JDBC_DRIVER_PATH} 的 "db2jcc.jar, db2jcc_license_cisuz.jar" 目錄位置,例如 C:\Program Files\IBM\SQLLIB\java
  10. 輸入原生程式庫路徑,例如 C:\Program Files\IBM\SQLLIB\java
  11. 按一下套用
    輸入資料庫類別路徑資訊
  12. 確定原生程式庫路徑正確,並按下一步
    原生程式庫路徑
  13. 檢閱摘要頁面,並按一下完成
    原生程式庫路徑
  14. 將變更儲存到主要配置。

rpeng 應用程式建立資料來源

程序

  1. 移至您剛才建立的 JDBC 提供者。
    1. 按一下資料來源
      資料來源鏈結
    2. 資料來源名稱欄位中,輸入 rpeng
    3. JNDI 名稱欄位中,輸入 RPENG_DB,然後按下一步
      輸入基本資料來源資訊
  2. 輸入資料來源的資料庫特定內容,並按下一步
    1. 將「驅動程式類型」值設為 4
    2. 資料庫名稱欄位中,輸入資料庫名稱。
    3. 伺服器名稱欄位中,輸入正在執行 DB2 的機器的主機名稱。
    4. 埠號欄位中,輸入您 DB2 資料庫的埠號。
      輸入資料來源的資料庫特定內容
  3. 在「設定安全別名」區段中,按下一步
  4. 檢閱摘要頁面,並按一下完成
    資料來源摘要
  5. 將變更儲存到主要配置。

建立 dgaas 應用程式的資料來源

程序

重複為 rpeng 應用程式建立資料來源中的步驟,並將資料來源名稱設為 DGAAS,將 JNDI 名稱設為 DGAAS_DB
輸入基本資料來源資訊

建立鑑別資料項目

程序

  1. 移至 RPE JDBC 提供者,並按一下資料來源
  2. 在「資料來源」頁面上,按一下 rpeng 資料來源。
  3. 在「相關項目」區段中,按一下 JAAS-J2C 鑑別資料
  4. 按一下新建
  5. 輸入您資料庫的鑑別詳細資料:
    • 若為 DB2:輸入 DB2 別名、使用者 ID 與密碼,並按一下確定
      新建鑑別資料
    • 若為 Oracle:輸入 Oracle 別名、使用者 ID 和密碼,然後按一下確定
      新的鑑別資料
  6. 將變更儲存到主要配置。
  7. 回到 rpeng 資料來源。
  8. 在「安全設定」中,針對下列選項選取 rpedb1 資料庫:
    1. XA 回復用的鑑別別名
    2. 元件管理的鑑別別名
    3. 儲存器管理的鑑別別名
    安全設定
  9. 按一下確定,並儲存。
  10. 再次移至 rpeng 資料來源,並按一下測試連線,測試資料來源。
    測試連線成功
  11. 針對 dgaas 資料來源,重複步驟 7-10。

WebSphere Application Server 配置成以 Oracle 作為資料來源

您必須在 WebSphere Application Server 上設定 Oracle 資料庫,並配置與「文件建置器」之間的連線

開始之前

  • 若要建立及設定 Oracle 資料庫,正在準備資料庫的使用者必須具備資料庫的資料庫管理權限,且資料庫、表格空間儲存體,以及適當的儲存體配置,都是由具備系統管理權限的使用者所建立。
  • 視您使用的 Oracle 版本而定,必要的「Java 資料庫連線功能 (JDBC)」驅動程式是 ojdbc7.jar
  • 如果要產生支援的資料庫版本和 JDBC 驅動程式清單,請參閱d JDBC drivers, see http://www.ibm.com/software/reports/compatibility/clarity/softwareReqsForProduct.html
  • 這個主題所用的配置參數和表格空間選項是範例,不一定完全適用於您的環境。比方說,如果您無法使用 AUTOEXTEND 設定,檔案必須夠大,才能容許繼續成長。 或者,如果您無法將 UNLIMITED 大小配額用於您的資料庫使用者,請務必酌留足夠的空間來應付快速的成長。
  • 您針對「文件建置器」應用程式所建立的資料庫必須格式化為使用 UTF-8 作為字集。依預設,Oracle 不會建立使用 UTF-8 字集的資料庫。 當您建立新的資料庫時,請務必在 Oracle DB 設定中選取 AL32UTF8

建立資料庫和表格空間

程序

  1. 作為系統管理者,請為「文件建置器」建立一個資料庫,例如,使用 UTF-8 編碼的 rpedb
    1. 啟動「資料庫配置助理」精靈,並在「歡迎使用」頁面中,按下一步
    2. 在「作業」頁面中,選取建立資料庫,然後按下一步
    3. 在「範本」頁面中,選取自訂資料庫,然後按下一步
    4. 廣域資料庫名稱SID 欄位中,輸入內容儲存資料庫的名稱;例如,CLMDB。按下一步
    5. 如果要配置資料庫控制,請輸入警示通知的必要資訊,並選擇性地啟用每日磁碟備份排程。如果要在沒有資料庫控制配置的情況下繼續作業,請清除配置企業管理程式旁的勾選框,然後按下一步
    6. 在「資料庫認證」頁面中,選擇一個適用於您的使用者帳戶的選項,然後按下一步
      註: Oracle 密碼複雜度原則要求密碼長度至少有 8 個字元。此外,密碼必須包含至少一個大寫字元、一個小寫字元,以及一個數字。
    7. 在下一頁中,選取資料庫檔案的儲存類型和位置。按下一步
    8. 在下一頁中,選擇資料庫的回復選項,然後按下一步
    9. 在下一頁中,指定是否新增「範例綱目」至您的資料庫中。按下一步
    10. 在下一頁中,按一下「字集」標籤,然後選取使用 Unicode (AL32UTF8)。按下一步
      註: 將字集設為 Unicode (AL32UTF8) 可讓您儲存多個語言群組。
    11. 在「資料庫儲存區」頁面中,驗證或變更資料庫物件,然後按下一步
    12. 在下一頁中,按一下完成來建立資料庫。
    13. 在開啟的「確認」視窗中,選擇性地將頁面儲存成 HTML 檔,然後按一下確定 此時會出現進度列,顯示資料庫的建立進度。
  2. 開啟 SQL *Plus 視窗,以 SYSTEMSYSDBA 身分登入。
  3. 導覽至 [OracleInstallDir]/dbhome_1/bin,例如 /u01/app/oracle/product/12.1.0/dbhome_1/bin ,並輸入下列指令, 其中 password 是您的密碼:
    ./sqlplus sys/[password]@RPEDB as sysdba
    登入 Oracle
  4. Rational Publishing Engine 建立表格空間

    如果要為 Rational Publishing Engine 建立表格空間,請輸入下列指令。以表格空間名稱取代 RPE,以 Oracle 絕對安裝路徑取代 ORACLE_BASE,以您在步驟 1 中所建立的資料庫名稱取代 RPEDB,以您想建立的資料檔名稱取代 RPE.DBF

    CREATE TABLESPACE RPE 
    DATAFILE 'ORACLE_BASE/oradata/RPEDB/RPE.DBF' 
    SIZE 1G AUTOEXTEND ON EXTENT MANAGEMENT LOCAL AUTOALLOCATE;
    例如:
    CREATE TABLESPACE RPEDB_TS DATAFILE '/u01/app/oracle/oradata/RPEDB/RPEDB_TS.dbf' SIZE 1G
            AUTOEXTEND ON EXTENT MANAGEMENT LOCAL AUTOALLOCATE;
  5. Rational Publishing Engine 建立暫存表格空間 如果要為 Rational Publishing Engine 建立暫存表格空間,請輸入下列指令。以暫存表格空間名稱取代 RPE_TEMP,以 Oracle 絕對安裝路徑取代 ORACLE_BASE,以您在步驟 1 中所建立的資料庫名稱取代 RPEDB,以您想建立的暫存檔名稱取代 RPE_TEMP.DBF
    CREATE TEMPORARY TABLESPACE RPE_TEMP 
    TEMPFILE 'ORACLE_BASE/oradata/RPEDB/RPE_TEMP.DBF' 
    SIZE 20M AUTOEXTEND ON EXTENT MANAGEMENT LOCAL UNIFORM SIZE 1M;
    例如:
    CREATE TEMPORARY TABLESPACE RPEDB_TEMP TEMPFILE
            '/u01/app/oracle/oradata/RPEDB/RPEDB_TEMP.DBF' SIZE 20M AUTOEXTEND ON EXTENT MANAGEMENT
            LOCAL UNIFORM SIZE 1M
  6. 以系統使用者身分登入 Oracle Enterprise Manager Database Control 入口網站。按一下儲存體 > 表格空間,驗證會顯示您所建立的表格空間,並且可存取。
    Oracle Enterprise Manager
  7. 建立表格空間之後,每個應用程式必須各建立一個特殊的 Oracle 使用者來使用 Oracle 資料庫。在本例中,會建立一個稱為 RPE_USER 的使用者,並授與許可權。Oracle 資料庫使用者必須能夠以建立階段作業、表格、程序及視圖的專用權,在其表格空間(無限制或有空間配額)中建立資料庫物件。 如果要為每個新的表格空間建立 Oracle 資料庫使用者,請輸入下列指令。以您想建立的使用者取代 USER_NAME,以使用者的密碼取代 PASSWORD,以您在步驟 4 中建立的表格空間名稱取代 RPEDB_TS,以及以您想建立的暫存表格空間取代 RPEDB_TEMP
    CREATE USER  USER_NAME IDENTIFIED BY PASSWORD DEFAULT TABLESPACE RPEDB_TS QUOTA UNLIMITED ON
          RPEDB_TS TEMPORARY TABLESPACE RPEDB_TEMP;
    例如:
    CREATE USER  RPE_USER IDENTIFIED BY RPEt3st123 DEFAULT TABLESPACE RPEDB_TS QUOTA UNLIMITED
            ON RPEDB_TS TEMPORARY TABLESPACE RPEDB_TEMP;
  8. 如果要授與對表格空間的必要許可權,請輸入下列指令:
    GRANT CREATE PROCEDURE, CREATE SESSION, CREATE TABLE, CREATE VIEW TO RPE_USER
  9. 現在,使用 RPE_USER 登入 SQL *Plus 編輯器,並確定您可以鑑別成功,例如:
    ./sqlplus.sh rpe_user/RPEt3st123@RPEDB

建立 JDBC 提供者

程序

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

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

  3. 選取資源 > JDBC > JDBC 提供者
  4. 將範圍設為 Cell。
    Cell
  5. 按一下新建
  6. 在「建立新 JDBC 提供者」精靈中,選取:
    1. 資料庫類型:Oracle
    2. 提供者類型:Oracle JDBC 驅動程式
    3. 實作類型:XA 資料來源
    4. 實作類型:輸入名稱,例如 RPE_Oracle
    建立新的 JDBC 提供者精靈
  7. 下一步
  8. 在「輸入資料庫類別路徑資訊」區段中,請確定類別路徑區段指向 ojdbc7.jar 位置。如果它顯示 ojdbc6.jar,請更新為 ojdbc7.jar,然後按一下套用。例如:
    ${ORACLE_JDBC_DRIVER_PATH}/odjbc7.jar 
  9. 輸入 "ojdbc7.jar" 檔的目錄位置,此位置會儲存為 WebSphere 變數 ${ORACLE_JDBC_DRIVER_PATH},例如,/oracle_jdbc
    輸入資料庫類別路徑資訊
  10. 檢閱摘要頁面,然後按一下完成
    原生程式庫路徑
  11. 將變更儲存到主要配置。

rpeng 應用程式建立資料來源

程序

  1. 移至您剛才建立的 JDBC 提供者。
    1. 按一下資料來源
      資料來源鏈結
    2. 資料來源名稱欄位中,輸入 rpeng
    3. JNDI 名稱欄位中,輸入 RPENG_DB,然後按下一步
      輸入基本資料來源資訊
  2. 輸入資料來源的資料庫特定內容,並按下一步
    1. URL 欄位中,輸入 Oracle 資料庫的 URL,例如,jdbc:oracle:thin:@[server]:1521/RPEDB
    2. 清除在儲存器管理的持續性 (CMP) 中使用此資料來源勾選框,然後按下一步
      輸入資料來源的資料庫特定內容
  3. 在「設定安全別名」區段中,按下一步
  4. 檢閱摘要頁面,然後按一下完成
    資料來源摘要
  5. 將變更儲存到主要配置。

建立 dgaas 應用程式的資料來源

程序

重複為 rpeng 應用程式建立資料來源中的步驟,並將 DGAAS 設為資料來源名稱,將 DGAAS_DB 設為 JNDI 名稱
輸入基本資料來源資訊

建立鑑別資料項目

程序

  1. 移至 RPE JDBC 提供者,並按一下資料來源
  2. 在「資料來源」頁面上,按一下 rpeng 資料來源。
  3. 在「相關項目」區段中,按一下 JAAS-J2C 鑑別資料
  4. 按一下新建
  5. 輸入 Oracle 別名、使用者 ID 和密碼,然後按一下確定
    新的鑑別資料
  6. 將變更儲存到主要配置。
  7. 回到 rpeng 資料來源。
  8. 在「安全設定」中,針對下列選項選取 rpedb 資料庫:
    1. XA 回復用的鑑別別名
    2. 元件管理的鑑別別名
    3. 儲存器管理的鑑別別名
    安全設定
  9. 按一下確定,並儲存。
  10. 再次移至 rpeng 資料來源,並按一下測試連線,測試資料來源。
    測試連線成功
  11. 針對 dgaas 資料來源,重複步驟 7-10。

將「文件建置器」部署在 WebSphere Application Server

開始之前

驗證已建立下列資產:
  • DB2 或 Oracle 中的 Rational Publishing Engine 資料庫
  • rpeng 資料來源,且 JNDI 名稱是:RPENG_DB
  • DGAAS 資料來源,且名稱是:DGAAS_DB

程序

  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\document-builder\com.ibm.rpe.web.app.ear
  5. 下一步
  6. 選取捷徑 - 僅於需要其他資訊時提示,然後按下一步
  7. 在「選取這些安裝選項」頁面中,接受預設值,並按下一步
    這是 WebSphere Application Server 管理主控台中之「選取這些安裝選項」頁面的畫面擷取
  8. 在「將模組對映至伺服器」頁面中,選取 Rational Publishing EngineDGaaS 模組,然後按下一步
  9. 在「將資源參照對映至資源」頁面中,您必須指定 Rational Publishing EngineDGaaS 模組的資料來源。
    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. 為了確認「文件建置器」已順利部署在伺服器上,請搜尋顯示在程序日誌中的下列輸出訊息:
    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. 在伺服器上啟動「文件建置器」:
    1. 選取 com.ibm.rpe.web.app 勾選框,然後按一下啟動
    2. 如果「文件建置器」順利在伺服器上啟動,會顯示下列訊息:
      位於伺服器 server_name 和節點 node_name 上的 com.ibm.rpe.web.app 應用程式順利啟動。可能需要重新整理集合,以顯示現行狀態。
      這是 WebSphere Application Server 管理主控台之「企業應用程式」頁面的畫面擷取。

WebSphere Application Server 上的「文件建置器」配置使用者

關於這項作業

如果要完成這項作業,您必須完成為 WebSphere Application Server 上的「文件建置器」配置使用者中的步驟

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 環境變數。 例如,您可以在「環境項目」頁面上,為 WebSphere Application Server 中的授權檔案建立環境變數:
    新增 Telelogic 環境變數
    若為 Linux,可在 $HOME/.flexlmrc 中找到 TELELOGIC_LICENSE_FILE 的登錄。
  2. 重新啟動 WebSphere Application Server

結果

您可以在瀏覽器中開啟下列 URL,來確認已部署「文件建置器」: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 應用程式首頁

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

Web 應用程式首頁

下一步

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

配置 http://server:port/rpeng/ 頁面上所列出的「Rational Publishing Engine 文件建置器。請參閱 「文件建置器」URL,以取得每個 URL 的使用方式及每個特性的配置作業的說明。