3 .\" Author: John Stange <building@nap.edu>
4 .\" Generator: DocBook XSL Stylesheets vsnapshot_8273 <http://docbook.sf.net/>
6 .\" Manual: System Administration Commands
7 .\" Source: Amanda 3.1.0
10 .TH "AMFETCHDUMP" "8" "06/01/2010" "Amanda 3\&.1\&.0" "System Administration Commands"
11 .\" -----------------------------------------------------------------
12 .\" * set default formatting
13 .\" -----------------------------------------------------------------
14 .\" disable hyphenation
16 .\" disable justification (adjust text to left margin only)
18 .\" -----------------------------------------------------------------
19 .\" * MAIN CONTENT STARTS HERE *
20 .\" -----------------------------------------------------------------
22 amfetchdump \- extract backup images from multiple Amanda tapes\&.
24 .HP \w'\fBamfetchdump\fR\ 'u
25 \fBamfetchdump\fR [\-phcClawns] [\-d\ \fIdevice\fR] [\-O\ \fIdirectory\fR] [\-b\ \fIblocksize\fR] [\-\-header\-fd\ \fIfd\fR] [\-\-header\-file\ \fIfilename\fR] [\-o\ \fIconfigoption\fR]... \fIconfig\fR \fIhostname\fR [\fIdisk\fR\ [\ \fIdate\fR\ [\ \fIlevel\fR\ [\ \fIhostname\fR\ [\&.\&.\&.]\ ]\ ]\ ]]
29 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\&.
31 It will automatically use the logs created by
33 to locate available dumps on tape, in the same way that the
37 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\&.
44 dump pattern\-matching works as in
45 \fBamrestore\fR(8), with the added requirement that at minimum a
47 must be specified when not in inventory mode\&.
51 is used, backup images are extracted to files in the current directory named:
53 If a changer error occurs, or the
55 option is given, then amfetchdump prompts for each required volume\&.
57 \fIhostname\&.diskname\&.datestamp\&.dumplevel\fR
62 Pipe exactly one complete dump file to
63 \fIstdout\fR, 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)\&.
68 Output the amanda header as a 32K block to same output as the image\&.
71 \fB\-\-header\-fd\fR \fIfd\fR
73 Output the amanda header to the numbered file descriptor\&.
76 \fB\-\-header\-file\fR \fIfilename\fR
78 Output the amanda header to the filename\&.
81 \fB\-d\fR \fIdevice_or_changer\fR
83 Restore from this device or changer instead of the default, prompting for each volume\&.
86 \fB\-O\fR \fIdirectory\fR
88 Output restored files to this directory, instead of to the current working directory\&.
93 Compress output, fastest method available\&.
98 Compress output, smallest file size method available\&.
103 Leave dumps in the compressed/uncompressed state in which they were found on tape\&. By default,
105 will automatically uncompress when restoring\&.
110 Assume that all tapes are already available, via tape changer or otherwise, instead of prompting the operator to ensure that all tapes are loaded\&.
115 Do not reassemble split dump files at all, just restore each piece as an individual file\&.
118 \fB\-o\fR \fIconfigoption\fR
120 See the "\fBCONFIGURATION OVERRIDE\fR" section in
125 All the examples here assume your configuration is called
128 Here\'s a simple case, restoring all known dumps of the host vanya to the current working directory\&.
130 $ amfetchdump SetA vanya
133 A more likely scenario involves restoring a particular dump from a particular date\&. We\'ll pipe this one to
135 as well, to automatically extract the dump\&.
137 $ amfetchdump \-p SetA vanya /home 20051020 | gtar \-xvpf \-
142 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
156 : http://wiki.zmanda.com/
159 \fBJohn Stange\fR <\&building@nap\&.edu\&>
161 National Academies Press
164 \fBIan Turner\fR <\&ian@zmanda\&.com\&>
166 Zmanda, Inc\&. (http://www\&.zmanda\&.com)