將「文件建置器」部署在 Apache Tomcat 上

您可以將「文件建置器」Web 應用程式(rpeng.wardgaas.war) 部署在具有 Derby 或 DB2® 的 Apache Tomcat 伺服器上。如果您想在企業資料庫上執行「文件建置器」應用程式,這項作業中的選用步驟會提供您額外的配置設定,以支援 DB2

開始之前

在部署「文件建置器」之前,您必須先安裝 Apache Tomcat 7.0.x 版或 8.0.x 版,以及具有「RPE 文件建置器」特性的 Rational® Publishing Engine
您必須能夠存取 RPE_HOME\document-builder 目錄中的下列 Web 應用程式:
  • rpeng.war
  • dgaas.war

程序

  1. 準備您的 Apache Tomcat 應用程式伺服器:
    1. 在 Tomcat 應用程式伺服器中,將 TELELOGIC_LICENSE_FILE 系統變數設為 port_number@hostname,例如 19353@licserver1。如需詳細資料,請參閱驗證 TELELOGIC_LICENSE_FILE 環境變數主題。
    2. 將檔案大小上限及要求大小加大:

      對於 Tomcat 7:

      1. 開啟 Tomcat 管理應用程式的 web.xml 檔,例如,<Tomcat_install_dir>/webapps/manager/WEB-INF/web.xml
      2. 尋找下列區段:
        <multipart-config>
        <!-- 50 MB max -->
        <max-file-size>52428800</max-file-size>
        <max-request-size>52428800</max-request-size>
        <file-size-threshold>0</file-size-threshold>
        </multipart-config>
      3. 編輯這個區段來增加容量:
        <multipart-config>
        <!-- 70 MB max -->
        <max-file-size>73400320</max-file-size>
        <max-request-size>73400320</max-request-size>
        <file-size-threshold>0</file-size-threshold>
        </multipart-config>
      4. 儲存及關閉 web.xml 檔。
      對於 Tomcat 8:
      1. 停止您的 Apache Tomcat 應用程式伺服器。
      2. 如果 <Tomcat_install_dir>\webapps 目錄中已有 dgaas 目錄及 dgaas.war,請刪除它們。
      3. dgaas.war 檔複製至 <Tomcat_install_dir>\webapps 目錄中。
  2. 選擇性的: 這是 DB2 圖示。 如果您想執行具有 DB2 的「文件建置器」應用程式,您必須完成這些額外的配置步驟:
    1. 將 JDBC 4.0 驅動程式 db2jcc4.jar 檔從 <DB2_install_dir>/java 目錄複製到 <Tomcat_install_dir>/lib 目錄。
    2. 開啟 Apache Tomcat 啟動 Script 檔:
      • 這是 Windows 作業系統圖示。 <Tomcat_install_dir>\bin\catalina.bat
      • 這是 Linux 作業系統圖示。 <Tomcat_install_dir>/bin/catalina.sh
      新增下列的程式碼行:
      set "VCAP_SERVICES={'sqldb':[{}]}"
    3. 準備 XML 陳述式,以便在 <Tomcat_install_dir>/conf/server.xml 檔中定義資料來源:
      <Resource auth="Container"
                  driverClassName="com.ibm.db2.jcc.DB2Driver"
                  name="jdbc/RPENG_DB"
                  username="db2admin"
                  password="myDBpassword"
                  type="javax.sql.DataSource"
                  url="jdbc:db2://<server>:50000/rpedb1"/>
      <Resource auth="Container"
                  driverClassName="com.ibm.db2.jcc.DB2Driver"
                  name="jdbc/DGAAS_DB"
                  username="db2admin"
                  password="myDBpassword"
                  type="javax.sql.DataSource"
                  url="jdbc:db2://<server>:50000/rpedb1"/>
      其中,username 屬性之後的 db2admin 值是系統使用者的名稱,且其對 rpedb1 資料庫具備 CONNECT 存取權,而 password 之後的 myDBpassword,則是使用者的密碼。如果您定義了不同的使用者名稱及/或不同的密碼,請從而取代 db2adminmyDBpassword。此外,以您資料庫伺服器的位址取代 <server>。
      提示: DB2 的使用者名稱與密碼長度限制為 8 個字元(若為 Linux 作業系統)和 30 個字元(若為 Windows 作業系統)。
    4. <Tomcat_install_dir>/conf/context.xml 檔中新增資源的宣告:
      <Context>
        ...
         <ResourceLink name="jdbc/RPENG_DB" global="jdbc/RPEBG_DB" type="javax.sql.DataSource"/>
         <ResourceLink name="jdbc/DGAAS_DB" global="jdbc/DGAAS_DB" type="javax.sql.DataSource"/>
      </Context>
  3. 啟動 Apache Tomcat 應用程式伺服器:
    這是 Windows 作業系統圖示。
    如果您將 Apache Tomcat 當成 Windows 服務來執行,請從 <Tomcat_install_dir>/bin 目錄執行這個指令來啟動伺服器(若為 Apache Tomcat 7.0.x 版,請換成 Tomcat7.exe):
    Tomcat8.exe start
    如果要停止伺服器,請從 <Tomcat_install_dir>/bin 目錄執行這個指令(若為 Apache Tomcat 7.0.x 版,請換成 Tomcat7.exe):
    Tomcat8.exe stop
    如果您不是將 Apache Tomcat 當成 Windows 服務來執行,請從 <Tomcat_install_dir>/bin 目錄執行這個指令來啟動伺服器:
    startup.bat
    提示: 這時會開啟另一個 Apache Tomcat 主控台視窗。請勿關閉此視窗,否則伺服器將停止運作。您需要稍待片刻,讓 Tomcat 伺服器啟動。伺服器啟動之後,Tomcat 視窗中會顯示啟動時間(毫秒)。 例如,Server startup in 25731 ms
    如果要停止伺服器,請從 <Tomcat_install_dir>/bin 目錄執行這個指令:
    shutdown.bat
    這是 Linux 作業系統圖示。
    如果要啟動伺服器,請從 <Tomcat_install_dir>/bin 執行這個指令:
    startup.sh
    如果要停止伺服器,請從 <Tomcat_install_dir>/bin 目錄執行這個指令:
    shutdown.sh
  4. 選取下列其中一個選項,來部署「文件建置器」:
    • 如果您想使用圖形使用者介面來部署「文件建置器」,請繼續下一步,以取得使用 Apache Tomcat Manager 介面來部署的詳細資料。
    • 如果您想使用檔案系統來部署「文件建置器」,請將 rpeng.wardgaas.war 檔,從 RPE_HOME\document-builder 目錄複製到 Tomcat webapps 目錄,例如 <Tomcat_install_dir>\webapps。然後繼續進行這個主題的結果下一步區段。
  5. 在瀏覽器中開啟 Apache Tomcat Manager,網址是 http://server:port/manager/html
    範例:http://localhost:8080/manager/html
    提示: 這時會開啟視窗,要求提供使用者名稱和密碼來鑑別「Tomcat 管理程式」應用程式。您必須將 manager-gui 角色新增至 <Tomcat_install_dir>/conf/tomcat-user.xml 檔,其中 <Tomcat_install_dir> 是 Apache Tomcat 的安裝目錄。下列範例新增 manager-gui 角色,使用者名稱為 my_username,密碼為 my_password
    <user username="my_username" password="my_password" roles="manager-gui"/>
  6. 同時將 rpeng.wardgaas.war 應用程式部署在 Apache Tomcat 上。
    1. 在「部署」區段中,輸入 rpeng.war 檔的詳細資料,然後按一下部署
      • 如果 WAR 檔位於 Apache Tomcat 以外的伺服器上,請在部署位於伺服器上的目錄或 WAR 檔區段中輸入下列資訊:
        1. 環境定義路徑:輸入 /rpeng 作為 「文件建置器」的名稱。這個項目是用來配置用戶端的 URL 部分。
        2. XML 配置檔 URL:不需要。
        3. WAR 或目錄 URLrpeng.war 檔的路徑。範例:RPE_HOME\document-builder\rpeng.war
      • 如果 .war 檔與 Apache Tomcat 在相同伺服器上,請在要部署的 WAR 檔區段中輸入下列資訊:
        1. 選取要上傳的 WARrpeng.war 檔的路徑。範例:RPE_HOME\document-builder\rpeng.war
    2. 在「部署」區段中,輸入 dgaas.war 檔的詳細資料,然後按一下部署
      • 如果 .war 檔在 Apache Tomcat 以外的伺服器上,請在部署位於伺服器上的目錄或 WAR 檔區段中輸入下列資訊:
        1. 環境定義路徑:輸入 /dgaas 作為 「文件建置器」的名稱。這個項目是用來配置用戶端的 URL 部分。
        2. XML 配置檔 URL:不需要。
        3. WAR 或目錄 URLdgaas.war 檔的路徑。範例:RPE_HOME\document-builder\dgaas.war
      • 如果 .war 檔與 Apache Tomcat 在相同伺服器上,請在要部署的 WAR 檔區段中輸入下列資訊:
        1. 選取要上傳的 WARdgaas.war 的路徑。範例:RPE_HOME\document-builder\dgaas.war

結果

您可以在瀏覽器中開啟介紹頁面,來確認已部署「文件建置器」:http://server:port/rpeng/
重要:

依預設,rpeng.war 應用程式會在相同伺服器的 /dgaas 環境定義路徑之下,尋找 dgaas.war 應用程式。如果您將 dgaas.war 應用程式部署在不同的環境定義路徑上,您必須在 rpeng.war 應用程式中配置 DGAAS_URL 執行時期環境變數。

如果要配置 DGAAS_URL 執行時期環境變數,請執行下列動作:
  1. 必須以具備管理者 (rpe_admin) 存取權的使用者身分,登入「文件建置器」(http://server:port/rpeng/)。如需如何為使用者配置 rpe_admin 使用者角色的詳細資料,請參閱為 Apache Tomcat 上的「文件建置器」配置使用者主題。
  2. 在「文件建置器」的使用者工具列中,選取管理者。這個管理功能表選項可供具有 rpe_admin 角色的使用者使用。
  3. 選取執行時期變數
  4. DGAAS_URL 執行時期環境變數值設為一個 URL,例如 http://server:port/dgaas

下一步

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

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