Blame example/amanda.conf.in

Packit Service 392537
# amanda.conf - sample Amanda configuration file. See amanda.conf(5) for 
Packit Service 392537
# details
Packit Service 392537
Packit Service 392537
org 	 "@DEFAULT_CONFIG@"	# your organization name for reports
Packit Service 392537
mailto 	 "@CLIENT_LOGIN@"	# space separated list of operators at your site
Packit Service 392537
dumpuser "@CLIENT_LOGIN@"	# the user to run dumps under
Packit Service 392537
Packit Service 392537
inparallel 4		# maximum dumpers that will run in parallel
Packit Service 392537
dumporder "sssS"	# specify the priority order of each dumper
Packit Service 392537
			#   s -> smallest size
Packit Service 392537
			#   S -> biggest size
Packit Service 392537
			#   t -> smallest time
Packit Service 392537
			#   T -> biggest time
Packit Service 392537
			#   b -> smallest bandwitdh
Packit Service 392537
			#   B -> biggest bandwitdh
Packit Service 392537
			# try "BTBTBTBTBTBT" if you are not holding
Packit Service 392537
			# disk constrained
Packit Service 392537
Packit Service 392537
taperalgo first		# The algorithm used to choose which dump image to send
Packit Service 392537
			# to the taper.
Packit Service 392537
			# Possible values: 
Packit Service 392537
		        # [first|firstfit|largest|largestfit|smallest|last]
Packit Service 392537
			# Default: first. 
Packit Service 392537
			# first		First in - first out.
Packit Service 392537
			# firstfit 	The first dump image that will fit 
Packit Service 392537
                        #               on the current tape.
Packit Service 392537
			# largest 	The largest dump image.
Packit Service 392537
			# largestfit 	The largest dump image that will fit 
Packit Service 392537
                        #               on the current tape.
Packit Service 392537
			# smallest 	The smallest dump image.
Packit Service 392537
			# last 		Last in - first out.
Packit Service 392537
Packit Service 392537
displayunit "k"		# Possible values: "k|m|g|t"
Packit Service 392537
			# Default: k. 
Packit Service 392537
			# The unit used to print many numbers.
Packit Service 392537
			# k=kilo, m=mega, g=giga, t=tera
Packit Service 392537
			
Packit Service 392537
netusage  8000 Kbps	# maximum net bandwidth for Amanda, in KB per sec
Packit Service 392537
Packit Service 392537
dumpcycle 4 weeks	# the number of days in the normal dump cycle
Packit Service 392537
runspercycle 20         # the number of amdump runs in dumpcycle days
Packit Service 392537
			# (4 weeks * 5 amdump runs per week -- just weekdays)
Packit Service 392537
tapecycle 25 tapes	# the number of tapes in rotation
Packit Service 392537
			# 4 weeks (dumpcycle) times 5 tapes per week (just
Packit Service 392537
			# the weekdays) plus a few to handle errors that
Packit Service 392537
			# need amflush and so we do not overwrite the full
Packit Service 392537
			# backups performed at the beginning of the previous
Packit Service 392537
			# cycle
Packit Service 392537
Packit Service 392537
bumpsize 20 Mb		# minimum savings (threshold) to bump level 1 -> 2
Packit Service 392537
bumppercent 20		# minimum savings (threshold) to bump level 1 -> 2
Packit Service 392537
bumpdays 1		# minimum days at each level
Packit Service 392537
bumpmult 4		# threshold = bumpsize * bumpmult^(level-1)
Packit Service 392537
Packit Service 392537
etimeout 300		# number of seconds per filesystem for estimates.
Packit Service 392537
dtimeout 1800		# number of idle seconds before a dump is aborted.
Packit Service 392537
ctimeout 30		# maximum number of seconds that amcheck waits
Packit Service 392537
			# for each client host
Packit Service 392537
 
Packit Service 392537
device_output_buffer_size 1280k
Packit Service 392537
                        # amount of buffer space to use when writing to devices
Packit Service 392537
Packit Service 392537
# flush-threshold-dumped, flush-threshold-scheduled, taperflush, and autoflush
Packit Service 392537
# are used to control tape utilization. See the amanda.conf (5) manpage for
Packit Service 392537
# details on how they work. Taping will not start until all criteria are
Packit Service 392537
# satisfied. Here are some examples:
Packit Service 392537
#
Packit Service 392537
# You want to fill tapes completely even in the case of failed dumps, and
Packit Service 392537
# don't care if some dumps are left on the holding disk after a run:
Packit Service 392537
# flush-threshold-dumped	100 # (or more)
Packit Service 392537
# flush-threshold-scheduled	100 # (or more)
Packit Service 392537
# taperflush			100
Packit Service 392537
# autoflush			yes
Packit Service 392537
#
Packit Service 392537
# You want to improve tape performance by waiting for a complete tape of data
Packit Service 392537
# before writing anything. However, all dumps will be flushed; none will
Packit Service 392537
# be left on the holding disk.
Packit Service 392537
# flush-threshold-dumped	100 # (or more)
Packit Service 392537
# flush-threshold-scheduled	100 # (or more)
Packit Service 392537
# taperflush	0
Packit Service 392537
#
Packit Service 392537
# You don't want to use a new tape for every run, but want to start writing
Packit Service 392537
# to tape as soon as possible:
Packit Service 392537
# flush-threshold-dumped	0   # (or more)
Packit Service 392537
# flush-threshold-scheduled	100 # (or more)
Packit Service 392537
# taperflush	100
Packit Service 392537
# autoflush     yes
Packit Service 392537
# maxdumpsize   100k # amount of data to dump each run; see above.
Packit Service 392537
#
Packit Service 392537
# You want to keep the most recent dumps on holding disk, for faster recovery.
Packit Service 392537
# Older dumps will be rotated to tape during each run.
Packit Service 392537
# flush-threshold-dumped	300 # (or more)
Packit Service 392537
# flush-threshold-scheduled	300 # (or more)
Packit Service 392537
# taperflush	300
Packit Service 392537
# autoflush     yes
Packit Service 392537
#
Packit Service 392537
# Defaults:
Packit Service 392537
# (no restrictions; flush to tape immediately; don't flush old dumps.)
Packit Service 392537
flush-threshold-dumped 0
Packit Service 392537
flush-threshold-scheduled 0
Packit Service 392537
taperflush 0
Packit Service 392537
autoflush no
Packit Service 392537
Packit Service 392537
# Specify tape device or tape changer.
Packit Service 392537
Packit Service 392537
runtapes 1			# number of tapes to be used in a single run of amdump
Packit Service 392537
tapedev "@EXAMPLE_TAPEDEV@"	# tape changer or device to use
Packit Service 392537
Packit Service 392537
# To use vtapes, create some slotN directories (slot0, slot1, etc.) under
Packit Service 392537
# /var/amanda/vtapes and use this tapedev:
Packit Service 392537
## tapedev "chg-disk:/var/amanda/vtapes"
Packit Service 392537
Packit Service 392537
# To use a tape library, uncomment this definition.  See amanda-changers(7)
Packit Service 392537
# for more configuration options.
Packit Service 392537
#
Packit Service 392537
# define changer myrobot {
Packit Service 392537
#   tpchanger "chg-robot:/dev/sg0"  # your changer device file
Packit Service 392537
#   tapedev "tape:@EXAMPLE_TAPEDEV@"	# your tape drive device file
Packit Service 392537
# }
Packit Service 392537
# tapedev "myrobot"
Packit Service 392537
Packit Service 392537
# If you want Amanda to automatically label any non-Amanda tapes it
Packit Service 392537
# encounters, uncomment the line below. Note that this will ERASE any
Packit Service 392537
# non-Amanda tapes you may have, and may also ERASE any near-failing tapes.
Packit Service 392537
# Use with caution.
Packit Service 392537
## autolabel "@DEFAULT_CONFIG@-%%%" empty
Packit Service 392537
Packit Service 392537
maxdumpsize -1		# Maximum number of bytes the planner will schedule
Packit Service 392537
			# for a run (default: runtapes * tape_length).
Packit Service 392537
tapetype HP-DAT		# what kind of tape it is (see tapetypes below)
Packit Service 392537
labelstr "^@DEFAULT_CONFIG@-[0-9][0-9]*$"	# label constraint regex: all tapes must match
Packit Service 392537
Packit Service 392537
amrecover_changer "changer"	# amrecover will use the changer if you restore
Packit Service 392537
    # from this device. It could be a string like 'changer' and amrecover will use your
Packit Service 392537
    # changer if you set your tape to 'changer' with 'setdevice changer' or via 
Packit Service 392537
    # 'tapedev "changer"' in amanda-client.conf
Packit Service 392537
Packit Service 392537
# Specify holding disks.  These are used as a temporary staging area for
Packit Service 392537
# dumps before they are written to tape and are recommended for most sites.
Packit Service 392537
# The advantages include: tape drive is more likely to operate in streaming
Packit Service 392537
# mode (which reduces tape and drive wear, reduces total dump time); multiple
Packit Service 392537
# dumps can be done in parallel (which can dramatically reduce total dump time.
Packit Service 392537
# The main disadvantage is that dumps on the holding disk need to be flushed
Packit Service 392537
# (with amflush) to tape after an operating system crash or a tape failure.
Packit Service 392537
# If no holding disks are specified then all dumps will be written directly
Packit Service 392537
# to tape.  If a dump is too big to fit on the holding disk than it will be
Packit Service 392537
# written directly to tape.  If more than one holding disk is specified then
Packit Service 392537
# they will all be used based on activity and available space.
Packit Service 392537
Packit Service 392537
holdingdisk hd1 {
Packit Service 392537
    comment "main holding disk"
Packit Service 392537
    directory "/dumps/amanda"	# where the holding disk is
Packit Service 392537
    use -100 Mb			# how much space can we use on it
Packit Service 392537
				# a non-positive value means:
Packit Service 392537
				# use all space but that value
Packit Service 392537
    chunksize 1Gb 	# size of chunk if you want big dump to be
Packit Service 392537
			# dumped on multiple files on holding disks
Packit Service 392537
			#  N Kb/Mb/Gb split images in chunks of size N
Packit Service 392537
			#	      The maximum value should be
Packit Service 392537
			#	      (MAX_FILE_SIZE - 1Mb)
Packit Service 392537
			#  0          same as INT_MAX bytes
Packit Service 392537
    }
Packit Service 392537
#holdingdisk hd2 {
Packit Service 392537
#    directory "/dumps2/amanda"
Packit Service 392537
#    use 1000 Mb
Packit Service 392537
#    }
Packit Service 392537
#holdingdisk hd3 {
Packit Service 392537
#    directory "/mnt/disk4"
Packit Service 392537
#    use 1000 Mb
Packit Service 392537
#    }
Packit Service 392537
Packit Service 392537
Packit Service 392537
# If amanda cannot find a tape on which to store backups, it will run
Packit Service 392537
# as many backups as it can to the holding disks.  In order to save
Packit Service 392537
# space for unattended backups, by default, amanda will only perform
Packit Service 392537
# incremental backups in this case, i.e., it will reserve 100% of the
Packit Service 392537
# holding disk space for the so-called degraded mode backups.
Packit Service 392537
# However, if you specify a different value for the `reserve'
Packit Service 392537
# parameter, amanda will not degrade backups if they will fit in the
Packit Service 392537
# non-reserved portion of the holding disk.
Packit Service 392537
Packit Service 392537
# reserve 30 # percent
Packit Service 392537
# This means save at least 30% of the holding disk space for degraded
Packit Service 392537
# mode backups.  
Packit Service 392537
Packit Service 392537
# The format for a ColumnSpec is a ',' seperated list of triples.
Packit Service 392537
# Each triple consists of
Packit Service 392537
#   + the name of the column (as in ColumnNameStrings)
Packit Service 392537
#   + prefix before the column
Packit Service 392537
#   + the width of the column, if set to -1 it will be recalculated
Packit Service 392537
#     to the maximum length of a line to print.
Packit Service 392537
# Example:
Packit Service 392537
# 	"Disk=1:17,HostName=1:10,OutKB=1:7"
Packit Service 392537
# or
Packit Service 392537
# 	"Disk=1:-1,HostName=1:10,OutKB=1:7"
Packit Service 392537
#        
Packit Service 392537
# You need only specify those colums that should be changed from
Packit Service 392537
# the default. If nothing is specified in the configfile, the
Packit Service 392537
# above compiled in values will be in effect, resulting in an
Packit Service 392537
# output as it was all the time.
Packit Service 392537
# The names of the colums are:
Packit Service 392537
# HostName, Disk, Level, OrigKB, OutKB, Compress, DumpTime, DumpRate,
Packit Service 392537
# TapeTime and TapeRate.
Packit Service 392537
#							ElB, 1999-02-24.
Packit Service 392537
# columnspec "Disk=1:18,HostName=0:10,OutKB=1:7"
Packit Service 392537
Packit Service 392537
Packit Service 392537
# Amanda needs a few Mb of diskspace for the log and debug files,
Packit Service 392537
# as well as a database.  This stuff can grow large, so the conf directory
Packit Service 392537
# isn't usually appropriate.  Some sites use /usr/local/var and some /usr/adm.
Packit Service 392537
# Create an amanda directory under there.  You need a separate infofile and
Packit Service 392537
# logdir for each configuration, so create subdirectories for each conf and
Packit Service 392537
# put the files there.  Specify the locations below.
Packit Service 392537
Packit Service 392537
# Note that, although the keyword below is infofile, it is only so for
Packit Service 392537
# historic reasons, since now it is supposed to be a directory (unless
Packit Service 392537
# you have selected some database format other than the `text' default)
Packit Service 392537
infofile "@CONFIG_DIR@/@DEFAULT_CONFIG@/curinfo"	# database DIRECTORY
Packit Service 392537
logdir   "@CONFIG_DIR@/@DEFAULT_CONFIG@"		# log directory
Packit Service 392537
indexdir "@CONFIG_DIR@/@DEFAULT_CONFIG@/index"		# index directory
Packit Service 392537
#tapelist "@CONFIG_DIR@/@DEFAULT_CONFIG@/tapelist"	# list of used tapes
Packit Service 392537
# tapelist is stored, by default, in the directory that contains amanda.conf
Packit Service 392537
Packit Service 392537
# tapetypes
Packit Service 392537
Packit Service 392537
# Define the type of tape you use here, and use it in "tapetype"
Packit Service 392537
# above.  Some typical types of tapes are included here.  The tapetype
Packit Service 392537
# tells amanda how many MB will fit on the tape, how big the filemarks
Packit Service 392537
# are, and how fast the tape device is.
Packit Service 392537
Packit Service 392537
# A filemark is the amount of wasted space every time a tape section
Packit Service 392537
# ends.
Packit Service 392537
Packit Service 392537
# For completeness Amanda should calculate the inter-record gaps too,
Packit Service 392537
# but it doesn't.  For EXABYTE and DAT tapes this is ok.  Anyone using
Packit Service 392537
# 9 tracks for amanda and need IRG calculations?  Drop me a note if
Packit Service 392537
# so.
Packit Service 392537
Packit Service 392537
# If you want amanda to print postscript paper tape labels
Packit Service 392537
# add a line after the comment in the tapetype of the form
Packit Service 392537
#    lbl-templ "/path/to/postscript/template/label.ps"
Packit Service 392537
Packit Service 392537
# if you want the label to go to a printer other than the default
Packit Service 392537
# for your system, you can also add a line above for a different
Packit Service 392537
# printer. (i usually add that line after the dumpuser specification)
Packit Service 392537
Packit Service 392537
# dumpuser "operator"     # the user to run dumps under
Packit Service 392537
# printer "mypostscript"  # printer to print paper label on
Packit Service 392537
Packit Service 392537
# here is an example of my definition for an EXB-8500
Packit Service 392537
Packit Service 392537
# define tapetype EXB-8500 {
Packit Service 392537
# ...
Packit Service 392537
#     lbl-templ "@CONFIG_DIR@/config/lbl.exabyte.ps"
Packit Service 392537
# }
Packit Service 392537
Packit Service 392537
define tapetype global {
Packit Service 392537
    part_size 3G
Packit Service 392537
    part_cache_type none
Packit Service 392537
}
Packit Service 392537
Packit Service 392537
define tapetype QIC-60 {
Packit Service 392537
    global
Packit Service 392537
    comment "Archive Viper"
Packit Service 392537
    length 60 mbytes
Packit Service 392537
    filemark 100 kbytes		# don't know a better value
Packit Service 392537
    speed 100 kbytes		# dito
Packit Service 392537
}
Packit Service 392537
Packit Service 392537
define tapetype DEC-DLT2000 {
Packit Service 392537
    global
Packit Service 392537
    comment "DEC Differential Digital Linear Tape 2000"
Packit Service 392537
    length 15000 mbytes
Packit Service 392537
    filemark 8 kbytes
Packit Service 392537
    speed 1250 kbytes
Packit Service 392537
}
Packit Service 392537
Packit Service 392537
# goluboff@butch.Colorado.EDU
Packit Service 392537
# in amanda-users (Thu Dec 26 01:55:38 MEZ 1996)
Packit Service 392537
define tapetype DLT {
Packit Service 392537
    global
Packit Service 392537
    comment "DLT tape drives"
Packit Service 392537
    length 20000 mbytes		# 20 Gig tapes
Packit Service 392537
    filemark 2000 kbytes	# I don't know what this means
Packit Service 392537
    speed 1536 kbytes		# 1.5 Mb/s
Packit Service 392537
}
Packit Service 392537
Packit Service 392537
define tapetype SURESTORE-1200E {
Packit Service 392537
    global
Packit Service 392537
    comment "HP AutoLoader"
Packit Service 392537
    length 3900 mbytes
Packit Service 392537
    filemark 100 kbytes
Packit Service 392537
    speed 500 kbytes
Packit Service 392537
}
Packit Service 392537
Packit Service 392537
define tapetype EXB-8500 {
Packit Service 392537
    global
Packit Service 392537
    comment "Exabyte EXB-8500 drive on decent machine"
Packit Service 392537
    length 4200 mbytes
Packit Service 392537
    filemark 48 kbytes
Packit Service 392537
    speed 474 kbytes			
Packit Service 392537
}
Packit Service 392537
Packit Service 392537
define tapetype EXB-8200 {
Packit Service 392537
    global
Packit Service 392537
    comment "Exabyte EXB-8200 drive on decent machine"
Packit Service 392537
    length 2200 mbytes
Packit Service 392537
    filemark 2130 kbytes
Packit Service 392537
    speed 240 kbytes			
Packit Service 392537
}
Packit Service 392537
Packit Service 392537
define tapetype HP-DAT {
Packit Service 392537
    global
Packit Service 392537
    comment "DAT tape drives"
Packit Service 392537
    # data provided by Rob Browning <rlb@cs.utexas.edu>
Packit Service 392537
    length 1930 mbytes
Packit Service 392537
    filemark 111 kbytes
Packit Service 392537
    speed 468 kbytes
Packit Service 392537
}
Packit Service 392537
Packit Service 392537
define tapetype DAT {
Packit Service 392537
    global
Packit Service 392537
    comment "DAT tape drives"
Packit Service 392537
    length 1000 mbytes		# these numbers are not accurate
Packit Service 392537
    filemark 100 kbytes		# but you get the idea
Packit Service 392537
    speed 100 kbytes
Packit Service 392537
}
Packit Service 392537
Packit Service 392537
define tapetype MIMSY-MEGATAPE {
Packit Service 392537
    global
Packit Service 392537
    comment "Megatape (Exabyte based) drive through Emulex on Vax 8600"
Packit Service 392537
    length 2200 mbytes
Packit Service 392537
    filemark 2130 kbytes
Packit Service 392537
    speed 170 kbytes		# limited by the Emulex bus interface, ugh
Packit Service 392537
}
Packit Service 392537
Packit Service 392537
define tapetype SEAGATE-ULTRIUM-LTO {
Packit Service 392537
    global
Packit Service 392537
    comment "SEAGATE ULTRIUM 06242 LTO, compression off"
Packit Service 392537
    length 99584 mbytes
Packit Service 392537
    filemark 0 kbytes
Packit Service 392537
    speed 11288 kps
Packit Service 392537
}
Packit Service 392537
Packit Service 392537
# dumptypes
Packit Service 392537
#
Packit Service 392537
# These are referred to by the disklist file.  The dumptype specifies
Packit Service 392537
# certain parameters for dumping including:
Packit Service 392537
#   auth	- authentication scheme to use between server and client.
Packit Service 392537
#		  Valid values are "bsd", "bsdudp", "bsdtcp", "krb5", "local",
Packit Service 392537
#		  "rsh" and "ssh".  
Packit Service 392537
#		  Default: [auth "bsdtcp"]
Packit Service 392537
#   comment	- just a comment string
Packit Service 392537
#   comprate	- set default compression rate.  Should be followed by one or
Packit Service 392537
#		  two numbers, optionally separated by a comma.  The 1st is
Packit Service 392537
#		  the full compression rate; the 2nd is the incremental rate.
Packit Service 392537
#		  If the second is omitted, it is assumed equal to the first.
Packit Service 392537
#		  The numbers represent the amount of the original file the
Packit Service 392537
#		  compressed file is expected to take up.
Packit Service 392537
#		  Default: [comprate 0.50, 0.50]
Packit Service 392537
#   compress	- specify compression of the backed up data.  Valid values are:
Packit Service 392537
#		  "none"        - don't compress the dump output.
Packit Service 392537
#		  "client best" - compress on the client using the best (and
Packit Service 392537
#				  probably slowest) algorithm.
Packit Service 392537
#		  "client fast" - compress on the client using fast algorithm.
Packit Service 392537
#	          "client custom" - compress using your custom client compression program.
Packit Service 392537
#				    use client_custom_compress "PROG" to specify
Packit Service 392537
#				    the custom compression program.
Packit Service 392537
#				    PROG must not contain white space.
Packit Service 392537
#		  "server best" - compress on the tape host using the best (and
Packit Service 392537
#				  probably slowest) algorithm.
Packit Service 392537
#		  "server fast" - compress on the tape host using a fast
Packit Service 392537
#				  algorithm.  This may be useful when a fast
Packit Service 392537
#				  tape host is backing up slow clients.
Packit Service 392537
#	          "server custom" - compress using your server custom compression program.
Packit Service 392537
#				    use server_custom_compress "PROG" to specify
Packit Service 392537
#				    the custom compression program.
Packit Service 392537
#				    PROG must not contain white space.
Packit Service 392537
#		  Default: [compress client fast]
Packit Service 392537
#   dumpcycle	- set the number of days in the dump cycle, ie, set how often a
Packit Service 392537
#		  full dump should be performed.  Default: from DUMPCYCLE above
Packit Service 392537
#   estimate      Determine the way AMANDA does it's estimate. 
Packit Service 392537
#		  "client"	- Use the same program as the dumping program,
Packit Service 392537
#				this is the most accurate way to do estimates, 
Packit Service 392537
#				but it can take a long time.
Packit Service 392537
#		  "calcsize"	- Use a faster program to do estimates, but the
Packit Service 392537
#		  		result is less accurate.
Packit Service 392537
#		  "server"	- Use only statistics from the previous run to 
Packit Service 392537
#				give an estimate, 
Packit Service 392537
#				it takes only a few seconds but the result is not 
Packit Service 392537
#				accurate if your disk usage changes from day to day.
Packit Service 392537
#		  Default: [client]
Packit Service 392537
#   encrypt  - specify encryption of the backed up data. Valid values are:
Packit Service 392537
#		  "none"   - don't encrypt the dump output.
Packit Service 392537
#		  "client" - encrypt on the client using the program specified by 
Packit Service 392537
#                            client_encrypt "PROG".
Packit Service 392537
#			     Use client_decrypt_option to specify the decrypt- 
Packit Service 392537
#                            parameter, default is "-d".
Packit Service 392537
#                            PROG and decrypt-parameter must not contain white space.     
Packit Service 392537
#		  "server" - encrypt on the server using the program specified by 
Packit Service 392537
#                            server_encrypt "PROG".
Packit Service 392537
#                            Use server_decrypt_option to specify the decrypt- 
Packit Service 392537
#                            parameter, default is "-d".
Packit Service 392537
#                            PROG and decrypt-parameter must not contain white space.
Packit Service 392537
#                 Default: [none]
Packit Service 392537
#   exclude	- specify files and directories to be excluded from the dump.
Packit Service 392537
#		  Useful with gnutar only; silently ignored by dump and samba.
Packit Service 392537
#		  Valid values are:
Packit Service 392537
#		  "pattern"       - a shell glob pattern defining which files
Packit Service 392537
#				    to exclude.
Packit Service 392537
#				    gnutar gets --exclude="pattern"
Packit Service 392537
#		  list "filename" - a file (on the client!) containing patterns
Packit Service 392537
#				    re's (1 per line) defining which files to
Packit Service 392537
#				    exclude.
Packit Service 392537
#				    gnutar gets --exclude-from="filename"
Packit Service 392537
#		  Note that the `full pathname' of a file within its
Packit Service 392537
#		  filesystem starts with `./', because of the way amanda runs
Packit Service 392537
#		  gnutar: `tar -C $mountpoint -cf - --lots-of-options .' (note
Packit Service 392537
#		  the final dot!)  Thus, if you're backing up `/usr' with a
Packit Service 392537
#		  diskfile entry like ``host /usr gnutar-root', but you don't
Packit Service 392537
#		  want to backup /usr/tmp, your exclude list should contain
Packit Service 392537
#		  the pattern `./tmp', as this is relative to the `/usr' above.
Packit Service 392537
#		  Please refer to the man-page of gnutar for more information.
Packit Service 392537
#		  If a relative pathname is specified as the exclude list,
Packit Service 392537
#		  it is searched from within the directory that is
Packit Service 392537
#		  going to be backed up.
Packit Service 392537
#		  Default: include all files
Packit Service 392537
#   holdingdisk	- should the holding disk be used for this dump.  Useful for
Packit Service 392537
#		  dumping the holding disk itself.  Default: [holdingdisk auto]
Packit Service 392537
#		  "never"    - Never use the holding disk.
Packit Service 392537
#		  "auto"     - Use the holding disk if possible.
Packit Service 392537
#		  "required" - Always use the holding disk.
Packit Service 392537
#   ignore	- do not back this filesystem up.  Useful for sharing a single
Packit Service 392537
#		  disklist in several configurations.
Packit Service 392537
#   index	- keep an index of the files backed up.  Default: [index no]
Packit Service 392537
#   kencrypt	- encrypt the data stream between the client and server.
Packit Service 392537
#		  Default: [kencrypt no]
Packit Service 392537
#   maxdumps	- max number of concurrent dumps to run on the client.
Packit Service 392537
#		  Default: [maxdumps 1]
Packit Service 392537
#   maxpromoteday - max number of day for a promotion, set it 0 if you don't
Packit Service 392537
#		  want promotion, set it to 1 or 2 if your disk get
Packit Service 392537
#		  overpromoted.
Packit Service 392537
#		  Default: [10000]
Packit Service 392537
#   priority	- priority level of the dump.  Valid levels are "low", "medium"
Packit Service 392537
#		  or "high".  These are really only used when Amanda has no
Packit Service 392537
#		  tape to write to because of some error.  In that "degraded
Packit Service 392537
#		  mode", as many incrementals as will fit on the holding disk
Packit Service 392537
#		  are done, higher priority first, to insure the important
Packit Service 392537
#		  disks are at least dumped.  Default: [priority medium]
Packit Service 392537
#   program	- specify the dump system to use.  Valid values are "DUMP",
Packit Service 392537
#                 or "GNUTAR".  Default: [program "DUMP"].
Packit Service 392537
#   record	- record the backup in the time-stamp-database of the backup
Packit Service 392537
#		  program (e.g. /etc/dumpdates for DUMP or
Packit Service 392537
#		  @GNUTAR_LISTED_INCREMENTAL_DIR@ for GNUTAR.).
Packit Service 392537
#		  Default: [record yes]
Packit Service 392537
#   skip-full	- skip the disk when a level 0 is due, to allow full backups
Packit Service 392537
#		  outside Amanda, eg when the machine is in single-user mode.
Packit Service 392537
#   skip-incr	- skip the disk when the level 0 is NOT due.  This is used in
Packit Service 392537
#		  archive configurations, where only full dumps are done and
Packit Service 392537
#		  the tapes saved.
Packit Service 392537
#   starttime	- delay the start of the dump?  Default: no delay
Packit Service 392537
#   strategy	- set the dump strategy.  Valid strategies are currently:
Packit Service 392537
#		  "standard" - the standard one.
Packit Service 392537
#		  "nofull"   - do level 1 dumps every time.  This can be used,
Packit Service 392537
#			       for example, for small root filesystems that
Packit Service 392537
#			       only change slightly relative to a site-wide
Packit Service 392537
#			       prototype.  Amanda then backs up just the
Packit Service 392537
#			       changes.
Packit Service 392537
#		  "noinc"    - do level 0 dumps every time.
Packit Service 392537
#		  "skip"     - skip all dumps.  Useful for sharing a single
Packit Service 392537
#			       disklist in several configurations.
Packit Service 392537
#		  "incronly" - do only incremental dumps. This is similar
Packit Service 392537
#                              to strategy 'nofull', but will increase
Packit Service 392537
#                              the dump level as usual. Full dumps will
Packit Service 392537
#                              only be performed when an 'amadmin force' 
Packit Service 392537
#                              has been issued 
Packit Service 392537
#		  Default: [strategy standard]
Packit Service 392537
#
Packit Service 392537
# Note that you may specify previously defined dumptypes as a shorthand way of
Packit Service 392537
# defining parameters.
Packit Service 392537
Packit Service 392537
define dumptype global {
Packit Service 392537
    comment "Global definitions"
Packit Service 392537
    # This is quite useful for setting global parameters, so you don't have
Packit Service 392537
    # to type them everywhere.  All dumptype definitions in this sample file
Packit Service 392537
    # do include these definitions, either directly or indirectly.
Packit Service 392537
    # There's nothing special about the name `global'; if you create any
Packit Service 392537
    # dumptype that does not contain the word `global' or the name of any
Packit Service 392537
    # other dumptype that contains it, these definitions won't apply.
Packit Service 392537
    # Note that these definitions may be overridden in other
Packit Service 392537
    # dumptypes, if the redefinitions appear *after* the `global'
Packit Service 392537
    # dumptype name.
Packit Service 392537
    # You may want to use this for globally enabling or disabling
Packit Service 392537
    # indexing, recording, etc.  Some examples:
Packit Service 392537
    # index yes
Packit Service 392537
    # record no
Packit Service 392537
    # auth "bsdtcp"
Packit Service 392537
}
Packit Service 392537
Packit Service 392537
define dumptype always-full {
Packit Service 392537
    global
Packit Service 392537
    comment "Full dump of this filesystem always"
Packit Service 392537
    compress none
Packit Service 392537
    priority high
Packit Service 392537
    dumpcycle 0
Packit Service 392537
}
Packit Service 392537
Packit Service 392537
# Dumptypes for gnutar
Packit Service 392537
define dumptype root-tar {
Packit Service 392537
    global
Packit Service 392537
    program "GNUTAR"
Packit Service 392537
    comment "root partitions dumped with tar"
Packit Service 392537
    compress none
Packit Service 392537
    index
Packit Service 392537
#   exclude list "@CONFIG_DIR@/exclude.gtar"
Packit Service 392537
    priority low
Packit Service 392537
}
Packit Service 392537
Packit Service 392537
define dumptype user-tar {
Packit Service 392537
    root-tar
Packit Service 392537
    comment "user partitions dumped with tar"
Packit Service 392537
    priority medium
Packit Service 392537
}
Packit Service 392537
Packit Service 392537
define dumptype user-tar-span {
Packit Service 392537
    root-tar
Packit Service 392537
    comment "tape-spanning user partitions dumped with tar"
Packit Service 392537
    priority medium
Packit Service 392537
}
Packit Service 392537
Packit Service 392537
define dumptype high-tar {
Packit Service 392537
    root-tar
Packit Service 392537
    comment "partitions dumped with tar"
Packit Service 392537
    priority high
Packit Service 392537
}
Packit Service 392537
Packit Service 392537
define dumptype comp-root-tar {
Packit Service 392537
    root-tar
Packit Service 392537
    comment "Root partitions with compression"
Packit Service 392537
    compress client fast
Packit Service 392537
}
Packit Service 392537
Packit Service 392537
define dumptype comp-user-tar {
Packit Service 392537
    user-tar
Packit Service 392537
    compress client fast
Packit Service 392537
}
Packit Service 392537
Packit Service 392537
define dumptype comp-user-tar-span {
Packit Service 392537
    user-tar-span
Packit Service 392537
    compress client fast
Packit Service 392537
}
Packit Service 392537
Packit Service 392537
define dumptype holding-disk {
Packit Service 392537
    global
Packit Service 392537
    comment "The master-host holding disk itself"
Packit Service 392537
    holdingdisk never # do not use the holding disk
Packit Service 392537
    priority medium
Packit Service 392537
}
Packit Service 392537
Packit Service 392537
define dumptype comp-user {
Packit Service 392537
    global
Packit Service 392537
    comment "Non-root partitions on reasonably fast machines"
Packit Service 392537
    compress client fast
Packit Service 392537
    priority medium
Packit Service 392537
}
Packit Service 392537
Packit Service 392537
define dumptype comp-user-span {
Packit Service 392537
    global
Packit Service 392537
    comment "Tape-spanning non-root partitions on reasonably fast machines"
Packit Service 392537
    compress client fast
Packit Service 392537
    priority medium
Packit Service 392537
}
Packit Service 392537
Packit Service 392537
define dumptype nocomp-user {
Packit Service 392537
    comp-user
Packit Service 392537
    comment "Non-root partitions on slow machines"
Packit Service 392537
    compress none
Packit Service 392537
}
Packit Service 392537
Packit Service 392537
define dumptype nocomp-user-span {
Packit Service 392537
    comp-user-span
Packit Service 392537
    comment "Tape-spanning non-root partitions on slow machines"
Packit Service 392537
    compress none
Packit Service 392537
}
Packit Service 392537
Packit Service 392537
define dumptype comp-root {
Packit Service 392537
    global
Packit Service 392537
    comment "Root partitions with compression"
Packit Service 392537
    compress client fast
Packit Service 392537
    priority low
Packit Service 392537
}
Packit Service 392537
Packit Service 392537
define dumptype nocomp-root {
Packit Service 392537
    comp-root
Packit Service 392537
    comment "Root partitions without compression"
Packit Service 392537
    compress none
Packit Service 392537
}
Packit Service 392537
Packit Service 392537
define dumptype comp-high {
Packit Service 392537
    global
Packit Service 392537
    comment "very important partitions on fast machines"
Packit Service 392537
    compress client best
Packit Service 392537
    priority high
Packit Service 392537
}
Packit Service 392537
Packit Service 392537
define dumptype nocomp-high {
Packit Service 392537
    comp-high
Packit Service 392537
    comment "very important partitions on slow machines"
Packit Service 392537
    compress none
Packit Service 392537
}
Packit Service 392537
Packit Service 392537
define dumptype nocomp-test {
Packit Service 392537
    global
Packit Service 392537
    comment "test dump without compression, no /etc/dumpdates recording"
Packit Service 392537
    compress none
Packit Service 392537
    record no
Packit Service 392537
    priority medium
Packit Service 392537
}
Packit Service 392537
Packit Service 392537
define dumptype comp-test {
Packit Service 392537
    nocomp-test
Packit Service 392537
    comment "test dump with compression, no /etc/dumpdates recording"
Packit Service 392537
    compress client fast
Packit Service 392537
}
Packit Service 392537
Packit Service 392537
define dumptype custom-compress {
Packit Service 392537
   global
Packit Service 392537
   program "GNUTAR"
Packit Service 392537
   comment "custom client compression dumped with tar"
Packit Service 392537
   compress client custom
Packit Service 392537
   client_custom_compress "/usr/bin/bzip2"
Packit Service 392537
}
Packit Service 392537
Packit Service 392537
define dumptype server-encrypt-fast {
Packit Service 392537
   global
Packit Service 392537
   program "GNUTAR"
Packit Service 392537
   comment "fast client compression and server symmetric encryption"
Packit Service 392537
   compress client fast
Packit Service 392537
   encrypt server
Packit Service 392537
   server_encrypt "/usr/sbin/amcrypt"
Packit Service 392537
   server_decrypt_option "-d"
Packit Service 392537
}
Packit Service 392537
Packit Service 392537
define dumptype client-encrypt-nocomp {
Packit Service 392537
   global
Packit Service 392537
   program "GNUTAR"
Packit Service 392537
   comment "no compression and client symmetric encryption"
Packit Service 392537
   compress none
Packit Service 392537
   encrypt client
Packit Service 392537
   client_encrypt "/usr/sbin/amcrypt"
Packit Service 392537
   client_decrypt_option "-d"
Packit Service 392537
}
Packit Service 392537
Packit Service 392537
Packit Service 392537
# To use gpg public-key encryption, gpg does compress with zlib by default.
Packit Service 392537
# Thus, no need to specify compress
Packit Service 392537
Packit Service 392537
#define dumptype gpg-encrypt {
Packit Service 392537
#    global
Packit Service 392537
#    program "GNUTAR"
Packit Service 392537
#    comment "server public-key encryption, dumped with tar"
Packit Service 392537
#    compress none
Packit Service 392537
#    encrypt server
Packit Service 392537
#    server_encrypt "/usr/sbin/amgpgcrypt"
Packit Service 392537
#    server_decrypt_option "-d"
Packit Service 392537
#}
Packit Service 392537
Packit Service 392537
Packit Service 392537
# network interfaces
Packit Service 392537
#
Packit Service 392537
# These are referred to by the disklist file.  They define the attributes
Packit Service 392537
# of the network interface that the remote machine is accessed through.
Packit Service 392537
# Notes: - netusage above defines the attributes that are used when the
Packit Service 392537
#          disklist entry doesn't specify otherwise.
Packit Service 392537
#        - the values below are only samples.
Packit Service 392537
#        - specifying an interface does not force the traffic to pass
Packit Service 392537
#          through that interface.  Your OS routing tables do that.  This
Packit Service 392537
#          is just a mechanism to stop Amanda trashing your network.
Packit Service 392537
# Attributes are:
Packit Service 392537
#	use		- bandwidth above which amanda won't start
Packit Service 392537
#			  backups using this interface.  Note that if
Packit Service 392537
#			  a single backup will take more than that,
Packit Service 392537
#			  amanda won't try to make it run slower!
Packit Service 392537
Packit Service 392537
define interface local {
Packit Service 392537
    comment "a local disk"
Packit Service 392537
    use 8000 kbps
Packit Service 392537
}
Packit Service 392537
Packit Service 392537
#define interface le0 {
Packit Service 392537
#    comment "10 Mbps ethernet"
Packit Service 392537
#    use 400 kbps
Packit Service 392537
#}
Packit Service 392537
Packit Service 392537
#define application-tool and dumptype for the amgtar application
Packit Service 392537
define application-tool app_amgtar {
Packit Service 392537
    comment "amgtar"
Packit Service 392537
    plugin  "amgtar"
Packit Service 6bcb2e
    property "XATTRS" "YES"
Packit Service 392537
    #property "GNUTAR-PATH" "/path/to/gtar"
Packit Service 392537
    #property "GNUTAR-LISTDIR" "/path/to/gnutar_list_dir"
Packit Service 392537
                    #default from gnutar_list_dir setting in amanda-client.conf
Packit Service 392537
}
Packit Service 392537
Packit Service 392537
define dumptype dt_amgtar {
Packit Service 392537
    program "APPLICATION"
Packit Service 392537
    application "app_amgtar"
Packit Service 392537
}
Packit Service 392537
Packit Service 392537
#define application-tool and dumptype for the amstar application
Packit Service 392537
define application-tool app_amstar {
Packit Service 392537
    comment "amstar"
Packit Service 392537
    plugin  "amstar"
Packit Service 392537
    #property "STAR-PATH" "/path/to/star"
Packit Service 392537
    #property "STAR-TARDUMP" "/path/to/tardumps"  # default /etc/tardumps
Packit Service 392537
    #property "STAR-DLE-TARDUMP" "no"
Packit Service 392537
	# if 'yes' then create a different tardump file for each DLE,
Packit Service 392537
        # it is required if you do many dump in parallel (maxdump>1)
Packit Service 392537
}
Packit Service 392537
Packit Service 392537
define dumptype dt_amstar {
Packit Service 392537
    program "APPLICATION"
Packit Service 392537
    application "app_amstar"
Packit Service 392537
}
Packit Service 392537
Packit Service 392537
#define a script-tool to send an email
Packit Service 392537
define script-tool sc-email {
Packit Service 392537
  comment "script-email"
Packit Service 392537
  plugin  "script-email"
Packit Service 392537
  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
Packit Service 392537
  execute_where server			# or client
Packit Service 392537
  property "mailto" "martinea"
Packit Service 392537
}
Packit Service 392537
#your dumptype must include: script "sc-email"
Packit Service 392537
#to use the script
Packit Service 392537
Packit Service 392537
define interactivity inter_tty {
Packit Service 392537
    plugin "tty"
Packit Service 392537
}
Packit Service 392537
define interactivity inter_email {
Packit Service 392537
    plugin "email"
Packit Service 392537
    property "mailto" "admin1" "admin2"
Packit Service 392537
    property "resend-delay" "10"
Packit Service 392537
    property "check-file" "/tmp/email_input"
Packit Service 392537
    property "check-file-delay" "10"
Packit Service 392537
}
Packit Service 392537
define interactivity inter_tty_email {
Packit Service 392537
    plugin "tty_email"
Packit Service 392537
    property "mailto" "admin1" "admin2"
Packit Service 392537
    property "resend-delay" "10"
Packit Service 392537
    property "check-file" "/tmp/email_input"
Packit Service 392537
    property "check-file-delay" "10"
Packit Service 392537
}
Packit Service 392537
interactivity "inter_tty_email"
Packit Service 392537
Packit Service 392537
define taperscan taper_traditional {
Packit Service 392537
    comment "traditional"
Packit Service 392537
    plugin "traditional"
Packit Service 392537
}
Packit Service 392537
define taperscan taper_oldest {
Packit Service 392537
    comment "oldest"
Packit Service 392537
    plugin "oldest"
Packit Service 392537
}
Packit Service 392537
define taperscan taper_lexical {
Packit Service 392537
    comment "lexical"
Packit Service 392537
    plugin "lexical"
Packit Service 392537
}
Packit Service 392537
taperscan "taper_lexical"
Packit Service 392537
Packit Service 392537
# You may include other amanda configuration files, so you can share
Packit Service 392537
# dumptypes, tapetypes and interface definitions among several
Packit Service 392537
# configurations.
Packit Service 392537
Packit Service 392537
#includefile "@CONFIG_DIR@/amanda.conf.main"