Rational ClearCase General data collectors available through IBM Support Assistant and IBM Support Assistant Lite

• Rational ClearCase v7.0
• Rational ClearCase v7.1

The set of collectors available are:

• ClearCase General Collector - Full or Full Collector
• ClearCase General Collector - Quick or Quick Collector
• WinMSD Collector (Windows)

Details of what is collected as well as collector walk through is shown below.

Prerequisites / Installation

Detail: ClearCase General Collector - Full

Detail: ClearCase General Collector - Quick

Detail: WinMSD Collector (Windows)

Data Collector Completion Options & Uploads

Prerequisites / Installation

These collectors are available as part of IBM Support Assistant Workbench and IBM Support Assistant Lite in the above listing of Rational products.

IBM Support Assistant

IBM Support Assistant (ISA) is a full serviceability workbench that can increases your capacity for self-help by making it easier to access support resources. This includes product information, tools and capability for automated data collection. For more information, see: Features and benefits of IBM Support Assistant.

Prerequisites
• You'll need IBM Support Assistant Workbench v4.1.x or higher for this collector to be available.
• If you do not have ISA workbench available, you need an IBM ID and password to download ISA workbench. Register here if you do not already have one.
• A copy of ISA workbench is available for download from the Serviceability Workbench Section in the ISA download page .

Install Add-on
• Launch ISA workbench. Use the Update > Find New... > Product Add-on to select one of the products listed above.
• Once you have the product add-on installed, select Collect and Send Data to select and run the available data collectors.

IBM Support Assistant Lite

IBM Support Assistant Lite (ISA Lite) is the customized subset of the ISA workbench that provides only the automated data collection capability. If you do not have ISA workbench installed and need to provide information for our support team, you can use this to quickly gather information. For more information, see: Overview of IBM Support Assistant Lite

Prerequisites:
• You need an IBM ID and password to download ISA Lite. Register here if you do not already have one.
• You need Java JRE 1.4.2 or greater on your machine to run ISA Lite

Download & Launching ISA Lite:
1. You can download ISA Lite for the product listed above the Quick Data Collection Section in the ISA download page.
2. Extract the .zip file in a folder.
3. In the same folder, cd ISALite
4. If Java is available in your path , simply run: runISALite.bat or runISALite.sh
5. If Java is not available on your path, you'll need to set JAVA_HOME first.
   • Windows: set JAVA_HOME=<your full path to Java> This path should point to the bin directory in your Java installation, containing java.exe.
   • Linux/Unix (in ksh): export JAVA_HOME=<your full path to Java>. This path should point to the bin directory in your Java installation, containing java

ClearCase General Collector - Full

Use this collector to gather general ClearCase and system information. Its recommended that you run this with administrator privileges. This will enable files to be collected that may not be accessible by regular account. Error can occur due to inability to gather restricted files.

Data Collected:

Windows:

	File	Description
/
	collectSystemOutput.txt	System information Windows: date /t, time /t , ver , hostname, mem , mode , net accounts, net config, net start, java -version
	collectNetworkOutput.txt	Network information Windows: ipconfig, netstat -an, net session, net share, net statistics , net statistics Server , net statistics Workstation, net use, net user, nbtstat -n, nbtstat -r, nbtstat -s, nbtstat -S
	environment.set.txt	User environment information Windows: set
	registry.*	User Environment. Windows Registry export of various registry keys.
	getWindowsHeapSize.txt	Windows: Heapsize registry information from: [HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Session Manager\SubSystems\Windows]
	winMSD_full.nfo	WinMSD information. This is available for full collection only.
/clearcase_info	*.*	Base ClearCase Information
/network_info	*.*	Folder containing system network information
/system_info	*.*	Folder containing system information such as event logs, environment, etc.
/FlexLM	*.*	Folder containing Flex/LM information about the system.
/IM	*.*	Folder containing information about Installation Manager (if available)

Linux/UNIX:

	File	Description
/
	BuildInfo.txt	Information relating to Clearcase build.
	SCS.txt	Base ClearCase information and some system information.
	<platform>.txt	System information about the platform. This include base clearcae info, network, env, process, df , cpuinfo, etc.
	*.txt	Additional information. Each file will indicate which command it has executed.
	lsview.txt	File containing cleartool lsview with -long option for full view registry data.
	lsvob.txt	File containing cleartool lsvob with -long option for expanded VOB data.
/ClearCase_config	*.*	Files from /var/adm/rational/clearcase/config
/ClearCase_logs	*.*	Files from /var/adm/rational/clearcase/log
/etc	*.*	Files from /etc that will assess in troubleshooting.
/FlexLM	*.*	Files containing Flex/LM information about the system.
/IHS or /rwp	*.*	Files containing information about Rational Web Platform. These files are extracted from : /opt/rational/common/IHS or /opt/rational/common/rwp .
/IM	*.*	IBM Installation Manager Information (if available). See above for more details.
/messages	*.*	Files containing system messages. These are: /var/adm/messages*
/syslog	*.*	(SunOS) Files containing system logs. These are: /var/log/syslog*
/samba	*.*	Files containing information about samba.

Detailed Walk Thru for "ClearCase General Collector - Full" Collector

Because information needed on Windows and Linux/Unix systems are different - a different panel is displayed to inform what is being collected.

Windows:

The collector will first inform you what it is going to collect. Click OK, to proceed

Back to top

ClearCase General Collector - Quick

Use this collector to gather general ClearCase and system information. Its recommended that you run this with administrator privileges. This will enable files to be collected that may not be accessible by regular account. Error can occur due to inability to gather restricted files.

Data Collected

This collector gathers almost the same data as "ClearCase General Collector - Full" with the following differences:

Windows:

This collector does not collect winMSD information, as this information may take some time to generate depending on your system.

Linux/UNIX:

This collector does not collect the expanded VOB and view registry data, as these information may take some time to generate depending on your configuration. It will run the -short version of the lsview and lsvob commands instead.

Detailed Walk Thru for "ClearCase General Collector - Full"

Because information needed on Windows and Linux/Unix systems are different - a different panel is displayed to inform what is being collected.

Windows:

The collector will first inform you what it is going to collect. Click OK, to proceed

Linux/Unix:

The collector will first inform you what it is going to collect. Click OK, to proceed


The collector will run to completion and request feedback and FTP options.

Please continue to Data Collector Completion Options & Uploads for additional information.

Back to top

WinMSD Collector

This is a Windows only data collector. Use this collector to gather WinMSD information on your system.

Data Collected

The collector will first inform you what it is going to collect. Click OK, to proceed

Back to top

Data Collector Completion Options & Uploads

When the collector is completed, it will request feedback about ISA or ISA Lite. Select Yes, to provide feedback. Select No to continue.

You'll also be provided with data upload options. This will allow you to send the collected data to IBM or another location via FTP or HTTPS.

IMPORTANT: To upload information to IBM, you'll need to have a PMR number. This is obtained when you work with our support team. If you do not have a PMR number, but do have support contract, you can leverage the Software Support page to open a service request and included the collected data with the service request.
IBM Service Request Page: https://www.ibm.com/support/servicerequest/

The upload options are:

• Send the Logs to IBM using secure transfer (HTTPS). You'll need an PMR number to transfer the data to IBM. This sends the collected data to IBM Support team through the HTTPS protocol.
• FTP the Logs to IBM Support (not encrypted). You'll need an PMR number to transfer the data to IBM. This sends the collected data to IBM Support team through the FTP protocol. This is a less secure option.
• FTP the Logs to a Different Location (not encrypted) This allows you to send the collected data to another location via FTP. You'll need to provide the target FTP location and appropriate authentication to access it.
• Do Not FTP the Logs. Do nothing.

When the collector completes, the .zip file is created at the location specified in Output File name. You can use any unzip tool to extract the files to examine the content of collected data.