Tivoli Storage Manager for NetWare Backup-Archive Client Installation and User's Guide

Restore

The restore command obtains copies of backup versions of your files from a server. To restore files, specify the directories or selected files, or select the files from a list. Restore files to the directory from which you backed them up or to a different directory. Tivoli Storage Manager uses the preservepath option with the subtree value as the default for restoring files. For more information, see Preservepath.

If you set the subdir option to yes when restoring a specific path and file, Tivoli Storage Manager recursively restores all subdirectories under that path, and any instances of the specified file that exist under any of those subdirectories.

System trustee rights are restored as part of the file restore process. They cannot be restored alone.

You can use the restore command to restore a backup set. See Restore Backupset for the syntax.

Syntax

                                     .----------------------.
            .- FILE-.                V                      |
>>-REStore--+-------+--+----------+----+-sourcefilespec---+-+--->
                       '- options-'    '-DIRectory or NDS-'
 
>--+----------------------+------------------------------------><
   '- destinationfilespec-'
 
 

Parameters

file

This parameter specifies that the source file specification is an explicit filename. This parameter is required when you restore a file name from the current path, when you do not specify a relative or absolute path, and when the file name conflicts with one of the reserved restore command keywords, such as restore backupset. See Maximum File Size for Operations for the maximum file size for restore processing.

options

You can use these command line options with the restore command: dirsonly, filelist, filesonly, fromdate, fromnode, fromtime, ifnewer, inactive, latest, pick, pitdate, pittime, preservepath, todate, totime. For more information, see Chapter 10, "Using Options with Commands".

You can use these common options with the restore command: replace, subdir. See Chapter 9, Using Processing Options for information about common options.

sourcefilespec

Specifies the path and file name in storage that you want to restore. Use wildcard characters to specify a group of files or all the files in a directory.

DIRectory or NDS

Restores the NDS. To restore the entire directory, enter:

  restore dir:* -sub=yes

To restore one container, enter:

dir:.o=container_name

In all examples, you may enter nds: instead of dir:.

Note:

Objects added after the backup version was created are not deleted.

destinationfilespec

Specifies the path and file name where you want to place the retrieved files. The path and file name must follow DOS naming conventions. If you do not specify a destination, Tivoli Storage Manager restores the files to the original source path.

Examples

Task

Restore a single file named budget.

Command: dsmc restore sys:u/projecta/budget

Task

Restore all files with a file extension of .bak from the sys:projecta directory.

Command: dsmc res sys:u/projecta/*.bak

Task

Restore files in the sys:user/project directory. Use the pick and inactive options to select active and inactive backup versions.

Command: dsmc res servb\sys:user/project/* -pick -inactive

Task

Restore all files from the sys:projecta directory that end with .bak to the sys:projectn directory.

Attention: If the destination is a directory, specify the delimiter (/) as the last character of the destination. If you omit the delimiter and your specified source is a directory or a file spec with a wildcard, you will receive an error.

Command: dsmc res sys:projecta/*.bak sys:projectn/

Task

Restore all files from the sys:projecta directory that end with .bak to another directory on a different NetWare server, serverb\sys:projectn. Projectn need not exist on serverb.

Command: dsmc restore sys:projecta/*.bak serverb\sys:projectn/

Task

Restore the NDS.

Command: dsmc res T9.dir:* -su=y -replace=y

Task

Restore the .o=ibm organization in the NDS.

Command: dsmc res adsm40.directory.o=ibm

Task

Restore files in the sys:user/project directory. Use the pick option and the inactive option.

Command: dsmc res servb\sys:user/projedct/* -pick -inactive

Task

Restore files specified in the filelist to a different location.

Command: dsmc res sys:dir1/dir2/restorelist.txt sys:home/NewRestoreLocation/