IBM Support

Manual collection of ClearCase logs and diagnostic data on UNIX

Technote (FAQ)


Question

How can you manually collect IBM® Rational® ClearCase® logs and diagnostic data on UNIX® and Linux® to assist IBM Rational Client Support?

Answer


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.

CLEARBUG

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:
  • date
  • uname -a
  • id
  • 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
Note: Clearbug on UNIX does NOT collect the ClearCase logs. Even though clearbug will gather the last 60 lines of system generated logs, please review the next section to tar up the system logs for each machine clearbug is executed on to ensure that ALL system logging is collected and made available to IBM Rational Support.

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.



CLEARCASE LOGS

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.

Related information

Data Collection Utility for Windows
Data Collection Utility for UNIX and Linux

Cross reference information
Segment Product Component Platform Version Edition
Software Development Rational ClearCase Utilities and Tools

Document information

More support for: Rational ClearCase
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