可以在带有 Derby 或 DB2® 的 Apache Tomcat 服务器上部署 文档构建器 Web 应用程序(rpeng.war 和 dgaas.war)。如果您想要在企业数据库上运行文档构建器应用程序,此任务中的可选步骤将为您提供 DB2 支持的额外配置设置。
开始之前
在部署
文档构建器之前,必须安装 Apache Tomcat V7.0.x 或 V8.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 启动脚本文件:
<Tomcat_install_dir>\bin\catalina.bat
<Tomcat_install_dir>/bin/catalina.sh
添加以下代码行:set "VCAP_SERVICES={'sqldb':[{}]}"
- 在 <Tomcat_install_dir>/conf/server.xml 文件中准备用于定义数据源的 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"/>
其中,
usename 属性后面的
db2admin 值是对
rpedb1 数据库具有
CONNECT 访问权的系统用户的名称,
password 后面的
myDBpassword 是此用户的密码。如果您已定义另外的用户名和/或另外的密码,请相应地替换
db2admin 和
myDBpassword。此外,请将 <
server> 替换为数据库服务器位置的地址。
提示: 对于 Linux 操作系统,DB2 的用户名和密码长度限制为 8 个字符,对于 Windows 操作系统则为 30 个字符。
- 在 <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 V7.0.x,请替换为 Tomcat7.exe):
Tomcat8.exe start
要停止服务器,请从
<Tomcat_install_dir>/bin 目录运行以下命令(对于 Apache Tomcat V7.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 应用程序的用户名和密码。您必须将
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 作为文档构建器的名称。此条目是用于配置客户机的 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 的用法说明以及用于配置每项功能部件的任务。