Search Google Appliance

Home >> HFS >> Need Help Using the HFS? >> HFS Backup for macOS Help and Support >> Removing the HFS Client Software from a Mac

Removing the HFS Client Software from a Mac

1. Why remove the HFS backup client?

There are several reasons why you may need or wish to remove the Spectrum Protect / TSM software from your machine, such as:

  • You are leaving the university - the software is licensed and configured specifically for use within Oxford University only.
  • You are having problems with Spectrum Protect / TSM and so have been asked to remove and reinstall Spectrum Protect / TSM.
  • You are upgrading to a new machine and no longer wish to back up the old one.
  • You no longer need to back a machine up.

2.1. Removing the HFS backup client using the uninstaller

If you are using TSM 7.1.6.6 or later, or IBM Spectrum Protect 8.1.0.2 or later on your Mac, an uninstaller is supplied within the the appropriate application folder.

  1. Run [Applications] > and then either [IBM Spectrum Protect] > [Uninstall IBM Spectrum Protect] or [Tivoli Storage Manager][Uninstall TSM].

  2. Click the Yes button to start the uninstall process:
  3. The uninstall process requires administrative authorisation as below:
  4. Click the Yes button to remove the Spectrum Protect / TSM configuration files - this is important to do if you need to change your nodename:
  5. Now that the uninstallation has completed, you can click on OK to close the window:

2.2. Manually removing the HFS backup client

Note: You must be logged in to the Mac as an administrator to perform at least some of the steps below.

  1. If you have Spectrum Protect / TSM running, first of all quit the program.
  2. Stop the Spectrum Protect / TSM Scheduler running: go [Applications] > [IBM Spectrum Protect] or [Tivoli Storage Manager] > [TSM Tools for Administrators] or [IBM Spectrum Protect Tools for Administrators] and select either [Stop the Client Acceptor Daemon] or [Stop the Scheduler]. You will be prompted to enter your Mac's local administrator password.
  3. Open a terminal window (via [Applications] > [Utilities] > [Terminal]) and enter the following commands:
    sudo /Library/Application\ Support/tivoli/tsm/client/ba/bin/uninstall.sh
    sudo rm -rf /Library/Application\ Support/tivoli
    sudo rm -rf /Library/ibm/gsk8
    sudo rm -f /Library/LaunchDaemons/com.ibm.tivoli.dsmcad.plist
    sudo rm -f /Library/LaunchDaemons/dsmsched.plist
    sudo pkgutil --forget com.ibm.gskit8.crypto
    sudo pkgutil --forget com.ibm.gskit8.ssl
    sudo pkgutil --forget com.ibm.tivoli.tsm.baclient
    sudo pkgutil --forget com.ibm.tivoli.tsm.baclientjava
    sudo pkgutil --forget hfs.tsm.opt

    You will again be prompted for the local administrator password, but no characters will appear on screen as you type: type your password as usual and press Enter.

  4. Additionally, you may want to remove the Spectrum Protect / TSM configuration files - this is important to do if you need to change your Spectrum Protect / TSM nodename. (On OS X 10.4.7 and later these files are dsm.sys, dsm.opt and TSM.PWD; on earlier versions of Mac OS X they are TSM System Preferences, TSM User Preferences and TSM.PWD.) To remove them, enter the following command:
    sudo rm -rf /Library/Preferences/Tivoli\ Storage\ Manager
  5. If you want to remove the Spectrum Protect / TSM log files, run the following command:
    sudo rm -rf /Library/Logs/tivoli

Written by IT Services. Latest revision 11 October 2018