1DISKLIST(5)              File formats and conventions              DISKLIST(5)
2
3
4

NAME

6       disklist - List of partitions to back up for Amanda
7

DESCRIPTION

9       The disklist file determines which disks will be backed up by Amanda.
10       The file contains includefile directive or disklist entry (DLE).
11
12       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
18       A DLE usually contains one line per disk:
19       hostname diskname [diskdevice] dumptype [spindle [interface] ]
20
21       All pairs [ hostname diskname ] must be unique.
22
23       Lines starting with # are ignored, as are blank lines. The fields have
24       the following meanings:
25
26       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
31       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
39       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
44           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
50       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
56       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
62       interface
63           Default: local. The name of a network interface definition in the
64           amanda.conf file, used to balance network load.
65
66       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
72       A line break must follow the left curly bracket.
73
74       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
82       The { must appear at the end of a line, and the } on its own line
83       possibly followed by the spindle and interface.
84

SEE ALSO

86       amanda(8), amanda.conf(5)
87
88       The Amanda Wiki: : http://wiki.zmanda.com/
89

AUTHORS

91       James da Silva <jds@amanda.org>
92
93       Stefan G. Weichinger <sgw@amanda.org>
94
95       Dustin J. Mitchell <dustin@zmanda.com>
96           Zmanda, Inc. (http://www.zmanda.com)
97
98
99
100Amanda 3.5.4                      07/27/2023                       DISKLIST(5)
Impressum