How do you enable IBM Rational DOORS Database logging?
None of the DOORS administration tools have a logging option.
IBM Rational DOORS logging has 6 levels; Level 1 is the most terse and 6 the most verbose. Here are the log level details:
- Level 1: Report connections, disconnections, and problem packets.
- Level 2: Report connections, disconnections, and packet types.
- Level 3: As Level 2, plus packet arguments (compact format).
- Level 4: As Level 3, but with packet arguments in verbose format.
- Level 5: Only logs data cache operations.
- Level 6: Logs messages as in Level 4 plus Level 5.
You may also check login_history file to check log in history under $DOORSHOME$\data\v6data\logs (example: C:\Program Files\IBM\Rational\DOORS\9.x\data\v6data\logs)
To help identify an unspecified error you can start logging at level 6 to capture all activity.
Once database logging has been enabled and you reproduce the behavior send the generated log file to Rational Client Support.
IMPORTANT: Ensure you disable database logging after the issue has been reproduced since this overhead may impact the performance.
For Microsoft Windows:
This solution contains information about modifying the system registry. Before making any modifications to the Microsoft Registry Editor, it is strongly recommended that you make a backup of the existing registry. For more information describing how to back up the registry, refer to Microsoft Knowledge Base article 256986
- Click Start > Run > type regedit to open the registry editor on the server
- Navigate to the following key:
for 32-bit Operating System:
for 64-bit Operating System:
- Create a new string value called logfile
- Modify the string value and set its data value to the log file location
For example c:\doorslog.txt
- Create a new string value called loglevel
- Modify the string value and set its data value to: 6
- Restart the Rational DOORS Database Server
Note: All users need to be logged out of DOORS before attempting to restart the server
For UNIX and Linux:
Start the DOORS Database Server with the following options:
doorsd -p "port number" -L "log level" -l "path to log file"
Where <port number> is the DOORS Database port number and the path to the log file includes the file name.
For example: doorsd -p 36677 -L 6 -l /usr1/logs/DOORSusers.log