Configuring enhanced logging for Rational DOORS Web Access reporting

To set up enhanced logging for Rational® DOORS® Web Access reporting, you must create a log file and add a command to server.start.bat.

Procedure

  1. Create a file called log4j.properties that contains commands like this example:
    log4j.rootLogger=WARN, R
    log4j.appender.R=org.apache.log4j.RollingFileAppender
    log4j.appender.R.File=c:/DWA/translation_layer.log
    log4j.appender.R.MaxFileSize=300KB
    log4j.appender.R.MaxBackupIndex=5
    log4j.appender.R.layout=org.apache.log4j.PatternLayout
    log4j.appender.R.layout.ConversionPattern=%d{ABSOLUTE} [%t] %5p %-50.50c  - %m%n
    log4j.logger.com.ibm.rational.doors=DEBUG
  2. Save the file as DWAInstallDir/server/conf/log4j.properties
    Important: You must save the file in the conf directory.
  3. Edit the server.start.bat file. Open the file and add a line like this example:
    set JAVA_OPTS=%JAVA_OPTS% -Dlog4j.configuration="file:///c:/DWA/server/conf/log4j.properties"
    Important: When you add the line to the server.start.bat file, you must make sure that you add it before the call ".\startup.bat" line.
  4. Restart the Rational DOORS Web Access server.

Results

The logging information is output to the file specified in the log4j.properties file. In this example, the log file is called c:/DWA/translation_layer.log.

Feedback