IBM Support Assistant Lite for Rational Common Licensing

News


Abstract

This document describes how to use the IBM Support Assistant Lite (ISA Lite) for Rational Common Licensing. ISALite is a tool that provides an automated way to gather initial troubleshooting data needed for the Rational support team to analyze problems.

Content

IBM Support Assistant Lite (ISALite) for Rational Common Licensing is a small, download-able package that allows you to automate data collection steps when data are requested by Rational support team. This particular package is specific to Rational Common Licensing product, as well as the products listed below. The tool will gather initial data needed for troubleshooting your problems with the product. Tool usage and what is collected are described below.





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
  • A valid JDK is generally available if you had Installation Manager, Jazz server or any Rational eclipse based product installed on your system. Some common locations:
    • <Installation Manager Install Location>\eclipse\jre_5.0.3.sr8a_20080811b\jre
    • <RationalSDLC location>\common\JAVA5\jre
    • <RationalSDLC location>\jdk\jre
Downloading and Launching ISA Lite

Download ISA Lite for Rational Common Licensing

Use your IBM ID and password to log-in. URL: https://www.ibm.com/services/forms/preLogin.do?source=swg-isalite&S_PKG=isalrcl


Windows:

  1. Extract RCL_ISALite_20120625.zip in a folder. If unzip utility is not available on your system, use jar xf RCL_ISALite_20121114.zip
  2. In the same folder, cd ISALite
  3. If Java is available in your path , simply run: runISALite.bat
    • NOTE: On some systems, you may need to "Run as administrator" in order to capture registry data.
  4. If Java is not available on your path, ISA Lite will prompt you for the path. You can also 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.
    • Example: set JAVA_HOME=C:\Program Files\IBM\RationalSDLC\common\JAVA5.0\jre
    • Once this is completed, run: runISALite.bat or runISALite.bat -console to run in console mode.

Linux / Unix
  1. Extract RCL_ISALite_20121114.tar.gz in a folder. To do so:
    • gzip -d RCL_ISALite_20121114.tar.gz
    • tar xf RCL_ISALite_20121114.tar
  2. In the same folder, cd ISALite
  3. If Java is not available on your path, ISA Lite will prompt you for the path. You can also 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/IBM/RationalSDLC/jre
  4. If you are running in a desktop environment: run: ./runISALite.sh
  5. If you are running in a console / terminal environment, run: ./runISALite.sh -console



Using ISA Lite (non-console mode)
Once you've launched ISA Lite:
    1. Select "Rational Licensing General Collector" from below.
    2. Fill in the Filename field.
    3. Click the Collect Data button to start data collection.
      • (Optional) Click on "Show execution details" to see the collector execution details.
    4. When finished, simply close the window.

Using ISA Lite (silent mode)
    To automate ISA collection and/or to run silently, please review the following two documents that discuss performing a silent recording, and a silent playback via command line:

    http://www.ibm.com/support/docview.wss?uid=swg27017356
    see section : Using ISA Lite for Remote Collection, starting at "To further simplify ..."

    Using this technique you can record an ISA execution, and subsequently playback via command line silently.



Rational Licensing General Collector

Use this collector to gather initial information relating to Rational Licensing issues. This collector needs to be run on the same system in which you have problem.

This collector does not modify your system.

Data Collected:
Please note that due to file system setup and restrictions, some files can only be accessed by user with appropriate administrative privileges.

Data collector and debug information

Output Location File Description
/autopdzip/autopd inventory_rcf.xml &
rcftransform.xsl
Information about all IBM products installed on this system. This may not be a complete list, but will contain additional information about user system that might be useful.
/autopdzip/rational Collector_Output.log Collectior execution trace.


System information
Output Location File Description
/ Linux_UnixSystemInfo.txt Basic system information for non Windows system.
/ FILES_EXCLUDED_FROM_COLLECTION.txt A listing of files that the tool is unable to gather due to permission issues.
/network_info *.txt
*_server.txt
Network information about the currently running system. If license server is determined, then output of ping, tracert or traceroute to the server are logged in *_server.txt
/system_info *.* Basic system information, including Windows event files, Unix syslog and message files.


IBM Installation Manager
Output Location File Description
/IM *.* Information related to IBM Installation Manager. See this technote for details


Rational Common Licensing
Output Location File Description
/rcl.properties RCL_Log_Location.properties File managed by Rational Common Licensing to indicate the location of product extensions. This file is located at either:
  • C:\Documents and Settings\All Users\Application Data\IBM\RCL\Logger
  • C:\ProgramData\IBM\RCL\Logger
or
  • /tmp/IBM/RCL/Logger
/rcl.properties/<product> RCL_API_Log*.xml Log files. These will also include versions of RCL that is running on the system


FlexLM
Windows
Output Location File Description
/FlexLM Lmutil_lmstat_out.txt Output of lmutil lmstat -a. The tool searches for lmutil.exe in directory specified by the registry keys:
  • HKEY_LOCAL_MACHINE\SOFTWARE\Rational Software\Common\CommonDir
  • HKEY_LOCAL_MACHINE\SOFTWARE\Rational Software\Licensing\<ver>\DaemonLocs
/FlexLM hostname.hostid.txt Information about hostname and host id. Execute system commands listed by technote: http://www.ibm.com/support/docview.wss?uid=swg21135430
/FlexLM/registry HKLM*.txt, HKCU*.txt Windows registry export of relevant registry keys. If key is not available, no file is generated.
  • HKEY_LOCAL_MACHINE\SOFTWARE\[Wow6432Node\]Flexlm License Manager
  • HKEY_LOCAL_MACHINE\SOFTWARE\[Wow6432Node\]Rational Software\Licensing
  • HKEY_CURRENT_USER\Software\FLEXlm License Manager
  • HKEY_CURRENT_USER\Software\Rational Software\Licensing
  • HKEY_LOCAL_MACHINE\SYSTEM\
    • ControlSet00[1,2,3]\Control\Session Manager\Environment
    • CurrentControlSet\Control\Session Manager\Environment
/FlexLM/License_[8.0, 2.0, 1.0] *.* License dat, and .opt files pulled from registry entries.
  • HKEY_LOCAL_MACHINE\SOFTWARE\[Wow6432Node\]Rational Software\Licensing\<ver>
    • LicensePerm
    • LicensePermServer
    • LicenseTemp
    • LicenseTempServer
  • *.opt from directory specified in HKEY_LOCAL_MACHINE\SOFTWARE\Rational Software\Licensing\<ver>\DaemonLocs
/FlexLM/lmgrd *.* Log from:
  • HKEY_LOCAL_MACHINE\SOFTWARE\[Wow6432Node\]Flexlm License Manager\LMGRD_LOG_FILE
  • HKEY_LOCAL_MACHINE\SOFTWARE\[Wow6432Node\]FLEXlm License Manager\FLEXlm License Manager\LMGRD_LOG_FILE
and dat files from:
  • HKEY_LOCAL_MACHINE\SOFTWARE\[Wow6432Node\]FLEXlm License Manager\License
  • HKEY_LOCAL_MACHINE\SOFTWARE\FLEXlm License Manager\FLEXlm License Manager\License


Linux or Unix
Output Location File Description
/FlexLM Lmutil_lmstat_out.txt, or
lmgrd_not_found.txt
Output of "lmutil lmstat" and "lmstat -a" if an appropriate lmutil location has been found.
/FlexLM .flexlm*, rs_install*.log Files collected: /.flexlm* and /tmp/rs_install*.log
/FlexLM hostname.hostid.txt Information about hostname and host id. Execute system commands listed by technote: http://www.ibm.com/support/docview.wss?uid=swg21135430
/FlexLM/env_dat *.* Files specified by the following environment variables (dat files)
  • RATIONAL_LICENSE_FILE
  • IBMRATL_LICENSE_FILE
  • TELELOGIC_LICENSE_FILE
  • LM_LICENSE_FILE
/FlexLM/startup_files *.* Collects known startup files for Rational products in /var/adm/rational location:
  • /var/adm/rational/common/ewas/conf/ewas_startup, ihs_startup, ccrc.conf
  • /var/adm/rational/**/config/flexlm_host,  license_host
/FlexLM/startup_files/_LICENSE_SCAN *.* Scans for known startup files that contains _LICENSE from:
  • /etc/*shrc
  • $HOME/.*rc
  • /etc/profile
Collect if matched.
/FlexLM/lmgrd/log *.* Collects log file that are defined by LICENSE_LOG=* in /etc/init.d/*.* files if available. Note: code does not do environment variable substitution
/FlexLM/lmgrd/dat/config *.* [AIX/HPUX only]
*.dat, *.lic, *.txt, *.upd from /opt/IBM/RationalRLKS/config directory

Available if lmgrd is currently running on the system. The location of lmgrd is base on ps -ef output
/FlexLM/lmgrd ps_out*.txt Output of ps -ef | grep ibmratl, or ps -ef | grep lmgrd
/FlexLM/lmgrd/log *.* Collect log files
  • Relative to the location of lmgrd. <lmgrd_dir>/*.log and <lmgrd_dir>\..\logs\*.log.
  • Specified by lmgrd command via -l option
/FlexLM/lmgrd/dat *.* Collect dat files specified by lmgrd command via -c option


Product dmp, core files
For each of the Rational products installed via IBM Installation Manager
Output Location File Description
/FlexLM/ System_dmp_file_scan.txt Logs the *.dmp, *.mdmp, *.phd files found under product install and product bin path.
/FlexLM/<product_id> *javacore.txt & flex*.log Collects the javacore*.txt and flex*.log found under product install and product bin path.



Data Collector Completion Options & Uploads

As part of the data collection path, when the collector completes data collection, it will request feedback about ISA. Select Yes, to provide feedback. Select No to continue.

You'll also be provided with data upload options as part of the collection process. This will allow you to send the collected data to IBM or another location via FTP or HTTPS. If you prefer to upload the data after the data collection tool runs to completion, you can upload data via : https://www.ecurep.ibm.com/app/upload

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.


The upload options included as part of data collection tool 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. NOTE: This option may not be available if the collected data are larger than 20M.
  • 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.

Click OK to continue. If you choose options other than "Do Not FTP the Logs" above, you will need to fill in additional information required to complete the upload.

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.

Rate this page:

(0 users)Average rating

Document information


More support for:

Rational License Key Server
General Information

Software version:

Version Independent

Operating system(s):

AIX, HP-UX, Linux, Solaris, Windows

Reference #:

1606152

Modified date:

2012-12-05

Translate my page

Machine Translation

Content navigation