Configuring enhanced logging for DWA reporting

To set up enhanced logging for IBM® Engineering Requirements Management DOORS® - Web Access (DWA) 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 DWA 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