mdadm.conf.5 (mdadm-4.1) | : | mdadm.conf.5 (mdadm-4.2) | ||
---|---|---|---|---|
skipping to change at line 249 | skipping to change at line 249 | |||
tem and provides a way of marking spares that can be moved to othe r arrays as well as the migra- | tem and provides a way of marking spares that can be moved to othe r arrays as well as the migra- | |||
tion domains. Domain can be defined through policy line by specif ying a domain name for a number | tion domains. Domain can be defined through policy line by specif ying a domain name for a number | |||
of paths from /dev/disk/by-path/. A device may belong to several domains. The domain of an array | of paths from /dev/disk/by-path/. A device may belong to several domains. The domain of an array | |||
is a union of domains of all devices in that array. A spare can be automatically moved from one | is a union of domains of all devices in that array. A spare can be automatically moved from one | |||
array to another if the set of the destination array's domains con tains all the domains of the | array to another if the set of the destination array's domains con tains all the domains of the | |||
new disk or if both arrays have the same spare-group. | new disk or if both arrays have the same spare-group. | |||
To update hot plug configuration it is necessary to execute m dadm --udev-rules command after | To update hot plug configuration it is necessary to execute m dadm --udev-rules command after | |||
changing the config file | changing the config file | |||
Key words used in the POLICY line and supported values are: | Keywords used in the POLICY line and supported values are: | |||
domain= | domain= | |||
any arbitrary string | any arbitrary string | |||
metadata= | metadata= | |||
0.9 1.x ddf or imsm | 0.9 1.x ddf or imsm | |||
path= file glob matching anything from /dev/disk/by-path | path= file glob matching anything from /dev/disk/by-path | |||
type= either disk or part. | type= either disk or part. | |||
action= | action= | |||
include, re-add, spare, spare-same-slot, or force-spare | include, re-add, spare, spare-same-slot, or force-spare | |||
auto= yes, no, or homehost. | auto= yes, no, or homehost. | |||
The action item determines the automatic behavior allowed for devi | The action item determines the automatic behavior allowed for devices | |||
ces matching the path and type | matching the path and type in | |||
in the same line. If a device matches several lines with differen | the same line. If a device matches several lines with different a | |||
t actions then the most permis- | ctions then the most permissive | |||
sive will apply. The ordering of policy lines is irrelevant to the | will apply. The ordering of policy lines is irrelevant to the end res | |||
end result. | ult. | |||
include | include | |||
allows adding a disk to an array if metadata on that disk m | allows adding a disk to an array if metadata on that disk matc | |||
atches that array | hes that array | |||
re-add will include the device in the array if it appears to be a | re-add will include the device in the array if it appears to be a cur | |||
current member or a member that | rent member or a member that | |||
was recently removed and the array has a write-intent-bitma | was recently removed and the array has a write-intent-bitmap | |||
p to allow the re-add function- | to allow the re-add functional- | |||
ality. | ity. | |||
spare as above and additionally: if the device is bare it can bec | spare as above and additionally: if the device is bare it can become | |||
ome a spare if there is any | a spare if there is any array | |||
array that it is a candidate for based on domains and metad | that it is a candidate for based on domains and metadata. | |||
ata. | ||||
spare-same-slot | spare-same-slot | |||
as above and additionally if given slot was used by an ar | as above and additionally if given slot was used by an array | |||
ray that went degraded recently | that went degraded recently and | |||
and the device plugged in has no metadata then it will be | the device plugged in has no metadata then it will be automati | |||
automatically added to that | cally added to that array (or | |||
array (or it's container) | it's container) | |||
force-spare | force-spare | |||
as above and the disk will become a spare in remaining case | as above and the disk will become a spare in remaining cases | |||
s | ||||
PART-POLICY | ||||
This is similar to POLICY and accepts the same keyword assignmen | ||||
ts. It allows a consistent set | ||||
of policies to applied to each of the partitions of a device. | ||||
A PART-POLICY line should set type=disk and identify the path to o | ||||
ne or more disk devices. Each | ||||
partition on these disks will be treated according to the action= | ||||
setting from this line. If a | ||||
domain is set in the line, then the domain associated with each pa | ||||
tition will be based on the | ||||
domain, but with "-partN" appended, when N is the partition nu | ||||
mber for the partition that was | ||||
found. | ||||
SYSFS The SYSFS line lists custom values of MD device's sysfs attributes | ||||
which will be stored in sysfs | ||||
after the array is assembled. Multiple lines are allowed and each | ||||
line has to contain the uuid or | ||||
the name of the device to which it relates. | ||||
uuid= hexadecimal identifier of MD device. This has to match the uui | ||||
d stored in the superblock. | ||||
name= name of the MD device as was given to mdadm when the array was | ||||
created. It will be ignored if | ||||
uuid is not empty. | ||||
MONITORDELAY | ||||
The monitordelay line gives a delay in seconds mdadm shall wai | ||||
t before pooling md arrays when | ||||
mdadm is running in --monitor mode. -d/--delay command line argum | ||||
ent takes precedence over the | ||||
config file | ||||
EXAMPLE | EXAMPLE | |||
DEVICE /dev/sd[bcdjkl]1 | DEVICE /dev/sd[bcdjkl]1 | |||
DEVICE /dev/hda1 /dev/hdb1 | DEVICE /dev/hda1 /dev/hdb1 | |||
# /dev/md0 is known by its UUID. | # /dev/md0 is known by its UUID. | |||
ARRAY /dev/md0 UUID=3aaa0122:29827cfa:5331ad66:ca767371 | ARRAY /dev/md0 UUID=3aaa0122:29827cfa:5331ad66:ca767371 | |||
# /dev/md1 contains all devices with a minor number of | # /dev/md1 contains all devices with a minor number of | |||
# 1 in the superblock. | # 1 in the superblock. | |||
ARRAY /dev/md1 superminor=1 | ARRAY /dev/md1 superminor=1 | |||
skipping to change at line 327 | skipping to change at line 351 | |||
# One domain comprising of devices attached to specified paths is defined . | # One domain comprising of devices attached to specified paths is defined . | |||
# Bare device matching first path will be made an imsm spare on hot plug. | # Bare device matching first path will be made an imsm spare on hot plug. | |||
# If more than one array is created on devices belonging to domain1 and | # If more than one array is created on devices belonging to domain1 and | |||
# one of them becomes degraded, then any imsm spare matching any path for | # one of them becomes degraded, then any imsm spare matching any path for | |||
# given domain name can be migrated. | # given domain name can be migrated. | |||
MAILADDR root@mydomain.tld | MAILADDR root@mydomain.tld | |||
PROGRAM /usr/sbin/handle-mdadm-events | PROGRAM /usr/sbin/handle-mdadm-events | |||
CREATE group=system mode=0640 auto=part-8 | CREATE group=system mode=0640 auto=part-8 | |||
HOMEHOST <system> | HOMEHOST <system> | |||
AUTO +1.x homehost -all | AUTO +1.x homehost -all | |||
SYSFS name=/dev/md/raid5 group_thread_cnt=4 sync_speed_max=1000000 | ||||
SYSFS uuid=bead5eb6:31c17a27:da120ba2:7dfda40d group_thread_cnt=4 sync_sp | ||||
eed_max=1000000 | ||||
MONITORDELAY 60 | ||||
SEE ALSO | SEE ALSO | |||
mdadm(8), md(4). | mdadm(8), md(4). | |||
MDADM.CONF(5) | MDADM.CONF(5) | |||
End of changes. 14 change blocks. | ||||
37 lines changed or deleted | 74 lines changed or added |