TivoliStorageManager
Intro
Purpose
Tivoli Storage Manager(TSM) is used to backup all user home dirs to an LTO2 tape library.
Reason for choosing
Downloaded for free from IBM Scholars Program.
Setup
Installation
Server
Installed TSM server.
mkdir /root/tsm cd /root/tsm mkdir linux_server cd linux_server
Downloaded server package for linux from IBM.
unzip tsmv5310.zip ./install_server
The server package has to be installed before the license package or the license files won't be installed.
Client
Installed TSM client.
cd /root/tsm mkdir linux_client cd linux_client
Grabbed TSM client package for linux.
tar -zxvf C80C5ML.tar.gz cd tsmcli/linux86 rpm -ivh TIVsm-API.i386.rpm TIVsm-BA.i386.rpm
Configuration
Server
Setup the server config file, /opt/tivoli/tsm/server/bin/dsmserv.opt.
* Comments are denoted by a *.
COMMmethod SHAREDMEM
COMMmethod TCPip
tcpport 1500
LANGuage en_US
Register the license files.
cd /opt/tivoli/tsm/server/bin ./dsmserv REGister LICense FILE=*.lic
Define LTO library.
define library autoltolib libtype=scsi autolabel=yes define path buttercup autoltolib srctype=server desttype=library device=/dev/IBMchanger0 define drive autoltolib autoltodrive01 define path buttercup autoltodrive01 srctype=server desttype=drive library=autoltolib device=/dev/IBMtape0
Define storage pool for LTO library.
define devclass autoltoclass library=autoltolib devtype=lto format=drive define stgpool autoltopool autoltoclass maxscratch=24
Check in labeled blank tapes.
label libvolume autoltolib search=yes labelsource=barcode checkin=scratch
Define storage policy.
define domain ICONIC define policyset ICONIC ICONIC define mgmtclass ICONIC ICONIC ICONIC define copygroup ICONIC ICONIC ICONIC standard destination=autoltopool assign defmgmtclass ICONIC ICONIC ICONIC activate policyset ICONIC ICONIC
Define schedules.
define schedule ICONIC nightly starttime=00:01 duration=5 durunits=hours define schedule ICONIC saturday startime=09:01 duration=5 durunits=hours dayofweek=saturday
Register client node.
register node <nodename> <password> domain=ICONIC
Define association between node and schedule.
define association ICONIC <schedule> <node>
Start server daemon on buttercup
cd /opt/tivoli/tsm/server/bin nohup ./dsmserv >& /dev/null &
Client
Setup client config file, /opt/tivoli/tsm/client/ba/bin/dsm.opt.
servername buttercup
Setup client config file, /opt/tivoli/tsm/client/ba/bin/dsm.sys.
servername buttercup commmethod tcpip tcpport 1500 tcpserveraddress 128.223.202.95 passwordaccess generate nodename sonicclient inclexcl /opt/tivoli/tsm/client/ba/bin/sonic.inclexcl
Setup client include/exclude file, /opt/tivoli/tsm/client/ba/bin/sonic.inclexcl.
exclude.dir / exclude.dir /boot include /mnt/home
Start client daemon on remote nodes.
nohup dsmc sched >& /dev/null &
Restoring Files
Log in to the machine the file was backed up from and run one or more of the following commands.
Restore a file.
dsmc restore /mnt/home/users/ryanm/test_file
Restore a user's home directory to a temporary space.
dsmc restore /mnt/home/users/amorris /mnt/admin/restores/20060523/ -subdir=yes
Maintenance
Start/Stop/Update
How to start/stop/update or maintain this service or system
Start the server.
/etc/init.d/dsmserv stop or nohup ./dsmserv >& /dev/null &
Stop the server.
/etc/init.d/dsmserv stop or killall dsmserv
Start the client.
/etc/init.d/dsmcsched start or nohup dsmc sched >& /dev/null &
Stop the client.
/etc/init.d/dsmsched stop or killall dsmc
Logs
Server logs are located here.
/opt/tivoli/tsm/server/bin/dsmserv.log
Client logs are located in the directory the daemon was started from, usually
~/dsmsched.log
Useful Tips
Configure server from client machine.
dsmadmc #username=admin #password=secret
Get help.
help <command> e.g. help query, help define, help define node
IBM 3582 LTO Tape Library
Description
The IBM 3582 LTO tape library is a 24 tape library with one robot and 2 drive slot, one of which is filled with an LTO2 Ultrium drive.
Kernel Module
The IBMtape kernel module is installed on buttercup and needs to be loaded on boot. It creates the following device files:
crw------- 1 root root 253, 512 Feb 24 09:58 /dev/IBMchanger0 crw------- 1 root root 253, 0 Feb 24 09:58 /dev/IBMtape0 crw------- 1 root root 253, 256 Feb 24 09:58 /dev/IBMtape0n
Command-line Utility
IBMtapeutil and IBMtapeconfig are installed on buttercup. The following are some useful commands.
IBMtapeutil usage.
IBMtapeutil -h
Output from IBMtapeutil -h.
Usage: IBMtapeutil [-f Device Subcommand [Subcommand ...]] IBMtapeutil for Linux, Version 1.3.1, Sept. 14, 2004 General Subcommands: tur inquiry [Page] print "Text" reserve release reqsense qryversion logpage "Page" modepage "Page" qrypath enablepath "primary" | number path disablepath "primary" | number Tape Subcommands: bsf [Count] bsr [Count] eof [Count] fsf [Count] fsr [Count] weof [Count] fsfm [Count] bsfm [Count] asf [Count] compress tell seek [Count] nocompress rewind sync load erase display "Message" unload retension read -d Destination [-c Count] qrypos seod write -s Source setpos [Blockid] status rtest [-b Blocksize] [-c Count] [-r Repetition] offline parms wtest [-b Blocksize] [-c Count] [-r Repetition] rewoffl list rwtest [-b Blocksize] [-c Count] [-r Repetition] prevent lock setblk [Count] allow unlock density qryinquiry qrysense append mtdevice Medium Changer Subcommands: allow prevent audit [Address [Count]] inventory mount [Slot] position "Destination" elementinfo unmount [Slot] move "Source" "Destination" devids exchange "Source" "Dest1" "Dest2" Service Aid Subcommands: dump [Filename] forcedump ucode "Name" resetdrive
Tape inventory.
IBMtapeutil -f /dev/IBMchanger0 inventory
Mount a tape from slot 5.
IBMtapeutil -f /dev/IBMchanger0 mount 5
Move a tape from slot 3 to slot 10.
IBMtapeutil -f /dev/IBMchanger0 move 3 10