在 Apache Tomcat 上配置远程服务

通过使用以下步骤,在 Apache Tomcat 服务器上配置远程服务的用户和 Java™ 选项。

开始之前

必须先安装 Apache Tomcat、Rational® Publishing EngineWeb Service 应用程序并对其进行部署,然后才能配置用户和 Java 选项。

配置用户和用户角色

关于此任务

表 1. 远程服务用户角色
角色 能力
文档生成用户 (rpe_docgen_user)
  • 可以从客户机应用程序以远程方式或本地方式生成文档
  • 可以查看有关其文档生成作业的输出文件和日志
文档生成管理员 (rpe_docgen_admin)
  • 可以从客户机应用程序以远程方式或本地方式生成文档
  • rpe_monitor_admin 角色结合使用时,可以查看由任何用户启动的文档生成作业的输出文件和日志
中央管理组件 用户 (rpe_library_user)
  • 可以从 Document Studio 应用程序查看公用资产
  • 可使用公用资产来设计模板
中央管理组件 提供者 (rpe_library_contributor)
  • 可以从 Document Studio 应用程序查看资产
  • 可以使用资产来设计模板
  • 可以从 Document Studio 应用程序提交资产
  • 可以从 Document Studio 应用程序修改其现有资产
中央管理组件 管理员 (rpe_library_admin)
  • 可以从 Document Studio 应用程序查看由任何用户创建的资产
  • 可以使用由任何用户创建的资产来设计模板
  • 可以从 Document Studio 应用程序提交资产
  • 可以从 Document Studio 应用程序修改由任何用户创建的现有资产
  • 可以在 中央管理组件 管理用户界面中创建资产
  • 可以从中央管理组件管理用户界面修改由任何用户创建的现有资产
  • 可以从中央管理组件管理用户界面除去由任何用户创建的资产
监视和控制组件用户 (rpe_monitor_user)
  • 可以更改其文档生成作业的状态
  • 允许具有 rpe_monitor_admin 角色的用户监视其文档生成作业
监视和控制组件管理员 (rpe_monitor_admin)
  • rpe_docgen_admin 角色结合使用时,可以查看由任何用户启动的文档生成作业的输出文件和日志
  • 可以更改由任何用户启动的文档生成作业的状态

过程

  1. 在浏览器中打开 Apache Tomcat Manager:http://server:port/manager/html 示例:http://localhost:8080/manager/html
  2. 停止已部署的 Web Service 应用程序。在“应用程序”部分中,找到 rpews.war application 行,然后单击停止
  3. 监视和控制组件创建 Apache Tomcat 用户和角色。
    1. 打开 tomcat-users.xml 文件,缺省情况下该文件位于 $CATALINA_HOME\conf\tomcat-users.xml
    2. 添加您所使用服务的用户角色、提供者角色和管理员角色。
      提示:
      • 请参阅上文“关于此任务”部分中的表,以获取各个角色的描述。
      • 为增加安全性,请创建多个客户机用户,并仅提供一个 rpe_docgen_user 角色。用户创建的文档生成结果可能包含机密数据。通过创建两种类型的用户,可以确保只有具有查看结果输出的许可权的用户才能查看这些结果输出。
      <role rolename="rpe_docgen_admin" />
      <role rolename="rpe_docgen_user" /> 
      <role rolename="rpe_library_user"/>
      <role rolename="rpe_library_contributor"/>
      <role rolename="rpe_library_admin"/>
      <role rolename="rpe_monitor_user"/>
      <role rolename="rpe_monitor_admin"/>
    3. 至少添加一个管理员,并为该管理员分配您所使用服务的管理员和用户角色。 示例:
      <user username="rpe_admin" password="password" roles="rpe_docgen_admin,rpe_library_admin,rpe_monitor_admin"/>
    4. 至少添加一个客户机用户。为该客户机用户分配您所使用服务的用户角色。 示例:
      <user username="rpe_client" password="password" roles="rpe_docgen_user,rpe_library_user,rpe_monitor_user"/>
      <user username="rpe_contributor" password="password" roles="rpe_docgen_user,rpe_library_contributor,rpe_monitor_user"/>
    5. 可选: 添加其他客户机用户和提供者用户。 示例:
      <user username="user1" password="password" roles="rpe_docgen_user,rpe_library_contributor,rpe_monitor_user"/>
  4. 启动 Web Service 应用程序。在 Apache Tomcat Manager 的“应用程序”部分中,找到 rpews.war application 行,然后单击启动

可选:在与远程文档生成不同的服务器上配置监视和控制组件

文档生成服务自动使用与其一起部署的监视和控制组件。要使用缺省监视和控制组件,无需进行任何其他配置,您可以继续执行下一步。要在不同于文档生成的其他服务器或端口上使用不同的监视和控制组件,请配置以下 Java 选项标志以配置登录凭证。

过程

  1. 停止已部署的 Web Service 应用程序。在“应用程序”部分中,找到 rpews.war application 行,然后单击停止
  2. 设置 Java 选项:
    1. 在 Apache Tomcat 应用程序文件中,右键单击用于启动服务器的 startup 文件。
    2. 单击属性
    3. 选择 Java 选项卡。
    4. 在 Java 选项字段中,输入以下选项:
      -Dcom.ibm.rational.rpe.mc.url=http://server:port/rpews/monitor
      -Dcom.ibm.rational.rpe.mc.user=rpe_client
      -Dcom.ibm.rational.rpe.mc.password=password
    5. 单击确定
  3. 启动 Web Service 应用程序。在 Apache Tomcat Manager 的“应用程序”部分中,找到 rpews.war application 行,然后单击启动

结果

完成部署之后,就可以 访问监视和控制组件管理控制台,网址如下:http://server:port/rpews/ui/monitor.html。 请参阅在监视和控制组件中管理文档生成作业以获取有关使用管理控制台的信息。

下一步做什么

在终端用户计算机上,指定远程服务器的监视和控制组件的 URL。请参阅设置远程服务首选项


反馈