TSM Backup

The files of your AFS (Andrew File System) home directory or of your local home directories (if participating in TSM) are automatically copied every night to a backup system by a server called TSM (Tivoli Storage Manager). This allows you to restore files and directories in case of a plight. The WWW-address http://www-it.desy.de/systems/services/backup/desyintern/tsm-admin.html shows the list of DESY nodes (computers) equipped with local drives (local home directories) taking part in TSM.

Up to twenty different file versions are recorded by the TSM back up mechanism, if so many changed file versions have been produced by you at all. The different  file versions are also called incremental backups in this context. If a file or directory is deleted then ten file or directory versions are preserved for a time span of 100 days. The last version will be kept for 200 days. Look also at http://www-it.desy.de/systems/services/backup/index.html.en for further details concerning TSM usage and policy.

Note: Tivoli Storage Manager is equipped with the access rights of AFS and Unix. The TSM can backup your files and directories only if they are accessible for system administrators. Therefore, do not change the access rights of your files and directories so that system administrators cannot read them.

If you destroyed or lost precious AFS files or directories look into the directory ~/.OldFiles of your AFS home directory first to find there the most recent copies of your files or directories. The directory ~/.OldFiles has been created for you in wise anticipation without your help and is independent from/not included in your quota.

If this does not make sense because you have no AFS file system at all or want to have back an older version, you can either use line commands or a graphical user interface to restore your files or directories with the help of TSM.

As the word "home directory" implies you can only restore files of your own.

To restore Windows XP files in the new domain win.desy.de, please use the "Previous Versions" of your directories. Description see: http://adweb.desy.de/Doku/ShadowCopy.doc  (only german)
The restore of Windows NT/XP files in the old domain DESYNT can only be done by an administrator you reach via email to windows@desy.de

To restore an Outlook/Exchange inbox or an inbox on the Unix mail server mail.desy.de, please send a request via email to mailmaster@desy.de

Restoring TSM Backup Files by Line Commands

Enter dsmc_afs in case of a AFS home directory (AFS file) or dsmc in case of a local directory (local file) in order to get into the command mode for restoring TSM backup files. A new X-term called "dsmcu" opens with a small choice of example line commands which you can enter at the prompt "tsm>" to inform yourself and to restore files finally (s. adjacent Unix printout).
"dsm" stands for "distributed storage manager" and "c" for "command line mode".
It can happen that you are asked for your AFS password before you can go on.


* *
* *
* Welcome to the Central AFS File Backup Service at DESY! *
* *
* *
* Only such AFS files which are readable by system:administrators *
* are in the TSM backup data. *
* *
* On the web see additional information: *
* DESY Home Page => Computer Center => Services => Backup/Restore => Central *
* or directly: *
* http://www-it.desy.de/systems/services/backup/index.html.en *
* http://www-it.desy.de/systems/services/backup/index.html.de *
* *
* DESY backup server maintenance (each Tuesday), see with: *
* http://www-it.desy.de/operating/news/news_trouble/index2.php?type=trouble *
* *
* DESY TSM node: *
* http://www-it.desy.de/systems/services/backup/desyintern/tsm-admin.html *
* *
* Some usefuly commands follow: *
* *
* - when was the latest backup? *
* tsm> q fi *
* *
* - which files from your home pwd are backed up? *
* tsm> q b * *
* *
* - which old file versions from your home pwd are backed up? *
* tsm> q b -ina * *
* *
* - simple file restore to another destination: *
* tsm> restore /afs/desy.de/user/a/anyuser/target.html -
* /afs/desy.de/user/a/anyuser/destination.html *
* *
* - simple file restore, with replace option: *
* tsm> restore -rep=yes /afs/desy.de/user/a/anyuser/show.html *
* *
* - selection menue of old file versions: *
* tsm> restore -ina -pick /afs/desy.de/user/a/anyuser/exp.cmz *
* *
* - restore old file version with date limit *
* tsm> restore -pitdate=2004.07.01 /afs/desy.de/user/a/anyuser/x.cpp *
* *
* - restore old file version with specific date *
* tsm> restore -fromdate=2004.07.01 /afs/desy.de/user/a/anyuser/x.cpp *
* *
* - restore old directory version, with date limit and replace data *
* tsm> restore -rep=yes -subdir=yes -pitdate=2004.07.01 -
/afs/desy.de/user/a/anyuser/tesla/ *
* - online help *
* tsm> help *
* *
* - work done *
* tsm> quit *
* *
* *
* Start the TSM V5 GUI with command: dsm_afs *
* *
* *
* Please send complaints and suggestions to *
* tsm.service@desy.de *
* *
* *
Tivoli Storage Manager
Command Line Backup/Archive Client Interface - Version 5, Release 1, Level 7.0
(C) Copyright IBM Corporation 1990, 2004 All Rights Reserved.

Restoring TSM Backup Files by the Graphical User Interface (GUI)

1. Enter the command dsm_afs (in case of AFS) or dsm (in case of a local file or directory) to start the graphical user interface (GUI) which you can use alternatively (see picture).
It can happen that you are asked for your AFS password before you can go on.


2. Double click on button "Restore files and directories to your system" to initiate the file recovery as shown in the following picture.


The green lamp on one of the buttons indicates that the TSM system is ready to restore the most recent backup, the so called active incremental backup.
If you want to restore older versions which are also called inactive incremental versions then click on the green lamp to turn it off (black) or one should better say to change the mode.
As the names imply it takes longer to restore an inactive incremental backup than an active incremental backup.


3. Click on the little squares with the plus and minus sign in front of the server, drive or folder symbol to open or close the items concerned within the left pane in order to reach your desired folder down the AFS tree. Your backup files are usually stored under the initial letter of your userid and your userid within the AFS path "/afs/desy.de/user/r/" as shown for the userid "rkxxxxx".
Note, sometimes you see only the server “afs-safe1” at first. The opening process may take time.

4. In the left pane please click on the grey symbol of the folder you are interested in to see the files it contains within the right pane. The right pane lists the file names, the sizes, the modification, access and backup times. The latter ones possibly only become visible if you use the scroll bar.

5. Click on the little grey squares in front of the desired files or directories if you want to mark them by a hook for restoring. A further click reverses a selection if necessary.

6. Click on the button "Restore" to restore the selected files and folders (directories). A prompt gives you the option either to replace files or to divert them to a different destination.

To get further help please contact the UCO (uco@desy.de).