在 Apache Tomcat 上部署 Web 应用程序

可以在带有 Derby 的 Apache Tomcat 服务器上部署 Rational® Publishing Engine Web 应用程序(rpeng.wardgaas.war)。

开始之前

在部署 Web 应用程序之前,必须安装 Apache Tomcat V7.0.x 或 V8.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 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
    这是 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 应用程序的用户名和密码。您必须将 manager-gui 角色添加至 Tomcat_install_dir/conf/tomcat-user.xml 文件,其中 Tomcat_install_dir 是 Apache Tomcat 的安装目录。以下示例添加一个用户名为 my_username 和密码为 my_passwordmanager-gui 角色:
    <user username="my_username" password="my_password" roles="manager-gui"/>
  5. 在 Apache Tomcat 上部署 rpeng.wardgaas.war 应用程序。
    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) 访问权的用户身份登录 Web 应用程序 http://server:port/rpeng/。有关如何配置具有 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 的用法说明以及用于配置每项功能部件的任务。