-
- amfetchdump
-Prev Chapter 36. The Amanda Manual Pages. Next
-
--------------------------------------------------------------------------------
-
-Name
-
-amfetchdump \14 extract backup images from multiple Amanda tapes.
-
-Synopsis
-
-amfetchdump [-pcClawns] [-d device] [-O directory] [-i logfile] [-b blocksize]
-config hostname [ disk [ date [ level [ hostname [...] ] ] ] ] [ -
-o configoption]...
-
-DESCRIPTION
-
-Amfetchdump pulls one or more matching dumps from tape or from the holding
-disk, handling the reassembly of multi-tape split dump files as well as any
-tape autochanger operations.
-It will automatically use the logs created by amdump(8) to locate available
-dumps on tape, in the same way that the find feature of amadmin(8) lists
-available dumps. If these logs are unavailable, it can search tape-by-tape to
-find what it needs, and can generate new logs to serve as an emergency tape
-inventory.
-The hostname, diskname, datestamp, and level dump pattern-matching works as in
-amrestore(8), with the added requirement that at minimum a hostname must be
-specified when not in inventory mode.
-Unless -p is used, backup images are extracted to files in the current
-directory named:
-hostname.diskname.datestamp.dumplevel
-
-OPTIONS
-
-
-
- -p
- Pipe exactly one complete dump file to stdout, instead of writing the
- file to disk. This will restore only the first matching dumpfile (where
- "first" is determined by the dump log search facility).
-
- -d device
- Restore from this tape device instead of the default.
-
- -O directory
- Output restored files to this directory, instead of to the current
- working directory.
-
- -c
- Compress output, fastest method available.
-
- -C
- Compress output, smallest file size method available.
-
- -l
- Leave dumps in the compressed/uncompressed state in which they were found
- on tape. By default, amfetchdump will automatically uncompress when
- restoring.
-
- -a
- Assume that all tapes are already available, via tape changer or
- otherwise, instead of prompting the operator to ensure that all tapes are
- loaded.
-
- -i filename
- Generate an inventory of all dumps "seen" on the tapes we search, for
- later use as a log.
-
- -w
- Wait to put split dumps together until all chunks have been restored.
- Normally, amfetchdump will attempt to read pieces of a split file from
- tape in order, so that it can assemble them simply by appending each file
- to the first. This option disables the appending behavior, and instead
- restores each piece as an individual file and reassembles them only after
- all have been restored.
-
- Note
-
- This requires at least double the size of your dump in free disk space,
- in order to build the final assembled dumpfile.
- This behavior is implicitly invoked in circumstances where knowing the
- location of all dumps on tape in advance is not possible, such as when
- you are restoring without log files.
-
- -n
- Do not reassemble split dump files at all, just restore each piece as an
- individual file.
-
- -s
- Do not fast-forward straight to needed files on tape. This will slow down
- most restores substantially. Only use this option if your tape drive does
- not properly support the fast-forward operation.
-
- -b blocksize
- Force a particular block size when reading from tapes. This value will
- usually be autodetected, and should not normally need to be set.
-
- -o configoption
- See the "CONFIGURATION OVERWRITE" section in amanda(8).
-
-
-EXAMPLES
-
-All the examples here assume your configuration is called SetA.
-Here's a simple case, restoring all known dumps of the host vanya to the
-current working directory.
-
-$ amfetchdump SetA vanya
-A more likely scenario involves restoring a particular dump from a particular
-date. We'll pipe this one to GNU-tar as well, to automatically extract the
-dump.
-
-$ amfetchdump -p SetA vanya /home 20051020 | gtar -xvpf -
-In a situation where all of our dump logs have been wiped out, we could also
-use amfetchdump to inventory our tapes and recreate an imitation of those logs,
-which we'll send to stdout for casual perusal.
-
-$ amfetchdump -i - SetA
-Note that you can specify a restore while in inventory mode, and amfetchdump
-will continue searching for more dumps from this host even after successfully
-restoring a dump, inventorying all the while. If your backup searcher has been
-trashed, this is a handy way to recover what you have.
-
-$ amfetchdump -i /var/amanda/log SetA backupserver
-
-CAVEATS
-
-Amfetchdump is dependent on accessing your server's config, tape changer, and
-(normally) dump logs. As such, it's not necessarily the most useful tool when
-those have all been wiped out and you desperately need to pull things from your
-tape. Pains have been taken to make it as capable as possible, but for
-seriously minimialist restores, look to amrestore(8) or dd(8) instead.
-
-AUTHOR
-
-John Stange, <building@nap.edu>, National Academies Press
-Ian Turner, <ian@zmanda.com>: XML-conversion
-
-SEE ALSO
-
-amanda(8), amadmin(8), amrestore(8), tar(1) restore(8)
--------------------------------------------------------------------------------
-
-Prev Up Next
-amdump Home amflush
-