Tivoli Header

Tivoli Storage Manager for UNIX Backup-Archive Clients 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.

Note:
On UNIX systems when a symbolic link is created its modification time is set to the current system time and cannot be changed. So, when restoring a symbolic link its modification date and time is set to the date and time of the restore, not to the date and time the link had when it was backed up. As a result, Tivoli Storage Manager will back up the symbolic link during the next incremental backup because its modification time changed since the last backup.

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.

When you restore an entire directory or directory tree, and you do not specify the inactive, latest, pick, todate, and fromdate options on the restore command, Tivoli Storage Manager tracks which objects are restored. If the restore process is interrupted for any reason, you can restart the restore at the point of interruption by entering the restart restore command. It is possible to create more than one restartable restore session. Restores are only restartable if the filespec is fully wildcarded. For example, for a restore which is restartable, enter:

   dsmc rest /home/* -sub=yes

For a restore which is not restartable, enter:

   dsmc rest /home/file?.c -sub=yes

Use the query restore command to display a list of your restartable restore sessions in the server database. Further backups of the file system cannot be performed unless the restartable restore completes using the restart restore command or is cancelled using the cancel restore command.

Supported Clients

This command is valid for all UNIX clients.

Syntax

            .- FILE-.
>>-REStore--+-------+--+----------+--+- sourcefilespec---+------>
                       '- options-'  '- "sourcefilespec"-'
 
>--+----------------------+------------------------------------><
   '- 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, fromowner, 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, Setting 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.

destinationfilespec
Specifies the path and file name where you want to place the retrieved files. 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: restore /home/devel/projecta/budget

Task
Restore a single file named budget which resides in the current directory.

Command: restore file budget

Task
Restore all files with a file extension of .c from the /home/devel/projecta directory.

Command: restore "/home/devel/projecta/*.c"

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

Command: restore "/user/project/*" -pick -inactive

Task
Restore all files from the /home/devel/projecta directory that end with the character .c to the /home/newdevel/projectn/projecta directory. If the projectn or the projectn/projecta directory does not exist, it is created.

Command: restore "/home/devel/projecta/*.c" /home/newdevel/projectn/

Task
Restore all files in the /home/mydir directory to their state as of 1:00 PM on August 17, 2002.

Command: res -pitd=8/17/2002 -pitt=13:00:00 /home/mydir/

Task
Restore all objects in the /home/myid/ directory. Since this restore is fully wildcarded, if the restore process is interrupted, a restartable restore session is created. Use the restart restore command to restart a restartable restore session. Use the cancel restore command to cancel a restartable restore session.

Command: res /home/myid/*

Task
Restore files specified in the filelist to a different location.

Command: res -filelist=/home/avi/restorelist.txt /home/NewRestoreLocation/


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