Uninstall Rational products, version 7.1 and earlier

If you are upgrading from a release earlier than 7.1, before installing Rational® products with IBM Installation Manager, you must use the rationaluninstalltool.exe tool to uninstall previous versions of Rational products that were installed with the MSI-based install technology.
Note: If the Rational product is installed on a Linux or UNIX system platform, you must uninstall this product before upgrading to the next version with Installation Manager. You can uninstall your current version with the uninstall option of install_release.
The following products, which were installed with MSI-based install technology, must be uninstalled:
Note: You must not attempt to uninstall these products with the MSI uninstall technology. The rationaluninstalltool.exe tool must be used.

If the rationaluninstalltool.exe tool is not run before installing a Version 7.1 or later release, Installation Manager warns that you have a previous version of a Rational product installed, which must be removed before Installation Manager can continue.

The rationaluninstalltool.exe tool offers two uninstall scenarios; a clean uninstall and a user data preserved uninstall.

The clean uninstall completely removes the Rational install directory as well the Rational Software registry keys under both HKEY_LOCAL_MACHINE and HKEY_CURRENT_USER.

The user data preserved uninstall does not remove files that are used to customize the environment. Use this method if you want to save customizations from your current deployment for your Installation Manager deployment. The following information identifies the files that are preserved for each of the products by this uninstall method.
Rational ClearCase
  • ClearCase\var directory
  • The IHS\Conf directory
  • Ccweb.conf for the CCweb feature
  • HKEY_LOCAL_MACHINE\Software\Atria
Rational ClearQuest
  • Under both HKEY_LOCAL_MACHINE and HKEY_CURRENT_USER
    • Rational Software\Email registry key
    • Rational Software\ClearQuest registry key
  • Rational ClearQuest Web Application Server:
    • jtl.properties
    • common.properties
    • dct.properties
  • Rational ClearQuest Request Manager
    • common.properties
    • jtl.properties
    • logging.xml
    • rmmanager.properties
    • saved.properties
    • csm.properties
Rational Robot
  • Rational Administrator\projects directory
  • Under both HKEY_LOCAL_MACHINE and HKEY_CURRENT_USER
    • Rational Software\Rational Test\8\Robot
Rational SoDA
  • SoDAWord\logs directory
  • SoDAWord\temp directory
Rational TestManager
  • Rational Administrator\projects directory
  • Under both HKEY_LOCAL_MACHINE and HKEY_CURRENT_USER
    • Rational Software\Rational Test\8\TestManager

The rationaluninstalltool.exe tool removes all the listed Rational products at once. It does not need to be rerun for each product.

To remove Rational products with the rationaluninstalltool.exe tool:

  1. Download rationaluninstalltool.exe from http://www.ibm.com/support/docview.wss?uid=swg24021131
  2. Copy the rationaluninstalltool.exe to the computer on which you must remove the Rational products
  3. From a Windows command prompt, run rationaluninstalltool.exe. Consult the following command reference.

Synopsis

rationaluninstalltool.exe <log file name> [ –c ]

Description

Use the rationaluninstalltool.exe command with the following subcommands:
  • <log file name> Specify the name and location of the log file you want the logging information stored.
  • [ –c ] Requests that everything is removed. The clean uninstall completely removes the Rational install directory as well the Rational Software registry keys under both HKEY_LOCAL_MACHINE and HKEY_CURRENT_USER.
    Note: If you want to run a user-data preserved uninstall, do not invoke the –c option. rationaluninstalltool.exe automatically preserves the data previously specified when this option is not used.

Feedback