Merge commit 'upstream/3.2.0'
[debian/amanda] / example / amanda.conf.in
index 57f1befc9baeb0032e2ec50b270c50acfc43bcfb..903b1bbd7b364254e0a8aac67fe3d114708fb6db 100644 (file)
@@ -111,47 +111,35 @@ flush-threshold-scheduled 0
 taperflush 0
 autoflush no
 
 taperflush 0
 autoflush no
 
-# 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.  
-
-# 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.
+# Specify tape device or tape changer.
 
 runtapes 1                     # number of tapes to be used in a single run of amdump
 
 runtapes 1                     # number of tapes to be used in a single run of amdump
-tpchanger "chg-manual"         # the tape-changer glue script
-tapedev "@EXAMPLE_TAPEDEV@"    # the no-rewind tape device to be used
+tapedev "@EXAMPLE_TAPEDEV@"    # tape changer or device to use
 
 
-#changerfile "@CONFIG_DIR@/@DEFAULT_CONFIG@/changer"
-#changerfile "@CONFIG_DIR@/@DEFAULT_CONFIG@/changer-status"
-changerfile "@CONFIG_DIR@/@DEFAULT_CONFIG@/changer.conf"
-changerdev "@DEFAULT_CHANGER_DEVICE@"
+# 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.
 
 # 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 "@DEFAULT_CONFIG@-%%%"
+## 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
 
 
 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 "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 
 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 
@@ -276,8 +264,13 @@ indexdir "@CONFIG_DIR@/@DEFAULT_CONFIG@/index"             # index directory
 #     lbl-templ "@CONFIG_DIR@/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 {
 
 define tapetype QIC-60 {
+    global
     comment "Archive Viper"
     length 60 mbytes
     filemark 100 kbytes                # don't know a better value
     comment "Archive Viper"
     length 60 mbytes
     filemark 100 kbytes                # don't know a better value
@@ -285,6 +278,7 @@ define tapetype QIC-60 {
 }
 
 define tapetype DEC-DLT2000 {
 }
 
 define tapetype DEC-DLT2000 {
+    global
     comment "DEC Differential Digital Linear Tape 2000"
     length 15000 mbytes
     filemark 8 kbytes
     comment "DEC Differential Digital Linear Tape 2000"
     length 15000 mbytes
     filemark 8 kbytes
@@ -294,6 +288,7 @@ define tapetype DEC-DLT2000 {
 # goluboff@butch.Colorado.EDU
 # in amanda-users (Thu Dec 26 01:55:38 MEZ 1996)
 define tapetype DLT {
 # 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
     comment "DLT tape drives"
     length 20000 mbytes                # 20 Gig tapes
     filemark 2000 kbytes       # I don't know what this means
@@ -301,6 +296,7 @@ define tapetype DLT {
 }
 
 define tapetype SURESTORE-1200E {
 }
 
 define tapetype SURESTORE-1200E {
+    global
     comment "HP AutoLoader"
     length 3900 mbytes
     filemark 100 kbytes
     comment "HP AutoLoader"
     length 3900 mbytes
     filemark 100 kbytes
@@ -308,6 +304,7 @@ define tapetype SURESTORE-1200E {
 }
 
 define tapetype EXB-8500 {
 }
 
 define tapetype EXB-8500 {
+    global
     comment "Exabyte EXB-8500 drive on decent machine"
     length 4200 mbytes
     filemark 48 kbytes
     comment "Exabyte EXB-8500 drive on decent machine"
     length 4200 mbytes
     filemark 48 kbytes
@@ -315,6 +312,7 @@ define tapetype EXB-8500 {
 }
 
 define tapetype EXB-8200 {
 }
 
 define tapetype EXB-8200 {
+    global
     comment "Exabyte EXB-8200 drive on decent machine"
     length 2200 mbytes
     filemark 2130 kbytes
     comment "Exabyte EXB-8200 drive on decent machine"
     length 2200 mbytes
     filemark 2130 kbytes
@@ -322,6 +320,7 @@ define tapetype EXB-8200 {
 }
 
 define tapetype HP-DAT {
 }
 
 define tapetype HP-DAT {
+    global
     comment "DAT tape drives"
     # data provided by Rob Browning <rlb@cs.utexas.edu>
     length 1930 mbytes
     comment "DAT tape drives"
     # data provided by Rob Browning <rlb@cs.utexas.edu>
     length 1930 mbytes
@@ -330,6 +329,7 @@ define tapetype HP-DAT {
 }
 
 define tapetype DAT {
 }
 
 define tapetype DAT {
+    global
     comment "DAT tape drives"
     length 1000 mbytes         # these numbers are not accurate
     filemark 100 kbytes                # but you get the idea
     comment "DAT tape drives"
     length 1000 mbytes         # these numbers are not accurate
     filemark 100 kbytes                # but you get the idea
@@ -337,6 +337,7 @@ define tapetype DAT {
 }
 
 define tapetype MIMSY-MEGATAPE {
 }
 
 define tapetype MIMSY-MEGATAPE {
+    global
     comment "Megatape (Exabyte based) drive through Emulex on Vax 8600"
     length 2200 mbytes
     filemark 2130 kbytes
     comment "Megatape (Exabyte based) drive through Emulex on Vax 8600"
     length 2200 mbytes
     filemark 2130 kbytes
@@ -344,10 +345,11 @@ define tapetype MIMSY-MEGATAPE {
 }
 
 define tapetype SEAGATE-ULTRIUM-LTO {
 }
 
 define tapetype SEAGATE-ULTRIUM-LTO {
-     comment "SEAGATE ULTRIUM 06242 LTO, compression off"
-     length 99584 mbytes
-     filemark 0 kbytes
-     speed 11288 kps
+    global
+    comment "SEAGATE ULTRIUM 06242 LTO, compression off"
+    length 99584 mbytes
+    filemark 0 kbytes
+    speed 11288 kps
 }
 
 # dumptypes
 }
 
 # dumptypes
@@ -355,8 +357,9 @@ define tapetype SEAGATE-ULTRIUM-LTO {
 # 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.
 # 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", "krb4", "krb5" and "ssh".  
-#                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
 #   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
@@ -457,7 +460,7 @@ define tapetype SEAGATE-ULTRIUM-LTO {
 #   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    - 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
 #                @GNUTAR_LISTED_INCREMENTAL_DIRX@ for GNUTAR.).
 #                Default: [record yes]
 #   skip-full  - skip the disk when a level 0 is due, to allow full backups
@@ -482,25 +485,6 @@ define tapetype SEAGATE-ULTRIUM-LTO {
 #                              only be performed when an 'amadmin force' 
 #                              has been issued 
 #                Default: [strategy standard]
 #                              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]
 #
 # 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.
@@ -551,7 +535,6 @@ define dumptype user-tar {
 
 define dumptype user-tar-span {
     root-tar
 
 define dumptype user-tar-span {
     root-tar
-    tape_splitsize 3 Gb
     comment "tape-spanning user partitions dumped with tar"
     priority medium
 }
     comment "tape-spanning user partitions dumped with tar"
     priority medium
 }
@@ -594,7 +577,6 @@ define dumptype comp-user {
 
 define dumptype comp-user-span {
     global
 
 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
     comment "Tape-spanning non-root partitions on reasonably fast machines"
     compress client fast
     priority medium
@@ -640,7 +622,7 @@ define dumptype nocomp-high {
 
 define dumptype nocomp-test {
     global
 
 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
     compress none
     record no
     priority medium
@@ -648,7 +630,7 @@ define dumptype nocomp-test {
 
 define dumptype comp-test {
     nocomp-test
 
 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
 }
 
     compress client fast
 }