symlink to upstream's installation of examples in /usr/share/amanda,
[debian/amanda] / debian / amanda.conf.in
index e5d56d35af19a5b601b12a88883b940eaf5c576d..3760360e42be1283ae401a8c8f468d70cc7ab5e0 100644 (file)
 #
-# amanda.conf - sample Amanda configuration file.  
+# amanda.conf - sample Amanda configuration file.
 #
 # If your configuration is called, say, "DailySet1", then this file
 # normally goes in /etc/amanda/DailySet1/amanda.conf.
-# 
-# for explanation of the parameters refer to amanda(8) and
-# /usr/doc/amanda/WHATS.NEW.gz 
-
-org "DailySet1"                # your organization name for reports
-mailto "root"          # space separated list of operators at your site
-dumpuser "backup"      # the user to run dumps under
 #
-inparallel 4           # maximum dumpers that will run in parallel
-netusage  600          # maximum net bandwidth for Amanda, in KB per sec
+# You need to edit this file to suit your needs.  See the documentation in 
+# this file, in the "man amanda" man page, in the /usr/share/docs/amanda*
+# directories, and on the web at www.amanda.org for more information.
+#
+
+org "DailySet1"                        # your organization name for reports
+mailto "root"                  # space separated list of operators at your site
+dumpuser "backup"              # the user to run dumps under
+
+inparallel 4           # maximum dumpers that will run in parallel (max 63)
+                       # this maximum can be increased at compile-time,
+                       # modifying MAX_DUMPERS in server-src/driverio.h
+dumporder "sssS"       # specify the priority order of each dumper
+                       #   s -> smallest size
+                       #   S -> biggest size
+                       #   t -> smallest time
+                       #   T -> biggest time
+                       #   b -> smallest bandwitdh
+                       #   B -> biggest bandwitdh
+                       # try "BTBTBTBTBTBT" if you are not holding
+                       # disk constrained
+
+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  600 Kbps     # maximum net bandwidth for Amanda, in KB per sec
 
-# a filesystem is due for a full backup once every <dumpcycle> days
 dumpcycle 4 weeks      # the number of days in the normal dump cycle
-tapecycle 8 tapes      # the number of tapes in rotation
+runspercycle 20         # the number of amdump runs in dumpcycle days
+                       # (4 weeks * 5 amdump runs per week -- just weekdays)
+tapecycle 25 tapes     # the number of tapes in rotation
+                       # 4 weeks (dumpcycle) times 5 tapes per week (just
+                       # the weekdays) plus a few to handle errors that
+                       # need amflush and so we do not overwrite the full
+                       # backups performed at the beginning of the previous
+                       # cycle
+
+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 "/etc/amanda/DailySet1/changer"
+#changerfile "/etc/amanda/DailySet1/changer-status"
+changerfile "/etc/amanda/DailySet1/changer.conf"
+changerdev "@DEFAULT_CHANGER_DEVICE@"
+
+# 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.
+## label_new_tapes "DailySet1-%%%"
+
+# 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 "^DailySet1-[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'
+
+# 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.
+# The advantages include: tape drive is more likely to operate in streaming
+# mode (which reduces tape and drive wear, reduces total dump time); multiple
+# dumps can be done in parallel (which can dramatically reduce total dump time.
+# The main disadvantage is that dumps on the holding disk need to be flushed
+# (with amflush) to tape after an operating system crash or a tape failure.
+# If no holding disks are specified then all dumps will be written directly
+# to tape.  If a dump is too big to fit on the holding disk than it will be
+# written directly to tape.  If more than one holding disk is specified then
+# they will all be used based on activity and available space.
+
+holdingdisk hd1 {
+    comment "main holding disk"
+    directory "/dumps/amanda"  # where the holding disk is
+    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
+                       #             The maximum value should be
+                       #             (MAX_FILE_SIZE - 1Mb)
+                       #  0          same as INT_MAX bytes
+    }
+#holdingdisk hd2 {
+#    directory "/dumps2/amanda"
+#    use 1000 Mb
+#    }
+#holdingdisk hd3 {
+#    directory "/mnt/disk4"
+#    use 1000 Mb
+#    }
+
+
+# If amanda cannot find a tape on which to store backups, it will run
+# as many backups as it can to the holding disks.  In order to save
+# space for unattended backups, by default, amanda will only perform
+# incremental backups in this case, i.e., it will reserve 100% of the
+# holding disk space for the so-called degraded mode backups.
+# However, if you specify a different value for the `reserve'
+# parameter, amanda will not degrade backups if they will fit in the
+# non-reserved portion of the holding disk.
+
+# reserve 30 # percent
+# 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)
+#   + prefix before the column
+#   + the width of the column, if set to -1 it will be recalculated
+#     to the maximum length of a line to print.
+# Example:
+#      "Disk=1:17,HostName=1:10,OutKB=1:7"
+# or
+#      "Disk=1:-1,HostName=1:10,OutKB=1:7"
+#        
+# You need only specify those colums that should be changed from
+# the default. If nothing is specified in the configfile, the
+# above compiled in values will be in effect, resulting in an
+# output as it was all the time.
+# The names of the colums are:
+# HostName, Disk, Level, OrigKB, OutKB, Compress, DumpTime, DumpRate,
+# TapeTime and TapeRate.
+#                                                      ElB, 1999-02-24.
+# columnspec "Disk=1:18,HostName=0:10,OutKB=1:7"
+
+
+# Amanda needs a few Mb of diskspace for the log and debug files,
+# as well as a database.  This stuff can grow large, so the conf directory
+# isn't usually appropriate.  Some sites use /usr/local/var and some /usr/adm.
+# Create an amanda directory under there.  You need a separate infofile and
+# logdir for each configuration, so create subdirectories for each conf and
+# put the files there.  Specify the locations below.
+
+# 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 "/etc/amanda/DailySet1/curinfo"       # database DIRECTORY
+logdir   "/etc/amanda/DailySet1"               # log directory
+indexdir "/etc/amanda/DailySet1/index"         # index directory
+#tapelist "@CONFIG_DIR/DailySet1/tapelist"     # list of used tapes
+# tapelist is stored, by default, in the directory that contains amanda.conf
 
-bumpsize 20 MB         # minimum savings (threshold) to bump level 1 -> 2
-bumpdays     1         # minimum days at each level
-bumpmult     4         # threshold = bumpsize * (level-1)**bumpmult
+# tapetypes
 
-#runtapes     9         # explained in WHATS.NEW
-#tpchanger "no-changer" # the tape-changer glue script, see TAPE.CHANGERS
-tapedev        "/dev/nst0"     # Linux @ tuck, important: norewinding
-# tapedev "/dev/nrst8" # or use the (no-rewind!) tape device directly
+# Define the type of tape you use here, and use it in "tapetype"
+# above.  Some typical types of tapes are included here.  The tapetype
+# tells amanda how many MB will fit on the tape, how big the filemarks
+# are, and how fast the tape device is.
 
-tapetype HP-DAT                # what kind of tape it is (see tapetypes below)
-labelstr "^HISS[0-9][0-9]*$"   # label constraint regex: all tapes must match
+# 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.
 
-diskdir "/space"               # where the holding disk is
-disksize 290 MB                        # how much space can we use on it
-#diskdir "/dumps/amanda/work"  # additionaly holding disks can be specified
-#diskdir "/mnt/disk4"
-#disksize 1000 MB              #       they are used round-robin
+# For completeness Amanda should calculate the inter-record gaps too,
+# but it doesn't.  For EXABYTE and DAT tapes this is ok.  Anyone using
+# 9 tracks for amanda and need IRG calculations?  Drop me a note if
+# so.
 
+# If you want amanda to print postscript paper tape labels
+# add a line after the comment in the tapetype of the form
+#    lbl-templ "/path/to/postscript/template/label.ps"
 
-# Amanda needs a few MB of diskspace for the log and debug files,
-# as well as a database.  This stuff can grow large, so the conf directory
-# isn't usually appropriate.
+# if you want the label to go to a printer other than the default
+# for your system, you can also add a line above for a different
+# printer. (i usually add that line after the dumpuser specification)
 
-infofile "/var/lib/amanda/DailySet1/curinfo"   # database filename
-logfile  "/var/log/amanda/DailySet1/log"       # log filename
+# dumpuser "operator"     # the user to run dumps under
+# printer "mypostscript"  # printer to print paper label on
 
-# where the index files live
-indexdir "/var/lib/amanda/DailySet1/index"
+# here is an example of my definition for an EXB-8500
+
+# define tapetype EXB-8500 {
+# ...
+#     lbl-templ "/etc/amanda/config/lbl.exabyte.ps"
+# }
 
-# tapetypes
-#
-# Define the type of tape you use here, and use it in "tapetype" above.
-# Some typical types of tapes are included here.  The tapetype tells amanda
-# how many MB will fit on the tape, how big the filemarks are, and how
-# fast the tape device is.
-#
-# For completeness Amanda should calculate the inter-record gaps too, but it
-# doesn't.  For EXABYTE and DAT tapes this is ok.  Anyone using 9 tracks for
-# amanda and need IRG calculations?  Drop me a note if so.
 
 define tapetype QIC-60 {
     comment "Archive Viper"
@@ -78,7 +277,7 @@ define tapetype DLT {
     comment "DLT tape drives"
     length 20000 mbytes                # 20 Gig tapes
     filemark 2000 kbytes       # I don't know what this means
-    speed 1500 kbytes
+    speed 1536 kbytes          # 1.5 Mb/s
 }
 
 define tapetype SURESTORE-1200E {
@@ -104,9 +303,10 @@ define tapetype EXB-8200 {
 
 define tapetype HP-DAT {
     comment "DAT tape drives"
-    length 1900 mbytes         # these numbers are not accurate
-    filemark 100 kbytes                # but you get the idea
-    speed 500 kbytes
+    # data provided by Rob Browning <rlb@cs.utexas.edu>
+    length 1930 mbytes
+    filemark 111 kbytes
+    speed 468 kbytes
 }
 
 define tapetype DAT {
@@ -123,138 +323,351 @@ define tapetype MIMSY-MEGATAPE {
     speed 170 kbytes           # limited by the Emulex bus interface, ugh
 }
 
-define tapetype QIC-3080 {
-    comment "QIC 3080"
-    length 2000 mbytes
-    filemark 64 kbytes
-    speed 250 kbytes
-}
 
 # dumptypes
 #
 # These are referred to by the disklist file.  The dumptype specifies
-# certain "options" for dumping including:
-#      index           - keep an index of the files backed up
-#      compress-fast   - (default) compress on the client using fast algorithm
-#      compress-best   - compress using the best (and slowww) algorithm
-#      no-compress     - don't compress the dump output
-#      srvcompress     - Compress dumps on the tape host instead of client
-#                        machines.  This may be useful when a fast tape host
-#                        is backing up slow clients.
-#      record          - (default) record the dump in /etc/dumpdates
-#      no-record       - don't record the dump, for testing
-#      no-hold         - don't go to the holding disk, good for dumping
-#                        the holding disk partition itself.
-#      skip-full       - Skip the disk when a level 0 is due, to allow
-#                        full backups outside Amanda, eg when the machine
-#                        is in single-user mode.
-#      skip-incr       - Skip the disk when the level 0 is NOT due.  This
-#                        is used in archive configurations, where only full
-#                        dumps are done and the tapes saved.
-#      no-full         - Do a level 1 every night.  This can be used, for
-#                        example, for small root filesystems that only change
-#                        slightly relative to a site-wide prototype.  Amanda
-#                        then backs up just the changes.
+# certain parameters for dumping including:
+#   auth       - authentication scheme to use between server and client.
+#                Valid values are "bsd", "krb4", "krb5" 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
+#                the full compression rate; the 2nd is the incremental rate.
+#                If the second is omitted, it is assumed equal to the first.
+#                The numbers represent the amount of the original file the
+#                compressed file is expected to take up.
+#                Default: [comprate 0.50, 0.50]
+#   compress   - specify compression of the backed up data.  Valid values are:
+#                "none"        - don't compress the dump output.
+#                "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:
+#                "pattern"       - a shell glob pattern defining which files
+#                                  to exclude.
+#                                  gnutar gets --exclude="pattern"
+#                list "filename" - a file (on the client!) containing patterns
+#                                  re's (1 per line) defining which files to
+#                                  exclude.
+#                                  gnutar gets --exclude-from="filename"
+#                Note that the `full pathname' of a file within its
+#                filesystem starts with `./', because of the way amanda runs
+#                gnutar: `tar -C $mountpoint -cf - --lots-of-options .' (note
+#                the final dot!)  Thus, if you're backing up `/usr' with a
+#                diskfile entry like ``host /usr gnutar-root', but you don't
+#                want to backup /usr/tmp, your exclude list should contain
+#                the pattern `./tmp', as this is relative to the `/usr' above.
+#                Please refer to the man-page of gnutar for more information.
+#                If a relative pathname is specified as the exclude list,
+#                it is searched from within the directory that is
+#                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]
+#   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]
+#   kencrypt   - encrypt the data stream between the client and server.
+#                Default: [kencrypt no]
+#   maxdumps   - max number of concurrent dumps to run on the client.
+#                Default: [maxdumps 1]
+#   maxpromoteday - max number of day for a promotion, set it 0 if you don't
+#                want promotion, set it to 1 or 2 if your disk get
+#                overpromoted.
+#                Default: [10000]
+#   priority   - priority level of the dump.  Valid levels are "low", "medium"
+#                or "high".  These are really only used when Amanda has no
+#                tape to write to because of some error.  In that "degraded
+#                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"].
+#   record     - record the backup in the time-stamp-database of the backup
+#                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
+#                outside Amanda, eg when the machine is in single-user mode.
+#   skip-incr  - skip the disk when the level 0 is NOT due.  This is used in
+#                archive configurations, where only full dumps are done and
+#                the tapes saved.
+#   starttime  - delay the start of the dump?  Default: no delay
+#   strategy   - set the dump strategy.  Valid strategies are currently:
+#                "standard" - the standard one.
+#                "nofull"   - do level 1 dumps every time.  This can be used,
+#                             for example, for small root filesystems that
+#                             only change slightly relative to a site-wide
+#                             prototype.  Amanda then backs up just the
+#                             changes.
+#                "noinc"    - do level 0 dumps every time.
+#                "skip"     - skip all dumps.  Useful for sharing a single
+#                             disklist in several configurations.
+#                "incronly" - do only incremental dumps. This is similar
+#                              to strategy 'nofull', but will increase
+#                              the dump level as usual. Full dumps will
+#                              only be performed when an 'amadmin force' 
+#                              has been issued 
+#                Default: [strategy standard]
+# tape_splitsize - (optional) split dump file into pieces of a specified size.
+#                This allows dumps to be spread across multiple tapes, and can
+#                potentially make more efficient use of tape space.  Note that
+#                if this value is too large (more than half the size of the
+#                average dump being split), substantial tape space can be
+#                wasted.  If too small, large dumps will be split into
+#                innumerable tiny dumpfiles, adding to restoration complexity.
+#                A good rule of thumb, usually, is 1/10 of the size of your
+#                tape.  Default: [disabled]
+# split_diskbuffer - (optional) When dumping a split dump  in  PORT-WRITE
+#                 mode (usually meaning "no holding disk"), buffer the split
+#                chunks to a file in the directory specified by this option.
+#                Default: [none]
+# fallback_splitsize - (optional) When dumping a split dump  in  PORT-WRITE
+#                 mode, if no split_diskbuffer is specified (or if we somehow
+#                 fail to use our split_diskbuffer), we must buffer split
+#                 chunks in memory.  This specifies the maximum size split
+#                 chunks can be in this scenario, and thus the maximum amount
+#                 of memory consumed for in-memory splitting.  Default: [10m]
 #
-# Also, the dumptype specifies the priority level, where "low", "medium" and
-# "high" are the allowed levels.  These are only really used when Amanda has
-# no tape to write to because of some error.  In that "degraded mode", as
-# many incrementals as will fit on the holding disk are done, higher priority
-# first, to insure the important disks are dumped first.
+# Note that you may specify previously defined dumptypes as a shorthand way of
+# defining parameters.
+
+define dumptype global {
+    comment "Global definitions"
+    # This is quite useful for setting global parameters, so you don't have
+    # to type them everywhere.  All dumptype definitions in this sample file
+    # do include these definitions, either directly or indirectly.
+    # There's nothing special about the name `global'; if you create any
+    # dumptype that does not contain the word `global' or the name of any
+    # other dumptype that contains it, these definitions won't apply.
+    # Note that these definitions may be overridden in other
+    # dumptypes, if the redefinitions appear *after* the `global'
+    # dumptype name.
+    # You may want to use this for globally enabling or disabling
+    # indexing, recording, etc.  Some examples:
+    # index yes
+    # record no
+    # split_diskbuffer "/raid/amanda"
+    # fallback_splitsize 64m
+}
 
 define dumptype always-full {
+    global
     comment "Full dump of this filesystem always"
-    options no-compress
+    compress none
     priority high
     dumpcycle 0
-    maxcycle 0
-}
-
-define dumptype comp-user-tar {
-    program "GNUTAR"
-    comment "partitions dumped with tar"
-    options compress-fast, index, exclude-list "/etc/amanda/exclude.gtar"
-    priority medium
 }
 
-define dumptype comp-root-tar {
+define dumptype root-tar {
+    global
     program "GNUTAR"
-    comment "Root partitions with compression"
-    options compress-fast, index, exclude-list "/etc/amanda/exclude.gtar"
+    comment "root partitions dumped with tar"
+    compress none
+    index
+#   exclude list "/etc/amanda/exclude.gtar"
     priority low
 }
 
 define dumptype user-tar {
-    program "GNUTAR"
-    comment "partitions dumped with tar"
-    options no-compress, index, exclude-list "/etc/amanda/exclude.gtar"
+    root-tar
+    comment "user partitions dumped with tar"
+    priority medium
+}
+
+define dumptype user-tar-span {
+    root-tar
+    tape_splitsize 3 Gb
+    comment "tape-spanning user partitions dumped with tar"
     priority medium
 }
 
 define dumptype high-tar {
-    program "GNUTAR"
+    root-tar
     comment "partitions dumped with tar"
-    options no-compress, index, exclude-list "/etc/amanda/exclude.gtar"
     priority high
 }
 
-define dumptype root-tar {
-    program "GNUTAR"
-    comment "Root partitions dumped with tar"
-    options no-compress, index, exclude-list "/etc/amanda/exclude.gtar"
-    priority low
+define dumptype comp-root-tar {
+    root-tar
+    comment "Root partitions with compression"
+    compress client fast
+}
+
+define dumptype comp-user-tar {
+    user-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
+    priority medium
 }
 
 define dumptype comp-user {
+    global
     comment "Non-root partitions on reasonably fast machines"
-    options compress-fast
+    compress client fast
+    priority medium
+}
+
+define dumptype comp-user-span {
+    global
+    tape_splitsize 5 Gb
+    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"
-    options no-compress
-    priority medium
+    compress none
 }
 
-define dumptype holding-disk {
-    comment "The master-host holding disk itself"
-    options no-hold
-    priority medium
+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"
-    options compress-fast
+    compress client fast
     priority low
 }
 
 define dumptype nocomp-root {
+    comp-root
     comment "Root partitions without compression"
-    options no-compress
-    priority low
+    compress none
 }
 
 define dumptype comp-high {
+    global
     comment "very important partitions on fast machines"
-    options compress-best
+    compress client best
     priority high
 }
 
 define dumptype nocomp-high {
+    comp-high
     comment "very important partitions on slow machines"
-    options no-compress
-    priority high
+    compress none
 }
 
 define dumptype nocomp-test {
-    comment "test dump without compression, no /etc/dumpdates recording"
-    options no-compress, no-record
+    global
+    comment "test dump without compression, no /var/lib/dumpdates recording"
+    compress none
+    record no
     priority medium
 }
 
 define dumptype comp-test {
-    comment "test dump with compression, no /etc/dumpdates recording"
-    options compress-fast, no-record
-    priority medium
+    nocomp-test
+    comment "test dump with compression, no /var/lib/dumpdates recording"
+    compress client fast
+}
+
+define dumptype custom-compress {
+   global
+   program "GNUTAR"
+   comment "test dump with custom client compression"
+   compress client custom
+   client_custom_compress "/usr/bin/bzip2"
+}
+
+define dumptype encrypt-fast {
+   global
+   program "GNUTAR"
+   comment "test dump with fast client compression and server symmetric encryption"
+   compress client fast
+   encrypt server
+   server_encrypt "/usr/local/sbin/amcrypt"
+   server_decrypt_option "-d"
+}
+
+# network interfaces
+#
+# These are referred to by the disklist file.  They define the attributes
+# of the network interface that the remote machine is accessed through.
+# Notes: - netusage above defines the attributes that are used when the
+#          disklist entry doesn't specify otherwise.
+#        - the values below are only samples.
+#        - specifying an interface does not force the traffic to pass
+#          through that interface.  Your OS routing tables do that.  This
+#          is just a mechanism to stop Amanda trashing your network.
+# Attributes are:
+#      use             - bandwidth above which amanda won't start
+#                        backups using this interface.  Note that if
+#                        a single backup will take more than that,
+#                        amanda won't try to make it run slower!
+
+define interface local {
+    comment "a local disk"
+    use 1000 kbps
 }
+
+define interface le0 {
+    comment "10 Mbps ethernet"
+    use 400 kbps
+}
+
+# You may include other amanda configuration files, so you can share
+# dumptypes, tapetypes and interface definitions among several
+# configurations.
+
+#includefile "/etc/amanda/amanda.conf.main"