WebSphere Application Server 上为远程服务应用程序配置远程标志

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

开始之前

复查可用于远程服务应用程序的远程标志的列表,然后选择一个要使用的标志以完成此任务。
表 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 GB 调整到 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 true, false

-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 true, false

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

过程

  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. 重新启动服务器。

反馈