Tivoli Header
Tivoli Storage Manager for UNIX Backup-Archive Clients Installation and User's Guide
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 ]