git.gag.com Git - debian/amanda/blob - man/amfetchdump.8

   1 '\" t
   2 .\"     Title: amfetchdump
   3 .\"    Author: John Stange <building@nap.edu>
   4 .\" Generator: DocBook XSL Stylesheets vsnapshot_8273 <http://docbook.sf.net/>
   5 .\"      Date: 10/18/2010
   6 .\"    Manual: System Administration Commands
   7 .\"    Source: Amanda 3.2.0
   8 .\"  Language: English
   9 .\"
  10 .TH "AMFETCHDUMP" "8" "10/18/2010" "Amanda 3\&.2\&.0" "System Administration Commands"
  11 .\" -----------------------------------------------------------------
  12 .\" * set default formatting
  13 .\" -----------------------------------------------------------------
  14 .\" disable hyphenation
  15 .nh
  16 .\" disable justification (adjust text to left margin only)
  17 .ad l
  18 .\" -----------------------------------------------------------------
  19 .\" * MAIN CONTENT STARTS HERE *
  20 .\" -----------------------------------------------------------------
  21 .SH "NAME"
  22 amfetchdump \- extract backup images from multiple Amanda tapes\&.
  23 .SH "SYNOPSIS"
  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\ [\&.\&.\&.]\ ]\ ]\ ]]
  26 .SH "DESCRIPTION"
  27 .PP
  28 \fBAmfetchdump\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\&.
  30 .PP
  31 It will automatically use the Amanda catalog to locate available dumps on tape, in the same way that the
  32 \fBfind\fR
  33 feature of
  34 \fBamadmin\fR(8)
  35 lists available dumps\&.
  36 .PP
  37 The
  38 \fIhostname\fR,
  39 \fIdiskname\fR,
  40 \fIdatestamp\fR, and
  41 \fIlevel\fR
  42 dump specifications are further described in
  43 \fBamanda-match\fR(7)\&. Note that at minimum a
  44 \fIhostname\fR
  45 must be specified\&.
  46 .PP
  47 Unless
  48 \fB\-p\fR
  49 is used, backup images are extracted to files in the current directory named:
  50 .PP
  51 If a changer error occurs, or the
  52 \fB\-d\fR
  53 option is given, then amfetchdump prompts for each required volume\&.
  54 .PP
  55 \fIhostname\&.diskname\&.datestamp\&.dumplevel\fR
  56 .SH "OPTIONS"
  57 .PP
  58 \fB\-p\fR
  59 .RS 4
  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)\&.
  62 .RE
  63 .PP
  64 \fB\-h\fR
  65 .RS 4
  66 Output the amanda header as a 32K block to same output as the image\&.
  67 .RE
  68 .PP
  69 \fB\-\-header\-fd\fR \fIfd\fR
  70 .RS 4
  71 Output the amanda header to the numbered file descriptor\&.
  72 .RE
  73 .PP
  74 \fB\-\-header\-file\fR \fIfilename\fR
  75 .RS 4
  76 Output the amanda header to the filename\&.
  77 .RE
  78 .PP
  79 \fB\-d\fR \fIdevice_or_changer\fR
  80 .RS 4
  81 Restore from this device or changer instead of the default, prompting for each volume\&.
  82 .RE
  83 .PP
  84 \fB\-O\fR \fIdirectory\fR
  85 .RS 4
  86 Output restored files to this directory, instead of to the current working directory\&.
  87 .RE
  88 .PP
  89 \fB\-c\fR
  90 .RS 4
  91 Compress output, fastest method available\&.
  92 .RE
  93 .PP
  94 \fB\-C\fR
  95 .RS 4
  96 Compress output, smallest file size method available\&.
  97 .RE
  98 .PP
  99 \fB\-l\fR
 100 .RS 4
 101 Leave dumps in the compressed/uncompressed state in which they were found on tape\&. By default,
 102 \fBamfetchdump\fR
 103 will automatically uncompress when restoring\&.
 104 .RE
 105 .PP
 106 \fB\-a\fR
 107 .RS 4
 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\&.
 109 .RE
 110 .PP
 111 \fB\-n\fR
 112 .RS 4
 113 Do not reassemble split dump files at all, just restore each piece as an individual file\&.
 114 .RE
 115 .PP
 116 \fB\-o\fR \fIconfigoption\fR
 117 .RS 4
 118 See the "\fBCONFIGURATION OVERRIDE\fR" section in
 119 \fBamanda\fR(8)\&.
 120 .RE
 121 .SH "EXAMPLES"
 122 .PP
 123 All the examples here assume your configuration is called
 124 \fISetA\fR\&.
 125 .PP
 126 Here\'s a simple case, restoring all known dumps of the host vanya to the current working directory\&.
 127 .nf
 128 $ amfetchdump SetA vanya
 129 .fi
 130 .PP
 131 A more likely scenario involves restoring a particular dump from a particular date\&. We\'ll pipe this one to
 132 \fBGNU\-tar\fR
 133 as well, to automatically extract the dump\&.
 134 .nf
 135 $ amfetchdump \-p SetA vanya /home 20051020 | gtar \-xvpf \-
 136 .fi
 137 .SH "CAVEATS"
 138 .PP
 139 \fBAmfetchdump\fR
 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
 141 \fBamrestore\fR(8)
 142 or
 143 \fBdd\fR(8)
 144 instead\&.
 145 .SH "SEE ALSO"
 146 .PP
 147 \fBamanda\fR(8),
 148 \fBamanda-match\fR(7),
 149 \fBamadmin\fR(8),
 150 \fBamrestore\fR(8)
 151 .PP
 152 The Amanda Wiki:
 153 : http://wiki.zmanda.com/
 154 .SH "AUTHORS"
 155 .PP
 156 \fBJohn Stange\fR <\&building@nap\&.edu\&>
 157 .RS 4
 158 National Academies Press
 159 .RE
 160 .PP
 161 \fBIan Turner\fR <\&ian@zmanda\&.com\&>
 162 .RS 4
 163 Zmanda, Inc\&. (http://www\&.zmanda\&.com)
 164 .RE