Skip to main content

Software  >  Rational  >  

Utility to collect ClearCase logs and diagnostic data on Linux, AIX, HP-UX and Solaris

 Technote (FAQ)
 
Question
Is there a way to collect IBM® Rational® ClearCase® logs and diagnostic data on Linux®, AIX®, HP-UX® and Solaris® to assist Technical Support?
 
Answer

See Change History for updates.

This is a new updated version of SCT (version 4).

The System Collection Tool (SCT) is designed to gather customer information on a system in order to start the preliminary troubleshooting process. It gathers system, network, hardware, and ClearCase information, including logs and configuration files. The tool outputs the information into segregated files for easy analysis and review. The SCT tool also is bundled with the System Collection Script (SCS) script used for escalated issues to engineering, performance analysis, and additional system information that the SCT tool may not collect.

Compatible operating systems include:

Solaris 6/7/8/9/10*
HP-UX 10.20/11.11/11.23
AIX 4.3.3/5/5.1/5.2/5.3
Red Hat Linux 7.2-9/Enterprise Server 2.1/3/4
SUSE Enterprise server 8/9


Update: SCT Integration into ISA

The SCT tool (along with SCS) is also included now with the Rational ClearCase 7.0 product plug-in, for IBM Support Assistant (ISA) V3.x.

ClearCase 7.0 plug-in for ISA allows you to:
  • Quickly access all the information about ClearCase and search through all IBM technical resources

  • Collect general system information needed for initial troubleshooting.

  • Collect all the initial ClearCase data needed for specific problem diagnostic and analysis. For UNIX
    platforms, it leverages the SCT tool to enable the data collection capability.

  • Open and manage problem reports using ESR interface.

  • ISA V3.1 - Automatically be notified for changes and updates.

For more information about the functionality of ISA , including where to get a copy, visit the IBM Support Assistant V3.x page.



Please send this information through ESR when submitting a new PMR.

The attached shell script will collect some preliminary information about your environment to assist the technical support team in troubleshooting your issue.


SCTv4.tar.gz


The script will collect the following information:
  1. OS system, version information, I/O data, and software packages installed

  2. System error messages

    Note: Error output is generated from the kernel at boot time; it shows the devices the kernel has found and if it has been able to configure them at all - aside from user configurations, as well as logging any system errors during up-time.

  3. ClearCase/MultiSite version and environment information

  4. ClearCase, MultiSite, RWP, Samba logs

  5. Network information

    Note: The SCTv4.tar.gz file includes a readme document (SCTv4_readme.txt). This file details what the tool is collecting (referencing the commands, description, and location) and segregates the data by operating system and product.



Usage Instructions:

1. Make a new directory in /tmp: (i.e. /tmp/ibm)

2. Copy the script below to local filesystem (i.e. /tmp/ibm), and login as root


3. Gunzip and untar the SCTv4.tar.gz file to extract the SCT tool and scs script file

gunzip SCTv4   tar -xvf SCTv4.tar


4. Add the appropriate permissions to execute, if needed

chmod 755 SCTv4, chmod 755 scs


5. Execute the script to gather system and ClearCase information to send to support

./SCTv4


Note: There are two new options

-d
Disables the -long options to any of the cleartool commands

-t <TEMP Directory>

Specifies a new Temporary Directory for the SCTv4 collection:  If this option is used, the tar.gz file will be located within this directory.


6. Send the generated file to Rational support that is located within the /tmp directory.

The filename of the archive that will be generated after executing the SCTv4 script will be in the form of:

<hostname>.<OS>.tar.gz

Example:

host1.AIX.tar.Z
host2.SunOS.tar.gz
host3.HP-UX.tar.gz
host4.Linux.tar.gz


Upon completion of script, the display will show the pathname and output file.
Note: If the -t option was used, the tar.gz will be located within the specified directory.

Review the comments in the SCT script for more details, or reference the SCTv4_readme.txt file.

**MUST BE root TO RUN TOOL


Change History
02 Nov 2009Updated SCT version to 4 - includes updates to collect ClearCase 7.1 data
19 May 2008Added step 1 to usage instructions
23 December 2008Updated SCT version to 3
27 August 2007Added ISA information
25 July 2007Added error when SCT is run on 7.0.1
11 June 2007Updated SCT version to 2.1


Do you need more help?

For additional assistance, contact IBM Rational Client Support:
Submit a Service Request (SR)

 
Related information
IBM Support Assistant V3.0
Data Collection Utilities for Windows
Manual Data Collection on UNIX and Linux
 
 
Cross Reference information
Segment Product Component Platform Version Edition
Software DevelopmentRational ClearCase LTUtilities and Tools
 
 

Copyright and trademark information
IBM, the IBM logo and ibm.com are trademarks of International Business Machines Corp., registered in many jurisdictions worldwide. Other product and service names might be trademarks of IBM or other companies. A current list of IBM trademarks is available on the Web at "Copyright and trademark information" at www.ibm.com/legal/copytrade.shtml.
Rate this page
Please take a moment to complete this form to help us better serve you.
This material provides me with the information I need.




This material is clear and easy to understand.




Did the information help you to achieve your goal?
What updates, improvements, or related information would you like to see in this document?
Your response will be used to improve our document content. Requests for assistance, if applicable, should be submitted through your normal support channel as we cannot respond from this site.
Input the verification number to submit feedback:
Document information
 Product categories:
 Software
 Software Development
 Change, Configuration, & Release Management
 Rational ClearCase
 Utilities and Tools
 Operating system(s):
  AIX, HP-UX, Linux, Solaris
 Software version:
  7.0, 7.0.0.1, 7.0.0.2, 7.0.0.3, 7.0.0.4, 7.0.0.5, 7.0.0.6, 7.0.0.7, 7.0.0.8, 7.0.1, 7.0.1.1, 7.0.1.2, 7.0.1.3, 7.0.1.4, 7.0.1.5, 7.0.1.6, 7.0.1.7, 7.1, 7.1.0.1, 7.1.0.2, 2003.06.00
 Reference #:
  1208895
 IBM Group:
 Software Group
 Modified date:
 2009-11-09

Translate My Page
 
 

Rate this page

Help us improve this page. Your response will be used to improve our document content. Requests for assistance, if applicable, should be submitted through your normal support channel as we cannot respond from this site.