MustGather: ClearQuest Web 8.0.x Server
What steps can you follow to gather additional information for IBM Rational ClearQuest Support in resolving issues with the ClearQuest Web 8.0.x?
Default Installation Locations
|These are the default installation directories for Rational home and Rational common components.
If you are using a non-default installation path, keep that in mind when reviewing these instructions.
RATIONAL_COMMON refers to the location where common components are installed.
Note: On some UNIX operating systems, the path might have a lowercase "ibm" directory. You can also access the Rational home and common directories using these symbolic paths:
Basic Verification Information
|Note: With steps 2 through 5, if you do not receive the expected verification that the software is running correctly, take a screenshot or save the message to file for IBM Support.
Gathering Diagnostic Logs for ClearQuest Web on Microsoft Windows
NOTE: If you are on ClearQuest 18.104.22.168 and later versions, you can enable, disable, and change ClearQuest Core trace setting dynamically without having to stop and restart the ClearQuest Web service. This is done by adding the Reset register key to the ClearQuest Core diagnostic keys. Here is an example of how to set it in the trace file:
Gathering Diagnostic Logs for ClearQuest Web on Linux or UNIX
ClearQuest Web Server Diagnostic Logging and Information
|These sections instruct you on how to prepare the diagnostic information for gathering along with the ClearQuest Web Server information. You should only follow these instructions at the request and guidance of a ClearQuest Support Engineer.
You can configure the ClearQuest Web Server using a variety of different variables called MBean attributes. When experiencing problems with the ClearQuest Web Server, it is worth verifying that these attributes are correctly established. Incorrect attribute values can cause problems with the starting or stability of the server processes.
You can send IBM Rational Support a summary of your custom MBean configuration settings with these instructions:
More information on proper MBean configuration
You can find more information about this in these documents:
These are the steps for increasing the logging level detail on the ClearQuest Web Server. By changing the logging level, you are increasing the trace output and diagnostic information in the ClearQuest Web Server logs. With these instructions, you will also verify that file count and file size of these logs is sufficient for reproducing a problem during a trace.
Increasing the diagnostic detail can affect system performance. This should only be done for short periods of time. Be sure to restore logging to original settings when such detail is not needed.
These are the steps for restoring the logging levels of the ClearQuest Web Server to their original state.
More support for:
Software version: 8.0, 22.214.171.124, 126.96.36.199, 188.8.131.52, 184.108.40.206, 220.127.116.11, 18.104.22.168, 22.214.171.124, 126.96.36.199, 188.8.131.52, 8.0.1, 184.108.40.206, 220.127.116.11
Operating system(s): AIX, Linux, Solaris, Windows
Reference #: 1638434
Modified date: 06 April 2015