This article provides the steps involved in recovering spectrum protect server instance when Server Instance user is deleted. This procedure is a helpful when Spectrum Protect AIX server instance user gets deleted along with instance user home directory. IBM Spectrum Protect formerly known as TSM (Tivoli Storage Manager) is an enterprise class Data Protection software.
About this task
To recover Spectrum Protect server instance when instance user is deleted by adding instance user, creating server instance, and cataloging database.
Prerequisite Steps
Make sure prerequisite steps are performed before actual steps are performed
Spectrum Protect server instance will not start once the instance user is deleted. If the server instance user got deleted with user home directory intact only recreating instance user is required. In case both instance user along with instance home directory is deleted recovery requires adding instance user, creating server instance, and cataloging database.
Spectrum Protect server Instance directory should be available and a backup of this folder to a safe network location is recommended before proceeding. Server Instance database and recovery log directories are also expected to be available on server and intact.
Actual Steps
Below mentioned steps will recover Spectrum Protect server instance when instance user is deleted along with instance home directory.
Step 1:
First step is to recreate instance user and group. The instance user and group details should match how it was setup originally before delete. Refer example commands below:
mkgroup id=1001 tsmsrvrs
mkuser id=1002 pgrp=tsmsrvrs home=/home/tsminst1 tsminst1
passwd tsminst1
Step 2:
After group and server instance user is created next step is to create spectrum server instance manually.
The name of the instance must be the same name as the user that owns the instance
Log in using the root user ID and create the server Instance issuing the following command
/opt/tivoli/tsm/db2/instance/db2icrt -a server -s ese -u instance_name instance_name
For example, if the user ID for this instance is tsminst1, use the following command to create the instance:
/opt/tivoli/tsm/db2/instance/db2icrt -a server -s ese -u tsminst1 tsminst1
Remember: From this point on, use this new user ID when you configure the Tivoli Storage Manager server. Log out of the root user ID, and log in using the user ID that is the instance owner.
Step 3:
Next step is to change the default path for the database to be the same as the instance directory for the server instance. Issue the command:
db2 update dbm cfg using dftdbpath instance_directory
For example:
db2 update dbm cfg using dftdbpath /tsminst1
Step 4:
Next step is to modify the library path to use the version of the IBM Global Security Kit (GSKit) that is installed with the Tivoli Storage Manager server. Issue below commands as instance user:
export LIBPATH=/usr/opt/ibm/gsk8_64/lib64:$LIBPATH
export LIBPATH= server_bin_directory /dbbkapi: /usr/opt/ibm/gsk8_64/lib64:$LIBPATH
where, server_bin_directory is a sub directory of the server installation directory.
For example:
export LIBPATH=/usr/opt/ibm/gsk8_64/lib64:$LIBPATH
export LIBPATH=/opt/tivoli/tsm/server/bin/dbbkapi: /usr/opt/ibm/gsk8_64/lib64:$LIBPATH
Step 5:
Verify the library path settings and that the GSKit is version 8.0.14.14 or later.
Issue the following commands:
echo $LIBPATH
gsk8capicmd_64 -version
gsk8ver_64
If the GSKit version is not 8.0.14.14 or later, you must reinstall the Tivoli Storage Manager server. The reinstallation ensures that the correct GSKit version is available.
Step 6:
Next step is to catalog the spectrum protect server instance database by issuing the following command:
db2 catalog db tsmdb1
Step 7:
After database catalog completes successfully verify by listing the Database Directories.
Issue the following command:
db2 list db directory
Step 8:
Start the spectrum protect server instance as instance user and verify everything is working normally.
Additionally spectrum protect server instance has to be configured for database backup manually.
