X-Git-Url: https://git.gag.com/?a=blobdiff_plain;f=man%2Famrestore.8;h=545eba1963b9cae0b0d817851802e6ade24aa838;hb=d74dc4d908fcbc1a4ef474edaf51e61ec90eab6b;hp=a51961fbf2b04f75509bf9ae4689e479f2ab5752;hpb=3ab887b9bc819a846c75dd7f2ee5d41fac22b19f;p=debian%2Famanda diff --git a/man/amrestore.8 b/man/amrestore.8 index a51961f..545eba1 100644 --- a/man/amrestore.8 +++ b/man/amrestore.8 @@ -1,321 +1,290 @@ +'\" t +.\" Title: amrestore +.\" Author: James da Silva +.\" Generator: DocBook XSL Stylesheets vsnapshot_8273 +.\" Date: 04/10/2009 +.\" Manual: System Administration Commands +.\" Source: Amanda 2.6.1p1 +.\" Language: English .\" -.de EX -.if t .ft C -.nf -.. -.de EE -.fi -.if t .ft -.. -.TH AMRESTORE 8 -.SH NAME -amrestore \- extract backup images from an Amanda tape -.SH SYNOPSIS -.B amrestore -[ -.B \-r -| -.B \-c -| -.B \-C -] -[ -.B \-b -.I blocksize -] -[ -.B \-f -.I fileno -] -[ -.B \-l -.I label -] -[ -.B \-p -] -[ -.B \-h -] -.I tapedevice -| -.I holdingfile -[ -.I hostname -[ -.I diskname -[ -.I datestamp -[ -.I hostname -[ -.I diskname -[ -.I datestamp -\&... -]]]]]] -.SH DESCRIPTION -.B Amrestore +.TH "AMRESTORE" "8" "04/10/2009" "Amanda 2\&.6\&.1p1" "System Administration Commands" +.\" ----------------------------------------------------------------- +.\" * set default formatting +.\" ----------------------------------------------------------------- +.\" disable hyphenation +.nh +.\" disable justification (adjust text to left margin only) +.ad l +.\" ----------------------------------------------------------------- +.\" * MAIN CONTENT STARTS HERE * +.\" ----------------------------------------------------------------- +.SH "NAME" +amrestore \- extract backup images from an \fIAmanda\fR tape +.SH "SYNOPSIS" +.HP \w'\fBamrestore\fR\ 'u +\fBamrestore\fR [\-r | \-c | \-C] [\-b | \fIblocksize\fR] [\-f | \fIfileno\fR] [\-l | \fIlabel\fR] [\-p] [\-h] \fItapedevice\fR|\ \fIholdingfile\fR [\fIhostname\fR [\fIdiskname\fR [\fIdatestamp\fR [\fIhostname\fR [\fIdiskname\fR [\fIdatestamp\fR | \&.\&.\&.]]]]]] +.SH "DESCRIPTION" +.PP +\fBAmrestore\fR extracts backup images from the tape mounted on -.I tapedevice +\fItapedevice\fR or from the holding disk file -.I holdingfile +\fIholdingfile\fR that match -.IR hostname , -.I diskname +\fIhostname\fR, +\fIdiskname\fR and -.I datestamp -patterns given on the command line. -The tape or holding file must be in a format written by the -.B amdump +\fIdatestamp\fR +patterns given on the command line\&. The tape or holding file must be in a format written by the +\fBamdump\fR or -.B amflush -program. -.LP +\fBamflush\fR +program\&. +.PP If -.I diskname +\fIdiskname\fR is not specified, all backups on the tape for the previous -.I hostname -are candidates. -If -.I datestamp +\fIhostname\fR +are candidates\&. If +\fIdatestamp\fR is not specified, all backups on the tape for the previous -.I hostname +\fIhostname\fR and -.I diskname -are candidates. -If no -.IR hostname , -.I diskname +\fIdiskname\fR +are candidates\&. If no +\fIhostname\fR, +\fIdiskname\fR or -.I datestamp -are specified, every backup on the tape is a candidate. -.LP -.I Hostname +\fIdatestamp\fR +are specified, every backup on the tape is a candidate\&. +.PP +\fIHostname\fR and -.I diskname -are special expression descibe in the "HOST & DISK EXPRESSION" section -of -.IR amanda (8). -.I Datestamp -are special expression describe in the "DATESTAMP EXPRESSION" section -of -.IR amanda (8). -For example, if -.I diskname +\fIdiskname\fR +are special expressions described in the "HOST & DISK EXPRESSION" section of +\fBamanda\fR(8)\&. +\fIDatestamp\fR +are special expression described in the "DATESTAMP EXPRESSION" section of +\fBamanda\fR(8)\&. For example, if +\fIdiskname\fR is "rz[23]a", it would match disks -.B rz2a +\fBrz2a\fR and -.BR rz3a . -.LP -.I Datestamp +\fBrz3a\fR\&. +.PP +\fIDatestamp\fR is useful if -.B amflush -writes multiple backup runs to a single tape. +\fBamflush\fR +writes multiple backup runs to a single tape\&. .PP Unless -.B \-p -is used, -candidate backup images are extracted to files -in the current directory named: -.LP -.RS -.I hostname.diskname.datestamp.dumplevel +\fB\-p\fR +is used, candidate backup images are extracted to files in the current directory named: +.PP +\fIhostname\&.diskname\&.datestamp\&.dumplevel\fR +.PP +Amrestore doesn\'t use a changer, it restore from the tape already loaded in the +\fItapedevice\&.\fR +.SH "OPTIONS" +.PP +\fB\-b\fR +.RS 4 +Set the blocksize used to read the tape or holding file\&. All holding files must be read with a blocksize of 32 KBytes\&. +\fBAmrestore\fR +should normally be able to determine the blocksize for tapes on its own and not need this parameter\&. +.RE +.PP +The default is 32 KBytes\&. +.PP +\fB\-f\fR +.RS 4 +Do a rewind followed by a fsf before trying to restore an image\&. .RE .PP -Amrestore doesn't use a changer, it restore from the tape already loaded -in the -.I tapedevice. -.SH OPTIONS -.TP -.B \-b -Set the blocksize used to read the tape or holding file. -All holding files must be read with a blocksize of 32 KBytes. -.B Amrestore -should normally be able to determine the blocksize for tapes -on its own and not need this parameter. -.IP -The default is 32 KBytes. -.TP -.B \-f -Do a rewind followed by a fsf before trying to restore an image. -.TP -.B \-l +\fB\-l\fR +.RS 4 Check if we restoring from the tape with the right -.I label -.TP -.B \-p -Pipe output. -The first matching backup image is sent to standard output, -which is normally a pipe to -.B restore +\fIlabel\fR +.RE +.PP +\fB\-p\fR +.RS 4 +Pipe output\&. The first matching backup image is sent to standard output, which is normally a pipe to +\fBrestore\fR or -.BR tar , -then -.B amrestore -quits. -It may be run again to continue selecting backups to process. -Make sure you specify the no-rewind -.I tapedevice -when doing this. -.IP +\fBtar\fR, then +\fBamrestore\fR +quits\&. It may be run again to continue selecting backups to process\&. Make sure you specify the no\-rewind +\fItapedevice\fR +when doing this\&. +.RE +.PP Note: -.B restore -may report "short read" errors when reading from a pipe. -Most versions of -.B restore -support a blocking factor option to let you set the read block size, -and you should set it to 2. -See the example below. -.TP -.B \-c -Compress output using the fastest method the compression program provides. -.B Amrestore +\fBrestore\fR +may report "short read" errors when reading from a pipe\&. Most versions of +\fBrestore\fR +support a blocking factor option to let you set the read block size, and you should set it to 2\&. See the example below\&. +.PP +\fB\-c\fR +.RS 4 +Compress output using the fastest method the compression program provides\&. +\fBAmrestore\fR normally writes output files in a format understood by -.B restore +\fBrestore\fR or -.BR tar , -even if the backups on the tape are compressed. -With the -.B \-c +\fBtar\fR, even if the backups on the tape are compressed\&. With the +\fB\-c\fR or -.B \-C +\fB\-C\fR option, -.B amrestore -writes all files in compressed format, -even if the backups on the tape are not compressed. -Output file names will have a -.I .Z +\fBamrestore\fR +writes all files in compressed format, even if the backups on the tape are not compressed\&. Output file names will have a +\fB\&.Z\fR or -.I .gz +\fB\&.gz\fR extension depending on whether -.B compress +\fBcompress\fR or -.B gzip -is the preferred compression program. -This option is useful when the current directory disk is small. -.TP -.B \-C -Compress output using the best method the compression program provides -(may be very CPU intensive). -See the notes above about the -.B \-c -option. -.TP -.B \-r -Raw output. -Backup images are output exactly as they are on the tape, -including the -.B amdump -headers. -Output file names will have a -.I .RAW -extension. -This option is only useful for debugging and other strange circumstances. -.TP -.B \-h -Header output. -The tape header block is output at the beginning of each file. -This is like -.B \-r +\fBgzip\fR +is the preferred compression program\&. This option is useful when the current directory disk is small\&. +.RE +.PP +\fB\-C\fR +.RS 4 +Compress output using the best method the compression program provides (may be very CPU intensive)\&. See the notes above about the +\fB\-c\fR +option\&. +.RE +.PP +\fB\-r\fR +.RS 4 +Raw output\&. Backup images are output exactly as they are on the tape, including the +\fBamdump\fR +headers\&. Output file names will have a +\fB\&.RAW\fR +extension\&. This option is only useful for debugging and other strange circumstances\&. +.RE +.PP +\fB\-h\fR +.RS 4 +Header output\&. The tape header block is output at the beginning of each file\&. This is like +\fB\-r\fR except -.B \-c +\fB\-c\fR or -.B \-C -may also be used to compress the result. -.B Amrecover -uses the header to determine the restore program to use. -.LP -If a header is written (\-r or \-h), -only 32 KBytes are output regardless of the tape blocksize. -This makes the resulting image usable as a holding file. -.SH EXAMPLES +\fB\-C\fR +may also be used to compress the result\&. +\fBAmrecover\fR +uses the header to determine the restore program to use\&. +.RE +.PP +If a header is written (\-r or \-h), only 32 KBytes are output regardless of the tape blocksize\&. This makes the resulting image usable as a holding file\&. +.PP +\fB\-o\fR \fIconfigoption\fR +.RS 4 +See the "\fBCONFIGURATION OVERRIDE\fR" section in +\fBamanda\fR(8)\&. +.RE +.SH "EXAMPLES" +.PP The following does an interactive restore of disk -.I rz3g +\fIrz3g\fR from host -.IR seine , -to restore particular files. -Note the use of the -.B b +\fIseine\fR, to restore particular files\&. Note the use of the +\fBb\fR option to -.BR restore , -which causes it to read in units of two 512-byte blocks (1 Kbyte) -at a time. -This helps keep it from complaining about short reads. -.LP -.RS -.EX +\fBrestore\fR, which causes it to read in units of two 512\-byte blocks (1 Kbyte) at a time\&. This helps keep it from complaining about short reads\&. +.sp +.if n \{\ +.RS 4 +.\} +.nf % amrestore \-p /dev/nrmt9 seine rz3g | restore \-ivbf 2 \- -.EE +.fi +.if n \{\ .RE -.LP +.\} +.PP The next example extracts all backup images for host -.IR seine . -This is the usual way to extract all data for a host after a disk crash. -.LP -.RS -.EX +\fIseine\fR\&. This is the usual way to extract all data for a host after a disk crash\&. +.sp +.if n \{\ +.RS 4 +.\} +.nf % amrestore /dev/nrmt9 seine -.EE +.fi +.if n \{\ .RE -.LP +.\} +.PP If the backup datestamp in the above example is -.I 19910125 +19910125 and -.I seine +\fIseine\fR has level 0 backups of disks -.I rz1a +\fIrz1a\fR and -.I rz1g -on the tape, -these files will be created in the current directory: -.LP -.RS -.EX -seine.rz1a.19910125.0 -seine.rz1g.19910125.0 -.EE +\fIrz1g\fR +on the tape, these files will be created in the current directory: +.sp +.if n \{\ +.RS 4 +.\} +.nf +seine\&.rz1a\&.19910125\&.0 +seine\&.rz1g\&.19910125\&.0 +.fi +.if n \{\ .RE -.LP +.\} +.PP You may also use -.B amrestore -to extract a backup image from a holding disk -file that has not yet been flushed to tape: -.LP -.RS -.EX -% amrestore \-p /amanda/20001119/seine.rz1a.2 | restore \-ivbf 2 \- -.EE +\fBamrestore\fR +to extract a backup image from a holding disk file that has not yet been flushed to tape: +.sp +.if n \{\ +.RS 4 +.\} +.nf +% amrestore \-p /amanda/20001119/seine\&.rz1a\&.2 | restore \-ivbf 2 \- +.fi +.if n \{\ .RE -.LP -.B Amrestore +.\} +.PP +\fBAmrestore\fR may be used to generate a listing of images on a tape: -.LP -.RS -.EX -% mt -f /dev/nrmt9 rewind -% amrestore \-p /dev/nrmt9 no-such-host > /dev/null -.EE +.sp +.if n \{\ +.RS 4 +.\} +.nf +% mt \-f /dev/nrmt9 rewind +% amrestore \-p /dev/nrmt9 no\-such\-host > /dev/null +.fi +.if n \{\ .RE -.LP +.\} +.PP This asks -.B amrestore +\fBamrestore\fR to find images for host -.BR no-such-host . -It will not find any entries that match, but along the way will report -each image it skips. -.SH CAVEATS -.LP -GNU tar must be used to restore files from backup images created with -the GNUTAR dumptype. -Vendor tar programs sometimes fail to read GNU tar images. -.SH AUTHOR -James da Silva -.br -University of Maryland, College Park +\fBno\-such\-host\fR\&. It will not find any entries that match, but along the way will report each image it skips\&. +.SH "CAVEATS" +.PP +\fBGNU\-tar\fR +must be used to restore files from backup images created with the GNUTAR dumptype\&. Vendor tar programs sometimes fail to read GNU tar images\&. .SH "SEE ALSO" -amanda(8), -amdump(8), -amflush(8), -tar(1) -restore(8) +.PP +\fBamanda\fR(8), +\fBamdump\fR(8), +\fBamflush\fR(8), +\fBtar\fR(1), +\fBrestore\fR(8), +: http://wiki.zmanda.com +.SH "AUTHORS" +.PP +\fBJames da Silva\fR <\&jds@amanda\&.org\&> +.PP +\fBStefan G\&. Weichinger\fR <\&sgw@amanda\&.org\&>