====== TSM Kommandozeile Überblick ======

===== Commands =====

==== Display ====


  * List contents of backup:

  dsmc query backup '/data/*'
  

==== Back up and archive ====

  * Incremental

  dsmc incr

  * Archive

  dsmc archive "/scratch/anna/*" -subdir=yes -description="Describe this archiving"
==== Restore and retrieve ====

The //restore// command works with files that have been backed up, //retrieve// works with files that have been archived. Otherwise the command and options are pretty much the same.

  * Restore files with directory recursion to __original__ location:

  dsmc restore "/data/*" -su=yes
  
"-su" stands for subdirectories.

  * Restore files recursively to a __different__ location:

  dsmc restore "/data/*" /different/location/ -su=yes

The "/" at end of the new location is mandatory.

  * :!: Please note that performing several restores in a row sometimes pulls in files that were previously marked as unavailable

==== Restore older (inactive) files or folders ====

  * search for available versions:
<code>
dsmc restore -inactive -pick -su=yes '/data/dir*' /different/location/ 
</code>
A window will open with the older files or folders numbered;choose the number of the file you want to restore and press enter; confirm by typing o (stands for ok) and press enter again, the files will be restored in the chosen location

==== Delete files from backup and archive ====

The commands are:

  dsmc delete backup ...
  dsmc delete archive ...
  
The other specifications are the same as with //backup//, //archive//, //restore// and //retrieve//.
==== Restartable restore sessions ====

  * List restartable restore sessions:

  dsmc query restore

  * Restart a restartable restore:

  dsmc restart restore

Choose for the list of restore sessions displayed.

  * Cancel a restartable restore:

  dsmc cancel restore

Choose for the list of restore sessions displayed.


==== Access ====


  * Allow access to this host's backup from other hosts:

  dsmc set access backup "*" TOP*.PHYSIK.UNI-FREIBURG.DE root

  * Display host that have been allowed access to this host's backup.

  dmsc query access

  * Delete access to this host's backup from other hosts:

  dmsc delete access

A list of access rules is shown and the user selects which one to delete.

  * Specify a different host's backup to restore from:

<code>
-fromnode=other-host
</code>


  * Do several at once to speed up recovery
===== Options =====

  * Options apparently go at the end of a command.

  * It looks like using dsmc interactively will wait for tape mounts but otherwise it won't. You can use the //tapeprompt// option:

<code>
  -tapeprompt=no
</code>

"No" is the default and means TSM will automatically wait for the tape to be mounted. "Yes" means TSM will ask the user whether to wait or not.

  * Specify what to do when trying to restore to an existing file with:

<code>
-replace=xxx
</code>

The possibilities are:

  * Prompt (default): You are prompted whether to overwrite a file that already exists on your workstation.
  * All: All existing files are overwritten. No action is taken on the file until there is a response to the prompt.
  * Yes: Any existing files are overwritten. No action is taken on the file until there is a response to the prompt.
  * No: Existing files are not overwritten. No more prompts will be displayed.