MiBackup: Installation Instructions for Linux (RHEL)

To access the TSM client software, mount //tsm-clients.m.storage.umich.edu/tsm-clients/BA. Then copy and un-tar the TSM client for your version of Linux. Un-tar the file gives the following install files:

• TIVsm-API.i386.rpm
• TIVsm-API64.i386.rpm
• TIVsm-BA.i386.rpm
• gskcrypt32-8.0.13.4.linux.x86.rpm
• gskcrypt64-8.0.13.4.linux.x86_64.rpm
• gskssl32-8.0.13.4.linux.x86.rpm
• gskssl64-8.0.13.4.linux.x86_64.rpm

Please do not change the install order, for Linux Redhat 6 we recommend using command “yum install” instead of “rpm”

RPMDIR=install_directory

• yum install $RPMDIR/gskcrypt32-8.0.13.4.linux.x86.rpm $RPMDIR/gskssl32-8.0.13.4.linux.x86.rpm
• yum install $RPMDIR/gskcrypt64-8.0.13.4.linux.x86_64.rpm $RPMDIR/gskssl64-8.0.13.4.linux.x86_64.rpm
• yum install $RPMDIR/TIVsm-API.i386.rpm
• yum install $RPMDIR/TIVsm-API64.i386.rpm
• yum install $RPMDIR/TIVsm-BA.i386.rpm

MiBackup (TSM Client) Configuration

In the directory /opt/tivoli/tsm/client/ba/bin/, edit the dsm.opt and dsm.sys file

*dsm.sys

1. Rename the dsm.opt.smp to dsm.opt and modify the content like below:

*dsm.sys

2. Rename the dsm.sys.smp to dsm.sys and modify the content as shown below:
3. Create a directory (/usr/local/logs ) for the TSM logs and grant appropriate permissions
   • >/usr/local/logs/tsmerror.log chmod 666 /usr/local/logs/tsmerror.log
4. Create a file /usr/local/tsm_client/tsm.incl_excl.system for an include/exclude list.
   Below is an example of an include/exclude list. It reads from the bottom to top. The incremental backup backs up everything on the server if nothing is excluded:
   • exclude /afs/.../*
   • exclude /usr/vice/cache/.../*
   • exclude /var/vice/cache/.../*
   • exclude /unix
   • exclude /temp_mount/.../*
   • exclude /.../core
   • exclude /.../oradata/.../*
   • exclude /cdrom/.../*
5. Set the environment:
   • export DSM_DIR=/opt/tivoli/tsm/client/ba/bin
   • export DSM_CONFIG=/opt/tivoli/tsm/client/ba/bin/dsm.opt
   • export DSM_LOG=/usr/local/logs
6. Have the TSM admin define your server (node) to the TSM server before you initiate the TSM client. You can also have them set a daily schedule if you like.

Initiate MiBackup (TSM Client)

• Initiate TSM client and reset password by typing in TSM command "dsmc set password"
• When asked for the "ID", press the [ENTER] Key.
• When asked for the "Password", enter PASSWORD for that info
• TSM is not case sensitive, can enter upper or lower case.

The following is an example TSM prompt:

$ dsmc set password

• IBM Tivoli Storage Manager
• Command Line Backup-Archive Client Interface
  • Client Version 6, Release 2, Level 2.0
  • Client date/time: 05/09/2013 16:41:18
• (c) Copyright by IBM Corporation and other(s) 1990, 2010. All Rights Reserved.

Please enter password for node “SHIKRA”:

• Please enter a new password.
• Enter new password for verification.
• Password updated.

Session established with server ITSUNIX: LINUX

• Server Version 6, Release 3, Level 4.0.
• Server date/time: 05/09/2013 16:41:18 Last access: 05/09/2013 15:01:19

tsm>

• To exit out of TSM, type the following: quit
• The command line for testing the backup is: dsmc backup “/usr/local/logs/*"
• If everything looks okay, begin the daily schedule process by entering the following: /opt/tivoli/tsm/client/ba/bin/dsmcad
• View /usr/local/logs/dsmwebcl.log to verify the process dsmcad.
• Wait one minute and then view the /usr/local/logs/tsm.sched.log to verify the schedule.
• View /usr/local/log/tsm.sched.log, to verify daily backup result.

Setup "dsmcad" for Reboot

1. Create the file /etc/rc.d/init.d/dsmcad and populate it with the “dsmcad” script on the following page
2. For Redhat 5 or 6, execute the following commands one time, which will add dsmcad to the service.
   • /sbin/chkconfig --add dsmcad
   • /sbin/chkconfig dsmcad on
   • /sbin/service dsmcad start

Script dsmcad

• #!/bin/sh
• #
• # chkconfig: - 91 35
• # description: Starts and stops TSM client acceptor daemon
• #
• #Source function library
• . /etc/rc.d/init.d/functions
• [ -f /opt/tivoli/tsm/client/ba/bin/dsmc ] || exit 0
• [ -f /opt/tivoli/tsm/client/ba/bin/dsmcad ] || exit 0
• prog="dsmcad"
• export DSM_DIR=/opt/tivoli/tsm/client/ba/bin
• export DSM_CONFIG=/opt/tivoli/tsm/client/ba/bin/dsm.opt
• start() {
• echo -n $"Starting $prog: "
• cd $DSM_DIR
• daemon $DSM_DIR/dsmcad
• RETVAL=$?
• [ $RETVAL -eq 0 ] && touch /var/lock/subsys/dsmcad
• return $RETVAL
• }
• stop() {
• if test "x`pidof dsmcad`" != x; then
• echo -n $"Stopping $prog: "
• killproc dsmcad
• echo
• fi
• RETVAL=$?
• [ $RETVAL -eq 0 ] && rm -f /var/lock/subsys/dsmcad
• return $RETVAL
• }
• case "$1" in
• start)
• start
• ;;
• stop)
• stop
• ;;
• status)
• status dsmcad
• ;;
• restart)
• stop
• start
• ;;
• condrestart)
• if test "x`pidof dsmcad`" != x; then
• stop
• start
• fi
• ;;
• *)
• echo $"Usage: $0 {start|stop|restart|condrestart|status}"
• exit 1
• esac
• exit 0