X-Git-Url: https://git.gag.com/?a=blobdiff_plain;f=man%2Famfetchdump.8;h=10fe5eb48f477e3555c0094319df494437996794;hb=HEAD;hp=b64135113bfe05e9fdc6192f28e1771ea26a7246;hpb=79cdc4b6ea8848b21ba4a0e7d2fd3bc401e0bebe;p=debian%2Famanda diff --git a/man/amfetchdump.8 b/man/amfetchdump.8 index b641351..10fe5eb 100644 --- a/man/amfetchdump.8 +++ b/man/amfetchdump.8 @@ -1,13 +1,22 @@ '\" t .\" Title: amfetchdump .\" Author: John Stange -.\" Generator: DocBook XSL Stylesheets vsnapshot_8273 -.\" Date: 04/10/2009 +.\" Generator: DocBook XSL Stylesheets v1.76.1 +.\" Date: 01/10/2013 .\" Manual: System Administration Commands -.\" Source: Amanda 2.6.1p1 +.\" Source: Amanda 3.3.3 .\" Language: English .\" -.TH "AMFETCHDUMP" "8" "04/10/2009" "Amanda 2\&.6\&.1p1" "System Administration Commands" +.TH "AMFETCHDUMP" "8" "01/10/2013" "Amanda 3\&.3\&.3" "System Administration Commands" +.\" ----------------------------------------------------------------- +.\" * Define some portability stuff +.\" ----------------------------------------------------------------- +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.\" http://bugs.debian.org/507673 +.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.ie \n(.g .ds Aq \(aq +.el .ds Aq ' .\" ----------------------------------------------------------------- .\" * set default formatting .\" ----------------------------------------------------------------- @@ -19,37 +28,39 @@ .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- .SH "NAME" -amfetchdump \- extract backup images from multiple \fIAmanda\fR tapes\&. +amfetchdump \- extract backup images from multiple Amanda tapes\&. .SH "SYNOPSIS" .HP \w'\fBamfetchdump\fR\ 'u -\fBamfetchdump\fR [\-pcClawns] [\-d\ \fIdevice\fR] [\-O\ \fIdirectory\fR] [\-b\ \fIblocksize\fR] \fIconfig\fR \fIhostname\fR [\fIdisk\fR\ [\ \fIdate\fR\ [\ \fIlevel\fR\ [\ \fIhostname\fR\ [\&.\&.\&.]\ ]\ ]\ ]] [\-o\ \fIconfigoption\fR]... +\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] [\-\-extract\ \-\-directory\fI\ directory\fR\ [\-\-data\-path\fI\ amanda|directtcp\fR]\ [\-\-application\-property\ \fINAME=VALUE\fR]*] [\-\-decrypt | \-\-no\-decrypt | \-\-server\-decrypt | \-\-client\-decrypt] [\-\-exact_match] [\fB\-o\fR\ \fIconfigoption\fR...] \fIconfig\fR \fIhostname\fR [\fIdisk\fR\ [\ \fIdate\fR\ [\ \fIlevel\fR\ [\ \fIhostname\fR\ [\&.\&.\&.]\ ]\ ]\ ]] .SH "DESCRIPTION" .PP \fBAmfetchdump\fR -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\&. +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\&. .PP -It will automatically use the logs created by -\fBamdump\fR(8) -to locate available dumps on tape, in the same way that the +It will automatically use the Amanda catalog to locate available dumps on tape, in the same way that the \fBfind\fR feature of \fBamadmin\fR(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\&. +lists available dumps\&. .PP The \fIhostname\fR, \fIdiskname\fR, \fIdatestamp\fR, and \fIlevel\fR -dump pattern\-matching works as in -\fBamrestore\fR(8), with the added requirement that at minimum a +dump specifications are further described in +\fBamanda-match\fR(7)\&. Note that at minimum a \fIhostname\fR -must be specified when not in inventory mode\&. +must be specified\&. .PP Unless \fB\-p\fR is used, backup images are extracted to files in the current directory named: .PP +If a changer error occurs, or the +\fB\-d\fR +option is given, then amfetchdump prompts for each required volume\&. +.PP \fIhostname\&.diskname\&.datestamp\&.dumplevel\fR .SH "OPTIONS" .PP @@ -59,9 +70,24 @@ Pipe exactly one complete dump file to \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)\&. .RE .PP -\fB\-d\fR \fIdevice\fR +\fB\-h\fR .RS 4 -Restore from this tape device instead of the default\&. +Output the amanda header as a 32K block to same output as the image\&. +.RE +.PP +\fB\-\-header\-fd\fR \fIfd\fR +.RS 4 +Output the amanda header to the numbered file descriptor\&. +.RE +.PP +\fB\-\-header\-file\fR \fIfilename\fR +.RS 4 +Output the amanda header to the filename\&. +.RE +.PP +\fB\-d\fR \fIdevice_or_changer\fR +.RS 4 +Restore from this device or changer instead of the default, prompting for each volume\&. .RE .PP \fB\-O\fR \fIdirectory\fR @@ -79,54 +105,94 @@ Compress output, fastest method available\&. Compress output, smallest file size method available\&. .RE .PP -\fB\-l\fR +\fB\-\-decompress\fR .RS 4 -Leave dumps in the compressed/uncompressed state in which they were found on tape\&. By default, -\fBamfetchdump\fR -will automatically uncompress when restoring\&. +Always do the decompression, this is the default\&. .RE .PP -\fB\-a\fR +\fB\-\-no\-decompress\fR .RS 4 -Assume that all tapes are already available, via tape changer or otherwise, instead of prompting the operator to ensure that all tapes are loaded\&. +Never do the decompression\&. +.RE +.PP +\fB\-\-server\-decompress\fR +.RS 4 +Do the decompression only if the compression was done on the server\&. +.RE +.PP +\fB\-\-client\-decompress\fR +.RS 4 +Do the decompression only if the compression was done on the client\&. +.RE +.PP +\fB\-\-decrypt\fR +.RS 4 +Always do the decryption, this is the default\&. +.RE +.PP +\fB\-\-no\-decrypt\fR +.RS 4 +Never do the decryption\&. +.RE +.PP +\fB\-\-server\-decrypt\fR +.RS 4 +Do the decryption only if the encryption was done on the server\&. +.RE +.PP +\fB\-\-client\-decrypt\fR +.RS 4 +Do the decryption only if the encryption was done on the client\&. +.RE +.PP +\fB\-\-exact\-match\fR +.RS 4 +The host and disk are parsed as exact values +.RE +.PP +\fB\-\-extract\fR +.RS 4 +Extract the backup on the server in the +\fIdirectory\fR +directory\&. .RE .PP -\fB\-w\fR +\fB\-\-directory\fR \fIdirectory\fR .RS 4 -Wait to put split dumps together until all chunks have been restored\&. Normally, -\fBamfetchdump\fR -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\&. -.if n \{\ +Where to extract the backup with the +\fB\-\-extract\fR +option\&. .sp -.\} +Warning: All files in that directory can be removed\&. +.RE +.PP +\fB\-\-data\-path\fR amanda|directtcp .RS 4 -.it 1 an-trap -.nr an-no-space-flag 1 -.nr an-break-flag 1 -.br -.ps +1 -\fBNote\fR -.ps -1 -.br -This requires at least double the size of your dump in free disk space, in order to build the final assembled dumpfile\&. -.sp .5v +The data path to use with +\fB\-\-extract\fR, the default is to use the fatest data path\&. .RE -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\&. +.PP +\fB\-\-application\-property\fR \fINAME=VALUE\fR +.RS 4 +Application property to send to the application with +\fB\-\-extract\&.\fR .RE .PP -\fB\-n\fR +\fB\-l\fR .RS 4 -Do not reassemble split dump files at all, just restore each piece as an individual file\&. +Leave dumps in the compressed/uncompressed and encrypted/unencrypted state in which they were found on tape\&. It is a synonym for +\fB\-\-no\-decompression\fR +\fB\-\-no\-decryption\fR .RE .PP -\fB\-s\fR +\fB\-a\fR .RS 4 -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\&. +Assume that all tapes are already available, via tape changer or otherwise, instead of prompting the operator to ensure that all tapes are loaded\&. .RE .PP -\fB\-b\fR \fIblocksize\fR +\fB\-n\fR .RS 4 -Force a particular block size when reading from tapes\&. This value will usually be autodetected, and should not normally need to be set\&. +Do not reassemble split dump files at all, just restore each piece as an individual file\&. .RE .PP \fB\-o\fR \fIconfigoption\fR @@ -139,12 +205,12 @@ See the "\fBCONFIGURATION OVERRIDE\fR" section in All the examples here assume your configuration is called \fISetA\fR\&. .PP -Here\'s a simple case, restoring all known dumps of the host vanya to the current working directory\&. +Here\*(Aqs a simple case, restoring all known dumps of the host vanya to the current working directory\&. .nf $ amfetchdump SetA vanya .fi .PP -A more likely scenario involves restoring a particular dump from a particular date\&. We\'ll pipe this one to +A more likely scenario involves restoring a particular dump from a particular date\&. We\*(Aqll pipe this one to \fBGNU\-tar\fR as well, to automatically extract the dump\&. .nf @@ -153,7 +219,7 @@ $ amfetchdump \-p SetA vanya /home 20051020 | gtar \-xvpf \- .SH "CAVEATS" .PP \fBAmfetchdump\fR -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 +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 \fBamrestore\fR(8) or \fBdd\fR(8) @@ -161,11 +227,12 @@ instead\&. .SH "SEE ALSO" .PP \fBamanda\fR(8), +\fBamanda-match\fR(7), \fBamadmin\fR(8), -\fBamrestore\fR(8), -\fBtar\fR(1), -\fBrestore\fR(8), -: http://wiki.zmanda.com +\fBamrestore\fR(8) +.PP +The Amanda Wiki: +: http://wiki.zmanda.com/ .SH "AUTHORS" .PP \fBJohn Stange\fR <\&building@nap\&.edu\&>