1 ### !!! WARNING !!! !!! WARNING !!! !!! WARNING !!! !!! WARNING !!! ###
3 ### This file is not meant to be installed "as is", and in fact, it ###
4 ### WILL NOT WORK! You must go through it and make changes appropriate ###
5 ### to your own situation. See the documentation in this file, in the ###
6 ### "man amanda" man page, in the "docs" directory and at the Amanda ###
7 ### web page (www.amanda.org). ###
9 ### !!! WARNING !!! !!! WARNING !!! !!! WARNING !!! !!! WARNING !!! ###
12 # amanda.conf - sample Amanda configuration file. This started off life as
13 # the actual config file in use at CS.UMD.EDU.
15 # If your configuration is called, say, "csd", then this file normally goes
16 # in @CONFIG_DIR@/csd/amanda.conf.
19 org "@DEFAULT_CONFIG@" # your organization name for reports
20 mailto "@CLIENT_LOGIN@" # space separated list of operators at your site
21 dumpuser "@CLIENT_LOGIN@" # the user to run dumps under
23 inparallel 4 # maximum dumpers that will run in parallel (max 63)
24 # this maximum can be increased at compile-time,
25 # modifying MAX_DUMPERS in server-src/driverio.h
26 dumporder "sssS" # specify the priority order of each dumper
31 # b -> smallest bandwitdh
32 # B -> biggest bandwitdh
33 # try "BTBTBTBTBTBT" if you are not holding
35 netusage 600 Kbps # maximum net bandwidth for Amanda, in KB per sec
37 dumpcycle 4 weeks # the number of days in the normal dump cycle
38 runspercycle 20 # the number of amdump runs in dumpcycle days
39 # (4 weeks * 5 amdump runs per week -- just weekdays)
40 tapecycle 25 tapes # the number of tapes in rotation
41 # 4 weeks (dumpcycle) times 5 tapes per week (just
42 # the weekdays) plus a few to handle errors that
43 # need amflush and so we do not overwrite the full
44 # backups performed at the beginning of the previous
47 # WARNING: don't use `inf' for tapecycle, it's broken!
50 bumpsize 20 Mb # minimum savings (threshold) to bump level 1 -> 2
51 bumpdays 1 # minimum days at each level
52 bumpmult 4 # threshold = bumpsize * bumpmult^(level-1)
54 etimeout 300 # number of seconds per filesystem for estimates.
55 #etimeout -600 # total number of seconds for estimates.
56 # a positive number will be multiplied by the number of filesystems on
57 # each host; a negative number will be taken as an absolute total time-out.
58 # The default is 5 minutes per filesystem.
60 dtimeout 1800 # number of idle seconds before a dump is aborted.
62 ctimeout 30 # maximum number of seconds that amcheck waits
63 # for each client host
66 # A positive integer telling taper how many 32k buffers to allocate.
67 # WARNING! If this is set too high, taper will not be able to allocate
68 # the memory and will die. The default is 20 (640k).
71 # Specify tape device and/or tape changer. If you don't have a tape
72 # changer, and you don't want to use more than one tape per run of
73 # amdump, just comment out the definition of tpchanger.
75 # Some tape changers require tapedev to be defined; others will use
76 # their own tape device selection mechanism. Some use a separate tape
77 # changer device (changerdev), others will simply ignore this
78 # parameter. Some rely on a configuration file (changerfile) to
79 # obtain more information about tape devices, number of slots, etc;
80 # others just need to store some data in files, whose names will start
81 # with changerfile. For more information about individual tape
82 # changers, read docs/TAPE.CHANGERS.
84 # At most one changerfile entry must be defined; select the most
85 # appropriate one for your configuration. If you select man-changer,
86 # keep the first one; if you decide not to use a tape changer, you may
87 # comment them all out.
89 runtapes 1 # number of tapes to be used in a single run of amdump
90 tpchanger "chg-manual" # the tape-changer glue script
91 tapedev "@DEFAULT_TAPE_DEVICE@" # the no-rewind tape device to be used
92 rawtapedev "@DEFAULT_RAW_TAPE_DEVICE@" # the raw device to be used (ftape only)
93 changerfile "/usr/adm/amanda/@DEFAULT_CONFIG@/changer"
94 changerfile "/usr/adm/amanda/@DEFAULT_CONFIG@/changer-status"
95 changerfile "@CONFIG_DIR@/@DEFAULT_CONFIG@/changer.conf"
96 changerdev "@DEFAULT_CHANGER_DEVICE@"
98 maxdumpsize -1 # Maximum number of bytes the planner will schedule
99 # for a run (default: runtapes * tape_length).
100 tapetype HP-DAT # what kind of tape it is (see tapetypes below)
101 labelstr "^@DEFAULT_CONFIG@[0-9][0-9]*$" # label constraint regex: all tapes must match
103 amrecover_do_fsf yes # amrecover will call amrestore with the
104 # -f flag for faster positioning of the tape.
105 amrecover_check_label yes # amrecover will call amrestore with the
106 # -l flag to check the label.
107 amrecover_changer "@DEFAULT_TAPE_DEVICE@" # amrecover will use the changer if you restore
109 # It could be a string like 'changer' and
110 # amrecover will use your changer if you
111 # set your tape with 'settape changer'
113 # Specify holding disks. These are used as a temporary staging area for
114 # dumps before they are written to tape and are recommended for most sites.
115 # The advantages include: tape drive is more likely to operate in streaming
116 # mode (which reduces tape and drive wear, reduces total dump time); multiple
117 # dumps can be done in parallel (which can dramatically reduce total dump time.
118 # The main disadvantage is that dumps on the holding disk need to be flushed
119 # (with amflush) to tape after an operating system crash or a tape failure.
120 # If no holding disks are specified then all dumps will be written directly
121 # to tape. If a dump is too big to fit on the holding disk than it will be
122 # written directly to tape. If more than one holding disk is specified then
123 # they will all be used based on activity and available space.
126 comment "main holding disk"
127 directory "/dumps/amanda" # where the holding disk is
128 use 290 Mb # how much space can we use on it
129 # a non-positive value means:
130 # use all space but that value
131 chunksize 1Gb # size of chunk if you want big dump to be
132 # dumped on multiple files on holding disks
133 # N Kb/Mb/Gb split images in chunks of size N
134 # The maximum value should be
135 # (MAX_FILE_SIZE - 1Mb)
136 # 0 same as INT_MAX bytes
139 # directory "/dumps2/amanda"
143 # directory "/mnt/disk4"
148 # If amanda cannot find a tape on which to store backups, it will run
149 # as many backups as it can to the holding disks. In order to save
150 # space for unattended backups, by default, amanda will only perform
151 # incremental backups in this case, i.e., it will reserve 100% of the
152 # holding disk space for the so-called degraded mode backups.
153 # However, if you specify a different value for the `reserve'
154 # parameter, amanda will not degrade backups if they will fit in the
155 # non-reserved portion of the holding disk.
157 # reserve 30 # percent
158 # This means save at least 30% of the holding disk space for degraded
162 # if autoflush is set to yes, then amdump will schedule all dump on
163 # holding disks to be flush to tape during the run.
165 # The format for a ColumnSpec is a ',' seperated list of triples.
166 # Each triple consists of
167 # + the name of the column (as in ColumnNameStrings)
168 # + prefix before the column
169 # + the width of the column, if set to -1 it will be recalculated
170 # to the maximum length of a line to print.
172 # "Disk=1:17,HostName=1:10,OutKB=1:7"
174 # "Disk=1:-1,HostName=1:10,OutKB=1:7"
176 # You need only specify those colums that should be changed from
177 # the default. If nothing is specified in the configfile, the
178 # above compiled in values will be in effect, resulting in an
179 # output as it was all the time.
180 # The names of the colums are:
181 # HostName, Disk, Level, OrigKB, OutKB, Compress, DumpTime, DumpRate,
182 # TapeTime and TapeRate.
184 # columnspec "Disk=1:18,HostName=0:10,OutKB=1:7"
187 # Amanda needs a few Mb of diskspace for the log and debug files,
188 # as well as a database. This stuff can grow large, so the conf directory
189 # isn't usually appropriate. Some sites use /usr/local/var and some /usr/adm.
190 # Create an amanda directory under there. You need a separate infofile and
191 # logdir for each configuration, so create subdirectories for each conf and
192 # put the files there. Specify the locations below.
194 # Note that, although the keyword below is infofile, it is only so for
195 # historic reasons, since now it is supposed to be a directory (unless
196 # you have selected some database format other than the `text' default)
197 infofile "/usr/adm/amanda/@DEFAULT_CONFIG@/curinfo" # database DIRECTORY
198 logdir "/usr/adm/amanda/@DEFAULT_CONFIG@" # log directory
199 indexdir "/usr/adm/amanda/@DEFAULT_CONFIG@/index" # index directory
200 #tapelist "/usr/adm/amanda/@DEFAULT_CONFIG@/tapelist" # list of used tapes
201 # tapelist is stored, by default, in the directory that contains amanda.conf
206 # Define the type of tape you use here, and use it in "tapetype"
207 # above. Some typical types of tapes are included here. The tapetype
208 # tells amanda how many MB will fit on the tape, how big the filemarks
209 # are, and how fast the tape device is.
211 # A filemark is the amount of wasted space every time a tape section
212 # ends. If you run `make tapetype' in tape-src, you'll get a program
213 # that generates tapetype entries, but it is slow as hell, use it only
214 # if you really must and, if you do, make sure you post the data to
215 # the amanda mailing list, so that others can use what you found out
216 # by searching the archives.
218 # For completeness Amanda should calculate the inter-record gaps too,
219 # but it doesn't. For EXABYTE and DAT tapes this is ok. Anyone using
220 # 9 tracks for amanda and need IRG calculations? Drop me a note if
223 # If you want amanda to print postscript paper tape labels
224 # add a line after the comment in the tapetype of the form
225 # lbl-templ "/path/to/postscript/template/label.ps"
227 # if you want the label to go to a printer other than the default
228 # for your system, you can also add a line above for a different
229 # printer. (i usually add that line after the dumpuser specification)
231 # dumpuser "operator" # the user to run dumps under
232 # printer "mypostscript" # printer to print paper label on
234 # here is an example of my definition for an EXB-8500
236 # define tapetype EXB-8500 {
238 # lbl-templ "/usr/local/amanda/config/lbl.exabyte.ps"
242 define tapetype QIC-60 {
243 comment "Archive Viper"
245 filemark 100 kbytes # don't know a better value
246 speed 100 kbytes # dito
249 define tapetype DEC-DLT2000 {
250 comment "DEC Differential Digital Linear Tape 2000"
256 # goluboff@butch.Colorado.EDU
257 # in amanda-users (Thu Dec 26 01:55:38 MEZ 1996)
258 define tapetype DLT {
259 comment "DLT tape drives"
260 length 20000 mbytes # 20 Gig tapes
261 filemark 2000 kbytes # I don't know what this means
262 speed 1536 kbytes # 1.5 Mb/s
265 define tapetype SURESTORE-1200E {
266 comment "HP AutoLoader"
272 define tapetype EXB-8500 {
273 comment "Exabyte EXB-8500 drive on decent machine"
279 define tapetype EXB-8200 {
280 comment "Exabyte EXB-8200 drive on decent machine"
286 define tapetype HP-DAT {
287 comment "DAT tape drives"
288 # data provided by Rob Browning <rlb@cs.utexas.edu>
294 define tapetype DAT {
295 comment "DAT tape drives"
296 length 1000 mbytes # these numbers are not accurate
297 filemark 100 kbytes # but you get the idea
301 define tapetype MIMSY-MEGATAPE {
302 comment "Megatape (Exabyte based) drive through Emulex on Vax 8600"
305 speed 170 kbytes # limited by the Emulex bus interface, ugh
311 # These are referred to by the disklist file. The dumptype specifies
312 # certain parameters for dumping including:
313 # auth - authentication scheme to use between server and client.
314 # Valid values are "bsd" and "krb4". Default: [auth bsd]
315 # comment - just a comment string
316 # comprate - set default compression rate. Should be followed by one or
317 # two numbers, optionally separated by a comma. The 1st is
318 # the full compression rate; the 2nd is the incremental rate.
319 # If the second is omitted, it is assumed equal to the first.
320 # The numbers represent the amount of the original file the
321 # compressed file is expected to take up.
322 # Default: [comprate 0.50, 0.50]
323 # compress - specify compression of the backed up data. Valid values are:
324 # "none" - don't compress the dump output.
325 # "client best" - compress on the client using the best (and
326 # probably slowest) algorithm.
327 # "client fast" - compress on the client using fast algorithm.
328 # "server best" - compress on the tape host using the best (and
329 # probably slowest) algorithm.
330 # "server fast" - compress on the tape host using a fast
331 # algorithm. This may be useful when a fast
332 # tape host is backing up slow clients.
333 # Default: [compress client fast]
334 # dumpcycle - set the number of days in the dump cycle, ie, set how often a
335 # full dump should be performed. Default: from DUMPCYCLE above
336 # exclude - specify files and directories to be excluded from the dump.
337 # Useful with gnutar only; silently ignored by dump and samba.
339 # "pattern" - a shell glob pattern defining which files
341 # gnutar gets --exclude="pattern"
342 # list "filename" - a file (on the client!) containing patterns
343 # re's (1 per line) defining which files to
345 # gnutar gets --exclude-from="filename"
346 # Note that the `full pathname' of a file within its
347 # filesystem starts with `./', because of the way amanda runs
348 # gnutar: `tar -C $mountpoint -cf - --lots-of-options .' (note
349 # the final dot!) Thus, if you're backing up `/usr' with a
350 # diskfile entry like ``host /usr gnutar-root', but you don't
351 # want to backup /usr/tmp, your exclude list should contain
352 # the pattern `./tmp', as this is relative to the `/usr' above.
353 # Please refer to the man-page of gnutar for more information.
354 # If a relative pathname is specified as the exclude list,
355 # it is searched from within the directory that is
356 # going to be backed up.
357 # Default: include all files
358 # holdingdisk - should the holding disk be used for this dump. Useful for
359 # dumping the holding disk itself. Default: [holdingdisk yes]
360 # ignore - do not back this filesystem up. Useful for sharing a single
361 # disklist in several configurations.
362 # index - keep an index of the files backed up. Default: [index no]
363 # kencrypt - encrypt the data stream between the client and server.
364 # Default: [kencrypt no]
365 # maxdumps - max number of concurrent dumps to run on the client.
366 # Default: [maxdumps 1]
367 # maxpromoteday - max number of day for a promotion, set it 0 if you don't
368 # want promotion, set it to 1 or 2 if your disk get
371 # priority - priority level of the dump. Valid levels are "low", "medium"
372 # or "high". These are really only used when Amanda has no
373 # tape to write to because of some error. In that "degraded
374 # mode", as many incrementals as will fit on the holding disk
375 # are done, higher priority first, to insure the important
376 # disks are at least dumped. Default: [priority medium]
377 # program - specify the dump system to use. Valid values are "DUMP" and
378 # "GNUTAR". Default: [program "DUMP"].
379 # record - record the backup in the time-stamp-database of the backup
380 # program (e.g. /etc/dumpdates for DUMP or
381 # @GNUTAR_LISTED_INCREMENTAL_DIRX@ for GNUTAR.).
382 # Default: [record yes]
383 # skip-full - skip the disk when a level 0 is due, to allow full backups
384 # outside Amanda, eg when the machine is in single-user mode.
385 # skip-incr - skip the disk when the level 0 is NOT due. This is used in
386 # archive configurations, where only full dumps are done and
388 # starttime - delay the start of the dump? Default: no delay
389 # strategy - set the dump strategy. Valid strategies are currently:
390 # "standard" - the standard one.
391 # "nofull" - do level 1 dumps every time. This can be used,
392 # for example, for small root filesystems that
393 # only change slightly relative to a site-wide
394 # prototype. Amanda then backs up just the
396 # "noinc" - do level 0 dumps every time.
397 # Unfortunately, this is not currently
398 # implemented. Use `dumpcycle 0'
400 # "skip" - skip all dumps. Useful for sharing a single
401 # disklist in several configurations.
402 # "incronly" - do only incremental dumps. This is similar
403 # to strategy 'nofull', but will increase
404 # the dump level as usual. Full dumps will
405 # only be performed when an 'amadmin force'
407 # Default: [strategy standard]
409 # Note that you may specify previously defined dumptypes as a shorthand way
410 # of defining parameters.
412 define dumptype global {
413 comment "Global definitions"
414 # This is quite useful for setting global parameters, so you don't have
415 # to type them everywhere. All dumptype definitions in this sample file
416 # do include these definitions, either directly or indirectly.
417 # There's nothing special about the name `global'; if you create any
418 # dumptype that does not contain the word `global' or the name of any
419 # other dumptype that contains it, these definitions won't apply.
420 # Note that these definitions may be overridden in other
421 # dumptypes, if the redefinitions appear *after* the `global'
423 # You may want to use this for globally enabling or disabling
424 # indexing, recording, etc. Some examples:
429 define dumptype always-full {
431 comment "Full dump of this filesystem always"
437 define dumptype root-tar {
440 comment "root partitions dumped with tar"
443 exclude list "/usr/local/lib/amanda/exclude.gtar"
447 define dumptype user-tar {
449 comment "user partitions dumped with tar"
453 define dumptype high-tar {
455 comment "partitions dumped with tar"
459 define dumptype comp-root-tar {
461 comment "Root partitions with compression"
465 define dumptype comp-user-tar {
470 define dumptype holding-disk {
472 comment "The master-host holding disk itself"
473 holdingdisk no # do not use the holding disk
477 define dumptype comp-user {
479 comment "Non-root partitions on reasonably fast machines"
484 define dumptype nocomp-user {
486 comment "Non-root partitions on slow machines"
490 define dumptype comp-root {
492 comment "Root partitions with compression"
497 define dumptype nocomp-root {
499 comment "Root partitions without compression"
503 define dumptype comp-high {
505 comment "very important partitions on fast machines"
510 define dumptype nocomp-high {
512 comment "very important partitions on slow machines"
516 define dumptype nocomp-test {
518 comment "test dump without compression, no /etc/dumpdates recording"
524 define dumptype comp-test {
526 comment "test dump with compression, no /etc/dumpdates recording"
532 # These are referred to by the disklist file. They define the attributes
533 # of the network interface that the remote machine is accessed through.
534 # Notes: - netusage above defines the attributes that are used when the
535 # disklist entry doesn't specify otherwise.
536 # - the values below are only samples.
537 # - specifying an interface does not force the traffic to pass
538 # through that interface. Your OS routing tables do that. This
539 # is just a mechanism to stop Amanda trashing your network.
541 # use - bandwidth above which amanda won't start
542 # backups using this interface. Note that if
543 # a single backup will take more than that,
544 # amanda won't try to make it run slower!
546 define interface local {
547 comment "a local disk"
551 define interface le0 {
552 comment "10 Mbps ethernet"
556 # You may include other amanda configuration files, so you can share
557 # dumptypes, tapetypes and interface definitions among several
560 #includefile "/usr/local/amanda.conf.main"