Manual collection of ClearCase logs and diagnostic data on UNIX
How can you manually collect IBM® Rational® ClearCase® logs and diagnostic data on UNIX® and Linux® to assist IBM Rational Client Support?
Review technote 1208895 for a utility to automate the collection of ClearCase logs and diagnostic data on Linux, AIX®, HP-UX® and Solaris®.
The manual method below was created for sites that are not allowed to run scripts on their servers.
Please send this information through ESR when submitting a new PMR.
Name of Utility: clearbug
Found in: /usr/atria/bin or /opt/rational/clearcase/bin
What does it do? Clearbug collects various pieces of information that assist Rational Support in gathering diagnostic data of your problematic environment.
On UNIX, this information includes:
- uname -a
- cleartool describe vob:/vob/tag
- Shows the contents of the view information file (cat /net/hostname/tmp/data_collection_vu.vws/.view)
- Collect the mount information (mount)
- Active VOBs in the region (cleartool lsvob)
- dmesg | tail -60
How to execute:
1. From the command line, set to a view and cd to a VOB.
Note: This is a bit different then how it is done on Windows, because the clearbug utility on UNIX collects information specific to a VOB and view combination.
2. Execute clearbug and follow the instructions that clearbug prompts.
Note: To suppress detailed instructions, use clearbug -short.
Found in: /var/adm/atria/log or /var/adm/rational/clearcase/logs
How to collect logs: The best way to collect the logs on UNIX, is to tar and zip the log directory.
1. Change directory to the location of the logs dir (see above).
2. Issue the tar command as follows: tar cvf log.tar log
Note: "Tarring" the log directory, places the entire contents of the ClearCase logs into one file. This allows Rational Support to see all applicable logs at once.
3. Compress (zip) the logs directory.
Example: gzip log.tar
Note: Use which ever compression utility you have available to you.
|Software Development||Rational ClearCase||Utilities and Tools|
More support for:
Utilities and Tools
Software version: 8.0, 8.0.1, 9.0
Operating system(s): AIX, HP-UX, IRIX, Linux, Solaris
Reference #: 1197528
Modified date: 12 November 2009