远程服务应用程序的远程标志参考

参考此表,以获取远程服务应用程序中可使用的远程标志和 Java™ 属性的列表。
可从列表中选择标志,然后查看“配置远程标志”主题(针对 WebSphere® Application ServerApache Tomcat),以获取有关使用该标志的信息。
表 1. 远程标志
标志 描述
-Dcom.ibm.rational.rpe.docgen.concurrentlimit 数字

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

设置并发 Rational® Publishing Engine 文档生成请求同时运行。如果达到限制,后续作业要求将放置在队列中,以在当前作业完成后开始。
要点: 选择若干并行文档生成请求时,请考虑可供您组织使用的许可证数。如果文档生成开始时许可证不可用,那么不管您是将并行限制设置为高于您所拥有的许可证数还是当前使用了所有许可证,均会发生以下其中一种行为:
  • 如果指定 com.ibm.rational.rpe.license.attempts.countcom.ibm.rational.rpe.license.retry.timeout 标志,那么会将文档生成添加到队列,且会在指定时间间隔重试。
  • 如果未指定 com.ibm.rational.rpe.license.attempts.countcom.ibm.rational.rpe.license.retry.timeout 标志,那么无法完成文档生成。文档生成结束。
-Dcom.ibm.rational.rpe.license.attempts.count 数字

缺省值:1

示例:-Dcom.ibm.rational.rpe.license.attempts.count=2

要检查可用许可证的次数。如果输入的值小于 1,那么会忽略该值。
-Dcom.ibm.rational.rpe.license.retry.timeout 数字(以秒计)

缺省值:5 秒

示例:-Dcom.ibm.rational.rpe.license.retry.timeout=6

尝试检查可用许可证之间要等待的秒数。
-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

缺省值:false

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

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

缺省值:-Xmx1024m

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

可增加由远程服务应用程序分配用于生成文档的内存量。

如果正在对远程服务应用程序使用 32 位 Java 运行时环境 (JRE),那么可将堆大小从 1 调整到 1.5 GB。如果正在对远程服务应用程序使用 64 位 JRE,那么可将堆大小调整为大于 1.5 GB。

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

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

您可以指定 Java 运行时环境的路径,该路径不同于位于 RPE_HOME\jre 中的 Rational Publishing Engine 应用程序文件中所包含的路径。
-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.rational.rpe.ssl 安全性类型:
  • SSL
  • SSLv2
  • SSLv3
  • TLS
  • TLSv1
  • TLSv1.1

示例:-Dcom.ibm.rational.rpe.ssl=TLSv1

设置为特定安全性类型时,Rational Publishing Engine 仅在此安全性类型中通信。

对于 TLS v1.2,改为配置 -Dcom.ibm.rational.rpe.tls12only 标志。如果同时配置了 -Dcom.ibm.rational.rpe.tls12only-Dcom.ibm.rational.rpe.ssl,那么会优先使用 -Dcom.ibm.rational.rpe.tls12only

-Dcom.ibm.rational.rpe.tls12only truefalse

示例:-Dcom.ibm.rational.rpe.tls12only=true

如果设置为 true,那么 Rational Publishing Engine 仅采用传输层安全性 (TLS) 1.2 方式通信。Rational Publishing Engine 不会检查其他 Java 虚拟机属性设置来确定哪个安全套接字层 (SSL) 协议正在使用中。

如果同时配置了 -Dcom.ibm.rational.rpe.tls12only-Dcom.ibm.rational.rpe.ssl,那么会优先使用 -Dcom.ibm.rational.rpe.tls12only

-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 无法对其进行读取。

反馈