IBM Support

How to increase Rational DOORS Web Access logging levels

Technote (FAQ)


Question

How do you increase the IBM Rational DOORS Web Access logging levels?

Cause

To gather more information for troubleshooting the IBM Rational DOORS Web Access server installation, you need to modify your server configuration files.

Answer

The procedure to increase the IBM Rational DOORS Web Access (DWA) logging levels varies by DWA version.

For DWA 1.4.0.4 and later:

To increase the logging levels, follow the instructions in the following file:
DWA_INSTALL_DIR/server/festival/config/festival-log4j.xml.support

This file contains instructions for enabling debug logging for the DWA server. It also refers you to the file containing instructions to enable debug logging for the DWA broker.

For DWA 1.4.0.0 - 1.4.0.3:

To increase the logging levels:

  1. Update Broker logging:
    Edit DWA_INSTALL_DIR\broker\conf\log4j.properties and set the rootLogger to:
    log4j.rootLogger=DEBUG, console, logfile

  2. Update Tomcat logging:
    1. Edit DWA_INSTALL_DIR\server\common\classes\log4j.properties and set the rootLogger to:
      log4j.rootLogger=DEBUG, console, logfile

    2. Add these 2 lines to the bottom of the Tomcat log4j.properties file (the file you are currently editing):
      log4j.logger.org.apache.commons.digester.Digester=INFO,logfile,console
      log4j.logger.org.apache.catalina.loader.WebappClassLoader=INFO,logfile,console


  3. Update Rational DOORS Web Access logging:
    Edit DWA_INSTALL_DIR\server\festival\config\festival-log4j.xml and set the priority value from INFO to DEBUG. You may also choose to increase MaxFileSize to something larger than 10 MB.

  4. Stop Rational DOORS Web Access.

  5. You may want to delete the old log files (or move them out of the way). The files are located at:
    DWA_INSTALL_DIR\server\logs
    DWA_INSTALL_DIR\server\festival\logs
    DWA_INSTALL_DIR\broker\data\activemq.log


  6. Start Rational DOORS Web Access.

If you also need to enable Interoperation Server logging, please refer to Tech Note #1397464.

NOTE:
Increasing the logging levels may impact performance.


Cross reference information
Segment Product Component Platform Version Edition
Rational DOORS

Document information

More support for: Rational DOORS
Installation

Software version: 1.4, 1.4.0.1, 1.4.0.2, 1.4.0.3, 1.4.0.4, 1.4.0.5, 1.5, 1.5.0.1, 9.5, 9.5.0.1, 9.5.1, 9.5.1.1, 9.5.1.2, 9.5.2

Operating system(s): Linux, Solaris, Windows

Reference #: 1456938

Modified date: 06 August 2012