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:
- Rational ClearCase®
- Rational ClearQuest®
- Rational Project
Console
- Rational Robot
- Rational SoDA
- Rational TestManager
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:
- Download rationaluninstalltool.exe from http://www.ibm.com/support/docview.wss?uid=swg24021131
- Copy the rationaluninstalltool.exe to the computer on which you
must remove the Rational products
- 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: