Setting virtual machine parameters

To set virtual machine parameters, edit the rpe-launcher.ini and rpe-studio.ini files.

About this task

Table 1. Run time and configuration flags for virtual machines
Parameter Value Description
-Dcom.ibm.rational.rpe.doors.data The data argument to pass to the Rational® DOORS® command line

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

Rational Publishing Engine flag You can include this flag to identify your Rational DOORS database so that Rational Publishing Engine does not have to identify it. Setting this value improves performance when your Rational DOORS is stable or your document generation is set up on a computer where running the reg.exe command is not permitted. When this flag is configured, it overrides the value specified for the doors_param property in a document specification. You can specify this flag as either a system or a Java™ Runtime variable. Java Runtime variables take precedence over system variables.

You must set new_instance property to true when configuring this flag.

-Dcom.ibm.rational.rpe.doors.home The path to the Rational DOORS executable file
Example:

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

Rational Publishing Engine flag You can include this flag to identify your Rational DOORS version so that Rational Publishing Engine does not have to identify it. Setting this value improves performance when your Rational DOORS is stable or your document generation is set up on a virtual machine where running the reg.exe command is not permitted. When this flag is configured, it overrides the value specified for the doors_home property in a document specification. You can specify this flag as either a system or a Java Runtime variable. Java Runtime variables take precedence over system variables.

You must set new_instance property to true when configuring this flag.

-Dosgi.configuration.area A file path
Example:

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

Standard Java flag To change the default output location of your document generations, you can change the file path for this parameter. Specify the same value for the -Dosgi.instance.area and -Dosgi.configuration.area parameters.
-Dosgi.instance.area A file path
Example:

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

Standard Java flag To change the default output location of your document generations, you can change the file path for this parameter. Specify the same value for the -Dosgi.configuration.area and -Dosgi.instance.area parameters.
–Xmx<value>m The Java heap setting

Example: –Xmx512m

IBM® Java Runtime Environment flag Decrease the value for this parameter in the product configuration files to enable Rational Publishing Engine to start on virtual machines.

Increase the value to improve performance when generating large documents in other environments, not virtual machines.

–Xmx is a standard Java parameter that is not unique to Rational Publishing Engine.

Document Studio

Procedure

  1. Open the configuration file for the Document Studio application with a text editor. The default location of the configuration file is: %RPE_HOME%\studio\rpe-studio.ini
  2. Add the flag and the value to the end of the file. Use a semicolon to separate multiple values. Example:
    -Dcom.ibm.rational.rpe.doors.home=C:\Program
    Files (x86)\IBM\Rational\DOORS\9.5\bin\doors.exe
  3. Save the changes.

Launcher

Procedure

  1. Open the configuration file for the Launcher application with a text editor. The default location of the configuration file is: %RPE_HOME%\launcher\rpe-launcher.ini
  2. Add the flag and the value to the end of the file. Use a semicolon to separate multiple values. Example:
    -Dcom.ibm.rational.rpe.doors.home=C:\Program
    Files (x86)\IBM\Rational\DOORS\9.5\bin\doors.exe
  3. Save the changes.

Feedback