Removing the Storage Protect software
How to remove the Storage Protect software from your machine
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.
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
- Open Windows Start Menu then type Control Panel.
- Open Control Panel.
- Select Programs and Features
- Locate IBM Storage Protect Client and select Uninstall
- Select OK if prompted to close the client scheduler or other Storage Protect related services.
- You will be returned to the Add/Remove Programs screen when the uninstallation process is complete.
- 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:
- Open Windows Start Menu then type cmd.
- Right click on Command Prompt and select Run as administrator
- 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"
- 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.
- 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
- 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.
- Open Windows Start Menu then type regedit.
- Right click on regedit.exe and select Run as administrator.
- From HKEY_LOCAL_MACHINE\SOFTWARE\IBM, delete the ADSM registry key.
- From HKEY_LOCAL_MACHINE\SOFTWARE, delete the Tivoli registry key.
- Select File > Exit to leave the registry editor.
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
- Run Applications > IBM Storage Protect > Uninstall IBM Storage Protect
- Click the Yes button to start the uninstall process.
- Provide administrative authorisation.
- 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.
- Ensure you have closed the backup client.
- Stop the Storage Protect Scheduler running Applications > IBM Storage Protect > IBM Storage Protect Tools for Administrators > Stop the Client Acceptor Daemon
- Provide your local administrator password when prompted.
- 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.
- 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.sys, dsm.opt and TSM.PWD. To remove them, enter the following command:
sudo rm -rf /Library/Preferences/Tivoli\ Storage\ Manager
- If you want to remove the Storage Protect log files, run the following command:
sudo rm -rf /Library/Logs/tivoli
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
Submit a suggestion, compliment or complaint