At IU, how do I install the TSM client software in Linux?

To install the TSM client software in Linux:

1. Select the appropriate TSM client package from IUware's Linux Utilities Software section.
   
   
2. Read the associated README file, and then download the TSM client package.
   
   
3. Log into your server as the root user.
   
   
4. Move the TSM tarball to /usr/local/src, or another directory of your choice.
   
   
5. Untar the client package as follows, replacing x.x.x.x with the version number of the client software: #tar -xvf ./x.x.x.x-TIV-TSMBAC-LinuxX86.tar
6. If a previous version of TSM is installed, remove it before installing a new version: rpm -e TIVsm-BA rpm -e TIVsm-API64 rpm -e TIVsm-API
7. Enter the following command to install the gskit 32-bit packages: rpm -Uvh gskcrypt32-8.x.x.x.linux.x86.rpm rpm -Uvh gskssl32-8.x.x.x.linux.x86.rpm
8. Enter the following commands to install the gskit 64-bit packages: rpm -Uvh gskcrypt64-8.x.x.x.linux.x86_64.rpm rpm -Uvh gskssl64-8.x.x.x.linux.x86_64.rpm
9. Install the TSM packages in this order: rpm -ivh TIVsm-API.i386.rpm rpm -ivh TIVsm-API64.rpm rpm -ivh TIVsm-BA.rpm
10. If you are upgrading TSM from a previous version, run the following command to start the Client Acceptor Daemon: /usr/bin/dsmcad &
11. Confirm that dsmcad started. If it did, you are finished. Otherwise, check dsmwebcl.log for errors: ps -ef | grep dsmcad

For a new install of TSM, continue with the following:

1. Change to the TSM client directory: cd /opt/tivoli/tsm/client/ba/bin
2. Copy the sample client system options file to create a working version: cp -p ./dsm.sys.smp dsm.sys
3. Configure the client system options file, using the following example as a reference. See the notes below for important information.

   Servername tsmXX01
   Nodename yourservername
   Domain ALL-LOCAL
   Inclexcl /etc/adsm.inclexcl
   Schedlogname /opt/adsm/dsmsched.log
   Schedlogretention 15 D
   Errorlogname /opt/adsm/dsmerror.log
   Errorlogretention 15 D
   Commmethod TCPIP
   Passwordaccess generate
   Passworddir /etc/security/adsm
   TCPPort 1500
   TCPServeraddress XXXXXXX.XXXX.XXXX.EDU
   Managedservices schedule
   

   Notes:

   • For the Servername option, use the TSM Server name given to you by the TSM admin.
   • For the Nodename option, use your server's name, but omit the domain portion of its FQDN.
   • The Domain option specifies the file systems you want to include in the backup. ALL-LOCAL includes all local file systems. Exclude a file system (e.g., /home ) as follows: Domain ALL-LOCAL -/home
   • The include/exclude statements in /etc/adsm.inclexcl fine-tune your backup. For best backup speed, exclude files that you would never restore.
   • For an explanation of include/exclude options, go to the IBM Tivoli Storage Manager Version 6.2 Information Center, then search for "exclude options", and then click Include and exclude option processing.
   • For the TCPserveraddress option, use the TCPName of the TSM server given to you by the TSM admin.
   
   
4. Create the client user options file from the template: #cp -p dsm.opt.smp dsm.opt
5. Set permissions on dsm.opt: chmod 644 dsm.opt
6. Configure the client user options file as below. Use the same Servername as in dsm.sys.

   Servername tsmxx01
   Subdir Yes

7. Create the file to hold the encrypted client password: mkdir /etc/security/adsm
8. Edit /root/.bash_profile to add these lines: export DSM_DIR=/opt/tivoli/tsm/client/ba/bin export DSM_LOG=/opt/tivoli/tsm/client/ba/bin export LANG=en_US export LC_CTYPE=en_US
9. Create the following symlink: ln -s /opt/tivoli/tsm/client/lang/EN_US $DSM_DIR/en_US
10. Your server initiates contacts with the TSM server through port 1500. Enable communications through your server's local firewall and the tcpserveraddress in dsm.sys .
    
    
11. Add this line to /etc/inittab to start dsmcad when your server reboots: cad::once:/opt/tivoli/tsm/client/ba/bin/dsmcad >/dev/null 2>&1
12. At a command line, start dsmcad: /usr/bin/dsmcad &
13. Confirm dsmcad started. If it did, you are finished. Otherwise, check dsmwebcl.log for errors: ps -ef | grep dsmcad
14. To request TSM backup services, see At IU, how do I request Tivoli Storage Manager backup services?
    
    
15. When you receive a TSM password from the TSM administrator:
    
    
    1. At /opt/tivoli/tsm/client/ba/bin , type dsmc query schedule to create the encrypted TSM password file for your server.
    2. At the Userid prompt, press the Enter key.
    3. At the Password prompt, type your server's TSM client password, and press the Enter key.
    4. Contact the TSM admins at  sav-request@indiana.edu  if you have questions, or to tell them your server is ready for backups.

Note: For more on TSM, see the TSM 6.3 Information Center. In the left pane, click IBM Tivoli Storage Manager backup-archive clients.

Comments/Questions/Corrections