MustGather: Enable debugging for ClearCase and ClearQuest installs using Installation Manager

Technote (FAQ)


Question

How can I enable debugging for IBM Rational ClearCase and IBM Rational ClearQuest installations using Installation Manager?

Cause

Certain situations can sometimes cause the installation of ClearCase or ClearQuest to fail. If the information provided in the log files is not enough to solve the problem, turning on debugging can help further narrow down the problem.


Answer

Debugging can be turned on either after Installation Manager is installed or before if you are having problems installing Installation Manager itself.

Enable Debugging

Turning on debugging once Installation Manager is installed:

  1. cd to the logs directory

    UNIX/Linux:
    cd /var/ibm/InstallationManager/logs


    Microsoft Windows 2000, XP, 2003:
    C:\Documents and Settings\All Users\Application Data\IBM\Installation Manager\logs

    Windows 2008, Vista or Windows 7:
    C:\ProgramData\IBM\Installation Manager\logs

    Note: The ProgramData folder is most likely hidden and you will have to unhide to see its contents.
  2. Create a file named log.properties and add the following lines:

    Director=DEBUG
    Engine=DEBUG
    InstallOrderManager=DEBUG
    InstallOperation=DEBUG

    If you are using Installation Manager 1.3.3 or higher and the install has already failed, add this line to the above file:

    InstallOperation/pause.on_error=true

    This will pause the install at the time of the error and allow the user to collect any log files that were mentioned in the original failure that were deleted when the install rolled back. Of interest would be logs such as:

    /opt/rational/common/eWAS/logs
    /opt/rational/common/CM/profiles/cmprofile/logs
    /opt/rational/common/IHS/logs


  3. Save the file

  4. Now invoke Installation Manager and repeat the install that is having problems.

    The debug information will be written to the log file in:
    • Windows:

      Windows 2000, XP, 2003:
      C:\Documents and Settings\All Users\Application Data\IBM\Installation Manager\logs\<date_time>.xml

      Windows 2008, Vista or Windows 7:
      C:\ProgramData\IBM\Installation Manager\logs\.settings\logs\<date_time>.xml

    • UNIX/Linux:
      /var/ibm/InstallationManager/logs/<date_time>.xml
      In addition, the debug information will also be written to the terminal window that Installation Manager was invoked from. The information in the terminal window can be ignored as it is also written to the log file.
    If you are using Installation Manager 1.3.3 or higher and added the pause.on_error directive, you will need to press enter (after collecting the additional log files) to allow the install to properly fail.

    If the debug information does not help you solve the issue, send the following data to IBM Rational Client Support for further analysis.
    • Windows:
      zip up the contents of

      Windows 2000, XP, 2003:
      C:\Documents and Settings\All Users\Application Data\IBM\Installation Manager

      Windows 2008, Vista or Windows 7:
      C:\ProgramData\IBM\Installation Manager

    • UNIX/Linux:
      tar up the contents of /var/ibm/InstallationManager

Note: If you are having problems with the installation of the Installation Manager itself, you can still create the log.properties file as noted above, however, you will need to carefully create the directories to put the file in (as they do not exist within a pre-install state). You can issue a mkdir -p /var/ibm/InstallationManager/logs  command to generate the directories necessary to create the log.properties file, and thus debug the install of the Installation Manager, if necessary.

Related information

A Japanese translation is available

Cross reference information
Segment Product Component Platform Version Edition
Software Development Rational ClearQuest Installation Linux, Solaris, Windows 7.1, 7.1.1

Rate this page:

(0 users)Average rating

Add comments

Document information


More support for:

Rational ClearCase
Installation

Software version:

7.1, 7.1.1, 7.1.2

Operating system(s):

Linux, Solaris, Windows

Reference #:

1358628

Modified date:

2012-11-26

Translate my page

Machine Translation

Content navigation