Extracting Rational DOORS data with DXL security settings

You can extract data from Rational® DOORS® running in secure mode. When Rational DOORS runs in secure mode, DXL scripts and some included files are restricted. If the trusted DXL is not defined in Rational DOORS, no additional tasks must be performed for Rational Publishing Engine to access files for generating reports from Rational DOORS data. If the trusted DXL setting is defined, you must configure Rational Publishing Engine to work with Rational DOORS.

DXL scripts are files that are created in the temporary directory for the user to configure the DXL execution. The information stored here is what is extracted from Rational DOORS, including module paths, view names, baseline versions, and names of the attributes. The Rational Publishing Engine installer deploys its own DXLs and compiles an XML file that provides run time details to the DXL environment. The path to this XML file is set in a system variable. This task provides you with the steps to configure the system variable with the path.

About this task

About the trusted DXL location:
  • Defined through the RPE_DXLLOCATION system variable
  • 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 (\)

Procedure

  1. In your Rational DOORS installation, locate the paths to the Add-ins and Batch files directories:
    1. Open Rational DOORS.
    2. Right-click DOORS Database and click Properties.
    3. In the Properties window, select DXL Securities.
    4. Note the path values for the Add-ins path and Batch files path fields.
  2. Copy the RPE_HOME\source directory.
  3. Paste the source directory into the Rational DOORS add-ins directory. Because Rational Publishing Engine references the included files using relative paths, the Rational DOORS DXL run time can retrieve them. The folder structure must be preserved. The source directory cannot be renamed.
  4. Paste the source directory into the Rational DOORS batch files directory. The folder structure must be preserved. The source folder cannot be renamed.
  5. 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.
    Note: Specify a full UNC path for the trusted DXL location. Paths using mapped drive names cannot be used as they are user-specific drives and might not be available to all users.

Feedback