IBM Support Assistant Lite for Rational ClearCase v7.0

This package contains the following data collection options:

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

Prerequisites

Downloading and Launching ISA Lite

Using ISA Lite

Collector Details

Data Collector Completion Options & Uploads

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

1. Download ISA Lite for Rational ClearCase V7.0 from: https://www.ibm.com/services/forms/preLogin.do?source=swg-isalite&S_PKG=isal131rcc
2. Extract the .zip file in a folder.
   • If your platform does not have unzip utility, you can use jar to unzip file: jar xf ISALiteforRationalClearCase_7.0_20091014.zip
3. In the same folder, cd ISALite

Windows:
1. If Java is available in your path , simply run: runISALite.bat
2. If Java is not available on your path, you'll need to set JAVA_HOME first:
   • set JAVA_HOME=<your full path to Java> This path should point to the bin directory in your Java installation, containing java.exe. No quotes.
   • Example: set JAVA_HOME=C:\Program Files\IBM\RationalSDLC\common\JAVA5.0\jre
   • Once this is completed, run: runISALite.bat

Linux / Unix
1. If Java is not available on your path, you'll need to set JAVA_HOME first:
   • In ksh: export JAVA_HOME=<your full path to Java> This path should point to the bin directory in your Java installation, containing java
   • Example: export JAVA_HOME=/opt/rational/common/java/jre
2. You may need to execute: chmod a+x *.sh to ensure .sh files in ISALite folder can be executed.
3. If you are running in a desktop environment: ./runISALite.sh
4. If you are running in a console / terminal environment: ./runISALiteConsole.sh

Back to top

1. Select a data collector to run.
2. Fill in the Output Filename field.
3. Click the Collect Data button to start data collection.
4. When finished, simply close the window.

Back to top

Collector Details

These are the same set of data collectors for collecting general ClearCase issues.

Full Collector - Full System and CC data collection
Use this collector to gather general ClearCase and system information, including WinMSD (if windows), or full lsview / lsvob. 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.
• Detailed description: ClearCase General Collector - Full

Quick Collector - System and CC data collection
Use this collector to gather general ClearCase and system information. This includes slightly less information than the Full collector. 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.

• Detailed description: ClearCase General Collector - Quick

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

• Detailed description: WinMSD Collector

Back to top

Data Collector Completion Options & Uploads

When the collector is completed, it will request feedback about ISA. 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 (unencrypted). 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 (unencrypted) 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.