Manually upgrading IBM Spectrum Protect server instances

Content

Tip: Beginning with Version 7.1.3, IBM Tivoli Storage Manager is now IBM Spectrum Protect. Some applications such as the software fulfillment systems and IBM License Metric Tool use the new product name. However, the software and its product documentation continue to use the Tivoli Storage Manager product name. To learn more about the rebranding transition, see
http://www.ibm.com/support/docview.wss?uid=swg21963634 (Tivoli Storage Manager branding transition to IBM Spectrum Protect).

To use a wizard, the IBM Spectrum Protect upgrade requires one of the following protocols on the default port, and that port cannot be blocked by a firewall:
-Secure shell (SSH)
-Remote shell (RSH)
-Remote Execution Protocol (REXEC)

-Windows® server message block (SMB)

If a connection cannot be established using SSH, RSH, REXEC, or SMB, manually upgrade the IBM Spectrum Protect server instance.

AIX®, Linux®, and UNIX®:

Close the installation wizard if you receive an error message indicating that the
wizard could not connect to your system using SSH, RSH, or REXEC:
All attempts to establish a connection as the instance user ID have failed. This might be due to an inability to connect to the local machine through the SSH, RSH, REXEC, or Windows SMB protocols.

Then, use the following procedure to manually upgrade the server instance.

First, rename the instance file. You can find this file in the following location:
/etc/tivoli/tsm/instance.info

The instance file looks similar to this example and contains DB2 environment
variables as configured for your server instance . Use the
values in this file for the commands necessary to manually upgrade the server
instance.

<Instance>
<InstanceName>tsminst1</InstanceName>
<InstanceUser>tsminst1</InstanceUser>
<DefaultDatabasePath>/home/tsminst1/tsminst1</DefaultDatabasePath>
<Database>
<DatabaseName>TSMDB1</DatabaseName>
<DatabasePath>/home/tsminst1/tsminst1</DatabasePath>
</Database>
<Variables>
<Variable>DB2_SKIPINSERTED=ON></Variable>
<Variable>DB2_KEEPTABLELOCK=ON</Variable>
<Variable>DB2_EVALUNCOMMITTED=ON</Variable>
<Variable>DB2_SKIPDELETED=ON</Variable>
<Variable>DB2CODEPAGE=819</Variable>
<Variable>DB2_PARALLEL_IO=*</Variable>
</Variables>
</Instance>

After renaming the instance file, complete the following steps.
Important: Complete steps 1-6 for each one of your IBM Spectrum Protect server instances.

1. Issue the following command:
/opt/tivoli/tsm/db2/instance/db2idrop InstanceName

2. Start the installation wizard again and step through it to upgrade the server.

3. After the upgrade, recreate each of the instances using the following command:
/opt/tivoli/tsm/db2/instance/db2icrt –u InstanceUser InstanceName

4. Recreate the variables in the instance file using the db2set -i command. Issue
this command for each variable in your instance file. Ensure that the variable is
in quotation marks:
/opt/tivoli/tsm/db2/instance/db2set –i InstanceName "Variable"

For example, to recreate the first variable in the example instance file, issue the
following command:
db2set -i tsminst1 "DB2_SKIPINSERTED=ON"

5. Stop and start the database instance.
Connect as the user ID that owns the server instance, then issue the following
commands:

a. Start DB2®:
db2start

b. Catalog and upgrade each database:
“db2 catalog db DatabaseName on DatabasePath"
“db2 upgrade db DatabaseName"

c. Stop DB2:
db2stop

6. Start and run the IBM Spectrum Protect server.

Windows®:

Close the installation wizard if you receive an error message indicating that the
wizard could not connect to your system using SSH, RSH, REXEC, or SMB:
All attempts to establish a connection as the instance user ID have failed. This might be due to an inability to connect to the local machine through the SSH, RSH, REXEC, or Windows SMB protocols.

Then, complete the following procedures to manually upgrade the server instance.

After renaming the instance file, complete the following steps.
Important: Complete steps 1-6 for each one of your IBM Spectrum Protect server instances.

1. Log on to the Windows system that runs the IBM Spectrum Protect server. Log on with the same Windows account that runs the server instance service, for example, the TSM Server1 service.

The Windows account must be part of the DB2ADMNS and DB2USERS groups.

Open a DB2 command window and issue the following commands :
set DB2INSTANCE=Server1
db2set

Keep the output of the DB2SET command in case it is needed later to recreate the environment correctly.

2. Start the installation wizard again and step through it to upgrade the server. During the upgrade process, you are prompted to provide the instance user name and password. Above the name and password fields, there is a check box to update your instance. Ensure that the box is not checked or the database instance will be updated.

3. During the upgrade, the server instance is automatically dropped.
After the upgrade, it is necessary to recreate each of the instances using the following command:
/opt/tivoli/tsm/db2/instance/db2icrt –u InstanceUser InstanceName

4. Run the DB2SET command. This command displays the current environment
that is configured for the instance. Recreate the variables by using this command:
db2set -i

Ensure that the variable is in quotation marks.

For example, to recreate the first variable in the example instance file, issue the
following command:
db2set -i server1 "DB2_SKIPINSERTED=ON"

5. Stop and start the database instance:

a. Open a DB2 command window. One method of doing this is by going to
the C:\Program Files\Tivoli\TSM\db2\bin directory, or if you installed
IBM Spectrum Protect in a different location, go to the db2\bin
subdirectory in your main installation directory. Then, issue this command:
db2cmd

b. Set the database instance:
set db2instance=InstanceName

c. Start DB2:
db2start

d. Catalog and upgrade each database name. The DatabasePath is the drive, for example, D:, if the DB2 database catalog exists on the D drive.
“db2 catalog db DatabaseNameon DatabasePath"
“db2 upgrade db DatabaseName"

e. Stop DB2:
db2stop

6. Start and run the IBM Spectrum Protect server.