您可以將「文件建置器」Web 應用程式(rpeng.war 和 dgaas.war)
部署在具有 Derby 或 DB2® 的 Apache Tomcat 伺服器上。如果您想在企業資料庫上執行「文件建置器」應用程式,這項作業中的選用步驟會提供您額外的配置設定,以支援 DB2。
開始之前
在部署「
文件建置器」之前,您必須先安裝 Apache Tomcat 7.0.x 版或 8.0.x 版,以及具有「RPE 文件建置器」特性的
Rational® Publishing Engine。
您必須能夠存取
RPE_HOME\document-builder 目錄中的下列 Web 應用程式:
程序
- 準備您的 Apache Tomcat 應用程式伺服器:
- 在 Tomcat 應用程式伺服器中,將 TELELOGIC_LICENSE_FILE 系統變數設為
port_number@hostname,例如 19353@licserver1。如需詳細資料,請參閱驗證 TELELOGIC_LICENSE_FILE 環境變數主題。
- 將檔案大小上限及要求大小加大:
對於 Tomcat 7:
- 開啟 Tomcat 管理應用程式的 web.xml 檔,例如,<Tomcat_install_dir>/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_install_dir>\webapps 目錄中已有 dgaas 目錄及 dgaas.war,請刪除它們。
- 將 dgaas.war 檔複製至 <Tomcat_install_dir>\webapps 目錄中。
- 選擇性的:
如果您想執行具有 DB2 的「文件建置器」應用程式,您必須完成這些額外的配置步驟: - 將 JDBC 4.0 驅動程式 db2jcc4.jar 檔從
<DB2_install_dir>/java 目錄複製到
<Tomcat_install_dir>/lib 目錄。
- 開啟 Apache Tomcat 啟動 Script 檔:
<Tomcat_install_dir>\bin\catalina.bat
<Tomcat_install_dir>/bin/catalina.sh
新增下列的程式碼行:
set "VCAP_SERVICES={'sqldb':[{}]}"
- 準備 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,則是使用者的密碼。如果您定義了不同的使用者名稱及/或不同的密碼,請從而取代
db2admin 和
myDBpassword。此外,以您資料庫伺服器的位址取代
<
server>。
提示: DB2
的使用者名稱與密碼長度限制為 8 個字元(若為 Linux 作業系統)和 30 個字元(若為 Windows 作業系統)。
- 在
<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>
- 啟動 Apache Tomcat 應用程式伺服器:

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

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