您可以將 Rational® Publishing Engine Web 應用程式(rpeng.war 和 dgaas.war)
部署在具有 Derby 的 Apache Tomcat 伺服器上。
開始之前
在部署 Web 應用程式之前,您必須先安裝 Apache Tomcat 7.0.x 版或 8.0.x 版,以及具有「RPE 遠端服務」特性的
Rational Publishing Engine。
您必須能夠存取
RPE_HOME\remote-services 目錄中的下列 Web 應用程式:
程序
- 準備您的 Apache Tomcat 應用程式伺服器:
- 在 Tomcat 應用程式伺服器中,將 TELELOGIC_LICENSE_FILE 系統變數設為
port_number@hostname,
例如 19353@licserver1。如需詳細資料,請參閱驗證 TELELOGIC_LICENSE_FILE 環境變數主題。
- 將檔案大小上限及要求大小加大:
對於 Tomcat 7:
- 開啟 Tomcat 管理應用程式的 web.xml 檔,例如,TomcatInstallDir/webapps/manager/WEB-INF/web.xml。
- 尋找下列區段:
<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>
- 編輯這個區段來增加容量:
<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>
- 儲存及關閉 web.xml 檔。
對於 Tomcat 8:
- 停止您的 Apache Tomcat 應用程式伺服器。
- 如果 TOMCAT_HOME\webapps 目錄中已有 dgaas 目錄及 dgaas.war,請刪除它們。
- 將 dgaas.war 檔複製至 TOMCAT_HOME\webapps 目錄中。
- 啟動 Apache Tomcat 應用程式伺服器:

- 如果您將 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

- 如果要啟動伺服器,請從 TomcatInstallDir/bin 執行這個指令:
startup.sh
如果要停止伺服器,請從
TomcatInstallDir/bin 目錄執行這個指令:
shutdown.sh
- 選取下列其中一個選項,來部署 Web 應用程式:
- 如果您想使用圖形使用者介面來部署 Web 應用程式,請繼續下一步,以取得使用 Apache Tomcat Manager 介面來部署的詳細資料。
- 如果您想使用檔案系統來部署 Web 應用程式,請將 rpeng.war 和 dgaas.war 檔,
從 RPE_HOME\remote-services 目錄複製到 Tomcat webapps 目錄,
例如 Tomcat_InstallDir\webapps。然後繼續進行這個主題的結果和下一步區段。
- 在瀏覽器中開啟 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"/>
- 同時將 rpeng.war 和 dgaas.war 應用程式部署在 Apache Tomcat 上。
- 在「部署」區段中,輸入 rpeng.war 檔的詳細資料,然後按一下部署:
- 如果 WAR 檔位於 Apache Tomcat 以外的伺服器上,
請在部署位於伺服器上的目錄或 WAR 檔區段中輸入下列資訊:
- 環境定義路徑:輸入 /rpeng 作為
Rational Publishing Engine Web 應用程式的名稱。這個項目是用來配置用戶端的 URL 部分。
- XML 配置檔 URL:不需要。
- WAR 或目錄 URL:rpeng.war 檔的路徑。範例:RPE_HOME\remote-services\rpeng.war
- 如果 .war 檔與 Apache Tomcat 在相同伺服器上,請在要部署的 WAR 檔區段中輸入下列資訊:
- 選取要上傳的 WAR:rpeng.war 檔的路徑。範例:RPE_HOME\remote-services\rpeng.war
- 在「部署」區段中,輸入 dgaas.war 檔的詳細資料,然後按一下部署:
- 如果 .war 檔在 Apache Tomcat 以外的伺服器上,請在部署位於伺服器上的目錄或 WAR 檔區段中輸入下列資訊:
- 環境定義路徑:輸入 /dgaas 作為
Rational Publishing Engine Web 應用程式的名稱。這個項目是用來配置用戶端的 URL 部分。
- XML 配置檔 URL:不需要。
- WAR 或目錄 URL:dgaas.war 檔的路徑。範例:RPE_HOME\remote-services\dgaas.war
- 如果 .war 檔與 Apache Tomcat 在相同伺服器上,請在要部署的 WAR 檔區段中輸入下列資訊:
- 選取要上傳的 WAR:dgaas.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 執行時期環境變數,請執行下列動作:
- 必須以具備管理者 (rpe_admin) 存取權的使用者身分,登入 http://server:port/rpeng/ Web 應用程式。如需如何為使用者配置 rpe_admin 使用者角色的詳細資料,請參閱在 Apache Tomcat 上配置 Web 應用程式的使用者主題。
- 在 Web 應用程式的使用者工具列中,選取管理者。這個管理功能表選項可供具備 rpe_admin 角色的使用者使用。
- 選取執行時期變數。
- 將 DGAAS_URL 執行時期環境變數值設為一個 URL,例如 http://server:port/dgaas。
下一步
您可以選擇性地部署和執行 Newskeeper 範例應用程式,
這個範例應用程式使用文件產生服務技術來產生文件,並提供用於文件產生服務資產和文件的儲存介面。如需詳細資料,請參閱執行 Newskeeper 範例。
配置 Rational Publishing Engine Web 應用程式(該 Web 應用程式列在
http://server:port/rpeng/ 頁面中)。請參閱
Web 應用程式 URL,以取得每個 URL 的使用方式及每個特性的配置作業的說明。