可以在带有 Derby 的 Apache Tomcat 服务器上部署 Rational® Publishing Engine Web 应用程序(rpeng.war 和 dgaas.war)。
开始之前
在部署 Web 应用程序之前,必须安装 Apache Tomcat V7.0.x 或 V8.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 V7.0.x,请替换为 Tomcat7.exe):
Tomcat8.exe start
要停止服务器,请从
TomcatInstallDir/bin 目录运行以下命令(对于
Apache Tomcat V7.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 应用程序的用户名和密码。您必须将
manager-gui 角色添加至
Tomcat_install_dir/conf/tomcat-user.xml 文件,其中
Tomcat_install_dir 是 Apache
Tomcat 的安装目录。以下示例添加一个用户名为
my_username 和密码为
my_password 的
manager-gui 角色:
<user username="my_username" password="my_password" roles="manager-gui"/>
- 在 Apache Tomcat 上部署 rpeng.war 和 dgaas.war 应用程序。
- 在“部署”部分中,输入 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) 访问权的用户身份登录 Web 应用程序 http://server:port/rpeng/。有关如何配置具有 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 的用法说明以及用于配置每项功能部件的任务。