HFS : Uninstalling the TSM Client Software

1. Introduction

When you no longer require use of the HFS Backup Service, or when you leave Oxford permanently, you are required to uninstall TSM Client Software from your machine and deregister the machine from the HFS via the registration pages. The order in which you do this is unimportant.

Uninstalling the TSM Client Software involves two steps:

  1. Stopping / shutting down any scheduler daemon services.
  2. Removing the TSM software from your local machine.

Platform-specific instructions on how to do this are detailed from the links below.

1.1. Uninstalling TSM from Windows

  1. ( If you are uninstalling from a Windows 98 or ME machine, please refer to the 1.8. Uninstalling TSM from older systems section below.) Shutdown any TSM Schedule service running by starting the TSM Backup Client GUI. From the [ Utilities | Setup Wizard ] menu option choose the configure the TSM Client Scheduler option. From the following screen choose the Remove ... option and from the next screen highlight the Scheduler entry in the window and click 'Next'. From the final screen click the Finish button.
  2. Close any TSM program running.
  3. Remove the TSM software by opening [ Start | Settings | Control Panel | Add/Remove Programs ]. In the window that opens, click the entry 'IBM Tivoli Storage Manager Client' and click the Remove button. Answer yes to all subsequent prompts for confirmation.

1.2. Uninstalling TSM from Mac OSX

  1. Stop the TSM Scheduler by running [TSM Tools for Administrators] and selecting either [Stop the Client Acceptor Daemon] or [Stop the Scheduler].
  2. Quit any TSM Backup program running.
  3. Remove the TSM application folder and all its contents.
  4. Delete the TSM configuration files - on OSX 10.4.7 and later these are dsm.sys, dsm.opt and TSM.PWD; and on earlier versions of Mac OSX they are TSM System Preferences, TSM User Preferences and TSM.PWD.
  5. In a Terminal window run 
    # sudo /Library/Application\ Support/tivoli/tsm/client/ba/bin/uninstall.sh
    - you will be prompted for the local administrator password.
  6. Additionally, you may want to remove the TSM configuration files - this is important to do if you need to change your TSM nodename. To do this, enter the following command: 
    # sudo rm -rf /Library/Preferences/Tivoli\ Storage\ Manager

1.3. Uninstalling TSM 5.4 and later from Linux

1.3.1. Debian based systems

1.3.1.1. TSM 6.3

To remove the TSM 6.3 Linux client retaining the existing configuration files

 apt-get remove tsm-client tsm-client-base gskcrypt64 gskssl64

To remove the TSM 6.3 Linux client and the configuration files

 apt-get purge tsm-client tsm-client-base gskcrypt64 gskssl64

This will still leave the OUCS HFS repository set up should you wish to reinstall. To remove that do

 apt-get remove oucs-hfs-repo
1.3.1.2. TSM 6.2

To remove the TSM 6.2 Linux client retaining the existing configuration files

 apt-get remove tsm-client tsm-client-base gskcrypt32 gskssl32

To remove the TSM 6.2 Linux client and the configuration files

 apt-get purge tsm-client tsm-client-base gskcrypt32 gskssl32

This will still leave the OUCS HFS repository set up should you wish to reinstall. To remove that do

 apt-get remove oucs-hfs-repo
1.3.1.3. TSM 6.1, 5.5, 5.4

To remove the TSM Linux client retaining the existing configuration files

 apt-get remove tsm-client

To remove the TSM Linux client and the configuration files

 apt-get purge tsm-client

1.3.2. RPM based systems

1.3.2.1. TSM 6.3

To remove the TSM 6.3 Linux client

 rpm -e tsm-client tsm-client-base gskcrypt64 gskssl64

This will still leave the OUCS HFS repository set up should you wish to reinstall. To remove that do

 rpm -e oucs-hfs-repo
1.3.2.2. TSM 6.2

To remove the TSM 6.2 Linux client

 rpm -e tsm-client tsm-client-base gskcrypt32 gskssl32

This will still leave the OUCS HFS repository set up should you wish to reinstall. To remove that do

 rpm -e oucs-hfs-repo
1.3.2.3. TSM 6.1, 5.5, 5.4

To remove the TSM Linux client

 rpm -e tsm-client

1.3.3. Uninstalling a tar file installation

1.3.3.1. TSM 6.2 or 6.3

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*
1.3.3.2. TSM 6.1

To remove the TSM 6.1 Linux client

 rm -rf /opt/tivoli
 rm -rf /etc/adsm
1.3.3.3. 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
1.3.3.4. TSM 6.1, 5.5, 5.4

To remove the TSM Linux client

 rpm -e tsm-client

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

1.4. Uninstalling TSM 5.3 and earlier from Linux

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 3.1, 3.7, 4,1 4.2 5.1 5.2 5.3
Tarball Yes Yes Yes Yes Yes
RPM Package name N/A TIVsm-BA (and) TIVsm-API TIVsm-OUCS TIVsm-OUCS-B1 tsm-client-b1
DEB Package name N/A N/A tivsm-oucs tivsm-oucs-b1 tsm-client-b1

Shutdown any scheduler process running as below: 

	# 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 as below: 

	# 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/

1.5. Uninstalling TSM 5.4 and later from Solaris 9,10

To uninstall TSM:

	# as root user
	% pkgrm TIVsmCoucs

This will stop the scheduler process from running, but it is worth checking this has happened i.e:

	% ps -ef | grep dsmc

1.6. Uninstalling TSM 5.3 from Solaris 9 and 10

Shutdown any scheduler process running as below:

	# Using the Service Management facility - as root
	% cd  /opt/tivoli/tsm/client/ba/bin
	% ./uninstall_xml.sh

Now uninstall the TSM software as below:

	# as root user
	% pkgrm TIVsmCoucs

1.7. Uninstalling TSM from Netware 4.x 5.x 6.x

To uninstall TSM from Netware, perform the following steps.

  1. Shutdown the TSM Scheduler by unloading the DSMCAD.NLM module.
  2. Shutdown any TSM Backup program running by unloading the DSMC.NLM module.
  3. Remove any entry for running TSM in the AUTOEXEC.NCF file.
  4. Remove the TSM installation directory and all it's contents.

1.8. Uninstalling TSM from older systems

1.8.1. Uninstalling TSM from Windows 98/ME

  1. Close any TSM Scheduler program running and remove the file OUCS Scheduler.bat.
  2. Delete any TSM batch file from the C:\Windows\Start Menu\Programs\StartUp folder.
  3. Close any TSM Backup program running.
  4. Remove the TSM software by opening [ Start | Settings | Control Panel | Add/Remove Programs ]. In the window that opens, highlight the 'Tivoli Storage Manager Client' entry and click the Add/Remove button. Follow the Installshield Wizard to chose the Remove option.

1.8.2. Uninstalling TSM from Mac OS 8 & 9

  1. Shutdown any TSM Scheduler or Schedule Daemon program running.
  2. Remove any TSM Schedule or Schedule Daemon program from the StartUp Items folder.
  3. Quit any TSM Backup program running.
  4. Remove the TSM application folder and all its contents.
  5. Delete the TSM configuration files TSM System Preferences, TSM User Preferences and TSM.PWD in the System:Library:Preferences folder.

1.8.3. Uninstalling TSM from Solaris 7,8,9

Shutdown any scheduler process running as below:

	# 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 as below:

	# If running TSM version 5.3 
	#  as root user
	% pkgrm TIVsmCoucs

	# If running TSM version 5.2 or earlier
	# as root user
	% pkgrm TIVsmCdoc
	% pkgrm TIVsmCba
	% pkgrm TIVsmCapi

Up: Contents