Diese Doku basiert u.a. auf folgender Quelle:

• http://blog.emeidi.com/2006/09/tivoli-storage-manager-tsm-unter.html

1. Alien installieren (RPM ⇒ DEB Converter) mit
   

   aptitude install alien libstdc++5

2. TSM Linux Client lokal z.B. nach /root/install/tsm kopieren
3. TSM Client auspacken mit
   

   tar -xvf 5.5.1.10-TIV-TSMBAC-LinuxX86.tar

   
   ACHTUNG: Dateien werden DIREKT im aktuellen Verzeichniss entpackt! Besser ein Subdir anlegen.

4. RPMs in DEBs umwandeln mit:
   

   alien -d TIVsm-API.i386.rpm
   alien -d TIVsm-BA.i386.rpm

5. DEB Pakete installieren mit:
   

   dpkg -i tivsm-api_5.5.1-11_i386.deb
   dpkg -i tivsm-ba_5.5.1-11_i386.deb

6. Nun sollten die BINs sowie die Konfigurationsdateien unter /opt/tivoli/tsm/client/ba/bin/ liegen
7. Beispiel (Sample) Konfig Dateien umkopieren:
   

   cd /opt/tivoli/tsm/client/ba/bin/
   cp dsm.opt.smp dsm.opt
   cp dsm.sys.smp dsm.sys

8. Anpassen der /opt/tivoli/tsm/client/ba/bin/dsm.opt wie folgt:
   ACHTUNG: Groß- Kleinschreibung beachten!
   

   ************************************************************************
   * IBM Tivoli Storage Manager                                           *
   *                                                                      *
   * Sample Client User Options file for UNIX (dsm.opt.smp)               *
   ************************************************************************
   
   *  This file contains an option you can use to specify the TSM
   *  server to contact if more than one is defined in your client
   *  system options file (dsm.sys).  Copy dsm.opt.smp to dsm.opt.
   *  If you enter a server name for the option below, remove the
   *  leading asterisk (*).
   
   ************************************************************************
   
   * SErvername       A server name defined in the dsm.sys file
   SErvername tsmserver1

9. Anpassen der /opt/tivoli/tsm/client/ba/bin/dsm.sys wie folgt:
   ACHTUNG: Groß- Kleinschreibung beachten!
   

   ************************************************************************
   * IBM Tivoli Storage Manager                                           *
   *                                                                      *
   * Sample Client System Options file for UNIX (dsm.sys.smp)             *
   ************************************************************************
   
   *  This file contains the minimum options required to get started
   *  using TSM.  Copy dsm.sys.smp to dsm.sys.  In the dsm.sys file,
   *  enter the appropriate values for each option listed below and
   *  remove the leading asterisk (*) for each one.
   
   *  If your client node communicates with multiple TSM servers, be
   *  sure to add a stanza, beginning with the SERVERNAME option, for
   *  each additional server.
   
   ************************************************************************
   
   SErvername  tsmserver1
      COMMMethod         TCPip
      TCPPort            1500
      TCPServeraddress   tsmserver1.domain.de
      PASSWORDACCESS GENERATE
      SCHEDMODE PROMPTED
      MANAGEDSERVICES Webclient schedule
      SCHEDLOGRETENTION 14
      ERRORLOGRETENTION 14
      SCHEDLOGNAME            /var/log/tsm-schedule.log
      ERRORLOGNAME            /var/log/tsm-error.log
   

10. Legen Sie eine Datei /etc/ld.so.conf.d/tsm.conf an und fügen Sie nachfolgend gezeigten Inhalt ein. Hiermit werden die SHARED OBJECTS (.so) von TSM automatisch geladen wenn diese benötigt werden.
    

    # Bindet die SHARED OBJECT Files (.so) von TSM ein
    /opt/tivoli/tsm/client/api/bin/
    /opt/tivoli/tsm/client/ba/bin

11. führen Sie nun einmalig folgenden Befehl aus:
    

    ldconfig

12. Ein Symbolischer Link muss noch für die genutzte locale angelegt werden. Gehen Sie dazu wie folgt vor:
    

    cd /opt/tivoli/tsm/client/ba/bin
    ln -s ../../lang/en_US en_US
    ln -s ../../lang/en_US en_US.UTF-8
    cd /opt/tivoli/tsm/client/api/bin/
    ln -s ../../lang/en_US en_US
    ln -s ../../lang/en_US en_US.UTF-8

13. Init-Start/Stop Script erstellen. z.B. als /etc/init.d/tsm
    

    #! /bin/sh
    ### BEGIN INIT INFO
    # Provides:          dsmcad tsm client
    # Required-Start:    $remote_fs
    # Required-Stop:     $remote_fs
    # Default-Start:     2 3 4 5
    # Default-Stop:      0 1 6
    # Short-Description: dsmcad TSM Client Agent (Scheduler)
    # Description:       dsmcad TSM Client Agent (Scheduler) - Tivoli Storage Manager Client Init script to be placed in /etc/init.d.
    ### END INIT INFO
    
    # Author: Axel Werner <mail@awerner.myhome-server.de>
    #
    # History / Version
    # =================
    #	2009-11-25	A.Werner	FIX: missing locales enviroment 
    #					variables if started by init at system-
    #					boot.
    #
    #	2009-11-26	A.Werner	useless if statement removed. setting
    #					LC_ALL to the same val as LANG sets 
    #					also any other LC_ variable
    #
    #
    
    # Do NOT "set -e"
    
    # PATH should only include /usr/* if it runs after the mountnfs.sh script
    PATH=/sbin:/usr/sbin:/bin:/usr/bin
    DESC="dsmcad TSM Client Agent (Scheduler)"
    NAME=dsmcad
    DAEMON=/opt/tivoli/tsm/client/ba/bin/"$NAME"
    DAEMON_ARGS=""   # <<< use this if you use scheduler as managed service
    PIDFILE=/var/run/"$NAME".pid
    SCRIPTNAME=/etc/init.d/"$0"
    
    # Exit if the package is not installed
    [ -x "$DAEMON" ] || exit 0
    
    # Read configuration variable file if it is present
    [ -r /etc/default/"$NAME" ] && . /etc/default/"$NAME"
    
    # IF there are Problems backing up Files that include special characters try
    # putting these few lines in a /etc/default/dsmc
    # export LANG=de_DE@euro
    # export LC_ALL=de_DE@euro
    # export LC_CTYPE=de_DE@euro
    
    #################################
    # FIX 2009-11-25 by A.Werner: Read/set enviroment vars (locales) as set by
    #				Systemowner (root)
    #
    #
    # /////////////////////////////////////////////////
    # DEBUG TEST BLOCK to simulate Server reboot
    #	export LANG=""
    #	export LC_ALL="POSIX""
    # /////////////////////////////////////////////////
    #
    #
    #
    parse_environment () 
    {
        ENV_FILE="none"
        [ -r /etc/environment ] && ENV_FILE="/etc/environment"
        [ -r /etc/default/locale ] && ENV_FILE="/etc/default/locale"
        [ $ENV_FILE = none ] && return
    
        for var in LANG LC_ALL LC_CTYPE; do
            value=$(egrep "^[^#]*${var}=" $ENV_FILE | tail -n1 | cut -d= -f2)
            eval $var=$value
        done
    }
    
    # Parse the system's environment
    export LANG LC_ALL LC_CTYPE
    parse_environment
    
    # da LC_ALL in /etc/default/locale nicht gesetzt wurden setze ich
    # diesen nun manuell auf den gleichen Wert wie LANG
    # PS: LC_ALL setzt automatisch auch alle anderen LC_ locale variablen
    #	sofern diese nicht anderweitig überschrieben werden.
    export LC_ALL=$LANG
    #
    #
    #################################
    
    
    
    # Load the VERBOSE setting and other rcS variables
    . /lib/init/vars.sh
    
    # Define LSB log_* functions.
    # Depend on lsb-base (>= 3.0-6) to ensure that this file is present.
    . /lib/lsb/init-functions
    
    
    # DEBUGING: show locales in tsm enviroment.
    #/usr/bin/locale > /root/tsm-debuging-locales-`date '+%F-%H%M'`
    
    
    
    
    #
    # Function that starts the daemon/service
    #
    do_start()
    {
    
    	# Return
    	#   0 if daemon has been started
    	#   1 if daemon was already running
    	#   2 if daemon could not be started
    	start-stop-daemon --start --quiet --pidfile "$PIDFILE" --exec "$DAEMON" --test > /dev/null \
    		|| return 1
    	start-stop-daemon --start --quiet --pidfile "$PIDFILE" --exec "$DAEMON" -- \
    		$DAEMON_ARGS \
    		|| return 2
    	# Add code here, if necessary, that waits for the process to be ready
    	# to handle requests from services started subsequently which depend
    	# on this one.  As a last resort, sleep for some time.
    }
    
    #
    # Function that stops the daemon/service
    #
    do_stop()
    {
    	# Return
    	#   0 if daemon has been stopped
    	#   1 if daemon was already stopped
    	#   2 if daemon could not be stopped
    	#   other if a failure occurred
    	start-stop-daemon --stop --quiet --retry=TERM/30/KILL/5 --pidfile "$PIDFILE" --name "$NAME"
    	RETVAL="$?"
    	[ "$RETVAL" = 2 ] && return 2
    	# Wait for children to finish too if this is a daemon that forks
    	# and if the daemon is only ever run from this initscript.
    	# If the above conditions are not satisfied then add some other code
    	# that waits for the process to drop all resources that could be
    	# needed by services started subsequently.  A last resort is to
    	# sleep for some time.
    	start-stop-daemon --stop --quiet --oknodo --retry=0/30/KILL/5 --exec "$DAEMON"
    	[ "$?" = 2 ] && return 2
    	# Many daemons don't delete their pidfiles when they exit.
    	rm -f "$PIDFILE"
    	return "$RETVAL"
    }
    
    #
    # Function that sends a SIGHUP to the daemon/service
    #
    do_reload() {
    	#
    	# If the daemon can reload its configuration without
    	# restarting (for example, when it is sent a SIGHUP),
    	# then implement that here.
    	#
    	start-stop-daemon --stop --signal 1 --quiet --pidfile $PIDFILE --name $NAME
    	return 0
    }
    
    case "$1" in
      start)
    	[ "$VERBOSE" != no ] && log_daemon_msg "Starting $DESC" "$NAME"
    	do_start
    	case "$?" in
    		0|1) [ "$VERBOSE" != no ] && log_end_msg 0 ;;
    		2) [ "$VERBOSE" != no ] && log_end_msg 1 ;;
    	esac
    	;;
      stop)
    	[ "$VERBOSE" != no ] && log_daemon_msg "Stopping $DESC" "$NAME"
    	do_stop
    	case "$?" in
    		0|1) [ "$VERBOSE" != no ] && log_end_msg 0 ;;
    		2) [ "$VERBOSE" != no ] && log_end_msg 1 ;;
    	esac
    	;;
      #reload|force-reload)
    	#
    	# If do_reload() is not implemented then leave this commented out
    	# and leave 'force-reload' as an alias for 'restart'.
    	#
    	#log_daemon_msg "Reloading $DESC" "$NAME"
    	#do_reload
    	#log_end_msg $?
    	#;;
      restart|force-reload)
    	#
    	# If the "reload" option is implemented then remove the
    	# 'force-reload' alias
    	#
    	log_daemon_msg "Restarting $DESC" "$NAME"
    	do_stop
    	case "$?" in
    	  0|1)
    		do_start
    		case "$?" in
    			0) log_end_msg 0 ;;
    			1) log_end_msg 1 ;; # Old process is still running
    			*) log_end_msg 1 ;; # Failed to start
    		esac
    		;;
    	  *)
    	  	# Failed to stop
    		log_end_msg 1
    		;;
    	esac
    	;;
      *)
    	#echo "Usage: $SCRIPTNAME {start|stop|restart|reload|force-reload}" >&2
    	echo "Usage: $SCRIPTNAME {start|stop|restart|force-reload}" >&2
    	exit 3
    	;;
    esac
    
    :
    

14. Init-Script ausführbar machen mit:
    

    chmod +x /etc/init.d/tsm

15. Start-/Stop-Script in den gewünschten Runlevels verlinken:

    update-rc.d tsm defaults
    
    verlinkt das start/stop script in den default runleveln wie sie im script hinterlegt sind.
    zum löschen der Links:
    update-rc.d -f tsm remove
    zum präzisen Anlegen:
    update-rc.d tsm start 2 3 4 5 . stop 0 1 6 . 

16. Spätestens jetzt muss auf dem TSM Server (Backup Server) ein “Node” für unseren Server eingerichtet werden.
17. Anschließend muss man sich auf dem Linux Server als ROOT anmelden und den TMS Client das erste mal manuell starten.
18. Starten des TSM Scheduler Dienstes per Init-Script:

    /etc/init.d/tsm restart

19. Der TSM Backup-Client ist nun bereit zur Sicherung. Ein Standard-Sicherungsjob kann von Seiten TSM Backupserver eingerichtet werden. Einfache EIN- und AUSSCHLUESSE (includes excludes) können über eine der oben genannten Konfigurationsdateien auch selbst durchgeführt werden. Dazu später mehr…

Beispielbefehle für Rücksicherungen

1. Replace this object
2. Replace all objects that already exist
3. Skip this object 
4. Skip all objects that already exist
A. Abort this operation

• Ein Link auf eine IBM-Seite mit einer Doku des Clients: http://publib.boulder.ibm.com/infocenter/tivihelp/v1r1/index.jsp?topic=/com.ibm.itsmfdt.doc/ans5000060.htm
• IBM Handbuch: Sicherungs/Rücksicherungsoptionen http://publib.boulder.ibm.com/infocenter/tivihelp/v1r1/topic/com.ibm.itsmfdt.doc/ans50000238.htm#buarcopt
• xxx

— Axel Werner 2011-01-01 23:37