Diffstat (limited to 'mdadm.8.in')
1 files changed, 56 insertions, 10 deletions
@@ -5,7 +5,7 @@
.\" the Free Software Foundation; either version 2 of the License, or
.\" (at your option) any later version.
.\" See file COPYING in distribution for details.
-.TH MDADM 8 "" v3.3.4
+.TH MDADM 8 "" v3.4
mdadm \- manage MD devices
@@ -267,13 +267,13 @@ the exact meaning of this option in different contexts.
.BR \-c ", " \-\-config=
Specify the config file or directory. Default is to use
-.BR /etc/mdadm/mdadm.conf.d ,
+.BR /etc/mdadm.conf.d ,
or if those are missing then
-.BR /etc/mdadm.conf.d .
+.BR /etc/mdadm/mdadm.conf.d .
If the config file given is
then nothing will be read, but
@@ -422,6 +422,12 @@ This functionality is currently only provided by
.BR \-\-monitor .
+specifies the cluster name for the md device. The md device can be assembled
+only on the cluster which matches the name specified. If this option is not
+provided, mdadm tries to detect the cluster name automatically.
.SH For create, build, or grow:
@@ -701,7 +707,12 @@ and so is replicated on all devices. If the word
is given with
-mode, then any bitmap that is present is removed.
+mode, then any bitmap that is present is removed. If the word
+is given, the array is created for a clustered environment. One bitmap
+is created for each node as defined by the
+parameter and are stored internally.
To help catch typing errors, the filename must contain at least one
slash ('/') if it is a real file (not 'internal' or 'none').
@@ -973,6 +984,18 @@ However for RAID0, it is not possible to add spares. So to increase
the number of devices in a RAID0, it is necessary to set the new
number of devices, and to add the new devices, in the same command.
+Only works when the array is for clustered environment. It specifies
+the maximum number of nodes in the cluster that will use this device
+simultaneously. If not specified, this defaults to 4.
+Specify journal device for the RAID-4/5/6 array. The journal device
+should be a SSD with reasonable lifetime.
.SH For assemble:
@@ -1087,7 +1110,9 @@ argument given to this flag can be one of
.BR summaries ,
.BR uuid ,
.BR name ,
+.BR nodes ,
.BR homehost ,
+.BR home-cluster ,
.BR resync ,
.BR byteorder ,
.BR devicesize ,
@@ -1142,6 +1167,13 @@ of the array as stored in the superblock. This is only supported for
+option will change the
+of the array as stored in the bitmap superblock. This option only
+works for a clustered environment.
option will change the
@@ -1150,6 +1182,11 @@ same as updating the UUID.
For version-1 superblocks, this involves updating the name.
+option will change the cluster name as recorded in the superblock and
+bitmap. This option only works for clustered environment.
option will cause the array to be marked
@@ -1396,6 +1433,15 @@ will avoid reading from these devices if possible.
Subsequent devices that are added or re\-added will have the 'write-mostly'
+Confirm the existence of the device. This is issued in response to an \-\-add
+request by a node in a cluster. When a node adds a device it sends a message
+to all nodes in the cluster to look for a device with a UUID. This translates
+to a udev notification with the UUID of the device to be added and the slot
+number. The receiving node must acknowledge this message
+with \-\-cluster\-confirm. Valid arguments are <slot>:<devicename> in case
+the device is found or <slot>:missing in case the device is not found.
Each of these options requires that the first device listed is the array
@@ -1803,9 +1849,9 @@ The config file is only used if explicitly named with
or requested with (a possibly implicit)
.BR \-\-scan .
In the later case,
@@ -3099,7 +3145,7 @@ uses this to find arrays when
is given in Misc mode, and to monitor array reconstruction
on Monitor mode.
-.SS /etc/mdadm/mdadm.conf (or /etc/mdadm.conf)
The config file lists which devices may be scanned to see if
they contain MD super block, and gives identifying information
@@ -3107,7 +3153,7 @@ they contain MD super block, and gives identifying information
.BR mdadm.conf (5)
for more details.
-.SS /etc/mdadm/mdadm.conf.d (or /etc/mdadm.conf.d)
A directory containing configuration files which are read in lexical