3 .\" Author: John Stange <building@nap.edu>
4 .\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
6 .\" Manual: System Administration Commands
7 .\" Source: Amanda 3.3.2
10 .TH "AMFETCHDUMP" "8" "07/25/2012" "Amanda 3\&.3\&.2" "System Administration Commands"
11 .\" -----------------------------------------------------------------
12 .\" * Define some portability stuff
13 .\" -----------------------------------------------------------------
14 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
15 .\" http://bugs.debian.org/507673
16 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
17 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
20 .\" -----------------------------------------------------------------
21 .\" * set default formatting
22 .\" -----------------------------------------------------------------
23 .\" disable hyphenation
25 .\" disable justification (adjust text to left margin only)
27 .\" -----------------------------------------------------------------
28 .\" * MAIN CONTENT STARTS HERE *
29 .\" -----------------------------------------------------------------
31 amfetchdump \- extract backup images from multiple Amanda tapes\&.
33 .HP \w'\fBamfetchdump\fR\ 'u
34 \fBamfetchdump\fR [\-c | \-C | \-l] [\-p | \-n] [\-a] [\-O\ \fIdirectory\fR] [\-d\ \fIdevice\fR] [\-h | \-\-header\-file\ \fIfilename\fR | \-\-header\-fd\ \fIfd\fR] [\-\-decompress | \-\-no\-decompress | \-\-server\-decompress | \-\-client\-decompress] [\-\-decrypt | \-\-no\-decrypt | \-\-server\-decrypt | \-\-client\-decrypt] [\fB\-o\fR\ \fIconfigoption\fR...] \fIconfig\fR \fIhostname\fR [\fIdisk\fR\ [\ \fIdate\fR\ [\ \fIlevel\fR\ [\ \fIhostname\fR\ [\&.\&.\&.]\ ]\ ]\ ]]
38 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\&. The dump are by default decompressed and decrypted\&.
40 It will automatically use the Amanda catalog to locate available dumps on tape, in the same way that the
44 lists available dumps\&.
51 dump specifications are further described in
52 \fBamanda-match\fR(7)\&. Note that at minimum a
58 is used, backup images are extracted to files in the current directory named:
60 If a changer error occurs, or the
62 option is given, then amfetchdump prompts for each required volume\&.
64 \fIhostname\&.diskname\&.datestamp\&.dumplevel\fR
69 Pipe exactly one complete dump file to
70 \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)\&.
75 Output the amanda header as a 32K block to same output as the image\&.
78 \fB\-\-header\-fd\fR \fIfd\fR
80 Output the amanda header to the numbered file descriptor\&.
83 \fB\-\-header\-file\fR \fIfilename\fR
85 Output the amanda header to the filename\&.
88 \fB\-d\fR \fIdevice_or_changer\fR
90 Restore from this device or changer instead of the default, prompting for each volume\&.
93 \fB\-O\fR \fIdirectory\fR
95 Output restored files to this directory, instead of to the current working directory\&.
100 Compress output, fastest method available\&.
105 Compress output, smallest file size method available\&.
110 Always do the decompression, this is the default\&.
113 \fB\-\-no\-decompress\fR
115 Never do the decompression\&.
118 \fB\-\-server\-decompress\fR
120 Do the decompression only if the compression was done on the server\&.
123 \fB\-\-client\-decompress\fR
125 Do the decompression only if the compression was done on the client\&.
130 Always do the decryption, this is the default\&.
133 \fB\-\-no\-decrypt\fR
135 Never do the decryption\&.
138 \fB\-\-server\-decrypt\fR
140 Do the decryption only if the encryption was done on the server\&.
143 \fB\-\-client\-decrypt\fR
145 Do the decryption only if the encryption was done on the client\&.
150 Leave dumps in the compressed/uncompressed and encrypted/unencrypted state in which they were found on tape\&. It is a synonym for
151 \fB\-\-no\-decompression\fR
152 \fB\-\-no\-decryption\fR
157 Assume that all tapes are already available, via tape changer or otherwise, instead of prompting the operator to ensure that all tapes are loaded\&.
162 Do not reassemble split dump files at all, just restore each piece as an individual file\&.
165 \fB\-o\fR \fIconfigoption\fR
167 See the "\fBCONFIGURATION OVERRIDE\fR" section in
172 All the examples here assume your configuration is called
175 Here\*(Aqs a simple case, restoring all known dumps of the host vanya to the current working directory\&.
177 $ amfetchdump SetA vanya
180 A more likely scenario involves restoring a particular dump from a particular date\&. We\*(Aqll pipe this one to
182 as well, to automatically extract the dump\&.
184 $ amfetchdump \-p SetA vanya /home 20051020 | gtar \-xvpf \-
189 is dependent on accessing your server\*(Aqs config, tape changer, and (normally) dump logs\&. As such, it\*(Aqs 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
197 \fBamanda-match\fR(7),
202 : http://wiki.zmanda.com/
205 \fBJohn Stange\fR <\&building@nap\&.edu\&>
207 National Academies Press
210 \fBIan Turner\fR <\&ian@zmanda\&.com\&>
212 Zmanda, Inc\&. (http://www\&.zmanda\&.com)