Question & Answer
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 6).
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 separated 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 and later.
ClearCase 7.0.x and later 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: --->
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 SCTv6.tar file includes a readme document (SCTv61_readme.txt). This file details what the tool is collecting (referencing the commands, description, and location) and separates the data by operating system and product.
Usage Instructions:
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 SCTv61.tar.gz file to extract the SCT tool and scs script file
gzip -d < SCTv61.tar.gz | tar -xvf -
4. Add the appropriate permissions to execute, if needed
chmod 755 SCTv6, chmod 755 scs
5. Execute the script to gather system and ClearCase information to send to support
./SCTv6
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 SCTv6 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 SCTv6 script will be in the form of:
<hostname>.<OS>.tar.xx
Example:
host1.AIX.tar.Z
host2.SunOS.tar.gz
host3.HP-UX.tar.gz
host4.Linux.tar.gz
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 SCTv6_readme.txt file.
**MUST BE root TO RUN TOOL
Related Information
[{"Product":{"code":"SSSH27","label":"Rational ClearCase"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"Utilities and Tools","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF010","label":"HP-UX"},{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"}],"Version":"7.0;7.0.1;7.1;7.1.1;7.1.2;8.0;8.0.1","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}},{"Product":{"code":"SSSH27","label":"Rational ClearCase"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"Utilities and Tools","Platform":[{"code":"","label":""}],"Version":"","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]
Was this topic helpful?
Document Information
Modified date:
29 September 2018
UID
swg21208895