Removing the Storage Protect software

There are several reasons why you may need or wish to remove the Storage 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 Storage 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 Storage Protect Client and select Uninstall
  5. Select OK if prompted to close the client scheduler or other Storage 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 Storage 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 Storage 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 IBM Storage Protect client software on a Mac, the software can either be removed manually or by using the uninstaller provided with Storage Protect


Removing Storage Protect using the uninstaller

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

Manually removing Storage 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 Storage Protect Scheduler running Applications > IBM Storage Protect > IBM Storage 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 Storage Protect configuration files, this is important to do if you need to change your Storage Protect nodename.  These files are dsm.sysdsm.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 Storage Protect log files, run the following command:
    sudo rm -rf /Library/Logs/tivoli
Linux

To remove the Storage Protect software on Linux systems, the packages you need to remove will depend on both the version of Storage 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-storage-protect Storage Protect 8.1.22 and higher
ox-hfs-spectrum-protect Spectrum Protect 8.1.13 to 8.1.20
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-storage-protect

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

apt-get purge ox-hfs-storage-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-storage-protect

For Fedora systems.

Packages can be removed with dnf, for example:

dnf erase ox-hfs-storage-protect

For SUSE systems, including SUSE Enterprise Linux, OpenSUSE.

Packages can be removed with zypper, for example:

zypper remove ox-hfs-storage-protect 

For Mandriva or Mageia systems.

Packages can be removed with urpme, for example:

urpme ox-hfs-storage-protect

For other rpm based systems.

Packages can be removed with rpm, for example:

rpm -e ox-hfs-storage-protect

For tar file installations, such as for Gentoo systems.

Storage Protect 8.1.22 or higher and Spectrum Protect 8.1.13-8.1.20

To remove the Storage Protect or 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 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 client

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

TSM 5.5, 5.4

To remove the TSM 5.5 or 5.4 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.

Get support


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

Get IT support

 

Submit a suggestion, compliment or complaint