Removing the HFS client software

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 have been asked to remove and reinstall the software after encountering issues.
  • You are upgrading to a new machine and no longer wish to back up the old one.
  • You no longer need to make backups for the machine.
WINDOWS

To remove the HFS client software fully in Windows you will need to first unistall the software, then remove the final components either manually or with the assistance of semi-automated scripts.


Uninstall the software

  1. Open Windows Start Menu then type Control Panel.
  2. Open Control Panel.
  3. Select Programs and Features
  4. Locate IBM Tivoli Storage Manager Client/IBM Spectrum Protect Client and select Uninstall
  5. Select OK if prompted to close the client scheduler or other Spectrum Protect/TSM-related services.
  6. You will be returned to the Add/Remove Programs screen when the uninstallation process is complete.
  7. Remove the final components using the semi-automated or manual methods below.

Semi-automated removal

Important: If you are likely to be reinstalling the software and have previously set up custom INCLUDE/EXCLUDE rules, please copy the file C:\Program Files\Tivoli\TSM\baclient\dsm.opt to an alternative location in order to preserve it.

  1. Download and run the file TSM-Removal.exe.
  2. Follow the on-screen prompts.
  3. You will receive confirmation that all Spectrum Protect/TSM components have now been removed.

Manual removal

  • Remove the services

The installation process does not always remove the Windows services associated with Spectrum Protect/TSM, so follow these steps to remove the services manually:

  1. Open Windows Start Menu then type cmd.
  2. Right click on Command Prompt and select Run as administrator
  3. Select Programs and Features
  4. In the command prompt window enter each of the following:
    • sc delete "TSM Client Scheduler"
    • sc delete "TSM Client Acceptor"
    • sc delete "TSM Client Agent"
  5. To check that the services have been removed:
    • Open Windows Start Menu then type services
    • Open Services.
    • There should be no services listed that start with TSM.
  • Tidy up files and folders

Important: If you are likely to be reinstalling the software and have previously set up custom INCLUDE/EXCLUDE rules, please copy the file C:\Program Files\Tivoli\TSM\baclient\dsm.opt to an alternative location in order to preserve it.

Some files and settings that are left behind following an uninstallation.  Below are steps on deleting all files, folders and registry entries previously linked with Spectrum Protect/TSM.

  1. Delete main software folder C:\Program Files\Tivoli.  If Windows states that some files are in use, reboot your machine and try again.Installation files
  2. Delete installation folder C:\tsm_images.
  3. The Spectrum Protect/TSM installation file, called something similar to ox-hfs-sp-8.1.0.2_4-win64.msi or tsm-7.1.6.5_2-win32.msi, may also be deleted from your Downloads folder if present.
  • Delete the registry entries

Important:This article contains information about editing the registry.  Do not delete any information other than the specific entries advised - IT Services cannot be held responsible for any errors that occur as a result of changes made to the registry.

  1. Open Windows Start Menu then type regedit.
  2. Right click on regedit.exe and select Run as administrator.
  3. From HKEY_LOCAL_MACHINE\SOFTWARE\IBM, delete the ADSM registry key.
  4. From HKEY_LOCAL_MACHINE\SOFTWARE, delete the Tivoli registry key.
  5. Select File > Exit to leave the registry editor.
MACOS / OSX

To remove the HFS client software on a Mac, the software can either be removed manually or by using the uninstaller provided with TSM 7.1.6.6 or IBM Spectrum Protect 8.1.0.2 and later.


Removing the HFS backup client using the uninstaller

  1. Run either 
    • Applications > IBM Spectrum Protect > Uninstall IBM Spectrum Protect
    • Applications > Tivoli Storage Manager > Uninstall TSM.
  2. Click the Yes button to start the uninstall process.
  3. Provide administrative authorisation.
  4. Click Yes to remove the Spectrum Protect / TSM configuration files, this is important to do if you need to change your nodename.

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. Ensure you have closed the backup client.
  2. Stop the Spectrum Protect / TSM Scheduler running by selecting either:
    • Applications > IBM Spectrum Protect > IBM Spectrum Protect Tools for Administrators > Stop the Client Acceptor Daemon
    • Applications > Tivoli Storage Manager > TSM Tools for Administrators Stop the Scheduler
  3. Provide your local administrator password when prompted.
  4. Open a terminal window by selecting Applications > Utilities > Terminal, then 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.

  5. 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.sysdsm.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
  6. If you want to remove the Spectrum Protect / TSM log files, run the following command:
    sudo rm -rf /Library/Logs/tivoli
LINUX

To remove the HFS client software on Linux systems, the packages you need to remove will depend on both the version of Spectrum Protect you have currently installed and which previous versions you had installed.  The packages may include any of the following:

 

Package name Notes
ox-hfs-sp-client Spectrum Protect 8.1 and higher
ox-hfs-sp-client-nogui Spectrum Protect 8.1 and higher
gskcrypt64 Required by TSM 6.3 and higher and Spectrum Protect 8.1 and higher
gskssl64 Required by TSM 6.3 and higher and Spectrum Protect 8.1 and higher
tsm-client TSM client 5.4 -7.1 (may also be present if you have upgraded from one of these versions to Spectrum Protect 8.1 or higher)
tsm-client-base TSM client 6.2 -7.1 (may also be present if you have upgraded from one of these versions to Spectrum Protect 8.1 or higher)
gskcrypt32 Required by TSM 6.2
gskssl32 Required by TSM 6.2
oucs-hfs-repo Older repository package that is no longer required

 

Removing these will still leave the HFS repository set up which is useful should you wish to reinstall.  To remove that too you also need to remove the ox-hfs-repo package.

Packages can usually be removed either using a GUI tool provided by your distribution or using the command line for various distributions as follows.

For Debian based systems, including Debian, Ubuntu, Kubuntu, Lubuntu, Xubuntu, Linux Mint, Zorin.

To remove packages retaining the existing configuration files,use apt-get remove if you're intending to reinstall, for example:

apt-get remove ox-hfs-sp-client

To remove packages removing the existing configuration files use apt-get purge, for example:

apt-get purge ox-hfs-sp-client

In either case do this for all the packages listed in the table.

For RedHat based systems including RedHat Enterprise Linux, Centos and Scientific Linux.

Packages can be removed with yum, for example:

yum erase ox-hfs-sp-client

For Fedora systems.

Packages can be removed with dnf, for example:

dnf erase ox-hfs-sp-client

For SUSE systems, including SUSE Enterprise Linux, OpenSUSE.

Packages can be removed with zypper, for example:

zypper remove ox-hfs-sp-client 

For Mandriva or Mageia systems.

Packages can be removed with urpme, for example:

urpme ox-hfs-sp-client

For other rpm based systems.

Packages can be removed with rpm, for example:

rpm -e ox-hfs-sp-client

For tar file installations, such as for Gentoo systems.

Spectrum Protect 8.1 or higher and TSM 6.2 and higher

To remove the TSM 6.2 Linux client

/opt/tivoli/tsm/client/ba/bin/HFSscheduler off
rm -rf /opt/tivoli
rm -rf /etc/adsm
rm -rf /usr/local/ibm/gsk*

TSM 6.1

To remove the TSM 6.1 Linux client

rm -rf /opt/tivoli
rm -rf /etc/adsm 

TSM 5.5, 5.4

To remove the TSM 5.5 or 5.4 Linux client

/opt/tivoli/tsm/client/ba/bin/HFSsched-remove.sh
rm -rf /opt/tivoli
rm -rf /etc/adsm 

TSM 6.1, 5.5, 5.4

To remove the TSM Linux client

rpm -e tsm-client

Log files

The log files in /var/log/dsm*.log are not removed by the removal process.  You may want to remove them manually to free up disk space.

Uninstalling TSM 5.3 and earlier

Depending on which version you have installed will mean you have a particular package name. The following table lists the different package names (in cases of package names ending in -b1 this also could be -b2, -b3, -b4, -b6):

TSM Version 5.1 5.2 5.3
Tarball Yes Yes Yes
RPM Package name TIVsm-OUCS TIVsm-OUCS-B1 tsm-client-b1
DEB Package name tivsm-oucs tivsm-oucs-b1 tsm-client-b1

 

Shutdown any scheduler process running:

# If using an init script - (here called 'dsmsched')
% dsmsched stop
% ps -ef | grep [d]smc # should return no output

# if just running in the background
% pid=`ps -ef | grep [d]smc | awk '{print $2}'`
% kill -TERM $pid   

Now uninstall the TSM software:

# Linux Redhat - as root user
% rpm -e TIVsm-OUCS

# Debian Linux - as root user
% dpkg --purge tivsm-oucs

# Removing an installation from tar files - as root user
% cd /opt
% rm -rf tivoli/
SOLARIS

The following process will remove the HFS client software on Solaris systems.


  1. Stop the scheduler daemon.
    • TSM / Spectrum Protect version 6 or higher:
      svcadm disable dsmsched
    • Earlier versions:

      svcadm disable dsmcad
  2. Remove the scheduler daemon.
    • TSM / Spectrum Protect version 6 or higher:
      svccfg delete svc:/network/dsmsched:default
    • Earlier versions:
      /opt/tivoli/tsm/client/ba/bin/uninstall_xml.sh
  3. Uninstall the client software.
    • TSM / Spectrum Protect version 6.4 or higher:
      pkgrm TIVsmCba
      pkgrm TIVsmCapi
      pkgrm gsk8ssl64
      pkgrm gsk8cry64
    • Version 6.2:
      pkgrm TIVsmCba
      pkgrm TIVsmCapi
      pkgrm gsk8ssl64
      pkgrm gsk8cry64
      pkgrm gsk8ssl32
      pkgrm gsk8cry32
    • Version 5.3 to 6.1:
      pkgrm TIVsmCoucs
    • Version 5.2 or earlier:
      pkgrm TIVsmCdoc pkgrm TIVsmCba pkgrm TIVsmCapi

Get support


Local IT support provide your first line of on-the-spot help

FIND MY LOCAL IT TEAM

 

Common requests and fault reports can be logged using self-service

   USE IT SELF-SERVICE    

   LOG A SUPPORT CALL    

VIEW MY SUPPORT CALLS  

The central Service Desk is available 24x7 on +44 1865 6 12345

 

If you do not have an SSO account you can use this form to contact the Service Desk