2006-08-07 03:12:25 +02:00
|
|
|
''' Copyright Neil Brown and others.
|
|
|
|
''' This program is free software; you can redistribute it and/or modify
|
|
|
|
''' it under the terms of the GNU General Public License as published by
|
|
|
|
''' the Free Software Foundation; either version 2 of the License, or
|
|
|
|
''' (at your option) any later version.
|
|
|
|
''' See file COPYING in distribution for details.
|
2002-03-15 06:21:36 +01:00
|
|
|
.TH MDADM.CONF 5
|
|
|
|
.SH NAME
|
|
|
|
mdadm.conf \- configuration for management of Software Raid with mdadm
|
|
|
|
.SH SYNOPSIS
|
|
|
|
/etc/mdadm.conf
|
|
|
|
.SH DESCRIPTION
|
|
|
|
.PP
|
|
|
|
.B mdadm
|
2002-03-20 23:39:50 +01:00
|
|
|
is a tool for creating, managing, and monitoring RAID devices using the
|
2002-03-15 06:21:36 +01:00
|
|
|
.B md
|
|
|
|
driver in Linux.
|
|
|
|
.PP
|
|
|
|
Some common tasks, such as assembling all arrays, can be simplified
|
2002-05-10 06:06:19 +02:00
|
|
|
by describing the devices and arrays in this configuration file.
|
2002-03-15 06:21:36 +01:00
|
|
|
|
|
|
|
.SS SYNTAX
|
|
|
|
The file should be seen as a collection of words separated by white
|
|
|
|
space (space, tab, or newline).
|
2002-03-20 23:39:50 +01:00
|
|
|
Any word that beings with a hash sign (#) starts a comment and that
|
2002-05-10 06:06:19 +02:00
|
|
|
word together with the remainder of the line is ignored.
|
2002-03-15 06:21:36 +01:00
|
|
|
|
2002-05-10 06:06:19 +02:00
|
|
|
Any line that starts with white space (space or tab) is treated as
|
2002-03-15 06:21:36 +01:00
|
|
|
though it were a continuation of the previous line.
|
|
|
|
|
|
|
|
Empty lines are ignored, but otherwise each (non continuation) line
|
2002-05-10 06:06:19 +02:00
|
|
|
must start with a keyword as listed below. The keywords are case
|
2002-04-04 03:58:32 +02:00
|
|
|
insensitive and can be abbreviated to 3 characters.
|
2002-03-15 06:21:36 +01:00
|
|
|
|
|
|
|
The keywords are:
|
|
|
|
.TP
|
|
|
|
.B DEVICE
|
|
|
|
A
|
|
|
|
.B device
|
|
|
|
line lists the devices (whole devices or partitions) that might contain
|
|
|
|
a component of an MD array. When looking for the components of an
|
|
|
|
array,
|
|
|
|
.B mdadm
|
2002-05-10 06:06:19 +02:00
|
|
|
will scan these devices (or any devices listed on the command line).
|
2002-03-15 06:21:36 +01:00
|
|
|
|
|
|
|
The
|
|
|
|
.B device
|
|
|
|
line may contain a number of different devices (separated by spaces)
|
|
|
|
and each device name can contain wild cards as defined by
|
|
|
|
.BR glob (7).
|
|
|
|
|
|
|
|
Also, there may be several device lines present in the file.
|
|
|
|
|
2003-02-12 01:17:26 +01:00
|
|
|
Alternatively, a
|
|
|
|
.B device
|
|
|
|
line can contain the word
|
|
|
|
.BR partitions .
|
|
|
|
This will cause
|
|
|
|
.I mdadm
|
|
|
|
to read
|
|
|
|
.I /proc/partitions
|
2007-05-08 09:13:03 +02:00
|
|
|
and include all devices and partitions found therein.
|
2003-02-12 01:17:26 +01:00
|
|
|
.I mdadm
|
|
|
|
does not use the names from
|
|
|
|
.I /proc/partitions
|
|
|
|
but only the major and minor device numbers. It scans
|
|
|
|
.I /dev
|
|
|
|
to find the name that matches the numbers.
|
|
|
|
|
2006-05-15 03:58:47 +02:00
|
|
|
If no DEVICE line is present, then "DEVICE partitions" is assumed.
|
|
|
|
|
2002-03-20 23:39:50 +01:00
|
|
|
For example:
|
|
|
|
.IP
|
|
|
|
DEVICE /dev/hda* /dev/hdc*
|
|
|
|
.br
|
|
|
|
DEV /dev/sd*
|
|
|
|
.br
|
|
|
|
DEVICE /dev/discs/disc*/disc
|
2003-02-12 01:17:26 +01:00
|
|
|
.br
|
|
|
|
DEVICE partitions
|
2002-03-20 23:39:50 +01:00
|
|
|
|
2002-03-15 06:21:36 +01:00
|
|
|
.TP
|
|
|
|
.B ARRAY
|
2002-03-20 23:39:50 +01:00
|
|
|
The ARRAY lines identify actual arrays. The second word on the line
|
|
|
|
should be the name of the device where the array is normally
|
|
|
|
assembled, such as
|
|
|
|
.BR /dev/md1 .
|
2002-04-04 03:58:32 +02:00
|
|
|
Subsequent words identify the array, or identify the array as a member
|
|
|
|
of a group. If multiple identities are given,
|
2002-05-10 06:06:19 +02:00
|
|
|
then a component device must match ALL identities to be considered a
|
|
|
|
match. Each identity word has a tag, and equals sign, and some value.
|
|
|
|
The tags are:
|
2002-03-20 23:39:50 +01:00
|
|
|
|
|
|
|
.RS 4
|
|
|
|
.TP
|
|
|
|
.B uuid=
|
|
|
|
The value should be a 128 bit uuid in hexadecimal, with punctuation
|
|
|
|
interspersed if desired. This must match the uuid stored in the
|
|
|
|
superblock.
|
|
|
|
.TP
|
2005-08-09 07:23:20 +02:00
|
|
|
.B name=
|
|
|
|
The value should be a simple textual name as was given to
|
|
|
|
.I mdadm
|
|
|
|
when the array was created. This must match the name stored in the
|
|
|
|
superblock on a device for that device to be included in the array.
|
2007-05-08 09:13:03 +02:00
|
|
|
Not all superblock formats support names.
|
2005-08-09 07:23:20 +02:00
|
|
|
.TP
|
2007-05-08 09:13:44 +02:00
|
|
|
.B super\-minor=
|
2002-03-20 23:39:50 +01:00
|
|
|
The value is an integer which indicates the minor number that was
|
|
|
|
stored in the superblock when the array was created. When an array is
|
|
|
|
created as /dev/mdX, then the minor number X is stored.
|
|
|
|
.TP
|
|
|
|
.B devices=
|
2003-03-12 23:24:39 +01:00
|
|
|
The value is a comma separated list of device names or device name
|
|
|
|
patterns.
|
|
|
|
Only devices with names which match one entry in the list will be used
|
|
|
|
to assemble the array. Note that the devices
|
2002-03-20 23:39:50 +01:00
|
|
|
listed there must also be listed on a DEVICE line.
|
|
|
|
.TP
|
|
|
|
.B level=
|
|
|
|
The value is a raid level. This is not normally used to
|
|
|
|
identify an array, but is supported so that the output of
|
|
|
|
|
2007-05-08 09:13:44 +02:00
|
|
|
.B "mdadm \-\-examine \-\-scan"
|
2002-03-20 23:39:50 +01:00
|
|
|
|
|
|
|
can be use directly in the configuration file.
|
|
|
|
.TP
|
2007-05-08 09:13:44 +02:00
|
|
|
.B num\-devices=
|
2002-04-11 03:36:14 +02:00
|
|
|
The value is the number of devices in a complete active array. As with
|
2002-03-20 23:39:50 +01:00
|
|
|
.B level=
|
|
|
|
this is mainly for compatibility with the output of
|
2002-03-15 06:21:36 +01:00
|
|
|
|
2007-05-08 09:13:44 +02:00
|
|
|
.BR "mdadm \-\-examine \-\-scan" .
|
2002-04-04 03:58:32 +02:00
|
|
|
|
2006-06-02 07:33:40 +02:00
|
|
|
.TP
|
|
|
|
.B spares=
|
|
|
|
The value is a number of spare devices to expect the array to have.
|
2007-05-08 09:13:44 +02:00
|
|
|
.B mdadm \-\-monitor
|
2006-06-02 07:33:40 +02:00
|
|
|
will report an array if it is found to have fewer than this number of
|
|
|
|
spares when
|
2007-05-08 09:13:44 +02:00
|
|
|
.B \-\-monitor
|
2006-06-02 07:33:40 +02:00
|
|
|
starts or when
|
2007-05-08 09:13:44 +02:00
|
|
|
.B \-\-oneshot
|
2006-06-02 07:33:40 +02:00
|
|
|
is used.
|
|
|
|
|
2002-04-04 03:58:32 +02:00
|
|
|
.TP
|
2007-05-08 09:13:44 +02:00
|
|
|
.B spare\-group=
|
2002-04-04 03:58:32 +02:00
|
|
|
The value is a textual name for a group of arrays. All arrays with
|
|
|
|
the same
|
2007-05-08 09:13:44 +02:00
|
|
|
.B spare\-group
|
2002-04-04 03:58:32 +02:00
|
|
|
name are considered to be part of the same group. The significance of
|
|
|
|
a group of arrays is that
|
|
|
|
.B mdadm
|
|
|
|
will, when monitoring the arrays, move a spare drive from one array in
|
|
|
|
a group to another array in that group if the first array had a failed
|
|
|
|
or missing drive but no spare.
|
2004-06-04 14:03:19 +02:00
|
|
|
|
|
|
|
.TP
|
|
|
|
.B auto=
|
|
|
|
This option declares to
|
|
|
|
.B mdadm
|
|
|
|
that it should try to create the device file of the array if it
|
|
|
|
doesn't already exist, or exists but with the wrong device number.
|
|
|
|
|
|
|
|
The value of this option can be "yes" or "md" to indicate that a
|
|
|
|
traditional, non-partitionable md array should be created, or "mdp",
|
|
|
|
"part" or "partition" to indicate that a partitionable md array (only
|
|
|
|
available in linux 2.6 and later) should be used. This later set can
|
|
|
|
also have a number appended to indicate how many partitions to create
|
|
|
|
device files for, e.g.
|
|
|
|
.BR auto=mdp5 .
|
|
|
|
The default is 4.
|
2006-03-29 04:57:48 +02:00
|
|
|
|
|
|
|
.TP
|
|
|
|
.B bitmap=
|
|
|
|
The option specifies a file in which a write-intent bitmap should be
|
|
|
|
found. When assembling the array,
|
|
|
|
.I mdadm
|
|
|
|
will provide this file to the
|
|
|
|
.B md
|
|
|
|
driver as the bitmap file. This has the same function as the
|
2007-05-08 09:13:44 +02:00
|
|
|
.B \-\-bitmap\-file
|
2006-03-29 04:57:48 +02:00
|
|
|
option to
|
2007-05-08 09:13:44 +02:00
|
|
|
.BR \-\-assemble .
|
2006-06-02 07:33:40 +02:00
|
|
|
|
|
|
|
.TP
|
|
|
|
.B metadata=
|
|
|
|
Specify the metadata format that the array has. This is mainly
|
|
|
|
recognised for comparability with the output of
|
2007-05-08 09:13:44 +02:00
|
|
|
.BR "mdadm \-Es" .
|
2006-06-02 07:33:40 +02:00
|
|
|
|
2002-03-20 23:39:50 +01:00
|
|
|
.RE
|
2002-04-04 03:58:32 +02:00
|
|
|
|
|
|
|
.TP
|
|
|
|
.B MAILADDR
|
|
|
|
The
|
|
|
|
.B mailaddr
|
|
|
|
line gives an E-mail address that alerts should be
|
|
|
|
sent to when
|
|
|
|
.M mdadm
|
|
|
|
is running in
|
2007-05-08 09:13:44 +02:00
|
|
|
.B \-\-monitor
|
2002-04-04 03:58:32 +02:00
|
|
|
mode (and was given the
|
2007-05-08 09:13:44 +02:00
|
|
|
.B \-\-scan
|
2002-04-04 03:58:32 +02:00
|
|
|
option). There should only be one
|
|
|
|
.B MAILADDR
|
|
|
|
line and it should have only one address.
|
|
|
|
|
|
|
|
|
2006-05-15 03:27:04 +02:00
|
|
|
.TP
|
|
|
|
.B MAILFROM
|
|
|
|
The
|
|
|
|
.B mailfrom
|
|
|
|
line (which can only be abbreviate at leat 5 characters) gives an
|
|
|
|
address to appear in the "From" address for alert mails. This can be
|
|
|
|
useful if you want to explicitly set a domain, as the default from
|
|
|
|
address is "root" with no domain. All words on this line are
|
|
|
|
catenated with spaces to form the address.
|
|
|
|
|
|
|
|
Note that this value cannot be set via the
|
|
|
|
.I mdadm
|
|
|
|
commandline. It is only settable via the config file.
|
|
|
|
|
2002-04-04 03:58:32 +02:00
|
|
|
.TP
|
|
|
|
.B PROGRAM
|
|
|
|
The
|
|
|
|
.B program
|
|
|
|
line gives the name of a program to be run when
|
2007-05-08 09:13:44 +02:00
|
|
|
.B "mdadm \-\-monitor"
|
2002-04-04 03:58:32 +02:00
|
|
|
detects potentially interesting events on any of the arrays that it
|
|
|
|
is monitoring. This program gets run with two or three arguments, they
|
|
|
|
being the Event, the md device, and possibly the related component
|
|
|
|
device.
|
|
|
|
|
|
|
|
There should only be one
|
|
|
|
.B program
|
|
|
|
line and it should be give only one program.
|
|
|
|
|
2006-05-15 08:02:41 +02:00
|
|
|
|
|
|
|
.TP
|
|
|
|
.B CREATE
|
|
|
|
The
|
|
|
|
.B create
|
2006-06-02 07:33:40 +02:00
|
|
|
line gives default values to be used when creating arrays and device entries for
|
2006-05-15 08:02:41 +02:00
|
|
|
arrays.
|
|
|
|
These include:
|
|
|
|
|
|
|
|
.RS 4
|
|
|
|
.TP
|
|
|
|
.B owner=
|
|
|
|
.TP
|
|
|
|
.B group=
|
|
|
|
These can give user/group ids or names to use instead of system
|
|
|
|
defaults (root/wheel or root/disk).
|
|
|
|
.TP
|
|
|
|
.B mode=
|
|
|
|
An octal file mode such as 0660 can be given to override the default
|
|
|
|
of 0600.
|
|
|
|
.TP
|
|
|
|
.B auto=
|
|
|
|
This corresponds to the
|
2007-05-08 09:13:44 +02:00
|
|
|
.B \-\-auto
|
2006-05-15 08:02:41 +02:00
|
|
|
flag to mdadm. Give
|
|
|
|
.BR yes ,
|
|
|
|
.BR md ,
|
|
|
|
.BR mdp ,
|
|
|
|
.B part
|
2007-05-08 09:13:25 +02:00
|
|
|
\(em possibly followed by a number of partitions \(em to indicate how
|
2006-05-15 08:02:41 +02:00
|
|
|
missing device entries should be created.
|
|
|
|
|
2006-06-02 07:33:40 +02:00
|
|
|
.TP
|
|
|
|
.B metadata=
|
|
|
|
The name of the metadata format to use if none is explicitly given.
|
|
|
|
This can be useful to impose a system-wide default of version-1 superblocks.
|
|
|
|
|
2006-08-11 10:00:05 +02:00
|
|
|
.TP
|
|
|
|
.B symlinks=no
|
|
|
|
Normally when creating devices in
|
|
|
|
.B /dev/md/
|
|
|
|
.I mdadm
|
|
|
|
will create a matching symlink from
|
|
|
|
.B /dev/
|
|
|
|
with a name starting
|
|
|
|
.B md
|
|
|
|
or
|
|
|
|
.BR md_ .
|
|
|
|
Give
|
2007-05-08 09:13:51 +02:00
|
|
|
.B symlinks=no
|
2006-08-11 10:00:05 +02:00
|
|
|
to suppress this symlink creation.
|
2006-05-15 08:02:41 +02:00
|
|
|
.RE
|
|
|
|
|
|
|
|
|
2002-05-10 06:06:19 +02:00
|
|
|
.SH EXAMPLE
|
|
|
|
DEVICE /dev/sd[bcdjkl]1
|
|
|
|
.br
|
|
|
|
DEVICE /dev/hda1 /dev/hdb1
|
|
|
|
|
|
|
|
# /dev/md0 is known by it's UID.
|
|
|
|
.br
|
|
|
|
ARRAY /dev/md0 UUID=3aaa0122:29827cfa:5331ad66:ca767371
|
|
|
|
.br
|
|
|
|
# /dev/md1 contains all devices with a minor number of
|
|
|
|
.br
|
|
|
|
# 1 in the superblock.
|
|
|
|
.br
|
|
|
|
ARRAY /dev/md1 superminor=1
|
|
|
|
.br
|
|
|
|
# /dev/md2 is made from precisey these two devices
|
|
|
|
.br
|
2005-08-25 07:11:29 +02:00
|
|
|
ARRAY /dev/md2 devices=/dev/hda1,/dev/hdb1
|
2002-05-10 06:06:19 +02:00
|
|
|
|
|
|
|
# /dev/md4 and /dev/md5 are a spare-group and spares
|
|
|
|
.br
|
|
|
|
# can be moved between them
|
|
|
|
.br
|
|
|
|
ARRAY /dev/md4 uuid=b23f3c6d:aec43a9f:fd65db85:369432df
|
|
|
|
.br
|
2007-05-08 09:13:44 +02:00
|
|
|
spare\-group=group1
|
2002-05-10 06:06:19 +02:00
|
|
|
.br
|
|
|
|
ARRAY /dev/md5 uuid=19464854:03f71b1b:e0df2edd:246cc977
|
|
|
|
.br
|
2007-05-08 09:13:44 +02:00
|
|
|
spare\-group=group1
|
2004-06-04 14:03:19 +02:00
|
|
|
.br
|
|
|
|
# /dev/md/home is created if need to be a partitionable md array
|
|
|
|
.br
|
|
|
|
# any spare device number is allocated.
|
|
|
|
.br
|
|
|
|
ARRAY /dev/md/home UUID=9187a482:5dde19d9:eea3cc4a:d646ab8b
|
|
|
|
.br
|
|
|
|
auto=part
|
2002-05-10 06:06:19 +02:00
|
|
|
|
|
|
|
MAILADDR root@mydomain.tld
|
|
|
|
.br
|
2007-05-08 09:13:44 +02:00
|
|
|
PROGRAM /usr/sbin/handle\-mdadm\-events
|
2006-05-15 08:02:41 +02:00
|
|
|
.br
|
2007-05-08 09:13:44 +02:00
|
|
|
CREATE group=system mode=0640 auto=part\-8
|
2006-05-26 09:12:48 +02:00
|
|
|
.br
|
|
|
|
HOMEHOST <system>
|
2002-04-04 03:58:32 +02:00
|
|
|
|
2002-03-15 06:21:36 +01:00
|
|
|
.SH SEE ALSO
|
2002-03-20 23:39:50 +01:00
|
|
|
.BR mdadm (8),
|
|
|
|
.BR md (4).
|
2002-03-15 06:21:36 +01:00
|
|
|
|