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. /var/lib/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]
135 # Note that you may specify previously defined dumptypes as a shorthand way
136 # of defining parameters.
138 # dumptype global defined in $config/amanda.conf
140 define dumptype always-full {
142 comment "Full dump of this filesystem always"
149 define dumptype root-star {
152 comment "root partitions dumped with star"
155 # exclude list "/var/lib/amanda/exclude.star"
159 define dumptype user-star {
161 comment "user partitions dumped with star"
165 define dumptype user-star-span {
167 comment "tape-spanning user partitions dumped with star"
171 define dumptype high-star {
173 comment "partitions dumped with star"
177 define dumptype comp-root-star {
179 comment "Root partitions with compression"
183 define dumptype comp-user-star {
188 define dumptype comp-user-star-span {
193 # Dumptypes for gnutar
195 define dumptype root-tar {
198 comment "root partitions dumped with tar"
205 define dumptype user-tar {
207 comment "user partitions dumped with tar"
212 define dumptype user-tar-span {
214 comment "tape-spanning user partitions dumped with tar"
219 define dumptype high-tar {
221 comment "partitions dumped with tar"
225 define dumptype comp-root-tar {
227 comment "Root partitions with compression dumped with tar"
231 define dumptype comp-user-tar {
236 define dumptype comp-user-tar-span {
242 define dumptype holding-disk {
244 comment "The master-host holding disk itself"
245 holdingdisk never # do not use the holding disk
249 define dumptype comp-user {
251 comment "Non-root partitions on reasonably fast machines"
256 define dumptype comp-user-span {
258 comment "Tape-spanning non-root partitions on reasonably fast machines"
264 define dumptype nocomp-user {
266 comment "Non-root partitions on slow machines"
270 define dumptype nocomp-user-span {
272 comment "Tape-spanning non-root partitions on slow machines"
277 define dumptype comp-root {
279 comment "Root partitions with compression"
284 define dumptype nocomp-root {
286 comment "Root partitions without compression"
290 define dumptype comp-high {
292 comment "very important partitions on fast machines"
297 define dumptype nocomp-high {
299 comment "very important partitions on slow machines"
303 define dumptype nocomp-test {
305 comment "test dump without compression, no /var/lib/dumpdates recording"
311 define dumptype comp-test {
313 comment "test dump with compression, no /var/lib/dumpdates recording"
317 define dumptype nocomp-ssh {
319 comment "ssh authorization and dumped with tar"
321 ssh_keys "/var/lib/amanda/.ssh/id_rsa_amdump"
326 define dumptype custom-compress {
328 comment "custom client compression, dumped with tar"
329 compress client custom
330 client_custom_compress "/usr/bin/bzip2"
333 # amcrypt requires aespipe and uuencode
334 define dumptype encrypt-fast {
336 comment "fast client compression and server symmetric encryption, dumped with tar"
339 server_encrypt "/usr/sbin/amcrypt"
340 server_decrypt_option "-d"
344 # amcryptsimple use gpg symmetric encryption. gpg does compress with zlib by default.
345 # Thus, specify compress none.
346 define dumptype encrypt-simple-nocomp {
348 comment "client simple symmetric encryption, dumped with tar"
351 client_encrypt "/usr/sbin/amcryptsimple"
352 client_decrypt_option "-d"
355 # To use gpg public-key encryption, gpg does compress with zlib by default.
356 # Thus, specify compress none.
358 define dumptype gpg-encrypt-nocomp {
360 comment "server public-key encryption, dumped with tar"
363 server_encrypt "/usr/sbin/amgpgcrypt"
364 server_decrypt_option "-d"
367 # The following dumptypes are for ZMC
368 # dumptype gui-base defined in $config/amanda.conf
370 define dumptype gui-default {
372 comment "gui default dumptype"
377 define dumptype gui-compress {
379 comment "gui dumptype with compression"
384 define dumptype gui-encrypt {
386 comment "gui dumptype with encryption"
389 server_encrypt "/usr/sbin/amcryptsimple"
392 define dumptype gui-encrypt-compress {
394 comment "gui dumptype with compression and encryption"
397 server_encrypt "/usr/sbin/amcryptsimple"