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.2.1
10 .TH "AMFETCHDUMP" "8" "12/14/2010" "Amanda 3\&.2\&.1" "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] [\fB\-o\fR\ \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 Amanda catalog to locate available dumps on tape, in the same way that the
35 lists available dumps\&.
42 dump specifications are further described in
43 \fBamanda-match\fR(7)\&. Note that at minimum a
49 is used, backup images are extracted to files in the current directory named:
51 If a changer error occurs, or the
53 option is given, then amfetchdump prompts for each required volume\&.
55 \fIhostname\&.diskname\&.datestamp\&.dumplevel\fR
60 Pipe exactly one complete dump file to
61 \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)\&.
66 Output the amanda header as a 32K block to same output as the image\&.
69 \fB\-\-header\-fd\fR \fIfd\fR
71 Output the amanda header to the numbered file descriptor\&.
74 \fB\-\-header\-file\fR \fIfilename\fR
76 Output the amanda header to the filename\&.
79 \fB\-d\fR \fIdevice_or_changer\fR
81 Restore from this device or changer instead of the default, prompting for each volume\&.
84 \fB\-O\fR \fIdirectory\fR
86 Output restored files to this directory, instead of to the current working directory\&.
91 Compress output, fastest method available\&.
96 Compress output, smallest file size method available\&.
101 Leave dumps in the compressed/uncompressed state in which they were found on tape\&. By default,
103 will automatically uncompress when restoring\&.
108 Assume that all tapes are already available, via tape changer or otherwise, instead of prompting the operator to ensure that all tapes are loaded\&.
113 Do not reassemble split dump files at all, just restore each piece as an individual file\&.
116 \fB\-o\fR \fIconfigoption\fR
118 See the "\fBCONFIGURATION OVERRIDE\fR" section in
123 All the examples here assume your configuration is called
126 Here\'s a simple case, restoring all known dumps of the host vanya to the current working directory\&.
128 $ amfetchdump SetA vanya
131 A more likely scenario involves restoring a particular dump from a particular date\&. We\'ll pipe this one to
133 as well, to automatically extract the dump\&.
135 $ amfetchdump \-p SetA vanya /home 20051020 | gtar \-xvpf \-
140 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
148 \fBamanda-match\fR(7),
153 : http://wiki.zmanda.com/
156 \fBJohn Stange\fR <\&building@nap\&.edu\&>
158 National Academies Press
161 \fBIan Turner\fR <\&ian@zmanda\&.com\&>
163 Zmanda, Inc\&. (http://www\&.zmanda\&.com)