X-Git-Url: https://git.gag.com/?a=blobdiff_plain;f=man%2Famvault.8;h=2d23cc6f0ec71c7fdecdcce0a63a06a53b43be6c;hb=HEAD;hp=682928f71d740f0d8c950acb419aeabf5a5ba446;hpb=79cdc4b6ea8848b21ba4a0e7d2fd3bc401e0bebe;p=debian%2Famanda diff --git a/man/amvault.8 b/man/amvault.8 index 682928f..2d23cc6 100644 --- a/man/amvault.8 +++ b/man/amvault.8 @@ -1,13 +1,22 @@ '\" t .\" Title: amvault .\" Author: Dustin J. Mitchell -.\" 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 "AMVAULT" "8" "04/10/2009" "Amanda 2\&.6\&.1p1" "System Administration Commands" +.TH "AMVAULT" "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,33 +28,82 @@ .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- .SH "NAME" -amvault \- Copy \fIAmanda\fR dumps from one volume to another +amvault \- Copy Amanda dumps from one volume to another .SH "SYNOPSIS" .HP \w'\fBamvault\fR\ 'u -\fBamvault\fR [\-o\ \fIconfigoption\fR]... \fIconfig\fR \fIsrc\-run\-timestamp\fR \fIdst\-changer\fR \fIlabel\-template\fR +\fBamvault\fR [\fB\-o\fR\ \fIconfigoption\fR...] [\-\-dry\-run | \-n] [\-\-quiet | \-q] [\-\-fulls\-only] [\-\-exact\-match] [\-\-export] [\fB\-\-src\-timestamp\fR\ \fIsrc\-timestamp\fR] +.br +\fB\-\-label\-template\fR\ \fIlabel\-template\fR \fB\-\-dst\-changer\fR\ \fIdst\-changer\fR [\fB\-\-autolabel\fR\ \fIautolabel\-arg\fR...] +.br +\fIconfig\fR [\fIhostname\fR\ [\ \fIdisk\fR\ [\ \fIdate\fR\ [\ \fIlevel\fR\ [\ \fIhostname\fR\ [\&.\&.\&.]\ ]\ ]\ ]\ ]] .SH "WARNING" .PP This application is not yet in its final form, and is subject to major revision in subsequent versions of Amanda\&. Backward compatibility is not guaranteed\&. .PP -The significant limitations of this version of amvault are: tapetypes for secondary and tertiary volumes much match (including length and device_properties); tertiary volumes must be blank (manual erasure is required to re\-use tertiary media; restore/recover operations will request tertiary media by label when dumpfiles are not found on secondary media, but there is no provision to automatically fetch such media from a different changer; and all dumpfiles on a secondary volume are moved to tertiary media \- there is no provision to filter dumps\&. +Note that Amanda restore/recover operations will request tertiary media by label when dumpfiles are not found on secondary media, but there is no provision to automatically fetch such media from a different changer .PP Feedback on and patches to this application are invited and encouraged! .SH "DESCRIPTION" .PP +Amvault is conceptually equivalent to "amfetchdump | taper"\&. That is, it reads specified dumps from secondary media and re\-writes them on tertiary media\&. +.PP \fBAmvault\fR Copies data from the run with timestamp -\fIsrc\-run\-timestamp\fR +\fBsrc\-timestamp\fR onto volumes using the changer -\fIdst\-changer\fR, labeling new volumes with -\fIlabel\-template\fR\&. If -\fIsrc\-run\-timestamp\fR -is "latest", then the most recent amdump or amflush run will be used\&. +\fBdst\-changer\fR, and labeling new volumes with +\fBlabel\-template\fR\&. +.SS "Secondary Media" +.PP +The dumps to be read from secondary media can be specified by any combination of dump specifications, +\fB\-\-fulls\-only\fR, and +\fB\-\-src\-timestamp\fR\&. At least one must be specified, lest amvault attempt to vault all dumps in the catalog\&. See +\fBamanda-match\fR(7) +for more information on dump specifications\&. .PP -In a vaulting operation, the source media is referred to as "secondary media", while the destination is referred to as "tertiary media"\&. +Note that the datestamp given in the dumpspec is the +\fIdump\fR +datestamp \- the run in which the backup was taken on the Amanda client\&. The +\fB\-\-src\-timestamp\fR, on the other hand, is the +\fIwrite\fR +timestamp \- the run in which the dump was written to secondary media\&. The latter option facilitates duplicating the results of an entire backup run, including any dumps that might have been flushed from holding disk\&. +.SS "Tertiary Media" .PP -Each source volume will be copied to a new destination volume; no re\-assembly or splitting will be performed\&. Destination volumes must be at least as large as the source volumes\&. +The +\fB\-\-dst\-changer\fR +must be specified, and names the changer in which tertiary media are stored\&. .PP -The changer parameter should specify the name of a changer defined in +If +\fBamanda.conf\fR(5) +contains the new +\fBpart\-size\fR +splitting parameters, then amvault will use them without any additional configuration\&. However, if the configuration still uses the old splitting parameters (\fBtape_splitsize\fR, +\fBsplit_diskbuffer\fR, and +\fBfallback_splitsize\fR), then amvault will need some additional configuration in order to properly split dumps to tertiary media\&. To do so, specify a new tapetype in +\fBamanda.conf\fR(5), say "TERTIARY", and set the +\fBpart\-size\fR +and other appropriate parameters there\&. Then reference that tapetype in the amvault invocation: +.sp +.nf + amvault \-otapetype=TERTIARY \&.\&.\&. +.fi +.SH "OPTIONS" +.PP +\fB\-\-autolabel\fR [any] [other\-config] [non\-amanda] [volume\-error] [empty] +.RS 4 +Works just like the +\fBautolabel\fR +parameter in +\fBamanda.conf\fR(5), and can be specified multiple times if necessary\&. The default is \*(Aqempty\*(Aq\&. +.RE +.PP +\fB\-\-dst\-changer\fR \fIdst\-changer\fR +.RS 4 +Specifies the changer in which tertiary media are stored\&. In general, this should be different from the secondary changer, to eliminate the possibility of overwriting secondary media with tertiary data\&. +.sp +The +\fBdst\-changer\fR +parameter should specify the name of a changer defined in \fBamanda.conf\fR(5)\&. For example: .sp .nf @@ -56,14 +114,72 @@ define changer vaulting_tape { changerfile "vaulting\-changer\&.conf" } .fi +.RE .PP -The label template functions identically to the -\fIlabel\-new\-tapes\fR -parameter in -\fBamanda.conf\fR(5)\&. +\fB\-\-dry\-run\fR, \fB\-n\fR +.RS 4 +Cause amvault to print the dumps it would vault, but not actually perform any vaulting operations\&. +.RE +.PP +\fB\-\-exact\-match\fR +.RS 4 +The host and disk are parsed as exact values +.RE +.PP +\fB\-\-export\fR +.RS 4 +Cause amvault to attempt to move completed tertiary volumes to import/export slots, where they can be more easily removed by an operator\&. +.RE +.PP +\fB\-\-\-fulls\-only\fR +.RS 4 +Only full (level\-0) dumps are copied\&. +.RE +.PP +\fB\-\-label\-template\fR \fIlabel\-template\fR +.RS 4 +Specifies a label template which is used to generate new labels for tertiary volumes\&. +.RE +.PP +\fB\-\-quiet\fR, \fB\-q\fR +.RS 4 +Eliminate non\-error messages, and is useful when running amvault from cron\&. +.RE +.PP +\fB\-\-src\-timestamps\fR \fIsrc\-timestamps\fR +.RS 4 +Specifies the timestamps in the format \*(AqYYYYMMDDHHMMSS\*(Aq of the run to vault, can be "latest", then the most recent amdump or amflush run will be used\&. +.RE +.PP +\fB\-o\fR \fIconfigoption\fR +.RS 4 +See the "\fBCONFIGURATION OVERRIDE\fR" section in +\fBamanda\fR(8)\&. +.RE +.SH "EXAMPLES" +.PP +Vault all dump written to tape in the latest amdump or amflush run: +.nf +$ amvault \-\-src\-timestamps latest \-\-label\-template "CONF\-%%%" \-\-dst\-changer vault\-changer CONF +.fi +.PP +Vault all dump written on the run of December 7 2011 12:13:14 : +.nf +$ amvault \-\-src\-timestamps 20111207121314 \-\-label\-template "CONF\-%%%" \-\-dst\-changer vault\-changer CONF +.fi +.PP +Vault all dump dumped on any run of December 7 2011: +.nf +$ amvault \-\-label\-template "CONF\-%%%" \-\-dst\-changer vault\-changer CONF \e* \e* 20111207 +.fi .SH "SEE ALSO" .PP -\fBamanda\fR(8) +\fBamanda\fR(8), +\fBamanda-changers\fR(7), +\fBamfetchdump\fR(8) +.PP +The Amanda Wiki: +: http://wiki.zmanda.com/ .SH "AUTHOR" .PP \fBDustin J\&. Mitchell\fR <\&dustin@zmanda\&.com\&>