Tivoli Header

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/


[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]