Removing the Spectrum Protect software

How to remove the Spectrum Protect software from your machine

There are several reasons why you may need or wish to remove the Spectrum Protect 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.

Note: The process of uninstalling the client software below requires a login to the machine in question. We understand that where neither you or your local IT Support have neither physical access to, nor the possibility of remotely logging in to, your machine, then the uninstall process will have to wait until such time as one of these is possible.

WINDOWS

To remove the HFS IBM Spectrum Protect client software fully in Windows you will need to first uninstall the software. On older IBM clients some components are not completely removed by the uninstall process and in this case need to be removed manually (see section below the uninstall process). 

Uninstall the software

  1. Open Windows Start Menu then type Control Panel.
  2. Open Control Panel.
  3. Select Programs and Features
  4. Locate IBM Spectrum Protect Client and select Uninstall
  5. Select OK if prompted to close the client scheduler or other Spectrum Protect 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 manual methods detailed below.

Manual removal

  • Remove the services

The installation process does not always remove the Windows services associated with Spectrum Protect/ 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. 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"
  4. 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.

  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.
  • 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

To remove the HFS client software on a Mac, the software can either be removed manually or by using the uninstaller provided with Spectrum Protect

Removing Spectrum Protect using the uninstaller

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

Manually removing Spectrum Protect

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 Applications > IBM Spectrum Protect > IBM Spectrum Protect Tools for Administrators > Stop the Client Acceptor Daemon
  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 configuration files, this is important to do if you need to change your Spectrum Protect nodename.  These files are dsm.sys, dsm.opt 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 log files, run the following command:
    sudo rm -rf /Library/Logs/tivoli
LINUX

To remove the Spectrum Protect 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-spectrum-protect Spectrum Protect 8.1.13 and higher
ox-hfs-sp-client Spectrum Protect 8.1.0 to 8.1.11
ox-hfs-sp-client-nogui Spectrum Protect 8.1.0 to 8.1.11
gskcrypt64 Required by TSM 6.3 and higher and Spectrum Protect 8.1.0 to 8.1.11
gskssl64 Required by TSM 6.3 and higher and Spectrum Protect 8.1.0 to 8.1.11
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-spectrum-protect

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

apt-get purge ox-hfs-spectrum-protect

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-spectrum-protect

For Fedora systems.

Packages can be removed with dnf, for example:

dnf erase ox-hfs-spectrum-protect

For SUSE systems, including SUSE Enterprise Linux, OpenSUSE.

Packages can be removed with zypper, for example:

zypper remove ox-hfs-spectrum-protect

For Mandriva or Mageia systems.

Packages can be removed with urpme, for example:

urpme ox-hfs-spectrum-protect

For other rpm based systems.

Packages can be removed with rpm, for example:

rpm -e ox-hfs-spectrum-protect

For tar file installations, such as for Gentoo systems.

Spectrum Protect 8.1.13 or higher

To remove the Spectrum Protect client

/opt/tivoli/tsm/client/ba/bin/HFSscheduler off
rm -rf /opt/tivoli
rm -rf /etc/adsm

Spectrum Protect 8.1.0-8.1.11 and TSM 6.2 and higher

To remove the Spectrum Protect or TSM 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

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.

Related links

Get support

If you cannot find the solution you need here then we have other ways to get IT support

Get IT support