'\" t
.\" Title: amanda.conf
.\" Author: James da Silva <jds@amanda.org>
-.\" Generator: DocBook XSL Stylesheets vsnapshot_8273 <http://docbook.sf.net/>
-.\" Date: 10/18/2010
+.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
+.\" Date: 02/21/2012
.\" Manual: File formats and conventions
-.\" Source: Amanda 3.2.0
+.\" Source: Amanda 3.3.1
.\" Language: English
.\"
-.TH "AMANDA\&.CONF" "5" "10/18/2010" "Amanda 3\&.2\&.0" "File formats and conventions"
+.TH "AMANDA\&.CONF" "5" "02/21/2012" "Amanda 3\&.3\&.1" "File formats and conventions"
+.\" -----------------------------------------------------------------
+.\" * 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
.\" -----------------------------------------------------------------
\fBmailto\fR
and
\fBMailTo\fR
-are treated the same\&. Also, the characters \'\fB\-\fR\' and \'\fB_\fR\' are interchangeable in all predefined Amanda keywords:
+are treated the same\&. Also, the characters \*(Aq\fB\-\fR\*(Aq and \*(Aq\fB_\fR\*(Aq are interchangeable in all predefined Amanda keywords:
\fBdevice_property\fR
and
\fBdevice\-property\fR
have the same meaning\&. This manpage uses the dashed versions, but the underscored versions will be accepted for backward compatibility
.PP
-Identifiers are names which are defined in the configuration itself, such as dumptypes or interfaces\&. Identifiers are are case\-insensitive, but sensitive to \'\fB\-\fR\' vs\&. \'\fB_\fR\'\&. Identifiers should be quoted in the configuration file, although For historical reasons, the quotes are optional\&.
+Identifiers are names which are defined in the configuration itself, such as dumptypes or interfaces\&. Identifiers are are case\-insensitive, but sensitive to \*(Aq\fB\-\fR\*(Aq vs\&. \*(Aq\fB_\fR\*(Aq\&. Identifiers should be quoted in the configuration file, although For historical reasons, the quotes are optional\&.
.PP
Strings are always quoted with double quotes ("), and any double quotes or backslashes within the string are escaped with a backslash:
.sp
Examples:
.sp
.nf
-finserver "/data/finance/XYZ Corp\'s \e"real\e" finances" finance\-high eth0 \-1
+finserver "/data/finance/XYZ Corp\*(Aqs \e"real\e" finances" finance\-high eth0 \-1
property "syspath" "C:\e\eWINDOWS\e\eSYSTEM"
.fi
.SS "SUBSECTIONS AND INHERITANCE"
}
define dumptype nocomp {
- global # inherit the parameters in dumptype \'global\'
+ global # inherit the parameters in dumptype \*(Aqglobal\*(Aq
compress none
}
.fi
filemark 32k
}
.fi
-In this example, \'child\' will have a filemark of 32k, a speed of 400bps, and a length of 200M\&.
+In this example, \*(Aqchild\*(Aq will have a filemark of 32k, a speed of 400bps, and a length of 200M\&.
.SH "GLOBAL PARAMETERS"
.PP
\fBorg\fR \fIstring\fR
.PP
\fBmailer\fR \fIstring\fR
.RS 4
-Default found by configure\&. A mail program that can send mail with \'\fIMAILER \-s "subject" user < message_file\fR\'\&.
+Default found by configure\&. A mail program that can send mail with \*(Aq\fIMAILER \-s "subject" user < message_file\fR\*(Aq\&.
.RE
.PP
\fBmailto\fR \fIstring\fR
.RE
.RE
.PP
+\fBmax\-dle\-by\-volume\fR \fIint\fR
+.RS 4
+Default:
+\fI1000000000\fR\&. The maximum number of dle written to a single volume\&.
+.RE
+.PP
\fBdumpcycle\fR \fIint\fR
.RS 4
Default:
\fBtapecycle\fR \fIint\fR
.RS 4
Default:
-\fI15 tapes\fR\&. Specifies the number of "active" volumes \- volumes that Amanda will not overwrite\&. While Amanda is always willing to write to a new volume, it refuses to overwrite a volume unless at least \'\fBtapecycle\fR
-\-1\' volumes have been written since\&.
+\fI15 tapes\fR\&. Specifies the number of "active" volumes \- volumes that Amanda will not overwrite\&. While Amanda is always willing to write to a new volume, it refuses to overwrite a volume unless at least \*(Aq\fBtapecycle\fR
+\-1\*(Aq volumes have been written since\&.
.sp
It is considered good administrative practice to set the
\fBtapecycle\fR
\fBusetimestamps\fR \fIbool\fR
.RS 4
Default:
-\fBYes\fR\&. This option allows Amanda to track multiple runs per calendar day\&. The only reason one might disable it is that Amanda versions before 2\&.5\&.1 can\'t read logfiles written when this option was enabled\&.
+\fBYes\fR\&. This option allows Amanda to track multiple runs per calendar day\&. The only reason one might disable it is that Amanda versions before 2\&.5\&.1 can\*(Aqt read logfiles written when this option was enabled\&.
.RE
.PP
\fBlabel\-new\-tapes\fR \fIstring\fR
.RS 4
Default: not set\&. When set, this directive will cause Amanda to automatically write an Amanda tape label to most volume she encounters\&. This option is DANGEROUS because when set, Amanda may erase near\-failing tapes or tapes accidentally loaded in the wrong slot\&.
.sp
-When using this directive, specify the template for new tape labels\&. The template should contain some number of contiguous \'%\' characters, which will be replaced with a generated number\&. Be sure to specify enough \'%\' characters that you do not run out of tape labels\&. Example:
-\fBautolabel "DailySet1\-%%%" empty\fR
+When using this directive, specify the template for new tape labels\&. The template can contains many variables that are substituted by their values:
+.sp
+.nf
+ $c : config name
+ $o : org configuration
+ $b : barcode of the volume
+ $s : slot number, can specify a minimun number of digit:
+ $3s to get \*(Aq001\*(Aq
+ $m : meta label
+.fi
+.sp
+The template can contain some number of contiguous \*(Aq%\*(Aq characters, which will be replaced with a generated number\&. Be sure to specify enough \*(Aq%\*(Aq characters that you do not run out of tape labels\&. Example:
+\fB"DailySet1\-%%%"\fR,
+\fB"$c\-%%%"\fR,
+\fB"$m\-%%%"\fR,
+\fB"$m\-$b"\fR
+.sp
+The generared label can be used only if it match the
+\fBlabelstr\fR
+setting\&. The volume will not be used if the generated label doesn\*(Aqt match the
+\fBlabelstr\fR
+setting\&.
.sp
Note that many devices cannot distinguish an empty tape from an error condition, so it may is often necessary to include
\fBvolume\-error\fR
.PP
\fBany\fR
.RS 4
-equivalent to \'\fBother\-config non\-amanda volume\-error empty\fR\'
+equivalent to \*(Aq\fBother\-config non\-amanda volume\-error empty\fR\*(Aq
.RE
.PP
\fBother\-config\fR
.RE
.RE
.PP
+\fBmeta\-autolabel\fR \fIstring\fR
+.RS 4
+Default: not set\&. When set and if the changer support meta\-label, this directive will cause Amanda to automatically add a meta\-label to a meta\-volume\&.
+.sp
+A meta\-volume is a containers that contains many volumes, eg\&. a removable hard\-disk for use with chg\-disk, each hard disk have many slots (volume)\&. The meta\-label is the label to put on the meta\-volume\&.
+.sp
+When using this directive, specify the template for new meta labels\&. The template can contains many variables that are substituted by their values:
+.sp
+.nf
+ $c : config name
+ $o : org configuration
+.fi
+.sp
+The template should contain some number of contiguous \*(Aq%\*(Aq characters, which will be replaced with a generated number\&. Be sure to specify enough \*(Aq%\*(Aq characters that you do not run out of meta labels\&. Example:
+\fB"DailySet1\-%%%"\fR,
+\fB"$o\-%%%"\fR,
+.RE
+.PP
\fBdumpuser\fR \fIstring\fR
.RS 4
Default:
for more information on configuring changers\&.
.RE
.PP
+\fBinteractivity\fR \fIstring\fR
+.RS 4
+Default: not set\&. The interactivity module Amanda should use to interact with the user\&. See
+\fBamanda-interactivity\fR(7)
+for a list of modules\&.
+.RE
+.PP
+\fBtaperscan\fR \fIstring\fR
+.RS 4
+Default: traditional\&. The taperscan module amanda should use to find a tape to write to\&. See
+\fBamanda-taperscan\fR(7)
+for a list of modules\&.
+.RE
+.PP
\fBchangerdev\fR \fIstring\fR
.RS 4
Default:
.PP
\fBtaper\-parallel\-write\fR \fIint\fR
.RS 4
-.PP
Default:
\fI1\fR\&. Amanda can write simultaneously up to that number of volume at any given time\&. The changer must have as many drives\&.
.RE
.PP
+\fBeject\-volume\fR \fIint\fR
+.RS 4
+Default:
+\fIno\fR\&. Set to
+\fByes\fR
+if you want the volume to be ejected after Amanda wrote data to it\&. It works only with some changer and device\&.
+.RE
+.PP
\fBlabelstr\fR \fIstring\fR
.RS 4
Default:
\fI"\&.*"\fR\&. The tape label constraint regular expression\&. All tape labels generated (see
-\fBamlabel\fR(8)) and used by this configuration must match the regular expression\&. If multiple configurations are run from the same tape server host, it is helpful to set their labels to different strings (for example, "DAILY[0\-9][0\-9]*" vs\&. "ARCHIVE[0\-9][0\-9]*") to avoid overwriting each other\'s tapes\&.
+\fBamlabel\fR(8)) and used by this configuration must match the regular expression\&. If multiple configurations are run from the same tape server host, it is helpful to set their labels to different strings (for example, "DAILY[0\-9][0\-9]*" vs\&. "ARCHIVE[0\-9][0\-9]*") to avoid overwriting each other\*(Aqs tapes\&.
.RE
.PP
\fBtapetype\fR \fIstring\fR
\fBplanner\fR
step of
\fBamdump\fR
-will wait to get the dump size estimates (note: Amanda runs up to 3 estimates for each DLE)\&. For instance, with the default of 300 seconds and four DLE\'s, each estimating level 0 and level 1 on client A,
+will wait to get the dump size estimates (note: Amanda runs up to 3 estimates for each DLE)\&. For instance, with the default of 300 seconds and four DLE\*(Aqs, each estimating level 0 and level 1 on client A,
\fBplanner\fR
will wait up to 40 minutes for that machine\&. A negative value will be interpreted as a total amount of time to wait per client instead of per disk\&.
.RE
\fBreq\-tries\fR \fIint\fR
.RS 4
Default:
-\fI3\fR\&. How many times the server will resend a REQ packet if it doesn\'t get the ACK packet\&.
+\fI3\fR\&. How many times the server will resend a REQ packet if it doesn\*(Aqt get the ACK packet\&.
.RE
.PP
\fBnetusage\fR \fIint\fR
.RS 4
Default:
-\fI8000 Kbps\fR\&. The maximum network bandwidth allocated to Amanda, in Kbytes per second\&. See also the
+\fI80000 Kbps\fR\&. The maximum network bandwidth allocated to Amanda, in Kbytes per second\&. See also the
\fBinterface\fR
section\&.
.RE
\fBinparallel\fR \fIint\fR
.RS 4
Default:
-\fI10\fR\&. The maximum number of backups that Amanda will attempt to run in parallel\&. Amanda will stay within the constraints of network bandwidth and holding disk space available, so it doesn\'t hurt to set this number a bit high\&. Some contention can occur with larger numbers of backups, but this effect is relatively small on most systems\&.
+\fI10\fR\&. The maximum number of backups that Amanda will attempt to run in parallel\&. Amanda will stay within the constraints of network bandwidth and holding disk space available, so it doesn\*(Aqt hurt to set this number a bit high\&. Some contention can occur with larger numbers of backups, but this effect is relatively small on most systems\&.
.RE
.PP
\fBdisplayunit\fR "k|m|g|t"
\fI100\fR\&. The part of holding\-disk space that should be reserved for incremental backups if no tape is available, expressed as a percentage of the available holding\-disk space (0\-100)\&. By default, when there is no tape to write to, degraded mode (incremental) backups will be performed to the holding disk\&. If full backups should also be allowed in this case, the amount of holding disk space reserved for incrementals should be lowered\&.
.RE
.PP
-\fBautoflush\fR \fIbool\fR
+\fBautoflush\fR \fBno\fR|\fByes\fR|\fBall\fR
.RS 4
Default:
-\fBoff\fR\&. Whether an amdump run will flush the dumps from holding disk to tape\&.
+\fBno\fR\&. Whether an amdump run will flush the dumps from holding disk to tape\&. With
+\fByes\fR, only dump matching the command line argument are flushed\&. With
+\fBall\fR, all dump are flushed\&.
.RE
.PP
\fBamrecover\-do\-fsf\fR \fIbool\fR
.PP
\fBamrecover\-changer\fR \fIstring\fR
.RS 4
-Default: not set\&. Amrecover will use the changer if you use \'settape <string>\' and that string is the same as the
+Default: not set\&. Amrecover will use the changer if you use \*(Aqsettape <string>\*(Aq and that string is the same as the
\fBamrecover\-changer\fR
setting\&.
.RE
\fBamreport\fR
should use\&.
\fIString\fR
-is a comma (\',\') separated list of triples\&. Each triple consists of three parts which are separated by a equal sign (\'=\') and a colon (\':\') (see the example)\&. These four parts specify:
+is a comma (\*(Aq,\*(Aq) separated list of triples\&. Each triple consists of three parts which are separated by a equal sign (\*(Aq=\*(Aq) and a colon (\*(Aq:\*(Aq) (see the example)\&. These four parts specify:
.sp
.RS 4
.ie n \{\
\fI0\fR\&. Debug level of the taper process
.RE
.PP
+\fBdebug\-recovery\fR \fIint\fR
+.RS 4
+Default:
+\fI1\fR\&. Debug level of all recovery process
+.RE
+.PP
\fBflush\-threshold\-dumped\fR \fIint\fR
.RS 4
Default:
\fBflush\-threshold\-scheduled\fR
parameter\&.;
\fBautoflush\fR
-must be set to \'yes\' if
+must be set to \*(Aqyes\*(Aq if
\fBtaperflush\fR
is greater than 0\&.
.RE
\fI1024,65535\fR\&. Unreserved tcp port that will be used (bsd, bsdudp)\&. Range is inclusive\&.
.RE
.PP
-\fBrecovery\-limit\fR [ \fIstring\fR | \fBsame\-host\fR ]
+\fBrecovery\-limit\fR [ \fIstring\fR | \fBsame\-host\fR | \fBserver\fR]
.RS 4
-Default: none (no limitations)\&. This parameter limits the hosts that may do remote recoveries\&. Hosts are identified by their authenticated peer name, as described in
+Default: none (no limitations)\&. This parameter limits the hosts that may do recoveries\&. Hosts are identified by their authenticated peer name, as described in
\fBamanda-auth\fR(7); if this is not available and the recovery\-limit parameter is present, recovery will be denied\&. The arguments to the parameter are strings giving host match expressions (see
-\fBamanda-match\fR(7)) or the special keyword same\-host, which requires an exact match to the hostname of the DLE being recovered\&. Specifying no arguments at all will disable all recoveries from any host\&.
+\fBamanda-match\fR(7)) or the special keywords
+\fBsame\-host\fR
+or
+\fBserver\fR\&. The
+\fBsame\-host\fR
+keyword requires an exact match to the hostname of the DLE being recovered\&. The
+\fBserver\fR
+keyword require the connection come from the fqdn of the server\&. Specifying no arguments at all will disable all recoveries from any host\&.
.sp
Note that match expressions can be constructed to be forgiving of e\&.g\&., fully\-qualified vs\&. unqualified hostnames, but
\fBsame\-host\fR
\fBauth\fR \fIstring\fR
.RS 4
Default:
-\fI"bsd"\fR\&. Type of authorization to perform between tape server and backup client hosts\&. See
+\fI"bsdtcp"\fR\&. Type of authorization to perform between tape server and backup client hosts\&. See
\fBamanda-auth\fR(7)
for more detail\&.
.RE
.PP
server
.RS 4
-Use only statistics from the previous few runs to give an estimate\&. This very quick, but the result is not accurate if your disk usage changes from day to day\&. If this method is specified, but the server does not have enough data to make an estimate, then the option is internally moved to the end of the list, thereby preferring \'client\' or \'calcsize\' in this case\&.
+Use only statistics from the previous few runs to give an estimate\&. This very quick, but the result is not accurate if your disk usage changes from day to day\&. If this method is specified, but the server does not have enough data to make an estimate, then the option is internally moved to the end of the list, thereby preferring \*(Aqclient\*(Aq or \*(Aqcalcsize\*(Aq in this case\&.
.RE
.RE
.PP
\fIstring\fR
is a file name on the client containing
\fBGNU\-tar\fR
-exclude expressions\&. The path to the specified exclude list file, if present (see description of \'optional\' below), must be readable by the Amanda user\&.
+exclude expressions\&. The path to the specified exclude list file, if present (see description of \*(Aqoptional\*(Aq below), must be readable by the Amanda user\&.
.sp
All exclude expressions are concatenated in one file and passed to the application as an
\fB\-\-exclude\-from\fR
\fBoptional\fR
is specified for
\fBexclude\fR
-\fBlist\fR, then amcheck will not complain if the file doesn\'t exist or is not readable\&.
+\fBlist\fR, then amcheck will not complain if the file doesn\*(Aqt exist or is not readable\&.
.sp
For
\fBexclude\fR
.PP
\fBauto\fR|yes|true|on
.RS 4
-Use the holding disk, unless there is a problem with the holding disk, the dump won\'t fit there or the medium doesn\'t require spooling (e\&.g\&., VFS device)
+Use the holding disk, unless there is a problem with the holding disk, the dump won\*(Aqt fit there or the medium doesn\*(Aqt require spooling (e\&.g\&., VFS device)
.RE
.PP
\fBrequired\fR
.RS 4
-Always dump to holdingdisk, never directly to tape\&. There will be no dump if it doesn\'t fit on holdingdisk
+Always dump to holdingdisk, never directly to tape\&. There will be no dump if it doesn\*(Aqt fit on holdingdisk
.RE
.RE
.PP
If
\fBoptional\fR
is specified for
-\fBinclude list\fR, then amcheck will not complain if the file doesn\'t exist or is not readable\&.
+\fBinclude list\fR, then amcheck will not complain if the file doesn\*(Aqt exist or is not readable\&.
.sp
For
\fBinclude list\fR, If the file name is relative, the disk name being backed up is prepended\&.
\fBmaxpromoteday\fR \fIint\fR
.RS 4
Default:
-\fI10000\fR\&. The maximum number of day for a promotion, set it 0 if you don\'t want promotion, set it to 1 or 2 if your disks get overpromoted\&.
+\fI10000\fR\&. The maximum number of day for a promotion, set it 0 if you don\*(Aqt want promotion, set it to 1 or 2 if your disks get overpromoted\&.
.RE
.PP
\fBpriority\fR [ \fBlow\fR | \fBmedium\fR | \fBhigh\fR ]
.PP
\fBskip\fR
.RS 4
-Treat this DLE as if it doesn\'t exist (useful to disable DLEs when sharing the
+Treat this DLE as if it doesn\*(Aqt exist (useful to disable DLEs when sharing the
\fIdisklist\fR
file between multiple configurations)\&. Skipped DLEs will not be checked or dumped, and will not be matched by disklist expressions\&.
.RE
is specified, or when it is too small or does not exist, and thus the maximum amount of memory consumed for in\-memory splitting\&. The default unit is Kbytes if it is not specified\&.
.RE
.PP
-\fBrecovery\-limit\fR [ \fBsame\-host\fR | \fIstring\fR ]*
+\fBrecovery\-limit\fR [ \fBserver\fR | \fBsame\-host\fR | \fIstring\fR ]*
.RS 4
Default: global value\&. This parameter overrides the global
\fBrecovery\-limit\fR
parameter for DLEs of this dumptype\&.
.RE
.PP
+\fBdump\-limit\fR [ \fBserver\fR | \fBsame\-host\fR ]*
+.RS 4
+Default:
+\fBserver\fR\&. Specify which host can initiate a backup of the dle\&. With
+\fBserver\fR, the server can initiate a backup with the
+\fBamdump\fR
+command\&. With
+\fBsame\-host\fR, the client can initiate a backup with the
+\fBamdump_client\fR
+command\&.
+.RE
+.PP
The following
\fBdumptype\fR
entries are predefined by Amanda:
compress server fast
}
define dumptype "bsd\-auth" {
- auth bsd
+ auth "bsd"
+}
+define dumptype "bsdtcp\-auth" {
+ auth "bsdtcp"
}
define dumptype "no\-record" {
record no
.RS 4
Default:
\fI32 kytes\fR
-How much data will be read in each tape record\&. This can be used to override a device\'s block size for reads only\&. This may be useful, for example, in reading a tape written with a 256k block size when Amanda is configured to use 128k blocks\&. This unusual feature is not supported by all operating systems and tape devices\&.
+How much data will be read in each tape record\&. This can be used to override a device\*(Aqs block size for reads only\&. This may be useful, for example, in reading a tape written with a 256k block size when Amanda is configured to use 128k blocks\&. This unusual feature is not supported by all operating systems and tape devices\&.
.sp
The default unit is Kbytes if it is not specified\&.
.RE
\fBuse\fR \fIint\fR
.RS 4
Default:
-\fI8000 Kbps\fR\&. The speed of the interface in Kbytes per second\&.
+\fI80000 Kbps\fR\&. The speed of the interface in Kbytes per second\&.
.RE
.PP
In addition to options, another
.PP
The application options and values are:
.PP
+\fBclient\-name\fR \fIstring\fR
+.RS 4
+No default, specifies an application name that is in the amanda\-client\&.conf on the client\&. The setting from that application will be merged with the current application\&. If
+\fBclient\-name\fR
+is set then it is an error if that application is not defined on the client\&.
+.sp
+If
+\fBclient\-name\fR
+is not set then the merge is done with the application that have the name equal to the plugin\&. eg\&. if the plugin is \*(Aqamgtar\*(Aq, then the setting from the application \*(Aqamgtar\*(Aq is used if it is defined\&.
+.RE
+.PP
\fBcomment\fR \fIstring\fR
.RS 4
Default: not set\&. A comment string describing this application\&.
.PP
The script options and values are:
.PP
+\fBclient\-name\fR \fIstring\fR
+.RS 4
+No default, specifies a script name that is in the amanda\-client\&.conf on the client\&. The setting from that script will be merged with the currect script\&. If
+\fBclient\-name\fR
+is set then it is an error if that script is not defined on the client\&.
+.sp
+If
+\fBclient\-name\fR
+is not set then the merge is done with the script that have the name equal to the plugin\&. eg\&. if the plugin is \*(Aqamlog\-script\*(Aq, then the setting from the script \*(Aqamlog\-script\*(Aq is used\&.
+.RE
+.PP
\fBcomment\fR \fIstring\fR
.RS 4
Default: not set\&. A comment string describing this script\&.
\fI5000\fR\&. Scripts are executed in that order, it is useful if you have many scripts and they must be executed in a spefific order\&.
.RE
.PP
+\fBsingle\-execution\fR \fIboolean\fR
+.RS 4
+Default:
+\fIno\fR\&. The script is executed for each dle\&. If
+\fIyes\fR, the script is executed one time only\&.
+.RE
+.PP
\fBexecute\-where\fR [ \fBclient\fR | \fBserver\fR ]
.RS 4
Default:
.RS 4
No default\&. When the script must be executed, you can specify many of them:
.PP
+\fBpre\-amcheck\fR
+.RS 4
+Execute before the amcheck command for all dle\&. Can only be run on server\&.
+.RE
+.PP
\fBpre\-dle\-amcheck\fR
.RS 4
Execute before the amcheck command for the dle\&.
Execute before the amcheck command for all dle for the client\&.
.RE
.PP
+\fBpost\-amcheck\fR
+.RS 4
+Execute after the amcheck command for all dle\&. Can only be run on server\&.
+.RE
+.PP
\fBpost\-dle\-amcheck\fR
.RS 4
Execute after the amcheck command for the dle\&.
Execute after the amcheck command for all dle for the client\&.
.RE
.PP
+\fBpre\-estimate\fR
+.RS 4
+Execute before the estimate command for all dle\&. Can only be run on server\&.
+.RE
+.PP
\fBpre\-dle\-estimate\fR
.RS 4
Execute before the estimate command for the dle\&.
Execute before the estimate command for all dle for the client\&.
.RE
.PP
+\fBpost\-estimate\fR
+.RS 4
+Execute after the estimate command for all dle\&. Can only be run on server\&.
+.RE
+.PP
\fBpost\-dle\-estimate\fR
.RS 4
Execute after the estimate command for the dle\&.
Execute after the estimate command for all dle for the client\&.
.RE
.PP
+\fBpre\-backup\fR
+.RS 4
+Execute before the backup command for all dle\&. Can only be run on server\&.
+.RE
+.PP
\fBpre\-dle\-backup\fR
.RS 4
Execute before the backup command for the dle\&.
.PP
\fBpre\-host\-backup\fR
.RS 4
-Execute before the backup command for all dle for the client\&. It can\'t be run on client, it must be run on server
+Execute before the backup command for all dle for the client\&. It can\*(Aqt be run on client, it must be run on server
+.RE
+.PP
+\fBpost\-backup\fR
+.RS 4
+Execute after the backup command for all dle\&. Can only be run on server\&.
.RE
.PP
\fBpost\-dle\-backup\fR
.PP
\fBpost\-host\-backup\fR
.RS 4
-Execute after the backup command for all dle for the client\&. It can\'t be run on client, it must be run on server
+Execute after the backup command for all dle for the client\&. It can\*(Aqt be run on client, it must be run on server
.RE
.PP
\fBpre\-recover\fR
specifies the device name to use; see
\fBamanda-devices\fR(7)\&. As with most sections, the
\fIcomment\fR
-parmeter is optional and only for the user\'s convenience\&.
+parmeter is optional and only for the user\*(Aqs convenience\&.
.PP
An arbitrary number of
\fIdevice\-property\fR
See
\fBamanda-changers\fR(7)
for more information on configuring changers\&.
+.SH "INTERACTIVITY SECTION"
+.PP
+The
+\fBamanda\&.conf\fR
+file may define multiple interactivyt methods, although only one will be used \- that specified by the
+\fBinteractivity\fR
+parameter\&. The information is entered in a
+\fBinteractivity\fR
+section, which looks like this:
+.nf
+define interactivity \fIname\fR {
+ \fIinteractivity\-option\fR \fIinteractivity\-value\fR
+ \&.\&.\&.
+}
+.fi
+.PP
+The { must appear at the end of a line, and the } on its own line\&.
+.PP
+\fIname\fR
+is the user\-specified name of this interactivity\&. The remaining parameters are specific to the interactivity type selected\&.
+.PP
+The interactivity options and values are:
+.PP
+\fBcomment\fR \fIstring\fR
+.RS 4
+Default: not set\&. A comment string describing this interactivity\&.
+.RE
+.PP
+\fBplugin\fR \fIstring\fR
+.RS 4
+No default\&. Must be set to the name of the interactivity module, as described in
+\fBamanda-interactivity\fR(7)\&.
+.RE
+.PP
+\fBproperty\fR [\fBappend\fR] \fIstring\fR \fIstring\fR+
+.RS 4
+No default\&. You can set arbitrary properties for the interactivity\&. Each interactivity module has a different set of properties\&. The first string contains the name of the property to set, and the others contains its values\&. All strings should be quoted\&. The
+\fBappend\fR
+keyword appends the given values to an existing list of values for that property\&.
+.RE
+.PP
+See
+\fBamanda-interactivity\fR(7)
+for more information on configuring interactivity methods\&.
+.SH "TAPERSCAN SECTION"
+.PP
+The
+\fBamanda\&.conf\fR
+file may define multiple taperscan methods, although only one will be used \- that specified by the
+\fBtaperscan\fR
+parameter\&. The information is entered in a
+\fBtaperscan\fR
+section, which looks like this:
+.nf
+define taperscan \fIname\fR {
+ \fItaperscan\-option\fR \fItaperscan\-value\fR
+ \&.\&.\&.
+}
+.fi
+.PP
+The { must appear at the end of a line, and the } on its own line\&.
+.PP
+\fIname\fR
+is the user\-specified name of this taperscan\&. The remaining parameters are specific to the taperscan type selected\&.
+.PP
+The taperscan options and values are:
+.PP
+\fBcomment\fR \fIstring\fR
+.RS 4
+Default: not set\&. A comment string describing this taperscan\&.
+.RE
+.PP
+\fBplugin\fR \fIstring\fR
+.RS 4
+No default\&. Must be set to the name of the taperscan module\&. See
+<man></man>
+for a list of defined taperscan modules\&.
+.RE
+.PP
+\fBproperty\fR [\fBappend\fR] \fIstring\fR \fIstring\fR+
+.RS 4
+No default\&. Operates just like properties for interactivity methods, above\&.
+.RE
+.PP
+See
+\fBamanda-taperscan\fR(7)
+for more information on configuring taperscan\&.
.SH "DUMP SPLITTING CONFIGURATION"
.PP
Amanda can "split" dumps into parts while writing them to storage media\&. This allows Amanda to recover gracefully from a failure while writing a part to a volume, by simply selecting a new volume and re\-writing the dump from the beginning of the failed part\&. Parts also allow Amanda to seek directly to the required data, although this functionality is not yet used\&.
\fBamanda-auth\fR(7),
\fBamanda-changers\fR(7),
\fBamanda-devices\fR(7),
-\fBamanda-scripts\fR(7)
+\fBamanda-interactivity\fR(7),
+\fBamanda-scripts\fR(7),
+\fBamanda-taperscan\fR(7)
.PP
The Amanda Wiki:
: http://wiki.zmanda.com/
projects / debian / amanda / blobdiff