Configuring IBM Spectrum Protect client for LAN-free backups

To configure IBM Spectrum Protect client for LAN-free backups, you must run some manage_tsm commands, change the node passwords for IBM Spectrum Protect client, configure IBM Spectrum Storage Agent, and configure IBM Spectrum Protect server.

Important:

To use the IBM Spectrum Protect client for LAN-Free operations to disk, contact IBM Support for the initial setup.

If a container is recreated, or you run an upgrade to a newer IAS release after LAN-free configuration has been completed, you must start STA services again using manage_tsm --start-dsmsta.

Before you begin

The IBM Spectrum Protect server administrator must register the system nodes with IBM Spectrum Protect server.
The IBM Spectrum Protect server must operate on either the same level as the IAS Client or a higher level than the Client.
To check the client version, run the version -a | grep tsm_version command as a bluadmin user inside the Db2 container.
All nodes must be externalized.

About this task

Do this task as the bluadmin user.

Procedure

Ensure that the external storage is mounted as a GPFS file system and is accessible by both IBM Spectrum Protect server and IBM Spectrum Protect client.
Continue with Configure IBM Spectrum Protect server for LAN-free backups.

Run one of the following manage_tsm commands:

If you use default values for the configuration of IBM Spectrum Protect client, run the following command:

manage_tsm --servername tsm_name --serveraddress tsm_address --configure-api-sta

Example with default values set:

[bluadmin@node0101-fab - Db2wh ~]$ cat /head/tsm/api/node0101-fab/dsm.sys 
servername tsm_name
tcpserveraddress tsm_address
commmethod tcpip
passwordaccess generate
tcpport 1500
ssl yes
enablelanfree yes
lanfreeshmport 1510
lanfreecommmethod sharedmem
passworddir /head/tsm/api/node0101-fab/cred_store

If you do not use default values for the configuration of IBM Spectrum Protect client, run the following command:

manage_tsm --serveraddress address --servername name --commmethod method --tcpport port number --lanfreecommmethod lanfree communication method --lanfreeshmport lanfree shared memory port --enablelanfree yes=LAN-free/no=not LAN-free --ssl yes/no --configure-api-sta

In the following example, the configuration is done on all nodes simultaneously.

[bluadmin@node0101-fab -Db2wh ~]$ manage_tsm --serveraddress tsm_address --servername tsm_name --commmethod tcpip --tcpport 1500--lanfreecommmethod sharedmem--lanfreeshmport 1512 --enablelanfree yes --ssl no --configure-api-sta

Request the original node password or node passwords for IBM Spectrum Protect client from IBM Spectrum Protect server.

Change these node password or passwords for IBM Spectrum Protect client by running the manage_tsm --password-change command.

The following example shows the password change on a three-node system:

[bluadmin@node0101-fab -dashDB /]$ manage_tsm --password-change
Updating IBM Spectrum Protect API password
Update the password for node0101-fab:
*******************************
******************************
* Tivoli Storage Manager
*
* API Version = 8.1.2 
*
*************************************************************
Enter your current password:
Enter your
new password:
Enter your new password again:
Your new password has been accepted and updated.
Connection to node0101-fab closed.
Update the password for node0102-fab:
*************************************************************
* Tivoli Storage Manager
*
* API Version = 8.1.2 
*
*************************************************************
Enter your current password:
Enter your new password:
Enter your new password again:
Your new password has been accepted and updated.
Connection to node0102-fab closed.
Update the password for node0103-fab:
*************************************************************
* Tivoli Storage Manager
*
* API Version = 8.1.2 
*
*************************************************************
Enter your current password:
Enter your new password:
Enter your new password again:
Your new password has been accepted and updated.
Connection to node0103-fab closed.

Configure Spectrum Storage Agent for IBM Spectrum Protect client by running the following command:

[bluadmin@node0104-fab -Db2wh ~]$ manage_tsm --dsmsta-setstorageserver

The following example shows the resulting configuration:

[bluadmin@node0101-fab - Db2wh ~]# manage_tsm --dsmsta-setstorageserver
Running dsmsta setstorageserver command
Enter server name: <server name>
Enter server password: <password>
Enter server IP: <server IP>
Enter low level address port(client side): 1500
Enter session security type: strict
Enter secure sockets layer (SSL): yes
Running setstorage server command on node0101-fab
Enter storage agent name: node0101_sf <ensure that this name is registered on Spectrum Protect server>
Enter storage agent password: <password registered on server for node0101_sf>
Enter storage agent IP: <node IP>


Executing the dsmsta command with input values provided
ANR7800I DSMSERV generated at 00:20:01 on Feb  5 2019.

IBM Spectrum Protect for Linux/ppc64le
Version 8, Release 1, Level 7.000

Licensed Materials - Property of IBM

(C) Copyright IBM Corporation 1990, 2019.
All rights reserved.
U.S. Government Users Restricted Rights - Use, duplication or disclosure
restricted by GSA ADP Schedule Contract with IBM Corporation.

ANR7801I Subsystem process ID is 89508.
ANR0900I Processing options file /head/tsm/sta/node0101-fab/dsmsta.opt.
ANR7814I Using instance directory /head/tsm/sta/node0101-fab.
ANR3339I Default Label in key data base is TSM Server SelfSigned SHA Key. 
ANR4726I The ICC support module has been loaded.
ANR1432I Updating device configuration information to defined files.
ANR1433I Device configuration information successfully written to devconfig.txt.
ANR2119I The SERVERNAME option has been changed in the options file.
ANR0467I The SETSTORAGESERVER command completed successfully.
Connection to node0101-fab closed.
Successfully started dsmsta service on node0101-fab