-### !!! WARNING !!! !!! WARNING !!! !!! WARNING !!! !!! WARNING !!! ###
-### ###
-### This file is not meant to be installed "as is", and in fact, it ###
-### WILL NOT WORK! You must go through it and make changes appropriate ###
-### to your own situation. See the documentation in this file, in the ###
-### "man amanda" man page, in the "docs" directory and at the Amanda ###
-### web page (www.amanda.org). ###
-### ###
-### !!! WARNING !!! !!! WARNING !!! !!! WARNING !!! !!! WARNING !!! ###
+# amanda.conf - sample Amanda configuration file. See amanda.conf(5) for
+# details
-#
-# amanda.conf - sample Amanda configuration file. This started off life as
-# the actual config file in use at CS.UMD.EDU.
-#
-# If your configuration is called, say, "csd", then this file normally goes
-# in @CONFIG_DIR@/csd/amanda.conf.
-#
-
-org "@DEFAULT_CONFIG@" # your organization name for reports
-mailto "@CLIENT_LOGIN@" # space separated list of operators at your site
+org "@DEFAULT_CONFIG@" # your organization name for reports
+mailto "@CLIENT_LOGIN@" # space separated list of operators at your site
dumpuser "@CLIENT_LOGIN@" # the user to run dumps under
inparallel 4 # maximum dumpers that will run in parallel (max 63)
# B -> biggest bandwitdh
# try "BTBTBTBTBTBT" if you are not holding
# disk constrained
-netusage 600 Kbps # maximum net bandwidth for Amanda, in KB per sec
+
+taperalgo first # The algorithm used to choose which dump image to send
+ # to the taper.
+ # Possible values:
+ # [first|firstfit|largest|largestfit|smallest|last]
+ # Default: first.
+ # first First in - first out.
+ # firstfit The first dump image that will fit
+ # on the current tape.
+ # largest The largest dump image.
+ # largestfit The largest dump image that will fit
+ # on the current tape.
+ # smallest The smallest dump image.
+ # last Last in - first out.
+
+displayunit "k" # Possible values: "k|m|g|t"
+ # Default: k.
+ # The unit used to print many numbers.
+ # k=kilo, m=mega, g=giga, t=tera
+
+netusage 8000 Kbps # maximum net bandwidth for Amanda, in KB per sec
dumpcycle 4 weeks # the number of days in the normal dump cycle
runspercycle 20 # the number of amdump runs in dumpcycle days
# need amflush and so we do not overwrite the full
# backups performed at the beginning of the previous
# cycle
-### ### ###
-# WARNING: don't use `inf' for tapecycle, it's broken!
-### ### ###
bumpsize 20 Mb # minimum savings (threshold) to bump level 1 -> 2
+bumppercent 20 # minimum savings (threshold) to bump level 1 -> 2
bumpdays 1 # minimum days at each level
bumpmult 4 # threshold = bumpsize * bumpmult^(level-1)
etimeout 300 # number of seconds per filesystem for estimates.
-#etimeout -600 # total number of seconds for estimates.
-# a positive number will be multiplied by the number of filesystems on
-# each host; a negative number will be taken as an absolute total time-out.
-# The default is 5 minutes per filesystem.
-
dtimeout 1800 # number of idle seconds before a dump is aborted.
-
ctimeout 30 # maximum number of seconds that amcheck waits
# for each client host
-tapebufs 20
-# A positive integer telling taper how many 32k buffers to allocate.
-# WARNING! If this is set too high, taper will not be able to allocate
-# the memory and will die. The default is 20 (640k).
-
-
-# Specify tape device and/or tape changer. If you don't have a tape
-# changer, and you don't want to use more than one tape per run of
-# amdump, just comment out the definition of tpchanger.
-
-# Some tape changers require tapedev to be defined; others will use
-# their own tape device selection mechanism. Some use a separate tape
-# changer device (changerdev), others will simply ignore this
-# parameter. Some rely on a configuration file (changerfile) to
-# obtain more information about tape devices, number of slots, etc;
-# others just need to store some data in files, whose names will start
-# with changerfile. For more information about individual tape
-# changers, read docs/TAPE.CHANGERS.
-
-# At most one changerfile entry must be defined; select the most
-# appropriate one for your configuration. If you select man-changer,
-# keep the first one; if you decide not to use a tape changer, you may
-# comment them all out.
-
-runtapes 1 # number of tapes to be used in a single run of amdump
-tpchanger "chg-manual" # the tape-changer glue script
-tapedev "@DEFAULT_TAPE_DEVICE@" # the no-rewind tape device to be used
-rawtapedev "@DEFAULT_RAW_TAPE_DEVICE@" # the raw device to be used (ftape only)
-changerfile "/usr/adm/amanda/@DEFAULT_CONFIG@/changer"
-changerfile "/usr/adm/amanda/@DEFAULT_CONFIG@/changer-status"
-changerfile "@CONFIG_DIR@/@DEFAULT_CONFIG@/changer.conf"
-changerdev "@DEFAULT_CHANGER_DEVICE@"
+device_output_buffer_size 1280k
+ # amount of buffer space to use when writing to devices
+
+# By default, Amanda can only track at most one run per calendar day. When
+# the usetimestamps option is enabled, however, Amanda can track as many
+# runs as you care to make.
+# WARNING: This option is not backward-compatible. Do not enable it if you
+# intend to downgrade your server installation to Amanda community
+# edition 2.5
+usetimestamps yes
+
+# flush-threshold-dumped, flush-threshold-scheduled, taperflush, and autoflush
+# are used to control tape utilization. See the amanda.conf (5) manpage for
+# details on how they work. Taping will not start until all criteria are
+# satisfied. Here are some examples:
+#
+# You want to fill tapes completely even in the case of failed dumps, and
+# don't care if some dumps are left on the holding disk after a run:
+# flush-threshold-dumped 100 # (or more)
+# flush-threshold-scheduled 100 # (or more)
+# taperflush 100
+# autoflush yes
+#
+# You want to improve tape performance by waiting for a complete tape of data
+# before writing anything. However, all dumps will be flushed; none will
+# be left on the holding disk.
+# flush-threshold-dumped 100 # (or more)
+# flush-threshold-scheduled 100 # (or more)
+# taperflush 0
+#
+# You don't want to use a new tape for every run, but want to start writing
+# to tape as soon as possible:
+# flush-threshold-dumped 0 # (or more)
+# flush-threshold-scheduled 100 # (or more)
+# taperflush 100
+# autoflush yes
+# maxdumpsize 100k # amount of data to dump each run; see above.
+#
+# You want to keep the most recent dumps on holding disk, for faster recovery.
+# Older dumps will be rotated to tape during each run.
+# flush-threshold-dumped 300 # (or more)
+# flush-threshold-scheduled 300 # (or more)
+# taperflush 300
+# autoflush yes
+#
+# Defaults:
+# (no restrictions; flush to tape immediately; don't flush old dumps.)
+flush-threshold-dumped 0
+flush-threshold-scheduled 0
+taperflush 0
+autoflush no
+
+# Specify tape device or tape changer.
+
+runtapes 1 # number of tapes to be used in a single run of amdump
+tapedev "@EXAMPLE_TAPEDEV@" # tape changer or device to use
+
+# To use vtapes, create some slotN directories (slot0, slot1, etc.) under
+# /var/amanda/vtapes and use this tapedev:
+## tapedev "chg-disk:/var/amanda/vtapes"
+
+# To use a tape library, uncomment this definition. See amanda-changers(7)
+# for more configuration options.
+#
+# define changer myrobot {
+# tpchanger "chg-robot:/dev/sg0" # your changer device file
+# tapedev "tape:@EXAMPLE_TAPEDEV@" # your tape drive device file
+# }
+# tapedev "myrobot"
+
+# If you want Amanda to automatically label any non-Amanda tapes it
+# encounters, uncomment the line below. Note that this will ERASE any
+# non-Amanda tapes you may have, and may also ERASE any near-failing tapes.
+# Use with caution.
+## autolabel "@DEFAULT_CONFIG@-%%%" empty
maxdumpsize -1 # Maximum number of bytes the planner will schedule
# for a run (default: runtapes * tape_length).
tapetype HP-DAT # what kind of tape it is (see tapetypes below)
-labelstr "^@DEFAULT_CONFIG@[0-9][0-9]*$" # label constraint regex: all tapes must match
-
-amrecover_do_fsf yes # amrecover will call amrestore with the
- # -f flag for faster positioning of the tape.
-amrecover_check_label yes # amrecover will call amrestore with the
- # -l flag to check the label.
-amrecover_changer "@DEFAULT_TAPE_DEVICE@" # amrecover will use the changer if you restore
- # from this device.
- # It could be a string like 'changer' and
- # amrecover will use your changer if you
- # set your tape with 'settape changer'
+labelstr "^@DEFAULT_CONFIG@-[0-9][0-9]*$" # label constraint regex: all tapes must match
+
+amrecover_changer "changer" # amrecover will use the changer if you restore
+ # from this device. It could be a string like 'changer' and amrecover will use your
+ # changer if you set your tape to 'changer' with 'setdevice changer' or via
+ # 'tapedev "changer"' in amanda-client.conf
# Specify holding disks. These are used as a temporary staging area for
# dumps before they are written to tape and are recommended for most sites.
holdingdisk hd1 {
comment "main holding disk"
directory "/dumps/amanda" # where the holding disk is
- use 290 Mb # how much space can we use on it
- # a non-positive value means:
- # use all space but that value
+ use -100 Mb # how much space can we use on it
+ # a non-positive value means:
+ # use all space but that value
chunksize 1Gb # size of chunk if you want big dump to be
# dumped on multiple files on holding disks
# N Kb/Mb/Gb split images in chunks of size N
# This means save at least 30% of the holding disk space for degraded
# mode backups.
-autoflush no #
-# if autoflush is set to yes, then amdump will schedule all dump on
-# holding disks to be flush to tape during the run.
-
# The format for a ColumnSpec is a ',' seperated list of triples.
# Each triple consists of
# + the name of the column (as in ColumnNameStrings)
# Note that, although the keyword below is infofile, it is only so for
# historic reasons, since now it is supposed to be a directory (unless
# you have selected some database format other than the `text' default)
-infofile "/usr/adm/amanda/@DEFAULT_CONFIG@/curinfo" # database DIRECTORY
-logdir "/usr/adm/amanda/@DEFAULT_CONFIG@" # log directory
-indexdir "/usr/adm/amanda/@DEFAULT_CONFIG@/index" # index directory
-#tapelist "/usr/adm/amanda/@DEFAULT_CONFIG@/tapelist" # list of used tapes
+infofile "@CONFIG_DIR@/@DEFAULT_CONFIG@/curinfo" # database DIRECTORY
+logdir "@CONFIG_DIR@/@DEFAULT_CONFIG@" # log directory
+indexdir "@CONFIG_DIR@/@DEFAULT_CONFIG@/index" # index directory
+#tapelist "@CONFIG_DIR@/@DEFAULT_CONFIG@/tapelist" # list of used tapes
# tapelist is stored, by default, in the directory that contains amanda.conf
-
# tapetypes
# Define the type of tape you use here, and use it in "tapetype"
# are, and how fast the tape device is.
# A filemark is the amount of wasted space every time a tape section
-# ends. If you run `make tapetype' in tape-src, you'll get a program
-# that generates tapetype entries, but it is slow as hell, use it only
-# if you really must and, if you do, make sure you post the data to
-# the amanda mailing list, so that others can use what you found out
-# by searching the archives.
+# ends.
# For completeness Amanda should calculate the inter-record gaps too,
# but it doesn't. For EXABYTE and DAT tapes this is ok. Anyone using
# define tapetype EXB-8500 {
# ...
-# lbl-templ "/usr/local/amanda/config/lbl.exabyte.ps"
+# lbl-templ "@CONFIG_DIR@/config/lbl.exabyte.ps"
# }
+define tapetype global {
+ part_size 3G
+ part_cache_type none
+}
define tapetype QIC-60 {
+ global
comment "Archive Viper"
length 60 mbytes
filemark 100 kbytes # don't know a better value
}
define tapetype DEC-DLT2000 {
+ global
comment "DEC Differential Digital Linear Tape 2000"
length 15000 mbytes
filemark 8 kbytes
# goluboff@butch.Colorado.EDU
# in amanda-users (Thu Dec 26 01:55:38 MEZ 1996)
define tapetype DLT {
+ global
comment "DLT tape drives"
length 20000 mbytes # 20 Gig tapes
filemark 2000 kbytes # I don't know what this means
}
define tapetype SURESTORE-1200E {
+ global
comment "HP AutoLoader"
length 3900 mbytes
filemark 100 kbytes
}
define tapetype EXB-8500 {
+ global
comment "Exabyte EXB-8500 drive on decent machine"
length 4200 mbytes
filemark 48 kbytes
}
define tapetype EXB-8200 {
+ global
comment "Exabyte EXB-8200 drive on decent machine"
length 2200 mbytes
filemark 2130 kbytes
}
define tapetype HP-DAT {
+ global
comment "DAT tape drives"
# data provided by Rob Browning <rlb@cs.utexas.edu>
length 1930 mbytes
}
define tapetype DAT {
+ global
comment "DAT tape drives"
length 1000 mbytes # these numbers are not accurate
filemark 100 kbytes # but you get the idea
}
define tapetype MIMSY-MEGATAPE {
+ global
comment "Megatape (Exabyte based) drive through Emulex on Vax 8600"
length 2200 mbytes
filemark 2130 kbytes
speed 170 kbytes # limited by the Emulex bus interface, ugh
}
+define tapetype SEAGATE-ULTRIUM-LTO {
+ global
+ comment "SEAGATE ULTRIUM 06242 LTO, compression off"
+ length 99584 mbytes
+ filemark 0 kbytes
+ speed 11288 kps
+}
# dumptypes
#
# These are referred to by the disklist file. The dumptype specifies
# certain parameters for dumping including:
# auth - authentication scheme to use between server and client.
-# Valid values are "bsd" and "krb4". Default: [auth bsd]
+# Valid values are "bsd", "bsdudp", "bsdtcp", "krb5", "local",
+# "rsh" and "ssh".
+# Default: [auth "bsd"]
# comment - just a comment string
# comprate - set default compression rate. Should be followed by one or
# two numbers, optionally separated by a comma. The 1st is
# "client best" - compress on the client using the best (and
# probably slowest) algorithm.
# "client fast" - compress on the client using fast algorithm.
+# "client custom" - compress using your custom client compression program.
+# use client_custom_compress "PROG" to specify
+# the custom compression program.
+# PROG must not contain white space.
# "server best" - compress on the tape host using the best (and
# probably slowest) algorithm.
# "server fast" - compress on the tape host using a fast
# algorithm. This may be useful when a fast
# tape host is backing up slow clients.
+# "server custom" - compress using your server custom compression program.
+# use server_custom_compress "PROG" to specify
+# the custom compression program.
+# PROG must not contain white space.
# Default: [compress client fast]
# dumpcycle - set the number of days in the dump cycle, ie, set how often a
# full dump should be performed. Default: from DUMPCYCLE above
+# estimate Determine the way AMANDA does it's estimate.
+# "client" - Use the same program as the dumping program,
+# this is the most accurate way to do estimates,
+# but it can take a long time.
+# "calcsize" - Use a faster program to do estimates, but the
+# result is less accurate.
+# "server" - Use only statistics from the previous run to
+# give an estimate,
+# it takes only a few seconds but the result is not
+# accurate if your disk usage changes from day to day.
+# Default: [client]
+# encrypt - specify encryption of the backed up data. Valid values are:
+# "none" - don't encrypt the dump output.
+# "client" - encrypt on the client using the program specified by
+# client_encrypt "PROG".
+# Use client_decrypt_option to specify the decrypt-
+# parameter, default is "-d".
+# PROG and decrypt-parameter must not contain white space.
+# "server" - encrypt on the server using the program specified by
+# server_encrypt "PROG".
+# Use server_decrypt_option to specify the decrypt-
+# parameter, default is "-d".
+# PROG and decrypt-parameter must not contain white space.
+# Default: [none]
# exclude - specify files and directories to be excluded from the dump.
# Useful with gnutar only; silently ignored by dump and samba.
# Valid values are:
# going to be backed up.
# Default: include all files
# holdingdisk - should the holding disk be used for this dump. Useful for
-# dumping the holding disk itself. Default: [holdingdisk yes]
+# dumping the holding disk itself. Default: [holdingdisk auto]
+# "never" - Never use the holding disk.
+# "auto" - Use the holding disk if possible.
+# "required" - Always use the holding disk.
# ignore - do not back this filesystem up. Useful for sharing a single
# disklist in several configurations.
# index - keep an index of the files backed up. Default: [index no]
# mode", as many incrementals as will fit on the holding disk
# are done, higher priority first, to insure the important
# disks are at least dumped. Default: [priority medium]
-# program - specify the dump system to use. Valid values are "DUMP" and
-# "GNUTAR". Default: [program "DUMP"].
+# program - specify the dump system to use. Valid values are "DUMP",
+# or "GNUTAR". Default: [program "DUMP"].
# record - record the backup in the time-stamp-database of the backup
-# program (e.g. /etc/dumpdates for DUMP or
+# program (e.g. /var/lib/dumpdates for DUMP or
# @GNUTAR_LISTED_INCREMENTAL_DIRX@ for GNUTAR.).
# Default: [record yes]
# skip-full - skip the disk when a level 0 is due, to allow full backups
# prototype. Amanda then backs up just the
# changes.
# "noinc" - do level 0 dumps every time.
-# Unfortunately, this is not currently
-# implemented. Use `dumpcycle 0'
-# instead.
# "skip" - skip all dumps. Useful for sharing a single
# disklist in several configurations.
# "incronly" - do only incremental dumps. This is similar
# has been issued
# Default: [strategy standard]
#
-# Note that you may specify previously defined dumptypes as a shorthand way
-# of defining parameters.
+# Note that you may specify previously defined dumptypes as a shorthand way of
+# defining parameters.
define dumptype global {
comment "Global definitions"
# indexing, recording, etc. Some examples:
# index yes
# record no
+ # split_diskbuffer "/raid/amanda"
+ # fallback_splitsize 64m
}
define dumptype always-full {
dumpcycle 0
}
+# Dumptypes for gnutar
define dumptype root-tar {
global
program "GNUTAR"
comment "root partitions dumped with tar"
compress none
index
- exclude list "/usr/local/lib/amanda/exclude.gtar"
+# exclude list "@CONFIG_DIR@/exclude.gtar"
priority low
}
priority medium
}
+define dumptype user-tar-span {
+ root-tar
+ comment "tape-spanning user partitions dumped with tar"
+ priority medium
+}
+
define dumptype high-tar {
root-tar
comment "partitions dumped with tar"
compress client fast
}
+define dumptype comp-user-tar-span {
+ user-tar-span
+ compress client fast
+}
+
define dumptype holding-disk {
global
comment "The master-host holding disk itself"
- holdingdisk no # do not use the holding disk
+ holdingdisk never # do not use the holding disk
priority medium
}
priority medium
}
+define dumptype comp-user-span {
+ global
+ comment "Tape-spanning non-root partitions on reasonably fast machines"
+ compress client fast
+ priority medium
+}
+
define dumptype nocomp-user {
comp-user
comment "Non-root partitions on slow machines"
compress none
}
+define dumptype nocomp-user-span {
+ comp-user-span
+ comment "Tape-spanning non-root partitions on slow machines"
+ compress none
+}
+
define dumptype comp-root {
global
comment "Root partitions with compression"
define dumptype nocomp-test {
global
- comment "test dump without compression, no /etc/dumpdates recording"
+ comment "test dump without compression, no /var/lib/dumpdates recording"
compress none
record no
priority medium
define dumptype comp-test {
nocomp-test
- comment "test dump with compression, no /etc/dumpdates recording"
+ comment "test dump with compression, no /var/lib/dumpdates recording"
compress client fast
}
+define dumptype custom-compress {
+ global
+ program "GNUTAR"
+ comment "custom client compression dumped with tar"
+ compress client custom
+ client_custom_compress "/usr/bin/bzip2"
+}
+
+define dumptype server-encrypt-fast {
+ global
+ program "GNUTAR"
+ comment "fast client compression and server symmetric encryption"
+ compress client fast
+ encrypt server
+ server_encrypt "/usr/sbin/amcrypt"
+ server_decrypt_option "-d"
+}
+
+define dumptype client-encrypt-nocomp {
+ global
+ program "GNUTAR"
+ comment "no compression and client symmetric encryption"
+ compress none
+ encrypt client
+ client_encrypt "/usr/sbin/amcrypt"
+ client_decrypt_option "-d"
+}
+
+
+# To use gpg public-key encryption, gpg does compress with zlib by default.
+# Thus, no need to specify compress
+
+#define dumptype gpg-encrypt {
+# global
+# program "GNUTAR"
+# comment "server public-key encryption, dumped with tar"
+# compress none
+# encrypt server
+# server_encrypt "/usr/sbin/amgpgcrypt"
+# server_decrypt_option "-d"
+#}
+
+
# network interfaces
#
# These are referred to by the disklist file. They define the attributes
define interface local {
comment "a local disk"
- use 1000 kbps
+ use 8000 kbps
+}
+
+#define interface le0 {
+# comment "10 Mbps ethernet"
+# use 400 kbps
+#}
+
+#define application-tool and dumptype for the amgtar application
+define application-tool app_amgtar {
+ comment "amgtar"
+ plugin "amgtar"
+ #property "GNUTAR-PATH" "/path/to/gtar"
+ #property "GNUTAR-LISTDIR" "/path/to/gnutar_list_dir"
+ #default from gnutar_list_dir setting in amanda-client.conf
+}
+
+define dumptype dt_amgtar {
+ program "APPLICATION"
+ application "app_amgtar"
+}
+
+#define application-tool and dumptype for the amstar application
+define application-tool app_amstar {
+ comment "amstar"
+ plugin "amstar"
+ #property "STAR-PATH" "/path/to/star"
+ #property "STAR-TARDUMP" "/path/to/tardumps" # default /etc/tardumps
+ #property "STAR-DLE-TARDUMP" "no"
+ # if 'yes' then create a different tardump file for each DLE,
+ # it is required if you do many dump in parallel (maxdump>1)
+}
+
+define dumptype dt_amstar {
+ program "APPLICATION"
+ application "app_amstar"
}
-define interface le0 {
- comment "10 Mbps ethernet"
- use 400 kbps
+#define a script-tool to send an email
+define script-tool sc-email {
+ comment "script-email"
+ plugin "script-email"
+ execute_on pre-dle-amcheck, pre-host-amcheck, post-dle-amcheck, post-host-amcheck, pre-dle-estimate, pre-host-estimate, post-dle-estimate, post-host-estimate, pre-dle-backup, pre-host-backup, post-dle-backup, post-host-backup
+ execute_where server # or client
+ property "mailto" "martinea"
}
+#your dumptype must include: script "sc-email"
+#to use the script
# You may include other amanda configuration files, so you can share
# dumptypes, tapetypes and interface definitions among several
# configurations.
-#includefile "/usr/local/amanda.conf.main"
+#includefile "@CONFIG_DIR@/amanda.conf.main"