Uninstall script (uninstall.sh)

If a TSLM installation script is used to install TSLM, you can use the uninstall script uninstall.sh to uninstall TSLM.

The uninstall script removes the TSLM database (database ermm) from Db2® and removes the TSLM packages.

Recommendation: Before you run the uninstall script, back up your TSLM database (database ermm).

The uninstall script can be run only with root account.

Before you run the uninstall script, ensure that these prerequisites are met:

All backup applications that use TSLM must be stopped.
The Media Manager must be stopped.
All Library Managers must be stopped.

TSLM installation scripts make an uninstall script available under the directory /opt/IBM/ermm:

-rwxr-xr-x    1 root     system        12658 Feb 29 04:41 uninstall.sh

Parameter options for the uninstall script

You can view all parameter options for the uninstall script by running the script without specifying any options. For example, the following is output from uninstall.sh when run with no options:

IBM Tape System Library Manager
Licensed Materials - Property of IBM
(C) Copyright IBM Corp. 2004, 2013 All Rights Reserved

Uninstall Tape System Library Manager and drop database ermm.
Usage: uninstall.sh [-p] [-d] [-b] [-h]
Options:
  -p    Uninstall TSLM packages only.
  -d    Drop database ermm only.
  -b    Uninstall TSLM packages and drop database ermm.
  -h    Display this help and exit.

You can specify the following parameters when you run an uninstall script:

-p: Specify the -p option to uninstall TSLM packages only.
-d: Specify the -d option to drop the TSLM database only.
-b: Specify the -b option to uninstall TSLM packages and drop the TSLM database.
-h: Shows the help description for the script.

Log files for the uninstall script

Messages that are generated by an uninstall script are written to a log file named /tmp/tslmlog/tslm_unint.log. If a log file exists in the same directory, the old log file is renamed to tslm_uninst.log.previous.

The following example uninstall log file shows the messages that are generated by running the uninstall script with the command root@tslm[../IBM/ermm] ./uninstall.sh -b, which uninstalls the TSLM packages and drops the TSLM database.

IBM Tape System Library Manager
Licensed Materials - Property of IBM
(C) Copyright IBM Corp. 2004, 2013 All Rights Reserved

Uninstalling TSLM packages and dropping database ermm...
################################################################################
Start of TSLM uninstallation on Wed Feb 29 05:10:27 CUT 2013
################################################################################

################################################################################
Try to stop the server processes of TSLM...
################################################################################
Trying to run /opt/IBM/ermm/bin/ermmLmStop...
IBM Tape System Library Manager
Licensed Materials - Property of IBM
(C) Copyright IBM Corp. 2004, 2013 All Rights Reserved

No active Library Manager found to stop.

Trying to run /opt/IBM/ermm/bin/ermmStop...
IBM Tape System Library Manager
Licensed Materials - Property of IBM
(C) Copyright IBM Corp. 2004, 2013 All Rights Reserved

IBM Tape System Library Manager not running

No Library Manager process detected.

No Media Manager process detected.

Done!

################################################################################
Dropping database ermm...
################################################################################
All data in the current database will be lost. Would you really like to continue
? (y/n)
y
Done!

################################################################################
Start uninstalling TSLM packages...
################################################################################
Attempting to remove tslm.pwgen
Removal of tslm.pwgen was successful.

Attempting to remove tslm.cli
Removal of tslm.cli was successful.

Attempting to remove tslm.elm
Removal of tslm.elm was successful.

Attempting to remove tslm.hdm
Removal of tslm.hdm was successful.

Attempting to remove tslm.lm
Removal of tslm.lm was successful.

Attempting to remove tslm.mm
Removal of tslm.mm was successful.

Attempting to remove tslm.system
Removal of tslm.system was successful.

Attempting to remove tslm.base
Removal of tslm.base was successful.

Done!
################################################################################
Try to stop Host Drive Manager process...
################################################################################
No Host Driver Manager process detected.

Uninstallation of TSLM completed successfully.

################################################################################
End of TSLM uninstallation on Wed Feb 29 05:10:42 CUT 2013
################################################################################

Return codes from the uninstall script

Possible return codes from the uninstall script are described in Table 1.

Table 1. Return codes from the uninstall script
Return code	Short name	Description
0	Success	The script was successful.
1	Account is non-root	The script failed because it was issued from a non-root account.
2	Log file was not created	The script failed because no log file can be created.
3	Option is incorrect	The script failed because one or more incorrect options were specified.
4	Unable to drop database	The script failed because it cannot drop an existing database.
5	Package uninstall cannot complete	The script failed because it cannot complete uninstallation of a package.
6	DB2® access is denied	The script failed because the `ermm` account does not have authority to issue Db2 commands.