TSM Linux Client Install Instructions

Upgrade Instructions For going from TSM Version 5.5.2 to 6.4.x

Download the following TARs and un-tar them into /tmp/tsm/.

  1. https://download.acsu.buffalo.edu/soft/ub/Linux/production/TSM/6.4.0.0-T...
  2. https://download.acsu.buffalo.edu/soft/ub/Linux/production/TSM/tsm_files...

Follow this set of instructions:

sudo /etc/init.d/adsm stop
sudo cp -p /opt/tivoli/tsm/client/ba/bin/dsm.opt /opt/tivoli/tsm/client/ba/bin/dsm.opt.save
sudo cp -p /opt/tivoli/tsm/client/ba/bin/dsm.sys /opt/tivoli/tsm/client/ba/bin/dsm.sys.save
sudo cp -p /etc/adsm.exclude /opt/tivoli/tsm/client/ba/bin/adsm.exclude.save
sudo cp -p /etc/adsm.mailto /opt/tivoli/tsm/client/ba/bin/adsm.mailto.save
sudo cp -p /opt/tivoli/tsm/client/ba/bin/*.save /tmp/tsm
sudo rpm -qa | grep -i tiv
sudo rpm -e TIVsm-API-5.4.2-0 TIVsm-BA-5.4.2-0 TIVsm-API64-5.4.2-0
sudo rpm -qa | egrep 'glibc|libgcc|libstdc|compat-libstdc' | sort
sudo rpm -U /tmp/tsm/gskcrypt64-8.0.14.14.linux.x86_64.rpm /tmp/tsm/gskssl64-8.0.14.14.linux.x86_64.rpm
sudo rpm -i /tmp/tsm/TIVsm-API64.x86_64.rpm /tmp/tsm/TIVsm-APIcit.x86_64.rpm /tmp/tsm/TIVsm-BA.x86_64.rpm /tmp/tsm/TIVsm-BAcit.x86_64.rpm
diff /opt/tivoli/tsm/client/ba/bin/dsm.opt /opt/tivoli/tsm/client/ba/bin/dsm.opt.save
diff /opt/tivoli/tsm/client/ba/bin/dsm.sys /opt/tivoli/tsm/client/ba/bin/dsm.sys.save
sudo mkdir /etc/tsm
sudo cp /tmp/tsm/adsm.exclude.save /etc/tsm/tsm.base.inclexcl

sudo cp -p /opt/tivoli/tsm/client/ba/bin/adsm.mailto.save /opt/tivoli/tsm/client/ba/bin/tsmlogger.base.mailto
sudo cp -p /tmp/tsm/tsmlogger /usr/local/bin
sudo rm -r /etc/adsm
sudo cp -p /tmp/tsm/tsm /etc/init.d
sudo ln -s /etc/init.d/tsm /etc/rc3.d/S99tsm
sudo /etc/init.d/tsm start

If /opt/tivoli/tsm/client/ba/bin/adsm.exclude.save has include/exclude rules defined:

  1. Create a new include/exclude file:
    sudo cp -p adsm.exclude.save tsm.base.inclexcl
  2. Update the inclexcl line in the dsm.sys file with the following:
    inclexcl               /opt/tivoli/tsm/client/ba/bin/tsm.base.inclexcl

To test

tail -16 /var/adm/log/adsm.schedlog
sudo dsmc 

A quick way to run a manual backup:

mjolnir {~} > sudo dsmc i

RHEL5 Instructions For TSM Version 5.5.2

  1. Make sure the locale on the server is set to en_US.ISO8859-1 using the locale(1) command. It is typically en_US.UTF-8 by default:
    
    penguin 1 % locale
    LANG=en_US.UTF-8
    LC_CTYPE="en_US.UTF-8"
    LC_NUMERIC="en_US.UTF-8"
    LC_TIME="en_US.UTF-8"
    LC_COLLATE="en_US.UTF-8"
    LC_MONETARY="en_US.UTF-8"
    LC_MESSAGES="en_US.UTF-8"
    LC_PAPER="en_US.UTF-8"
    LC_NAME="en_US.UTF-8"
    LC_ADDRESS="en_US.UTF-8"
    LC_TELEPHONE="en_US.UTF-8"
    LC_MEASUREMENT="en_US.UTF-8"
    LC_IDENTIFICATION="en_US.UTF-8"
    LC_ALL=
    penguin 2 % 
    
    
    If it needs to be changed, edit /etc/sysconfig/i18n and change the LANG environment variable:
    
    LANG="en_US.ISO8859-1"
    
    

    and reboot. This should be the result:

    
    penguin 1 % locale
    LANG=en_US.ISO8859-1
    LC_CTYPE="en_US.ISO8859-1"
    LC_NUMERIC="en_US.ISO8859-1"
    LC_TIME="en_US.ISO8859-1"
    LC_COLLATE="en_US.ISO8859-1"
    LC_MONETARY="en_US.ISO8859-1"
    LC_MESSAGES="en_US.ISO8859-1"
    LC_PAPER="en_US.ISO8859-1"
    LC_NAME="en_US.ISO8859-1"
    LC_ADDRESS="en_US.ISO8859-1"
    LC_TELEPHONE="en_US.ISO8859-1"
    LC_MEASUREMENT="en_US.ISO8859-1"
    LC_IDENTIFICATION="en_US.ISO8859-1"
    LC_ALL=
    penguin 2 %
    
    
  2. Install libstdc++ compatability libraries:
    
    sudo yum -y install libstdc++.x86_64
    sudo yum -y install libstdc++.i386
    sudo yum -y install compat-libstdc++-33.i386
    
    
  3. Create a temporary install directory:
    
    % mkdir /tmp/ubtsm
    
    
  4. Download the CIT TSM install scripts from https://ubfs.buffalo.edu/ubfs/collab/cit/tks_public/TSM/downloads.shtml to /tmp/ubtsm
  5. Untar the tarfile:
    
    % sudo tar -xvf UB_tsm_______.tar
    
    
  6. Install the RPMs:
    
    % sudo ./tsminstall
    
    
  7. Setup the configuration files with sudo ./tsmconf setup. For this step you will need the nodename and tsm credentials as supplied by CIT-TKS. For a more thorough description of what this script does see: https://ubfs.buffalo.edu/ubfs/collab/cit/tks_public/TSM/UnixScripts.shtm....
  8. Rehash your shell so that the new TSM scripts are picked up in your search path.
    
    % rehash
    
    
  9. Test the success of the client install with sudo dsmc. You should see something like:
    
    IBM Tivoli Storage Manager
    Command Line Backup/Archive Client Interface
      Client Version 5, Release 5, Level 2.0
      Client date/time: 06/19/2009 13:29:56
    (c) Copyright by IBM Corporation and other(s) 1990, 2009. All Rights Reserved.
    
    Node Name: ATHENA.CSE.BUFFALO.EDU
    Session established with server TSM4: AIX-RS/6000
      Server Version 5, Release 5, Level 1.0
      Data compression forced off by the server
      Server date/time: 06/19/2009 13:29:56  Last access: 06/19/2009 10:30:14
    
    
  10. Add any excludes in to /etc/tsm/tsm.base.inclexcl. Bare minimum you should have:
    • exclude.dir /.../.snapshot to exclude the snapshot directories on any netapp-mounted filesystem.
    • exclude /home/.../.mozilla/firefox/*.default/Cache/.../* to exclude browser caches from user home directories.
  11. Add cse-staff@buffalo.edu to /etc/tsm/tsmlogger.base.mailto.
  12. Add memoryefficientbackup yes to /etc/tsm/tsm.sys.
  13. Start TSM:
    
    % sudo /etc/init.d/tsm start
    
    
  14. Verify that the scheduler has started by viewing the TSM log file:
    
    % tsmlog
    
    

    This should resemble:

    
    06/19/2009 10:29:57 Querying server for next scheduled event.
    06/19/2009 10:29:57 Node Name: ATHENA.CSE.BUFFALO.EDU
    06/19/2009 10:29:57 Session established with server TSM4: AIX-RS/6000
    06/19/2009 10:29:57   Server Version 5, Release 5, Level 1.0
    06/19/2009 10:29:57   Data compression forced off by the server
    06/19/2009 10:29:57   Server date/time: 06/19/2009 10:29:57  Last access: 06/19/2009 06:53:53
    
    06/19/2009 10:29:57 --- SCHEDULEREC QUERY BEGIN
    06/19/2009 10:29:57 --- SCHEDULEREC QUERY END
    06/19/2009 10:29:57 Next operation scheduled:
    06/19/2009 10:29:57 ------------------------------------------------------------06/19/2009 10:29:57 Schedule Name:         0400
    06/19/2009 10:29:57 Action:                Incremental
    06/19/2009 10:29:57 Objects:
    06/19/2009 10:29:57 Options:
    06/19/2009 10:29:57 Server Window Start:   04:00:00 on 06/20/2009
    06/19/2009 10:29:57 ------------------------------------------------------------06/19/2009 10:29:57 Waiting to be contacted by the server.
    
    

RHEL5 Instructions For TSM Version 5.4.2

  1. Request a node name from http://www.tks.buffalo.edu/usg/forms/backuprequest.form.html. You will need the FQDN of the machine as well as...
    • Total amount of disk space installed (in Gigabytes)
    • Total amount of disk space currently in use (in Gigabytes)
    • Total amount of disk space changing on a daily basis (in Megabytes)
    • Approximate number of files and directories on your system, in thousands
    • Approximate number of files and directories changing on a daily basis
    • ** use the file+dir_count.c file to assist with the number values in conjunction with df -h. The file+dir_count.c script is attached to this page. you will have to rename it and compile it.
  2. Install libstdc++ computability libraries.
    sudo yum -y install libstdc++.x86_64
    sudo yum -y install libstdc++.i386
    sudo yum -y install compat-libstdc++-33.i386
    
  3. Download and un-tar the installation material to a temporary directory.
    cd /tmp
    wget https://download1.buffalo.edu/soft/ub/Linux/production/TSM/TSM5420.Linux...
    sudo tar xvf tar.file.name
    
  4. Install all the client software packages. API package must be installed first.
    sudo rpm -i TIVsm-API.i386.rpm
    sudo rpm -i TIVsm-API64.i386.rpm
    sudo rpm -i TIVsm-BA.i386.rpm
    
  5. Run the setup script tsm.setup. You must know your nodename (and password) and the TSM server where the nodename is defined. This will aaaall be suppied to you in request for a nodename. Press enter when prompted for a userid, and enter the password when prompted for it.
    [kpcleary@acl-primary linux]$ sudo ./tsm.setup
    Enter your tsm server, backups|tsm|tsm3|tsm4 :
    tsm3
    Installing new startup scrtip in init.d...
    adsm            0:off   1:off   2:on    3:on    4:on    5:on    6:on
    IBM Tivoli Storage Manager
    Command Line Backup/Archive Client Interface
      Client Version 5, Release 4, Level 2.0
      Client date/time: 10/07/2008 11:47:20
    (c) Copyright by IBM Corporation and other(s) 1990, 2008. All Rights Reserved.
    
    Node Name: ACL-PRIMARY.CSE.BUFFALO.EDU
    Please enter your user id :
    
    Please enter password for user id "ACL-PRIMARY.CSE.BUFFALO.EDU":
    
    Session established with server TSM3: AIX-RS/6000
      Server Version 5, Release 4, Level 1.2
      Data compression forced off by the server
      Server date/time: 10/07/2008 11:47:20  Last access: 10/07/2008 11:47:20
    
    TSM Server Connection Information
    
    Server Name.............: TSM3
    Server Type.............: AIX-RS/6000
    Archive Retain Protect..: "No"
    Server Version..........: Ver. 5, Rel. 4, Lev. 1.2
    Last Access Date........: 10/07/2008 11:47:20
    Delete Backup Files.....: "No"
    Delete Archive Files....: "Yes"
    
    Node Name...............: ACL-PRIMARY.CSE.BUFFALO.EDU
    User Name...............: root
    
  6. Remove the installation material. sudo rm -r /tmp/linux
  7. Start the scheduler. The scheduler must be restarted any time you change dsm.opt, dsm.sys, or adsm.exclude because these files are only read when the scheduler is started:
    
    % sudo /etc/init.d/adsm start
    
    
  8. Reboot the machine.
  9. Edit /usr/local/bin/qadsmlog to say:
    
    #!/bin/csh -f
    # tail the log file
    tail -50 /var/adm/log/adsm.schedlog | more
    exit 0
    
    
  10. Edit /etc/adsm.mailto to say:
    
    tsm-backup-reports@gory.acsu.buffalo.edu cse-staff@cse.buffalo.edu
    
    
  11. Edit the log paths in /opt/tivoli/tsm/client/ba/bin/tsm.POSTschedulecmd to say LOG=/var/adm/log/adsm.schedlog
  12. Edit the tail values in /opt/tivoli/tsm/client/ba/bin/tsm.POSTschedulecmd to say /usr/bin/tail -43 $LOG. This will allow the summary emails to have a bit more detail.
  13. Check /etc/mail/sendmail.cf to ensure that mail to non-local users is forwarded to electra:
    
    Kuser user -m -a<>
    DLelectra.cse.buffalo.edu
    
    
  14. Edit /etc/adsm.exclude for appropriate excludes and includes. In particular if this machine is to backup NFS shares add include /home/.../*. The "/.../" matches all subdirs recursively, and * matches all the files in those subdirs. The default backup domain is "all-local" filesystems/drives. Optionally, you could code a domain statement: Domain ALL_LOCAL F:

References

  1. http://www.buffalo.edu/ubit/information-for-it-staff/server-management-f...
  2. https://ubfs.buffalo.edu/ubfs/collab/cit/tks_public/TSM/UnixInstall.shtml
  3. https://ubfs.buffalo.edu/ubfs/collab/cit/tks_public/TSM/install/TSMSolar...