Extracting Rational DOORS data with DXL security settings

You can extract data from Rational® DOORS® 9.3 running in secure mode. When run 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. Determine Addins path Batch files path:
    1. Open Rational DOORS.
    2. Right-click DOORS Database and click Properties.
    3. In the Properties window, select DXL Securities page.
  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. Issue the msiexec.exe /i ratlPublishingEngine_RPEn.n_Windows.msi/qn INSTALLDIR=“install dir" LAPAGREE="Yes" RPE_DXLLOCATION=“TRUSTED DXL LOCATION PATH" command to specify the RPE_DXLLOCATION.
    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 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 msi>" /qn INSTALLDIR=“<install dir>" LAPAGREE="Yes" RPE_DXLLOCATION="<TRUSTED DXL LOCATION PATH>"
  • The <TRUSTED DXL LOCATION PATH>
    • Example: \\Arakis\DOORS\trusted_dxl
    • Must be the same path as the one in the DOORS DB properties.
    • Must be an absolute path ( cannot contain system variables). Example of bad value: %DOORS_SERVER%\DOORS\trusted_dxl where DOORS_SERVER = \\Arakis
    • Must be an UNC path. It cannot be a mapped drive letter as drive mappings are user specific and will not work 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 “\”

What to do next

Custom installation for DOORS 9.3 in Secure Mode
  1. On the server, copy the Source subfolder from the Rational Publishing Engine installation folder in one of the Addins Path locations specified in DOORS DB – DXL security property. As Rational Publishing Engine references the included files using relative paths, the DOORS DXL runtime will be able to 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 DOORS DB – DXL security property. The folder structure must be preserved. The source folder cannot be renamed.
  3. Define the RPE_DXLLOCATION (double L) variable to point to the Batch files path value. Rational Publishing Engine will use this location as the startup location for its DXLs instead of the default RPE_HOME. This value can be set through the Rational Publishing Engine silent installer.
    Edit system variable window

Feedback