在 Apache Tomcat 上部署 Web 應用程式

您可以將 Rational® Publishing Engine Web 應用程式(rpeng.wardgaas.war) 部署在具有 Derby 的 Apache Tomcat 伺服器上。

開始之前

在部署 Web 應用程式之前,您必須先安裝 Apache Tomcat 7.0.x 版或 8.0.x 版,以及具有「RPE 遠端服務」特性的 Rational Publishing Engine
您必須能夠存取 RPE_HOME\remote-services 目錄中的下列 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 檔,例如,TomcatInstallDir/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_HOME\webapps 目錄中已有 dgaas 目錄及 dgaas.war,請刪除它們。
      3. dgaas.war 檔複製至 TOMCAT_HOME\webapps 目錄中。
  2. 啟動 Apache Tomcat 應用程式伺服器:
    這是 Windows 作業系統圖示。
    如果您將 Apache Tomcat 當成 Windows 服務來執行,請從 TomcatInstallDir/bin 目錄執行這個指令來啟動伺服器(若為 Apache Tomcat 7.0.x 版,請換成 Tomcat7.exe):
    Tomcat8.exe start
    如果要停止伺服器,請從 TomcatInstallDir/bin 目錄執行這個指令(若為 Apache Tomcat 7.0.x 版,請換成 Tomcat7.exe):
    Tomcat8.exe stop
    如果您不是將 Apache Tomcat 當成 Windows 服務來執行,請從 TomcatInstallDir/bin 目錄執行這個指令來啟動伺服器:
    startup.bat
    提示: 這時會開啟另一個 Apache Tomcat 主控台視窗。請勿關閉此視窗,否則伺服器將停止運作。您需要稍待片刻,讓 Tomcat 伺服器啟動。伺服器啟動之後,Tomcat 視窗中會顯示啟動時間(毫秒)。 例如,Server startup in 25731 ms
    如果要停止伺服器,請從 TomcatInstallDir/bin 目錄執行這個指令:
    shutdown.bat
    這是 Linux 作業系統圖示。
    如果要啟動伺服器,請從 TomcatInstallDir/bin 執行這個指令:
    startup.sh
    如果要停止伺服器,請從 TomcatInstallDir/bin 目錄執行這個指令:
    shutdown.sh
  3. 選取下列其中一個選項,來部署 Web 應用程式:
    • 如果您想使用圖形使用者介面來部署 Web 應用程式,請繼續下一步,以取得使用 Apache Tomcat Manager 介面來部署的詳細資料。
    • 如果您想使用檔案系統來部署 Web 應用程式,請將 rpeng.wardgaas.war 檔, 從 RPE_HOME\remote-services 目錄複製到 Tomcat webapps 目錄, 例如 Tomcat_InstallDir\webapps。然後繼續進行這個主題的結果下一步區段。
  4. 在瀏覽器中開啟 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"/>
  5. 同時將 rpeng.wardgaas.war 應用程式部署在 Apache Tomcat 上。
    1. 在「部署」區段中,輸入 rpeng.war 檔的詳細資料,然後按一下部署
      • 如果 WAR 檔位於 Apache Tomcat 以外的伺服器上, 請在部署位於伺服器上的目錄或 WAR 檔區段中輸入下列資訊:
        1. 環境定義路徑:輸入 /rpeng 作為 Rational Publishing Engine Web 應用程式的名稱。這個項目是用來配置用戶端的 URL 部分。
        2. XML 配置檔 URL:不需要。
        3. WAR 或目錄 URLrpeng.war 檔的路徑。範例:RPE_HOME\remote-services\rpeng.war
      • 如果 .war 檔與 Apache Tomcat 在相同伺服器上,請在要部署的 WAR 檔區段中輸入下列資訊:
        1. 選取要上傳的 WARrpeng.war 檔的路徑。範例:RPE_HOME\remote-services\rpeng.war
    2. 在「部署」區段中,輸入 dgaas.war 檔的詳細資料,然後按一下部署
      • 如果 .war 檔在 Apache Tomcat 以外的伺服器上,請在部署位於伺服器上的目錄或 WAR 檔區段中輸入下列資訊:
        1. 環境定義路徑:輸入 /dgaas 作為 Rational Publishing Engine Web 應用程式的名稱。這個項目是用來配置用戶端的 URL 部分。
        2. XML 配置檔 URL:不需要。
        3. WAR 或目錄 URLdgaas.war 檔的路徑。範例:RPE_HOME\remote-services\dgaas.war
      • 如果 .war 檔與 Apache Tomcat 在相同伺服器上,請在要部署的 WAR 檔區段中輸入下列資訊:
        1. 選取要上傳的 WARdgaas.war 的路徑。範例:RPE_HOME\remote-services\dgaas.war

結果

您可以在瀏覽器中開啟 Rational Publishing Engine Web 應用程式的介紹頁面, 確認已部署 Web 應用程式,網址是:http://server:port/rpeng/
重要:

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

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

下一步

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

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