amanda.conf

Langue: en

Version: 183757 (CentOS - 06/07/09)

Section: 5 (Format de fichier)

NAME

amanda.conf - Main configuration file for Amanda, the Advanced Maryland Automatic Network Disk Archiver

DESCRIPTION

amanda.conf is the main configuration file for Amanda. This manpage lists the relevant sections and parameters of this file for quick reference.

PARAMETERS

There are a number of configuration parameters that control the behavior of the Amanda programs. All have default values, so you need not specify the parameter in amanda.conf if the default is suitable.

Lines starting with # are ignored, as are blank lines. Comments may be placed on a line with a directive by starting the comment with a #. The remainder of the line is ignored.

Keywords are case insensitive, i.e. mailto and MailTo are treated the same.

Integer arguments may have one of the following (case insensitive) suffixes, some of which have a multiplier effect:

POSSIBLE SUFFIXES

b byte bytes
Some number of bytes.
bps
Some number of bytes per second.
k kb kbyte kbytes kilobyte kilobytes
Some number of kilobytes (bytes*1024).
kps kbps
Some number of kilobytes per second (bytes*1024).
m mb meg mbyte mbytes megabyte megabytes
Some number of megabytes (bytes*1024*1024).
mps mbps
Some number of megabytes per second (bytes*1024*1024).
g gb gbyte gbytes gigabyte gigabytes
Some number of gigabytes (bytes*1024*1024*1024).
tape tapes
Some number of tapes.
day days
Some number of days.
week weeks
Some number of weeks (days*7).


Note The value inf may be used in most places where an integer is expected to mean an infinite amount.

Boolean arguments may have any of the values y, yes, t, true or on to indicate a true state, or n, no, f, false or off to indicate a false state. If no argument is given, true is assumed.

PARAMETERS

org string
Default: daily. A descriptive name for the configuration. This string appears in the Subject line of mail reports. Each Amanda configuration should have a different string to keep mail reports distinct.
mailto string
Default: operators. A space separated list of recipients for mail reports.
dumpcycle int
Default: 10 days. The number of days in the backup cycle. Each disk will get a full backup at least this often. Setting this to zero tries to do a full backup each run.


Note This parameter may also be set in a specific dumptype (see below). This value sets the default for all dumptypes so must appear in amanda.conf before any dumptypes are defined..TP runspercycle int Default: same as dumpcycle. The number of amdump runs in dumpcycle days. A value of 0 means the same value as dumpcycle. A value of -1 means guess the number of runs from the tapelist file, which is the number of tapes used in the last dumpcycle days / runtapes.

tapecycle int
Default: 15 tapes. Typically tapes are used by Amanda in an ordered rotation. The tapecycle parameter defines the size of that rotation. The number of tapes in rotation must be larger than the number of tapes required for a complete dump cycle (see the dumpcycle parameter).

This is calculated by multiplying the number of amdump runs per dump cycle (runspercycle parameter) times the number of tapes used per run (runtapes parameter). Typically two to four times this calculated number of tapes are in rotation. While Amanda is always willing to use a new tape in its rotation, it refuses to reuse a tape until at least 'tapecycle -1' number of other tapes have been used.

It is considered good administrative practice to set the tapecycle parameter slightly lower than the actual number of tapes in rotation. This allows the administrator to more easily cope with damaged or misplaced tapes or schedule adjustments that call for slight adjustments in the rotation order.

label_new_tapes string
Default: not set. When set, this directive will cause Amanda to automatically write an Amanda tape label to any blank tape she encounters. This option is DANGEROUS because when set, Amanda will ERASE any non-Amanda tapes you may have, and may also ERASE any near-failing tapes. Use with caution.

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: label_new_tapes "DailySet1-%%%"

label_new_tapes string

=======
  Default: not set. When set, this directive will cause Amanda to automatically write an Amanda tape label to any black tape she encounters. This option is DANGEROUS because when set, Amanda will ERASE any non-Amanda tapes you may have, and may also ERASE any near-failing tapes. Use with caution.

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: label_new_tapes "DailySet1-%%%"

dumpuser string
Default: amanda. The login name Amanda uses to run the backups. The backup client hosts must allow access from the tape server host as this user via or