Linux TSM Quickstart

or How I learned to stop worrying and love the bomb^W^WTSM

Most of this should happen automagically when you kickstart a host but in the event that you're doing something stupid or manual I wanted to document this process anyway:

yum install tsm-oit (This is from the oit repo from: http://linux.oit.duke.edu/yum/oit/centos-4/, if you're using a machine installed from the centos-4 kickstarts, it's already on there.)
edit the files /etc/tsm/dsm.opt, /etc/tsm/dsm.sys and /etc/tsm/inclexcl.txt for the machine specific information
register your host with the tsm admins: CSIS:Registering For Tivoli Storage Manager Clients TSM Backups

Once you get the register info back from the tsm admins:

/opt/tivoli/tsm/client/ba/bin/dsmc

# /opt/tivoli/tsm/client/ba/bin/dsmc

IBM Tivoli Storage Manager
Command Line Backup/Archive Client Interface
  Client Version 5, Release 3, Level 2.0
  Client date/time: 11/15/2005 17:01:49
(c) Copyright by IBM Corporation and other(s) 1990, 2005. All Rights Reserved.

Node Name: YOUR_FQDN
Please enter your user id <YOUR_FQDN>:

Please enter password for user id "YOUR_FQDN":

Then at the tsm> prompt:

query schedule

If you don't see a schedule list then you need to setup a schedule with the tsm-admins.

Either way type:

quit

and then you can run:

/sbin/chkconfig dsmc on
/etc/init.d/dsmc start

to make sure that the scheduler starts on reboot.

To make sure that tsm is backing up what you want and NOT what you don't want:

configure your inclexcl.txt the way you think you want it
restart the dsmc process (on linux: /etc/init.d/dsmc restart)
as root run:
```
    dsmc
   
```

at the tsm> prompt run:

   preview backup / -filter=INCL -filename=/tmp/preview.txt

repeat this command for each partition you have setup on this system. Example:

   preview backup /srv/ -filter=INCL -filename=/tmp/srv-preview.txt

A couple of points:

you must have a / trailing the partition name
you should definitely change the filename as it will just overwrite the old

Then you can look through that file and see what would or would not be backed up.

An example inclexcl.txt file that only backups /etc and /srv:

exclude *

include /etc/*
include /etc/.../*
include /srv/*
include /srv/.../*

The special directory name .../ tells TSM to include all the subdirectories under /etc and /srv. In theory,

include /etc/.../*

is enough to include everything under /etc. However, IBM has seen some rare cases where this will not include the files that are in /etc (as opposed to being in one of its subdirectories). They recommend we also us

include /etc/*

in order to make sure that doesn't cause a problem.