在 Apache Tomcat 上为远程服务应用程序配置运行时标志和格式设置标志

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

开始之前

复查可用于远程服务应用程序的运行时标志和格式设置标志的列表,然后选择一个要使用的标志以完成此任务。
表 1. 运行时标志和格式设置标志
标志 类型 描述
-Dcom.ibm.rational.rpe.config.oslcServiceProviders 完整文件路径、UNC 路径或 HTTP 位置
示例:

-Dcom.ibm.rational.rpe.config.oslcServiceProviders=
C:\rpe\oslcServiceProviders.xml

Rational® Publishing Engine 标志 用于为 Rational DOORS® Web 访问数据源配置 OAuth-OSLC 认证方法。必须在为此标志指定的 oslcServiceProviders.xml 文件中输入有效的 base_urlconsumer_keysecret 属性值。有关更多信息,请参阅创建 oslcServiceProviders.xml 文件以进行 OAuth-OSLC 认证,并参考 Rational Publishing Engine 安装目录中的样本:%RPE_HOME%/config/oslcServiceProviders-sample.xml
-Dcom.ibm.rational.rpe.config.oslcServiceProviders.pwd 字符串

示例:-Dcom.ibm.rational.rpe.config.oslcServiceProviders.pwd=password

Rational Publishing Engine 标志 执行带有 -Dcom.ibm.rational.rpe.config.oslcServiceProviders 标志的 OAuth-OSLC 认证所需的密码。
-Dcom.ibm.rational.rpe.config.oslcServiceProviders.usr 字符串

示例:-Dcom.ibm.rational.rpe.config.oslcServiceProviders.usr=user

Rational Publishing Engine 标志 执行带有 -Dcom.ibm.rational.rpe.config.oslcServiceProviders 标志的 OAuth-OSLC 认证所需的用户名。
-Dcom.ibm.rational.rpe.disablecommands truefalse

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

Rational Publishing Engine 标志 为了获得额外的安全性,可将此标志设置为禁止远程服务应用程序执行任何前命令和后命令。
-Dcom.ibm.rational.rpe.mc.maxerrorcount 数字

示例:-Dcom.ibm.rational.rpe.mc.maxerrorcount=

Rational Publishing Engine 标志 客户机尝试与监视和控制组件连接(以列示文档生成作业)的次数。缺省次数为 3。通常,如果在连续尝试 6 次之后无法与服务器联系,那么服务器可能已关闭并且必须由管理员重新启动。
-Dcom.ibm.rational.rpe.console.limit 字符数

示例:-Dcom.ibm.rational.rpe.console.limit=90000

Rational Publishing Engine 标志 可以控制“控制台”视图中保留的日志信息的大小。缺省情况下,最大大小会设置为 100000 个字符。
-Dcom.ibm.rational.rpe.doors.data 要传递至 Rational DOORS 命令行的数据参数

示例:-Dcom.ibm.rational.rpe.doors.data=36677@localhost

Rational Publishing Engine 标志 您可以包括此标志以标识 Rational DOORS 数据库,以便 Rational Publishing Engine 不必标识该数据库。当 Rational DOORS 稳定或者在不允许运行 reg.exe 命令的计算机上设置了文档生成时,设置此值将提高性能。配置了此标志时,它会覆盖文档规范中对 doors_param 属性指定的值。可以将此标志指定为系统变量或 Java™ 运行时变量。Java 运行时变量优先于系统变量。

配置此标志时,必须将 new_instance 属性设置为 true

-Dcom.ibm.rational.rpe.doors.flags Rational DOORS 命令行选项

示例:-Dcom.ibm.rational.rpe.doors.flags=“-addins file path

Rational Publishing Engine 标志 可以对 Rational DOORS 指定命令行选项。可以将此标志指定为系统变量或 Java 运行时变量。Java 运行时变量优先于系统变量。
-Dcom.ibm.rational.rpe.doors.home 指向 Rational DOORS 可执行文件的路径
示例:

-Dcom.ibm.rational.rpe.doors.home=
C:\Program Files (x86)\IBM\Rational\DOORS\9.5\bin\doors.exe

Rational Publishing Engine 标志 您可以包括此标志以标识 Rational DOORS 版本,以便 Rational Publishing Engine 不必标识该版本。当 Rational DOORS 稳定或者在不允许运行 reg.exe 的虚拟机上设置了您的文档生成时,设置此值可提高性能。配置了此标志时,它会覆盖文档规范中对 doors_home 属性指定的值。可以将此标志指定为系统变量或 Java 运行时变量。Java 运行时变量优先于系统变量。

配置此标志时,必须将 new_instance 属性设置为 true

-Dcom.ibm.rational.rpe.dxl.enable.memory.management truefalse

示例:-Dcom.ibm.rational.rpe.dxl.enable.memory.management=true

Rational Publishing Engine 标志

如果 Rational DOORS 模块已链接到其他模块,那么在生成文档时,Rational Publishing Engine 必须在后台打开那些已链接的模块。此外,使用布局 DXL 代码时,将在后台打开模块,直到 DXL 完成为止。

在这两种情况下,将使用 Rational DOORS 客户机内存,以在后台打开和关闭模块。可配置注册表键,以便当达到内存限制时,后台进程会在它们完成对当前对象的读取时关闭,并且仅在必要时,才会再次重新打开该对象。

-Dcom.ibm.rational.rpe.dxl.enable.memory.management 设置为 true 时,用户可以设置注册表键来定义此内存限制,否则将使用 DXL 代码中设置的缺省内存限制 2GB。有关该注册表键的更多信息,请参阅对 Rational DOORS 文档生成进行故障诊断

缺省值为 false,并且该注册表键对文档生成进程没有影响。

-Dcom.ibm.rational.rpe.nonunicodefonts 一个非 Unicode 字体名称或用分号分隔的若干字体名称。

示例:-Dcom.ibm.rational.rpe.nonunicodefonts=Akshar

Rational Publishing Engine 标志 可指定要在 Rational Publishing Engine 中使用的非 Unicode 字体。您指定的非 Unicode 字体必须安装在正运行客户机应用程序的计算机上。

在 Microsoft Word 输出中,不会始终正确生成非 Unicode 字体。请将字体设置为 Arial Unicode MS 或任何其他能够呈示此字符的字体,然后输出会正确生成。

-Dcom.ibm.rational.rpe.output.default 临时目录

示例:-Dcom.ibm.rational.rpe.output.default=C:\RPE\output

Rational Publishing Engine 标志 可以将临时目录更改为与缺省临时目录 (%TEMP%\rpe\output) 不同的位置。可以将此标志指定为系统变量或 Java 运行时变量。Java 运行时变量优先于系统变量。
-Dcom.ibm.rational.rpe.pdf.truetypefontdirectory 一个目录或用分号分隔的若干目录。
示例:

-Dcom.ibm.rational.rpe.pdf.truetypefontdirectory=
C:\Windows\Fonts;d:\fontlib

Rational Publishing Engine 标志 如果系统在非缺省目录中安装了额外字体,那么可指定这些字体目录。
-Dcom.ibm.rational.rpe.rpews.scheduler.pwd 用于向报告计划程序进行认证的用户密码。

示例:-Dcom.ibm.rational.rpe.rpews.scheduler.pwd=password

Rational Publishing Engine 标志 要向远程服务应用程序的报告计划程序组件进行认证,请使用密码来配置此标志。
-Dcom.ibm.rational.rpe.rpews.scheduler.url 报告计划程序的 URL。
示例:

-Dcom.ibm.rational.rpe.rpews.scheduler.url=
http://server:port/rpews/scheduler

Rational Publishing Engine 标志 要向远程服务应用程序的报告计划程序组件进行认证,请使用 URL 来配置此标志。
-Dcom.ibm.rational.rpe.rpews.scheduler.usr 用于向报告计划程序进行认证的用户名。

示例:-Dcom.ibm.rational.rpe.rpews.scheduler.usr=user

Rational Publishing Engine 标志 要向远程服务应用程序的报告计划程序组件进行认证,请使用用户名来配置此标志。
-Dcom.ibm.rational.rpe.wstimeout 时间(以毫秒计)

示例:-Dcom.ibm.rational.rpe.wstimeout=35000

Rational Publishing Engine 标志 创建已配置为使用远程发布引擎的复杂文档规范时,Launcher 会进入超时状态。如果您发现该客户机进入超时状态太快,请增大超时值。缺省超时值是 30000 毫秒。
-Dcom.ibm.rational.rpews.pwd 用于向远程服务进行认证的用户密码。

示例:-Dcom.ibm.rational.rpews.pwd=password

Rational Publishing Engine 标志 要向远程服务应用程序进行认证,请使用密码来配置此标志。
-Dcom.ibm.rational.rpews.url URL
示例:

-Dcom.ibm.rational.rpews.url=
http://server:port/rpews/

Rational Publishing Engine 标志 用来连接至远程服务应用程序的 URL。如果管理员不允许用户更改该位置,那么此 URL 不可编辑。
-Dcom.ibm.rational.rpews.usr 用于向远程服务进行认证的用户名。

示例:-Dcom.ibm.rational.rpews.usr=user

Rational Publishing Engine 标志 要向远程服务应用程序进行认证,请使用用户名来配置此标志。
-Dosgi.configuration.area 文件路径
示例:

-Dosgi.configuration.area=@user.home/Application
Data/IBM/Rational/RPE_qualifier_date/Launcher/workspace/

标准 Java 标志 要更改您的文档生成所在的缺省输出位置,可以更改此参数的文件路径。为 -Dosgi.instance.area-Dosgi.configuration.area 参数指定相同值。
-Dosgi.instance.area 文件路径
示例:

-Dosgi.instance.area=@user.home/Application
Data/IBM/Rational/RPE_qualifier_date/Launcher/workspace/

标准 Java 标志 要更改您的文档生成所在的缺省输出位置,可以更改此参数的文件路径。为 -Dosgi.configuration.area-Dosgi.instance.area 参数指定相同值。
-Duser.country 国家或地区代码
针对巴西葡萄牙语的示例:

-Duser.country=BR -Duser.language=pt

标准 Java 标志 将此标志设置为对应于您的语言代码的国家或地区的缩写,以设置您的文档生成的语言环境。当与 -Duser.language 结合使用时,如果提供了它所引用的特定语言的翻译版本,那么只需要包括 -Duser.country
-Duser.language 语言代码

针对日语的示例:-Duser.language=ja

标准 Java 标志 将此标志设置为某个语言的缩写,以设置您的文档生成的语言环境。有关语言代码的更多示例,请参阅 HTML 语言代码引用
-Duser.timezone GMT+offset

示例:-Duser.timezone=GMT+02:00

标准 Java 标志 Rational Publishing Engine 会将日期和时间转换为安装了 Rational Publishing Engine 的计算机的时区,而不是转换为正在远程生成文档的服务器的时区。要指定将作为服务器的日期和时间,请输入 GMT 以及服务器位置相对于格林威治标准时间的偏移量(以小时数计)。
–Xmx<value>m Java 堆设置

示例:–Xmx512m

IBM® Java 运行时环境标志 减小产品配置文件中此参数的值以使 Rational Publishing Engine 能够在虚拟机上启动。

增加该值以提高在其他环境(而不是虚拟机)中生成大型文档时的性能。

–Xmx 是标准 Java 参数,并不是 Rational Publishing Engine 所独有的参数。

TELELOGIC_LICENSE_FILE TELELOGIC_LICENSE_FILE 系统变量中列出的许可证服务器值(格式为 port@license_server_hostname_or_IP_address)。

示例:19353@LicenseServer2

Rational Publishing Engine 标志 用于列出许可证服务器的地址的系统变量。

过程


反馈