3 # These are referred to by the disklist file. The dumptype specifies
4 # certain parameters for dumping including:
5 # auth - authentication scheme to use between server and client.
6 # Valid values are "bsd", "bsdudp", "bsdtcp", "krb5", "local",
9 # comment - just a comment string
10 # comprate - set default compression rate. Should be followed by one or
11 # two numbers, optionally separated by a comma. The 1st is
12 # the full compression rate; the 2nd is the incremental rate.
13 # If the second is omitted, it is assumed equal to the first.
14 # The numbers represent the amount of the original file the
15 # compressed file is expected to take up.
16 # Default: [comprate 0.50, 0.50]
17 # compress - specify compression of the backed up data. Valid values are:
18 # "none" - don't compress the dump output.
19 # "client best" - compress on the client using the best (and
20 # probably slowest) algorithm.
21 # "client fast" - compress on the client using fast algorithm.
22 # "client custom" - compress using your custom client compression program.
23 # use client_custom_compress "PROG" to specify
24 # the custom compression program.
25 # PROG must not contain white space.
26 # "server best" - compress on the tape host using the best (and
27 # probably slowest) algorithm.
28 # "server fast" - compress on the tape host using a fast
29 # algorithm. This may be useful when a fast
30 # tape host is backing up slow clients.
31 # "server custom" - compress using your server custom compression program.
32 # use server_custom_compress "PROG" to specify
33 # the custom compression program.
34 # PROG must not contain white space.
35 # Default: [compress client fast]
36 # dumpcycle - set the number of days in the dump cycle, ie, set how often a
37 # full dump should be performed. Default: from DUMPCYCLE variable
38 # estimate Determine the way AMANDA does it's estimate.
39 # "client" - Use the same program as the dumping program,
40 # this is the most accurate way to do estimates,
41 # but it can take a long time.
42 # "calcsize" - Use a faster program to do estimates, but the
43 # result is less accurate.
44 # "server" - Use only statistics from the previous run to
46 # it takes only a few seconds but the result is not
47 # accurate if your disk usage changes from day to day.
49 # encrypt - specify encryption of the backed up data. Valid values are:
50 # "none" - don't encrypt the dump output.
51 # "client" - encrypt on the client using the program specified by
52 # client_encrypt "PROG".
53 # Use client_decrypt_option to specify the decrypt-
54 # parameter, default is "-d".
55 # PROG and decrypt-parameter must not contain white space.
56 # "server" - encrypt on the server using the program specified by
57 # server_encrypt "PROG".
58 # Use server_decrypt_option to specify the decrypt-
59 # parameter, default is "-d".
60 # PROG and decrypt-parameter must not contain white space.
62 # exclude - specify files and directories to be excluded from the dump.
63 # Useful with gnutar only; silently ignored by dump and samba.
65 # "pattern" - a shell glob pattern defining which files
67 # gnutar gets --exclude="pattern"
68 # list "filename" - a file (on the client!) containing patterns
69 # re's (1 per line) defining which files to
71 # gnutar gets --exclude-from="filename"
72 # Note that the `full pathname' of a file within its
73 # filesystem starts with `./', because of the way amanda runs
74 # gnutar: `tar -C $mountpoint -cf - --lots-of-options .' (note
75 # the final dot!) Thus, if you're backing up `/usr' with a
76 # diskfile entry like ``host /usr gnutar-root', but you don't
77 # want to backup /usr/tmp, your exclude list should contain
78 # the pattern `./tmp', as this is relative to the `/usr' above.
79 # Please refer to the man-page of gnutar for more information.
80 # If a relative pathname is specified as the exclude list,
81 # it is searched from within the directory that is
82 # going to be backed up.
83 # Default: include all files
84 # holdingdisk - should the holding disk be used for this dump. Useful for
85 # dumping the holding disk itself. Default: [holdingdisk auto]
86 # "never" - Never use the holding disk.
87 # "auto" - Use the holding disk if possible.
88 # "required" - Always use the holding disk.
89 # ignore - do not back this filesystem up. Useful for sharing a single
90 # disklist in several configurations.
91 # index - keep an index of the files backed up. Default: [index no]
92 # kencrypt - encrypt the data stream between the client and server.
93 # Default: [kencrypt no]
94 # maxdumps - max number of concurrent dumps to run on the client.
95 # Default: [maxdumps 1]
96 # maxpromoteday - max number of day for a promotion, set it 0 if you don't
97 # want promotion, set it to 1 or 2 if your disk get
100 # priority - priority level of the dump. Valid levels are "low", "medium"
101 # or "high". These are really only used when Amanda has no
102 # tape to write to because of some error. In that "degraded
103 # mode", as many incrementals as will fit on the holding disk
104 # are done, higher priority first, to insure the important
105 # disks are at least dumped. Default: [priority medium]
106 # program - specify the dump system to use. Valid values are "DUMP"
107 # "STAR" and "GNUTAR". Default: [program "DUMP"].
108 # record - record the backup in the time-stamp-database of the backup
109 # program (e.g. /etc/dumpdates for DUMP or
110 # /var/lib/amanda/gnutar-lists for GNUTAR.).
111 # Default: [record yes]
112 # skip-full - skip the disk when a level 0 is due, to allow full backups
113 # outside Amanda, eg when the machine is in single-user mode.
114 # skip-incr - skip the disk when the level 0 is NOT due. This is used in
115 # archive configurations, where only full dumps are done and
117 # starttime - delay the start of the dump? Default: no delay
118 # strategy - set the dump strategy. Valid strategies are currently:
119 # "standard" - the standard one.
120 # "nofull" - do level 1 dumps every time. This can be used,
121 # for example, for small root filesystems that
122 # only change slightly relative to a site-wide
123 # prototype. Amanda then backs up just the
125 # "noinc" - do level 0 dumps every time.
126 # "skip" - skip all dumps. Useful for sharing a single
127 # disklist in several configurations.
128 # "incronly" - do only incremental dumps. This is similar
129 # to strategy 'nofull', but will increase
130 # the dump level as usual. Full dumps will
131 # only be performed when an 'amadmin force'
133 # Default: [strategy standard]
134 # tape_splitsize - (optional) split dump file into pieces of a specified size.
135 # This allows dumps to be spread across multiple tapes, and can
136 # potentially make more efficient use of tape space. Note that
137 # if this value is too large (more than half the size of the
138 # average dump being split), substantial tape space can be
139 # wasted. If too small, large dumps will be split into
140 # innumerable tiny dumpfiles, adding to restoration complexity.
141 # A good rule of thumb, usually, is 1/10 of the size of your
142 # tape. Default: [disabled]
143 # split_diskbuffer - (optional) When dumping a split dump in PORT-WRITE
144 # mode (usually meaning "no holding disk"), buffer the split
145 # chunks to a file in the directory specified by this option.
147 # fallback_splitsize - (optional) When dumping a split dump in PORT-WRITE
148 # mode, if no split_diskbuffer is specified (or if we somehow
149 # fail to use our split_diskbuffer), we must buffer split
150 # chunks in memory. This specifies the maximum size split
151 # chunks can be in this scenario, and thus the maximum amount
152 # of memory consumed for in-memory splitting. Default: [10m]
155 # Note that you may specify previously defined dumptypes as a shorthand way
156 # of defining parameters.
158 # dumptype global defined in $config/amanda.conf
160 define dumptype always-full {
162 comment "Full dump of this filesystem always"
169 define dumptype root-star {
172 comment "root partitions dumped with star"
175 # exclude list "/var/lib/amanda/exclude.star"
179 define dumptype user-star {
181 comment "user partitions dumped with star"
185 define dumptype user-star-span {
188 comment "tape-spanning user partitions dumped with star"
192 define dumptype high-star {
194 comment "partitions dumped with star"
198 define dumptype comp-root-star {
200 comment "Root partitions with compression"
204 define dumptype comp-user-star {
209 define dumptype comp-user-star-span {
214 # Dumptypes for gnutar
216 define dumptype root-tar {
219 comment "root partitions dumped with tar"
226 define dumptype user-tar {
228 comment "user partitions dumped with tar"
233 define dumptype user-tar-span {
236 comment "tape-spanning user partitions dumped with tar"
241 define dumptype high-tar {
243 comment "partitions dumped with tar"
247 define dumptype comp-root-tar {
249 comment "Root partitions with compression dumped with tar"
253 define dumptype comp-user-tar {
258 define dumptype comp-user-tar-span {
264 define dumptype holding-disk {
266 comment "The master-host holding disk itself"
267 holdingdisk never # do not use the holding disk
271 define dumptype comp-user {
273 comment "Non-root partitions on reasonably fast machines"
278 define dumptype comp-user-span {
281 comment "Tape-spanning non-root partitions on reasonably fast machines"
287 define dumptype nocomp-user {
289 comment "Non-root partitions on slow machines"
293 define dumptype nocomp-user-span {
295 comment "Tape-spanning non-root partitions on slow machines"
300 define dumptype comp-root {
302 comment "Root partitions with compression"
307 define dumptype nocomp-root {
309 comment "Root partitions without compression"
313 define dumptype comp-high {
315 comment "very important partitions on fast machines"
320 define dumptype nocomp-high {
322 comment "very important partitions on slow machines"
326 define dumptype nocomp-test {
328 comment "test dump without compression, no /etc/dumpdates recording"
334 define dumptype comp-test {
336 comment "test dump with compression, no /etc/dumpdates recording"
340 define dumptype nocomp-ssh {
342 comment "ssh authorization and dumped with tar"
344 ssh_keys "/var/lib/amanda/.ssh/id_rsa_amdump"
349 define dumptype custom-compress {
351 comment "custom client compression, dumped with tar"
352 compress client custom
353 client_custom_compress "/usr/bin/bzip2"
356 # amcrypt requires aespipe and uuencode
357 define dumptype encrypt-fast {
359 comment "fast client compression and server symmetric encryption, dumped with tar"
362 server_encrypt "/usr/sbin/amcrypt"
363 server_decrypt_option "-d"
367 # amcryptsimple use gpg symmetric encryption. gpg does compress with zlib by default.
368 # Thus, specify compress none.
369 define dumptype encrypt-simple-nocomp {
371 comment "client simple symmetric encryption, dumped with tar"
374 client_encrypt "/usr/sbin/amcryptsimple"
375 client_decrypt_option "-d"
378 # To use gpg public-key encryption, gpg does compress with zlib by default.
379 # Thus, specify compress none.
381 define dumptype gpg-encrypt-nocomp {
383 comment "server public-key encryption, dumped with tar"
386 server_encrypt "/usr/sbin/amgpgcrypt"
387 server_decrypt_option "-d"
390 # The following dumptypes are for ZMC
391 # dumptype gui-base defined in $config/amanda.conf
393 define dumptype gui-default {
395 comment "gui default dumptype"
400 define dumptype gui-compress {
402 comment "gui dumptype with compression"
407 define dumptype gui-encrypt {
409 comment "gui dumptype with encryption"
412 server_encrypt "/usr/sbin/amcryptsimple"
415 define dumptype gui-encrypt-compress {
417 comment "gui dumptype with compression and encryption"
420 server_encrypt "/usr/sbin/amcryptsimple"