Is there a way to collect IBM Rational ClearCase logs and diagnostic data on Linux, AIX, HP-UX and Solaris to assist Technical Support?
See Change History for updates.
This is a new updated version of SCT (version 5).
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.
The instructions documented in this technote are expected to work on any of the supported platforms that are listed in the ClearCase System Requirements documents. For Ubuntu, the Korn shell will need to be installed before running the tool.
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 page.
The attached shell script will collect some preliminary information about your environment to assist the technical support team in troubleshooting your issue.
Download script file here: ---> SCTv5.tar
The script will collect the following information:
- OS system, version information, I/O data, and software packages installed
- 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.
- ClearCase/MultiSite version and environment information
- ClearCase, MultiSite, RWP, Samba logs
- Network information
Note: The SCTv5.tar file includes a readme document (SCTv5_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.
1. Make a new directory in /tmp: (/tmp/ibm)
2. Copy the script below to local filesystem (i.e. /tmp/ibm), and login as root
3. Untar the SCTv5.tar file to extract the SCT tool and scs script file
tar -xvf SCTv5.tar
4. Add the appropriate permissions to execute, if needed
chmod 755 SCTv5 , chmod 755 scs
5. Execute the script to gather system and ClearCase information to send to support
Note: There are two new options
Disables the -long options to any of the cleartool commands
-t <TEMP Directory>
Specifies a new Temporary Directory for the SCTv5 collection. If this option is used, the tar 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 SCTv5 script will be in the form of:
Upon completion of the 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 SCTv5_readme.txt file.
**MUST BE root TO RUN TOOL
|Software Development||Rational ClearCase||Utilities and Tools|
Rate this page:
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.