Enabling application message logs in DOORS

You can enable application message logs in the IBM® Engineering Requirements Management DOORS® (DOORS) server and client to diagnose unexpected behavior.

Procedure

  1. In the DOORS installation, edit the .xml configuration file.
    By default, those files are in the root path for the DOORS client and server installations.
    • Server example: C:\Program Files (x86)\IBM\Rational\DOORS\9.7\logging-config.xml
    • Client example: C:\Program Files\IBM\Rational\DOORS\9.7\logging-config-client.xml
  2. Replace the ${LOG_FOLDER_LOCATION} value of the file appender with an accessible path. For example:
    <param name="file" value="c:\IBM\DOORS\log\SystemTrace.log" \>
  3. Start the component by using the -logxconfig command-line switch.
    Note: When you start the component on a Windows computer, instead of using command-line parameters to enable application message logging, you can enable it by creating a registry key. The key is named logxconfig and it uses the value of the component .xml configuration file.
    1. To enable application message logs for the server, start the DOORS database server by using the -logxconfig logging_file_name command-line switch. Be sure to include -debug. For example,
      C:\Program Files\IBM\Rational\DOORS\9.version\doorsd -debug -logxconfig logging-config.xml
    2. To enable application message logs for the client, start the DOORS client by using the -logxconfig logging_file_name command-line switch. For example,
      C:\Program Files\IBM\Rational\DOORS\9.6\doors -logxconfig logging-config-client.xml

Feedback