1DISKLIST(5) File formats and conventions DISKLIST(5)
2
6 disklist - List of partitions to back up for Amanda
7
9 The disklist file determines which disks will be backed up by Amanda.
10 The file contains includefile directive or disklist entry (DLE).
11 includefile string
13 Default: no default. The name of a disklist file to include within
14 the current file. Useful for sharing disklist among several
15 configurations. Relative pathnames are relative to the
16 configuration directory.
17 A DLE usually contains one line per disk:
19 hostname diskname [diskdevice] dumptype [spindle [interface] ]
20 All pairs [ hostname diskname ] must be unique.
22 Lines starting with # are ignored, as are blank lines. The fields have
24 the following meanings:
25 hostname
27 The name of the host to be backed up. If diskdevice refers to a PC
28 share, this is the host Amanda will run the Samba smbclient program
29 on to back up the share.
30 diskname
32 The name of the disk (a label). In most case, you set your diskname
33 to the diskdevice and you don't set the diskdevice. If you want
34 multiple entries with the same diskdevice, you must set a different
35 diskname for each entry. It's the diskname that you use on the
36 commandline for any Amanda command. Look at the example/disklist
37 file for example.
38 diskdevice
40 Default: same as diskname. The name of the disk device to be backed
41 up. It may be a full device name, a device name without the /dev/
42 prefix, e.g. sd0a, or a mount point such as /usr.
43 It may also refer to a PC share by starting the name with two
45 (forward) slashes, e.g. //some-pc/home. In this case, the program
46 option in the associated dumptype must be entered as GNUTAR. It is
47 the combination of the double slash disk name and program GNUTAR in
48 the dumptype that triggers the use of Samba.
49 dumptype
51 Refers to a dumptype defined in the amanda.conf file. Dumptypes
52 specify backup related parameters, such as whether to compress the
53 backups, whether to record backup results in /etc/dumpdates, the
54 disk's relative priority, etc.
55 spindle
57 Default: -1. A number used to balance backup load on a host. Amanda
58 will not run multiple backups at the same time on the same spindle,
59 unless the spindle number is -1, which means there is no spindle
60 restriction.
61 interface
63 Default: local. The name of a network interface definition in the
64 amanda.conf file, used to balance network load.
65 Instead of naming a dumptype, it is possible to define one in-line,
67 enclosing dumptype options within curly braces, one per line, just like
68 a dumptype definition in amanda.conf. Since pre-existing dumptypes are
69 valid option names, this syntax may be used to customize dumptypes for
70 particular disks.
71 A line break must follow the left curly bracket.
73 For instance, if a dumptype named normal is used for most disks, but
75 use of the holding disk needs to be disabled for the file system that
76 holds it, this would work instead of defining a new dumptype:
77 hostname diskname [ diskdevice ] {
78 normal
79 holdingdisk never
80 } [ spindle [ interface ] ]
81 The { must appear at the end of a line, and the } on its own line
83 possibly followed by the spindle and interface.
84
86 amanda(8), amanda.conf(5)
87 The Amanda Wiki: : http://wiki.zmanda.com/
89
91 James da Silva <jds@amanda.org>
92 Stefan G. Weichinger <sgw@amanda.org>
94 Dustin J. Mitchell <dustin@zmanda.com>
96 Zmanda, Inc. (http://www.zmanda.com)
97Amanda 3.5.4 07/27/2023 DISKLIST(5)