The IBM Rational MSI Uninstall tool, rationaluninstalltool.exe, is used to remove previous versions of IBM Rational Team Products.
Download Description
The Rational MSI Uninstall tool removes versions of the following Rational Team Products with version numbers between 2003.06.00 and 7.1/7.0.2.
Rational ClearCase
Rational ClearCase Clients for Visual Studio.NET
Rational ClearCase Remote Client for Visual Studio .NET
Rational ClearQuest
Rational License Server
Rational ProjectConsole
Rational RequisitePro
Rational Robot*
Rational SoDA
Rational TestManager*
NOTE: This tool is only for uninstalling the point products listed above. It will not uninstall any Rational Suites, such as the Rational Suite Enterprise or TUP.
Run the command rationaluninstalltool.exe at a command prompt with the following options:
<log file name> Specify the name and location of the log file where you want the logging information stored.
[ –c] Perform a complete clean of the system. The clean uninstall option completely removes the Rational install directory as well the Rational Software registry keys under both HKEY_LOCAL_MACHINE and HKEY_CURRENT_USER.
[ –nr] As of version 1.0.0.5 of the Uninstall Tool, this option will suppress the automatic reboot that happens for ClearCase, ClearQuest, RequisitePro, and ProjectConsole. NOTE: You will need to reboot the machine manually in order to complete the uninstall of these Rational products.
The following example demonstrates how to run the tool with the option to completely clean the Rational install directory and Rational Software and Atria registry keys:
Please note that if a reboot was necessary, the tool will need to be available after the reboot, and also that the same user must log in again in order to complete the process.
The tool currently always returns 0, but does indicate if the MSI portion of the uninstall failed. The error log from the MSI uninstall will be listed in the Rational MSI Uninstall tool log.
Generally, the tool will take between 1 and 2 hours to uninstall ClearCase or ClearQuest, depending on the features installed. The other products will generally take between 45 minutes and an hour to uninstall.
As of version 1.0.0.3 of the Rational Uninstall Tool, there has been a change to how registry keys and values have been preserved. They are now exported as .reg files in the RationalSDLC_Temp\Rational.Preserve directory on the root drive of the machine (generally, C:\). Please be aware that some of these registry keys contain references to the install directory and could break product functionality if imported into a 7.1.0.x install of the product.
*Rational Robot and Rational TestManager
Please read technote 1326951 about backing up your TestDataStores prior to running the Uninstall tool.
Prerequisites
Any IBM Rational Team Product with a version between 2003.06.00 and 7.1/7.0.2.
Installation Instructions
Download the zip file to the user's machine. Extract the contents to a temporary location, for example "C:\temp2".
Download package
Rationaluninstalltool.exe and the license agreement documentation.
IBM, the IBM logo and ibm.com are trademarks of International Business Machines Corp., registered in many jurisdictions worldwide. Other product and service names might be trademarks of IBM or other companies. A current list of IBM trademarks is available on the Web at "Copyright and trademark information" at www.ibm.com/legal/copytrade.shtml.
Rate this page
Please take a moment to complete this form to help us better serve you.
