Completing the move to Code42 CrashPlan Cloud Backup

Once you have Code42 CrashPlan successfully backing up all the data you wish to protect on any one machine for several days, you can now uninstall the old Spectrum Protect client software and deregister the machine from the legacy HFS desktop backup service. The drivers for this are several:

Leaving unused programs and apps on your computer is a security risk as they typically are not updated.
It is inefficient and poor practice to have two competing products backing up the same system. They may well both fail due to competing for limited resources on your machine, or compete for access to the same file(s) at the same time.
The Code42 CrashPlan product offers a better backup service than the old IBM-based client, as detailed on the benefits of the Code42 CrashPlan Cloud Backup Service page.
Uninstalling the IBM client software and deregistering the old machine account frees up valuable licence capacity in the IBM-based service for the future.

The processes of uninstalling the client software and deregistering the account can occur in either order. You can easily deregister your machine account via the HFS Portal (select the node you wish to deregister and then choose the deregister node item in the left hand menu then click Proceed to the message displayed). Having deregistered a node account, it is now important to uninstall the IBM client software. This process is specific to your operating system and instructions are detailed under the respective tabs below.

Note: The process of uninstalling the old 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 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 Tivoli Storage Manager Client/IBM Spectrum Protect Client and select Uninstall
Select OK if prompted to close the client scheduler or other Spectrum Protect/TSM-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 (for older IBM clients)

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:

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

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.

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

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.

macOS

To remove the HFS IBM 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 IBM backup client using the uninstaller

Run either
- Applications > IBM Spectrum Protect > Uninstall IBM Spectrum Protect
- Applications > Tivoli Storage Manager > Uninstall TSM.
Click the Yes button to start the uninstall process.
Provide administrative authorisation.
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 IBM backup client

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 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
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 Spectrum Protect / TSM configuration files. To do this, enter the following command:
```
sudo rm -rf /Library/Preferences/Tivoli\ Storage\ Manager
```
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.

Expand All

Debian based distributions

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.

Red Hat based distributions

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

Fedora based distributions

For Fedora systems.

Packages can be removed with dnf, for example:

dnf erase ox-hfs-sp-client

SUSE based distributions

For SUSE systems, including SUSE Enterprise Linux, OpenSUSE.

Packages can be removed with zypper, for example:

zypper remove ox-hfs-sp-client

Mageia / Mandriva distributions

For Mandriva or Mageia systems.

Packages can be removed with urpme, for example:

urpme ox-hfs-sp-client

Other rpm based distributions

For other rpm based systems.

Packages can be removed with rpm, for example:

rpm -e ox-hfs-sp-client

Tar file

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/