Extracting Rational DOORS data with DXL security settings

You can extract data from Rational® DOORS® running in secure mode. When running in secure mode, Rational DOORS limits DXL access. If the trusted DXL is not defined in Rational DOORS, no additional tasks need to be performed in Rational Publishing Engine. If the trusted DXL setting is defined, you must configure Rational Publishing Engine to work with Rational DOORS.

Procedure

  1. In your Rational DOORS installation, locate the paths to the Addins and Batch files directories:
    1. Open Rational DOORS.
    2. Right-click DOORS Database and click Properties.
    3. In the Properties window, select DXL Securities.
  2. Copy the source subfolder from Rational Publishing Engine installation path to the Rational DOORS Addins path.
  3. Copy the source subfolder from Rational Publishing Engine installation path to the Rational DOORS Batch files path.
  4. Specify the RPE_DXLLOCATION by running the following command: msiexec.exe /i "path_to_\ratlPublishingEngine_version_Windows.msi" /qn INSTALLDIR=“install_dir" LAPAGREE="Yes" RPE_DXLLOCATION=“TRUSTED_DXL_LOCATION_PATH"
    Note: Specify a full UNC path to the TRUSTED DXL LOCATION PATH variable. Paths using mapped drive names cannot be used as they are user-specific drives and might not be available to all users.

Example

Silent installer example for Rational Publishing Engine 1.1.1.2:
msiexec.exe /i "path_to_\ratlPublishingEngine_1.1.2.2_Windows.msi" /qn INSTALLDIR=“install dir" LAPAGREE="Yes" RPE_DXLLOCATION="TRUSTED_DXL_LOCATION_PATH"
  • About the TRUSTED_DXL_LOCATION_PATH:
    • Example: \\Arakis\DOORS\trusted_dxl
    • Must be the same path as the one in the Rational DOORS database properties.
    • Must be an absolute path and cannot contain system variables. Example of bad value: %DOORS_SERVER%\DOORS\trusted_dxl where DOORS_SERVER is \\Arakis
    • Must be an UNC path. The path cannot be a mapped drive letter as drive mappings are user-specific drives and might not be accessible from all user accounts, including the Local System account used by NT Services, such as the Tomcat service. Example of bad value: Z:\trusted_dxl where Z: = \\Arakis\DOORS
    • The path must not end with a backslash (\).

What to do next

Custom installation for Rational DOORS in Secure Mode:
  1. On the server, copy the Source subfolder from the Rational Publishing Engine installation folder into one of the Addins Path locations specified in DOORS DB – DXL security property. Because Rational Publishing Engine references the included files using relative paths, the Rational DOORS DXL runtime can retrieve them. The folder structure must be preserved. The Source folder cannot be renamed.
  2. On the server, copy the Source subfolder from the Rational Publishing Engine installation folder in the location specified by Batch files path property in Rational DOORS database – DXL security property. The folder structure must be preserved. The Source folder cannot be renamed.
  3. Define the RPE_DXLLOCATION variable to point to the Batch files path. Rational Publishing Engine uses this location as the startup location for the DXLs instead of the default RPE_HOME. This value can be set through the Rational Publishing Engine silent installer.
    Edit system variable window

Feedback