Setting virtual machine parameters

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

About this task

Table 1. Runtime 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

You can include this flag to enable Rational Publishing Engine to identify your Rational DOORS database. 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.
-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

You can include this flag to enable Rational Publishing Engine to identify your Rational DOORS version. 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.
-Dosgi.configuration.area A filepath

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

To change the default output location of your document generations, you can change the filepath for this parameter. Specify the same value for the -Dosgi.instance.area and -Dosgi.configuration.area parameters.
-Dosgi.instance.area A filepath

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

To change the default output location of your document generations, you can change the filepath 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

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