Web Service 应用程序配置远程标志

可以将称为标志的参数添加至应用程序服务器配置文件,以便为 Web Service 应用程序指定某些参数。

开始之前

查看可用于 Web Service 应用程序的远程标志的列表,然后选择一个标志用于完成此任务。
表 1. 远程标志
标志 描述
-Dcom.ibm.rational.rpe.docgen.concurentlimit 一个数字

示例:-Dcom.ibm.rational.rpe.docgen.concurentlimit=5

设置可同时运行的并行 Rational® Publishing Engine 文档生成请求的最大数目。如果达到该限制,那么会将后续作业请求排成一列以在当前作业完成之后开始。
-Dcom.ibm.rational.rpe.remote.debug truefalse

示例:-Dcom.ibm.rational.rpe.remote.debug=true

可以复审更详细的日志信息以调试文档生成问题。
-Dcom.ibm.rational.rpe.remote.filestore \\ 开头的文件路径

示例:-Dcom.ibm.rational.rpe.remote.filestore=\\storage\rpe\files

如果您正在配置负载均衡环境,那么可指定共享存储目录所在的位置。
-Dcom.ibm.rational.rpe.remote.ignorelanguage truefalse

示例:-Dcom.ibm.rational.rpe.remote.ignorelanguage=true

当设置为 true 时,Web Service 应用程序将忽略用户所设置的 -Duser.country-Duser.language 标志,并设置管理员为服务器指定的缺省语言。
-Dcom.ibm.rational.rpe.remote.javaopts 堆大小

示例:-Dcom.ibm.rational.rpe.remote.javaopts=-Xmx1280m

可以增加由 Web Service 应用程序分配用于生成文档的内存量。 缺省值为 -Xmx1024m

如果您对 Web Service 应用程序使用的是 32 位 Java™ 运行时环境 (JRE),那么您可以将堆大小 1 GB 调整为 1.5 GB 。如果您对 Web Service 应用程序使用的是 64 位 JRE,那么您可以将堆大小调整为大于 1.5 GB。

-Dcom.ibm.rational.rpe.remote.jre Java 运行时环境应用程序文件的绝对路径。

示例:-Dcom.ibm.rational.rpe.remote.jre=C:\Program Files\Java\jre7

可以指定 Java 运行时环境的路径,该运行时环境不同于 Rational Publishing Engine 应用程序文件中所含的运行时环境(位于 %RPE_HOME%\jre)。
-Dcom.ibm.rational.rpe.remote.jrearch 32 位或 64 位。

示例:-Dcom.ibm.rational.rpe.remote.jrearch=32

如果 Rational Publishing Engine 检测不到 Java 运行时环境的正确版本来运行文档生成作业,那么您可以指定必须使用的版本。
-Dcom.ibm.rational.rpe.remote.rpecommandjar rpecommand.jar 文件的绝对路径。

示例:-Dcom.ibm.rational.rpe.remote.rpecommandjar=C:\Program Files\Rational\Publishing Engine

如果 Rational Publishing Engine 检测不到 rpecommand.jar 的正确路径,那么您可以指定必须使用的路径。
-Dcom.ibm.rational.rpe.remote.showconsole truefalse

-Dcom.ibm.rational.rpe.remote.debug 必须也设置为 true

示例:

-Dcom.ibm.rational.rpe.remote.showconsole=true
-Dcom.ibm.rational.rpe.remote.debug=true

Windows 图标:在 Windows 计算机上,可以在单独的控制台中,从 com.ibm.rational.rpe.remote.debug 打开详细日志信息。如果应用程序服务器正在作为 Windows NT 服务运行,请不要使用此属性。
-Dcom.ibm.rational.rpe.remote.workarea 用户具有写访问权的绝对路径。

示例:-Dcom.ibm.rational.rpe.remote.workarea=C:\temp

文档生成期间创建临时文件的位置。如果未指定路径,那么将使用系统的临时目录。
-Dcom.ibm.ws.classloader.encodeResourceURLs truefalse

-Dcom.ibm.rational.rpe.remote.debug 必须也设置为 true

示例:

-Dcom.ibm.ws.classloader.encodeResourceURLs=false
-Dcom.ibm.rational.rpe.remote.debug=true

只有 WebSphere® Application Server 8 才需要此标志。 此标志会阻止对 URL 进行编码。当 WebSphere Application Server 8 将这些 URL 进行编码时,Rational Publishing Engine 不能读取这些 URL。

关于此任务

可以为这些应用程序服务器配置一个或多个远程标志:

WebSphere Application Server

过程

  1. 在浏览器中打开管理控制台。 示例:http://server:port/ibm/console/logon.jsp
  2. 展开服务器 > 服务器类型
  3. 单击 WebSphere Application Server
  4. 通过单击 server_name 打开服务器属性。
  5. 在“服务器基础结构”部分中,展开 Java 和进程管理
  6. 单击进程定义
  7. 在“其他属性”部分中,单击 Java 虚拟机
  8. 在“其他属性”部分中,单击定制属性
  9. 单击新建以添加标志。
  10. 在“名称”字段中,输入您选择的标志的名称。
  11. 从您复制的标志的名称中,删除开头的 -D 例如,-Dcom.ibm.rational.rpe.flag 变为 com.ibm.rational.rpe.flag
  12. 在“值”字段中,输入该标志的参数。
  13. 可选: 输入指示该标志的使用目的的描述。
  14. 单击确定
  15. 重新启动服务器。

Apache Tomcat

过程

  1. 在 Apache Tomcat 应用程序文件中,右键单击用于启动服务器的 startup 文件。
  2. 单击属性
  3. 选择 Java 选项卡。
  4. 在 Java 选项字段中,输入您选择的标志及其相应值。 示例:
    -Dcom.ibm.rational.rpe.flag=value
  5. 单击确定
  6. 重新启动 Apache Tomcat。

反馈