IBM Support

Uninstall ClearCase 7.1 on Linux or Unix

Question & Answer


Question

How to uninstall IBM Rational ClearCase (CC) version 7.1 on Linux or Unix?

Answer

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


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.

Note: If you have IBM Rational ClearQuest still installed and the only issue is a few files left behind from the uninstall of ClearCase, it is easier to just leave the files, otherwise you will have to uninstall ClearQuest using the Installation Manager.

  1. Use the Installation Manager to uninstall ClearCase

    Note: It is necessary to run this step as to ensure that the Installation Manager properly reflects 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.

  2. Stop ClearCase
    /opt/rational/clearcase/etc/clearcase stop

  3. Uninstall Global Monitoring (if installed)
    1. Get all running agents by running <gm_installdir>/bin/cinfo -r
    2. On each agent returned, run <gm_installdir>/bin/itmcmd agent -f stop <agentcode>
    3. Run <gm_installdir>/bin/uninstall.sh rc <os_code>
      where <os_code> is one of the values below:
      - If the operating system is Solaris, <os_code> = sol286
      - If the operating system is Linux (32 bit), <os_code> = li6263
      - If the operating system is Linux (64 bit), <os_code> = lx8266
      - If no other agents are installed on your system, execute
      <gm_installdir>/bin/uninstall.sh REMOVE EVERYTHING

  4. Unload / uninstall the MVFS

    • All platforms
      If the MVFS viewroot is mounted on /view, unmount /view
      Then run:
      rmdir /view

    • Linux
      • Remove files
        rm -rf /sbin/mount.mvfs
        find /lib/modules -name mvfs.o -exec rm -rf {} \;
        find /lib/modules -name mvfs.ko -exec rm -rf {} \;
        find /lib/modules -name vnode.o -exec rm -rf {} \;
        find /lib/modules -name vnode.ko -exec rm -rf {} \;
      • If the linux kernel is 2.6, run /sbin/depmod
        rm -rf /etc/exports.mvfs
      • Modify Cron Job to remove MVFS components
        1. Open the following files: "/etc/rc.config", "/etc/sysconfig/locate", "/etc/diskcheck.conf", "/etc/updatedb.conf"
        2. Modify the files as follows:
          1. If the line starts with "UPDATEDB_PRUNEPATHS" or "PRUNEPATHS", remove /view
          2. If the line starts with "ignore", remove -xmvfs
          3. If the line starts with "UPDATEDB_PRUNEFS", remove mvfs
        3. (for SUSE Linux) Run: /sbin/SuSEconfig
        4. Run crontab -l > /var/tmp/crontab_output
        5. Open /var/tmp/crontab_output and remove all occurrences of "-o -fstype mvfs -prune"
        6. Run: crontab /var/tmp/crontab_output
      • /sbin/chkconfig --del clearcase
      • rm /etc/init.d/clearcase

    • Solaris
      • If within the global zone, rm -rf /usr/lib/fs/mvfs/mount
      • rm -rf /etc/exports.mvfs
      • Modify Cron Job to remove MVFS components
        1. Run crontab -l > /var/tmp/crontab_output
        2. if "grep nfsfind /var/tmp/crontab_output" returns a line, open /usr/lib/fs/nfs/nfsfind
          1. Remove all occurences of && substr($1,1,6) != "/view/""
        3. Open /var/tmp/crontab_output and remove all occurences of "-o -fstype mvfs -prune"
        4. Run: crontab /var/tmp/crontab_output
      • rm /etc/init.d/clearcase
        rm /etc/rc0.d/K35clearcase
        rm /etc/rc2.d/S77clearcase

        rm /usr/lib/fs/mvfs/mount
        rmdir -rf /usr/lib/fs/mvfs

    • HP
      • rm -rf /sbin/fs/mvfs/mount
      • rm -rf /sbin/fs/mvfs/umount
      • swremove -x auto_kernel_build=false -x mount_all_filesystems=false CCASE-MVFS
      • rm -rf /usr/conf/master.d/mvfs
      • rm -rf /usr/conf/mod/mvfs
      • rm -rf /usr/sam/lib/kc/drivers.MFS.tx
      • rm -rf /etc/exports.mvfs
      • rm -rf /sbin/rc1.d/K007clearcase
      • rm -rf /sbin/rc2.d/S750clearcase
      • rm -rf /sbin/init.d/clearcase
      • Modify crontab to remove MVFS components
        1. Run crontab -l > /var/tmp/crontab_output
        2. Open /var/tmp/crontab_output and remove all occurrences of "-o -fstype mvfs -prune"
        3. Run: crontab /var/tmp/crontab_output

    • AIX
      • rmvfs mvfs
      • rm -rf /sbin/helpers/mvfsmnthelp
      • rm -rf /etc/exports.mvfs
      • rmitab clearcase
      • rm -rf /etc/rc.clearcase
      • Modify Cron Job to remove MVFS components
      • Run crontab -l > /var/tmp/crontab_output
      • Open /var/tmp/crontab_output and remove all occurrences of "-o -fstype mvfs -prune"
      • Run: crontab /var/tmp/crontab_output

  5. If ClearQuest is still installed, you MUSTuninstall it using the Installation Manager before you proceed.

    Note: Depending on how successful the uninstall was, some of these steps will not be needed

  6. Stop IHS and Websphere
    /opt/rational/common/IHS/bin/ihs_shutdown

  7. Stop Websphere Application Server/opt/IBM/RationalSDLC/common/eWAS/bin/ewas_shutdown

  8. Uninstall Websphere Application Server (WAS)
    cd /opt/rational/common/eWAS/uninstall
    ./uninstall -silent


  9. Uninstall IBM HTTP Server (IHS)
    cd /opt/rational/common/IHS/uninstall
    ./uninstall -silent


  10. Uninstall (IHS) update Installer
    cd /opt/rational/common/IHS_updateinstaller/uninstall
    ./uninstall -silent


  11. Remove all files under the install directory (by default it is /opt/IBM/RationalSDLC or /opt/ibm/RationalSDLC
    rm -rf <ClearCase install directory>

  12. Remove files outside of the installation directory
    rm -rf /var/adm/rational
  13. Remove the following links:
    rm /opt/rational/common
    rm /opt/rational/clearcase


At this point you have successfully removed any installation files associated with ClearCase.

Note: During an uninstall we preserve some files in the /tmp/Rational.preserve folder. These files will be used on a subsequent install, so if you really wanted to start fresh, you should "rename" that folder before the install. Never "delete" this folder as it does contain configuration files that can be of use to you after you re-install. For example, if this is your ClearCase Registry server, your view and VOB registration files are some of the files in this folder.

[{"Product":{"code":"SSSH27","label":"Rational ClearCase"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"Installation","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF010","label":"HP-UX"},{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"}],"Version":"7.1;7.1.0.1;7.1.0.2;7.1.1","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]

Document Information

Modified date:
16 June 2018

UID

swg21376016