Question & Answer
Question
What information and diagnostic trace logging can be gathered for troubleshooting e-mail related issues in IBM Rational ClearQuest in both Microsoft Windows and UNIX-based environments?
Answer
- Click on the category to view more information.
Can the SMTP or MAPI server be pinged from the problem machine? Run the following from the command line:
ping myMailServer If using SMTP, does a Telnet to port 25 of the mail server work on the problem machine? Run the following from the command line: telnet myMailServer 25 helo |
Diagnostic Tracing instructions for Microsoft Windows Environments
Windows Registry keys can be set to enable the tracing and gathering of diagnostic information for troubleshooting problems on the native ClearQuest client and ClearQuest web. You can create a .reg file to set up these keys. Copy the following lines for your ClearQuest product into a text editor and save the file with a ".reg" extension. This file can then be run to enable diagnostic tracing. Note: The ClearQuest client, Mail Reader, and Web services need to be restarted after the registry settings have been set. Once diagnostic tracing is enabled, perform the actions to reproduce the issue you are experiencing. Review the log file for output that indicates the source of the problem.
Make sure you disable the trace values when diagnostics are complete. Failure to do so can have a negative impact on system performance, and cause large text files to be created.
* Note: If the Mail Reader service is running as a user account instead of Local System, you must log into Windows as that user and use the same registry keys as the ClearQuest Windows and Eclipse clients. |
Diagnostic Tracing instructions for UNIX and Linux Environments
The following is instructions on how to enable e-mail diagnostic tracing on UNIX-based platforms. Note that Visual Basic-based trace values are not used, as BASIC scripts are not executed in UNIX-based environments. Note: Make sure users disable the trace values when diagnostics are complete. Failure to do so can have a negative impact on system performance, and cause large text files to be created. Enabling e-mail diagnostic tracing on ClearQuest UNIX-based workstations running the native UNIX or RCP Eclipse clients: ClearQuest UNIX client tracing is dependent upon a series of environment variables. Create these environment variables for e-mail diagnostic tracing. The following commands assume that users are working in the c-shell (csh): setenv CQ_DIAG_TRACE "API;DB_CONNECT=2;DB_MISC;EMAIL;HOOKS=2;PERL;THROW;SQL=2" setenv CQ_DIAG_REPORT "MESSAGE_INFO=0x070B;DIAG_FLAGS=-1" setenv CQ_DIAG_OUTPUT "/export/home/username/cq_diagnostics.log" When diagnostic tracing is completed, turning off tracing by running the following commands from a system prompt:
The following statements would be used for the bash shell:
export CQ_DIAG_TRACE="API;DB_CONNECT=2;DB_MISC;EMAIL;HOOKS=2;PERL;THROW;SQL=2" export CQ_DIAG_REPORT="MESSAGE_INFO=0x070B;DIAG_FLAGS=-1" export CQ_DIAG_OUTPUT="/export/home/username/cq_diagnostics.log" unset CQ_DIAG_TRACE unset CQ_DIAG_OUTPUT Enable e-mail diagnostic tracing on ClearQuest Web 2003 UNIX-based servers running the Request Manager:
Enabling e-mail diagnostic tracing on ClearQuest Web 7.0.x UNIX-based servers
Enabling e-mail diagnostic tracing on ClearQuest Web 7.1.x UNIX-based servers
|
Parameters and values used for tracing
Trace: A semi-colon separated list of what we want to trace. For example:
Report: A semi-colon separated list of what we want to report. For example:
|
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 |
---|
Was this topic helpful?
Document Information
Modified date:
16 June 2018
UID
swg21231445