tar: Scripted Restoration
1
1 5.6 Using the Restore Script
1 ============================
1
1 To restore files that were archived using a scripted backup, use the
1 'restore' script. Its usage is quite straightforward. In the simplest
1 form, invoke 'restore --all', it will then restore all the file systems
11 and files specified in 'backup-specs' (⇒BACKUP_DIRS
General-Purpose Variables.).
1
1 You may select the file systems (and/or files) to restore by giving
1 'restore' a list of "patterns" in its command line. For example,
1 running
1
1 restore 'albert:*'
1
1 will restore all file systems on the machine 'albert'. A more
1 complicated example:
1
1 restore 'albert:*' '*:/var'
1
1 This command will restore all file systems on the machine 'albert' as
1 well as '/var' file system on all machines.
1
1 By default 'restore' will start restoring files from the lowest
1 available dump level (usually zero) and will continue through all
1 available dump levels. There may be situations where such a thorough
1 restore is not necessary. For example, you may wish to restore only
1 files from the recent level one backup. To do so, use '--level' option,
1 as shown in the example below:
1
1 restore --level=1
1
1 The full list of options accepted by 'restore' follows:
1
1 '-a'
1 '--all'
1 Restore all file systems and files specified in 'backup-specs'.
1
1 '-l LEVEL'
1 '--level=LEVEL'
1 Start restoring from the given backup level, instead of the default
1 0.
1
1 '-v[LEVEL]'
1 '--verbose[=LEVEL]'
1 Set verbosity level. The higher the level is, the more debugging
1 information will be output during execution. Default LEVEL is 100,
1 which means the highest debugging level.
1
1 '-h'
1 '--help'
1 Display short help message and exit.
1
1 '-V'
1 '--version'
1 Display information about the program's name, version, origin and
1 legal status, all on standard output, and then exit successfully.
1
1 You should start the restore script with the media containing the
1 first volume of the archive mounted. The script will prompt for other
1 volumes as they are needed. If the archive is on tape, you don't need
1 to rewind the tape to to its beginning--if the tape head is positioned
1 past the beginning of the archive, the script will rewind the tape as
1 needed. ⇒Tape Positioning, for a discussion of tape positioning.
1
1 *Warning:* The script will delete files from the active file system
1 if they were not in the file system when the archive was made.
1
1 ⇒Incremental Dumps, for an explanation of how the script makes
1 that determination.
1