IBM Support

How to uninstall ClearCase 7.1 on Windows

Question & Answer


Question

How do you uninstall IBM Rational ClearCase version 7.1 on Microsoft Windows?

Answer

The steps below will explain how to uninstall IBM Rational ClearCase version 7.1 using Installation Manager. Once that is done, if there are files left behind or if the uninstall using Installation Manager produced errors, you can use these steps to clean up.

Important note: Attempting to uninstall ClearCase without using the IBM Installation Manager will prevent you from being able to install ClearCase in the future on this machine.

REGISTRY EDITS:

This solution contains information about modifying the system registry. Before making any modifications to the Microsoft Registry Editor, it is strongly recommended that you make a backup of the existing registry. For more information describing how to back up the registry, refer to Microsoft Knowledge Base article 256986

  1. Uninstall ClearCase using the Installation Manager

    Note: It is necessary to run this step as to ensure that the Installation Manager properly reflects the fact that the product is no longer installed. If you need assistance with uninstalling a product using Installation Manager, refer to the IBM Installation Manager documentation under the topic of Uninstalling products, packages, and updates.

    If this uninstall step does not completely remove ClearCase, or if you were unable to uninstall ClearCase via Installation Manager, then proceed with the following steps to manually remove ClearCase.

    Note: If you have other Rational products still installed and the only issue is a few files left behind, it will be easier to leave the extra files, as otherwise you will have to uninstall all installed products using the Installation Manager.

    If you decide to continue on, you should realize that some of these steps might be unnecessary if the uninstall was able to successfully remove them.

  2. Uninstall MVFS
    1. Open a command prompt
    2. Change directory to <ClearCase install directory>\ClearCase\install\inf
    3. Execute: installmvfs.exe /q /u

  3. Uninstall Global Monitoring (if applicable)
    1. Download ClearCase-krc-agent.windows_*.zip from a ClearCase repository
    2. Unzip the file to C:\gm_install_package
    3. Change directory to C:\gm_install_package\windows\setup.exe
    4. When the Installshield graphical user interface comes up, choose to remove Global monitoring and follow the prompts

  4. If any of the following products are installed (Rational ClearQuest, Rational RequisitePro, Rational ClearCase Remote Client, Rational SoDA, Rational TestManager, Rational Robot or Rational ProjectConsole), you must uninstall them using the Installation Manager BEFORE you proceed to the rest of the cleanup.

    Note: Depending on how successful the uninstall was, some of the following steps may not be needed.

  5. Stop CM services
    1. Open a command prompt
    2. Change directory to <ClearCase install directory>\common\CM\profiles\cmprofile\bin
    3. Execute: stopserver.bat server1
    4. Change directory to <ClearCase install directory>\common\eWAS\bin
    5. Execute: wasservice.exe -remove cmprofile

  6. Uninstall WebSphere Application Server (WAS)
    1. Change Directory to <ClearCase install directory>\common\eWAS\uninstall
    2. Execute:uninstall.exe
    3. Follow the Installshield prompts to uninstall WAS. Make sure to check the box 'delete all profiles'

  7. Uninstall IHS (IBM HTTP Server)
    1. Change directory to <ClearCase install directory>\common\IHS\uninstall
    2. Execute: uninstall.exe
    3. Follow the Installshield prompts to uninstall IHS

  8. Uninstall the IHS Update Installer
    1. Change directory to <ClearCase install directory>\common\IHS_updateinstaller\uninstall
    2. Execute: uninstall.exe
    3. Follow the Installshield prompt to uninstall IHS

  9. Remove the ClearCase installation directory
    1. Execute the command rmdir /q /s <ClearCase install directory>
    2. If this fails, skip this step and continue to next step

  10. Remove the directories outside of the ClearCase installation directory
    1. Delete %Temp%\ratl*
    2. Delete <Global Monitoring Installation Directory (if applicable)

  11. Remove all of the mvfs$$.sys files from C:\WINDOWS\system32\drivers

  12. Delete the registry entries for ClearCase:
    1. Click start > run > regedit.exe
    2. Delete from HKEY_LOCAL_MACHINE:

      HKEY_LOCAL_MACHINE\software\atria
      HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\Albd
      HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\cccredmgr
      HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\Eventlog\Application\ClearCase
      HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\Eventlog\System\Mvfs
      HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\LockMgr
      HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\Mvfs

      Note: The above keys may also be found in the following locations as well.
      * HKEY_LOCAL_MACHINE\SYSTEM\ControlSet001
      * HKEY_LOCAL_MACHINE\SYSTEM\ControlSet002
      * HKEY_LOCAL_MACHINE\SYSTEM\ControlSet003
    3. Delete HKEY_CURRENT_USER \software\atria
    4. If there are no other Rational Products installed:
      • Delete HKEY_LOCAL_MACHINE\software\Rational Software\ClearCase
      • Delete HKEY_LOCAL_MACHINE\Software\Rational Software\Licensing\2.0
      • Delete (if it exists) HKEY_CLASSES_ROOT\CLSID\{2F766012-B4BB-11D3-B9D9-00207814BCF5}

        This key represents the path chooser for IBM Rational products. If the key exists and you are attempting to install for the first time, you can receive the following error message:

        Registry write error during installation phase for registry path "HKCR\CLSID\{2F766012-B4BB-11D3-B9D9-00207814BCF5}\InprocServer32\
    5. Remove the MVFS network provider information from these keys:

      HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\NetworkProvider\HwOrder
      "ProviderOrder"="Mvfs,RDPNP,LanmanWorkstation,WebClient,Nfsnp"

      HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\NetworkProvider\Order
      "ProviderOrder"="Mvfs,RDPNP,LanmanWorkstation,WebClient,Nfsnp"

      HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\NetworkProvider\ShortName
      "nfs"="NFS Network"
      "Mvfs"="ClearCase Dynamic Views"

  13. Reboot the machine

  14. If the install directory removal failed in step 7, try to remove the installation directory once again after the reboot. If it fails, rename the installation directory.

    Note: Although not normally necessary, you may need to boot up Windows in Safe mode to get access to the directory if errors occur when trying to remove or rename following the normal reboot.

Note: During an uninstall we preserve some files at the root of the installation drive in a folder called Rational.preserve and starting in 7.1.1 we also create a Rational.preserve folder in c:\Documents and Settings\All Users\Application Data\IBM. These files will be used on a subsequent installation, so if you really wanted to start fresh, you should "rename" these folders before the installation. Never "delete" this folder as it does contain configuration files that can be of use to you after you reinstall. For example, if this is your ClearCase Registry server, your view and VOB registration files are some of the files in this folder.

Internal Use Only



====================================================
Title: Windows から ClearCase 7.1 をアンインストールする手順 - Database 'DCF Technotes (Rational)', View '(vwGetContent)', Document 'Windows から ClearCase 7.1 をアンインストールする手順'

IMPORTANT: If this technote is modified, the changes need to also be applied to the Japanese version through an update request.

a) Make note of the changes that were made to the English technote. All modifications need to be identified in the update request.
Copy the changed text and create a BEFORE and AFTER to identify the changes and the section that was changed (Title, Abstraction, Question, Solution,). Note: Since the update request is text only, no colors can be used to highlight the changes.

b) Click the Japanese technote doc link above and submit an update as follows (Copy and Paste):

The English technote equivalent to this one has been updated as noted below.
Please review the content and update the Japanese version as required.
When complete, send the Japanese technote to be published.
====================================================


Keeping the following internal pending further validation. -denise oct 29, 2010
DCF - Update Document #1358566
Submitted by: Bren N Warren on 10/25/2010 10:19 AM
Technote Owner: Denise M McKinnon
Segment: Software Development
Product: Rational ClearCase
Component: Installation
Required fields are marked with an asterisk (*) and must be filled in to complete the form.

Title *Uninstalling ClearCase 7.1 on Windows

Please input your comments * :

Perhaps we can add the following to the Internal section of the technote for now or even add to the main text.

Some times due to an bad initial installation you may not be able to uninstall using Installation Manager. (when you open IM there is no Clearcase to uninstall.

In these circumstances you can carry out the following steps to uninstall Clearcase:


1 Uninstall without using Installation Manager (IM).

Follow the steps as described in the following technote WITHOUT
using step 1 from that technote.
http://www-01.ibm.com/support/docview.wss?uid=swg21358566

Once you've carried out the steps in the technote above. (Starting with
step 2) continue as below:

2 Move the whole directory C:\Program Files\IBM\RationalSDLC to a
temporary directory. (Step 9 in the technote above doesn't remove files
in this
directory fully.)

3 After perform the steps in the technote, you need to move the agent
data directory of IM to a temporary directory. Otherwise attempts to
install CC on the machine will again fail.

By default the Installation Manager (IM) agent data directory is created in:

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

Windows Vista
C:\ProgramData\IBM\Installation Manager

Windows 2008
C:\ProgramData\Installation Manager

4 You should then be able to re-install Clearcase if required.

5 After you have re-installed , you can remove all data in the temporary
directory.



*************************EVERYTHING BELOW THIS LINE IS DONE*********************************************


I have made the changes that development requested which is basically to not remove any files by hand unless you have uninstalled all Team Products using IM - jcass 8/5/09

===============================

I backed up the current text from the Answer section below. thanks, -denise June 16, 2009

Backup (June 16, 2009)

Certain situations arise that result in the inability to uninstall ClearCase version 7.1 using the Installation Manager. However, the process documented in this technote can be used to manually uninstall ClearCase version 7.1.

 REGISTRY EDITS:

This solution contains information about modifying the system registry. Before making any modifications to the Microsoft® Registry Editor, it is strongly recommended that you make a backup of the existing registry. For more information describing how to back up the registry, refer to the Microsoft Knowledge Base article 256986 .

Note: You should skip steps #3 - 5 if any other 7.1 / 7.0.2 products are still on this machine that are sharing the Web services (such as ReqWeb, PJCweb, CQ Web, or others).

  1. Uninstall ClearCase using the Installation Manager
    Note: It is necessary to run this step as to ensure that the Installation Manager properly reflects the uninstall.

    If the uninstall above doesn't completely remove ClearCase, then proceed with the following steps to manually remove ClearCase.
  2. Uninstall MVFS
  3. Open a command prompt
  4. Change directory to <ClearCase install directory>\ClearCase\install\inf
  5. Execute: installmvfs.exe /q /u

  6. Stop CM services
  7. Open a command prompt
  8. Change directory to <ClearCase install directory>\common\CM\profiles\cmprofile\bin
  9. Execute: stopserver.bat server1
  10. Change directory to <ClearCase install directory>\common\eWAS\bin
  11. Execute: wasservice.exe -remove cmprofile

  12. Uninstall Websphere Application Server (WAS)
  13. Change Directory to <ClearCase install directory>\common\eWAS\uninstall
  14. Execute:uninstall.exe
  15. Follow the installshield prompts to uninstall WAS. Make sure to check the box 'delete all profiles'

  16. Uninstall IHS (IBM HTTP Server)
  17. Change directory to <ClearCase install directory>\common\IHS\uninstall
  18. Execute: uninstall.exe
  19. Follow the install shield prompts to uninstall IHS

  20. Uninstall the IHS Update Installer
  21. Change directory to <ClearCase install directory>\common\IHS_updateinstaller\uninstall
  22. Execute: uninstall.exe
  23. Follow the install shield prompt to uninstall IHS

  24. Uninstall Global Monitoring (if applicable)
  25. Download ClearCase-krc-agent.windows_*.zip from a ClearCase repository.
  26. Unzip the file to C:\gm_install_package
  27. Change directory to C:\gm_install_package\windows\setup.exe
  28. When the install shield graphical user interface comes up choose to remove Global monitoring and follow the prompts

  29. Remove the ClearCase installation directory
  30. Execute the command rmdir /q /s <ClearCase install directory>
  31. If this fails, skip this step and continue to next step.

  32. Remove the directories outside of the ClearCase installation directory
  33. Delete %Temp%\ratl*
  34. Delete <Global Monitoring Installation Directory (if applicable)

  35. Delete the registry entries for ClearCase
  36. Click start > run > regedit.exe
  37. Delete HKLM\software\atria
  38. Delete HKCU\software\atria
  39. If there are no other Rational Products installed:
  • Delete HKLM\software\Rational Software\ClearCase
  • Delete HKLM\Software\Rational Software\Licensing\2.0

  • 1. Reboot the machine

    2. If the install directory removal failed in step 7, try to remove the install directory once again after the reboot. If it fails, rename the install directory.

    Note: This should not be the case, but you may need to boot up in Safe mode to get access to the directory, if errors occur when trying to remove or rename following the normal reboot.




Do you need more help?

For additional assistance, contact IBM Rational Client Support:
Submit a Service Request (SR)



Sending to publish following feedback from Judy and Mark Guertin. -denise 1/8/2009

==============================

Keeping the following here as a reference:

For pre-CC7.1:

If you are unable to reinstall ClearCase after uninstalling a pre-CC7.1 version whose uninstall was incomplete, the following utility may be helpful:

Windows Installer CleanUp Utility
http://support.microsoft.com/default.aspx?scid=kb;en-us;290301

=================================


[{"Product":{"code":"SSSH27","label":"Rational ClearCase"},"Business Unit":{"code":"BU004","label":"Hybrid Cloud"},"Component":"Installation","Platform":[{"code":"PF033","label":"Windows"}],"Version":"7.1","Edition":""}]

Document Information

Modified date:
16 June 2018

UID

swg21358566

Contact and feedback

Need support?