Installing RJS Tivoli/DR550 Storage Manager API

From Support

Contents 1 Installing IBM Tivoli Storage Manager API's 1.1 Step 1: Download 1.2 Step 2: Check for existing install 1.3 Step 3: Restore Licensed program 2 Installing RJS Tivoli Storage Manager API's 2.1 Step 1: Download 3 Configuring Tivoli Storage Manager API's for use 3.1 Step 1: Configure node 3.2 Step 2: Determine IP 3.3 Step 3: Create directory 3.4 Step 4: Create dsm.opt 3.5 Step 5: Create dsm.sys 3.6 Step 6: Run CFGRJSTSM 3.7 Step 7: Test Save 3.8 Step 8: Test Restore

Installing IBM Tivoli Storage Manager API's

Step 1: Download

Download and Install IBM Tivoli Storage Manage API library (Ver 5.3.4) if not already installed.

Username = *********
Password = ***********

Note: V5R2 or above is needed to install this API library. This is IBM's code library repackaged in a more user friendly installer.

Step 2: Check for existing install

After install, run the following command to see if the Tivoli Storage Manager API is already loaded on your iSeries.

GO LICPGM

Take option 10.

Look for: 5733197 *INSTALLED Tivoli Storage Manager APIs

If already installed, you are done. If not, continue.

Step 3: Restore Licensed program

Call the Restore Licensed program option from library RJSTSMINST by entering the following commands.

ADDLIBLE RJSTSMINST
CALL INSTALLTSM

When prompted to restore the license program, simply press Enter to continue.

Installing RJS Tivoli Storage Manager API's

Step 1: Download

Download and Install RJS Tivoli Storage Manage API library RJSTSM if not already installed.

Username = *********
Password = ***********

Configuring Tivoli Storage Manager API's for use

Step 1: Configure node

A node must be configure on the Tivoli Server and a password must be assigned to it. This node definition determines where documents will be stored on the Tivoli server.

Step 2: Determine IP

Detemine the IP address or host name for your Tivoli server.

Step 3: Create directory

Create a directory named: /home/rjstsm

MKDIR DIR('/home/rjstsm') DTAAUT(*RWX) OBJAUT(*ALL) 

Step 4: Create dsm.opt

Create a file named dsm.opt file in /home/rjstsm with the following entry in it:

SErvername Server1     

Create a file named dsm.opt file in /usr/Tivoli/TSM/Client/API/bin with the following entry in it:

SErvername Server1     

Step 5: Create dsm.sys

Create a file named dsm.sys file in /usr/Tivoli/TSM/Client/API/bin with the following entries in it:

SErvername  Server1    
   COMMMethod         TCPip      
   TCPPort            1500       
   TCPServeraddress   125.1.1.56 

DR550 Needs the following additional line

   ENABLEARCHIVERETENTIONPROTECTION  YES

Step 6: Run CFGRJSTSM

Run the CFGRJSTSM command to set up the environment variables.

CFGRJSTSM DSMICONFIG('/home/rjstsm/DSM.OPT') DSMIDIR('/USR/TIVOLI/TSM/CLIENT/API/BIN') DSMILOG('/home/rjstsm') NODE('NODET1') APPTYPE('RJSTSMAPI') LOGLVL(*DEBG)                                                                          

Note: Where we use node NODET1, you will use the node name you created in Tivoli Storage Manager.

Step 7: Test Save

Test save a document to Tivoli server:

RJSTSMSTR PASSWORD(NODET1) FILENAME('/TEST.PDF') FSNAME(WEBDOCS) HLNAME('/RJSIMAGEDOC') LLNAME('/TEST.PDF') DELETE(*NO) DSPSTDERR(*YES)                   

Note: The node password is entered. In our example the node password matches the node user.

Step 8: Test Restore

Test restore a document from Tivoli server saved path.

RJSTSMGET PASSWORD(NODET1) FILENAME('/TEST.PDF') FSNAME(WEBDOCS) HLNAME('/RJSIMAGEDOC') LLNAME('/TEST.PDF') REPLACE(*NO) DSPSTDERR(*YES)                   

Note: The node password is entered. In our example the node password matches the node user.