"Fossies" - the Fresh Open Source Software Archive  

Source code changes of the file "mdadm.conf.5" between
mdadm-4.2-rc1.tar.xz and mdadm-4.2-rc2.tar.xz

About: mdadm is a tool for creating, managing and monitoring device arrays using the "md" driver in Linux, also known as Software RAID arrays.

mdadm.conf.5  (mdadm-4.2-rc1.tar.xz):mdadm.conf.5  (mdadm-4.2-rc2.tar.xz)
skipping to change at line 250 skipping to change at line 250
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 b e automatically moved from one is a union of domains of all devices in that array. A spare can b e automatically moved from one
array to another if the set of the destination array's domains con tains all the domains of the new 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. disk or if both arrays have the same spare-group.
To update hot plug configuration it is necessary to execute mda dm --udev-rules command after To update hot plug configuration it is necessary to execute mda dm --udev-rules command after
changing the config file changing the config file
Keywords 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 de The action item determines the automatic behavior allowed for devic
vices matching the path and type es 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 acti
t actions then the most permis- ons 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
was recently removed and the array has a write-intent-bitma recently removed and the array has a write-intent-bitmap to al
p to allow the re-add function- low the re-add functionality.
ality.
spare as above and additionally: if the device is bare it ca spare as above and additionally: if the device is bare it can become
n become 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 arra as above and additionally if given slot was used by an array
y that went degraded recently that went degraded recently and
and the device plugged in has no metadata then it will be a the device plugged in has no metadata then it will be automati
utomatically added to that array cally added to that array (or
(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 PART-POLICY
This is similar to POLICY and accepts the same keyword assignments . It allows a consistent set of This is similar to POLICY and accepts the same keyword assignments . It allows a consistent set of
policies to applied to each of the partitions of a device. policies to applied to each of the partitions of a device.
A PART-POLICY line should set type=disk and identify the path to A PART-POLICY line should set type=disk and identify the path to o
one or more disk devices. Each ne or more disk devices. Each
partition on these disks will be treated according to the action= partition on these disks will be treated according to the action
setting from this line. If a = setting from this line. If a
domain is set in the line, then the domain associated with ea domain is set in the line, then the domain associated with each pa
ch patition will be based on the tition will be based on the
domain, but with "-partN" appended, when N is the partition number domain, but with "-partN" appended, when N is the partition n
for the partition that was umber for the partition that was
found. found.
SYSFS The SYSFS line lists custom values of MD device's sysfs attribut SYSFS The SYSFS line lists custom values of MD device's sysfs attributes
es which will be stored in sysfs which will be stored in sysfs
after the array is assembled. Multiple lines are allowed and each after the array is assembled. Multiple lines are allowed and each
line has to contain the uuid or line has to contain the uuid or
the name of the device to which it relates. 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. 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 wa s created. It will be ignored if 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. uuid is not empty.
EXAMPLE MONITORDELAY
DEVICE /dev/sd[bcdjkl]1 The monitordelay line gives a delay in seconds mdadm shall wa
DEVICE /dev/hda1 /dev/hdb1 it before pooling md arrays when
mdadm is running in --monitor mode. -d/--delay command line argum
# /dev/md0 is known by its UUID. ent takes precedence over the
ARRAY /dev/md0 UUID=3aaa0122:29827cfa:5331ad66:ca767371 config file
# /dev/md1 contains all devices with a minor number of
# 1 in the superblock. EXAMPLE
ARRAY /dev/md1 superminor=1 DEVICE /dev/sd[bcdjkl]1
# /dev/md2 is made from precisely these two devices DEVICE /dev/hda1 /dev/hdb1
ARRAY /dev/md2 devices=/dev/hda1,/dev/hdb1
# /dev/md0 is known by its UUID.
# /dev/md4 and /dev/md5 are a spare-group and spares ARRAY /dev/md0 UUID=3aaa0122:29827cfa:5331ad66:ca767371
# can be moved between them # /dev/md1 contains all devices with a minor number of
ARRAY /dev/md4 uuid=b23f3c6d:aec43a9f:fd65db85:369432df # 1 in the superblock.
spare-group=group1 ARRAY /dev/md1 superminor=1
ARRAY /dev/md5 uuid=19464854:03f71b1b:e0df2edd:246cc977 # /dev/md2 is made from precisely these two devices
spare-group=group1 ARRAY /dev/md2 devices=/dev/hda1,/dev/hdb1
# /dev/md/home is created if need to be a partitionable md array
# any spare device number is allocated. # /dev/md4 and /dev/md5 are a spare-group and spares
ARRAY /dev/md/home UUID=9187a482:5dde19d9:eea3cc4a:d646ab8b # can be moved between them
auto=part ARRAY /dev/md4 uuid=b23f3c6d:aec43a9f:fd65db85:369432df
# The name of this array contains a space. spare-group=group1
ARRAY /dev/md9 name='Data Storage' ARRAY /dev/md5 uuid=19464854:03f71b1b:e0df2edd:246cc977
spare-group=group1
POLICY domain=domain1 metadata=imsm path=pci-0000:00:1f.2-scsi-* # /dev/md/home is created if need to be a partitionable md array
action=spare # any spare device number is allocated.
POLICY domain=domain1 metadata=imsm path=pci-0000:04:00.0-scsi-[01 ARRAY /dev/md/home UUID=9187a482:5dde19d9:eea3cc4a:d646ab8b
]* auto=part
action=include # The name of this array contains a space.
# One domain comprising of devices attached to specified paths is ARRAY /dev/md9 name='Data Storage'
defined.
# Bare device matching first path will be made an imsm spare on ho POLICY domain=domain1 metadata=imsm path=pci-0000:00:1f.2-scsi-*
t plug. action=spare
# If more than one array is created on devices belonging to domain POLICY domain=domain1 metadata=imsm path=pci-0000:04:00.0-scsi-[01]*
1 and action=include
# one of them becomes degraded, then any imsm spare matching any p # One domain comprising of devices attached to specified paths is defined
ath for .
# given domain name can be migrated. # Bare device matching first path will be made an imsm spare on hot plug.
MAILADDR root@mydomain.tld # If more than one array is created on devices belonging to domain1 and
PROGRAM /usr/sbin/handle-mdadm-events # one of them becomes degraded, then any imsm spare matching any path for
CREATE group=system mode=0640 auto=part-8 # given domain name can be migrated.
HOMEHOST <system> MAILADDR root@mydomain.tld
AUTO +1.x homehost -all PROGRAM /usr/sbin/handle-mdadm-events
SYSFS name=/dev/md/raid5 group_thread_cnt=4 sync_speed_max=1000000 CREATE group=system mode=0640 auto=part-8
SYSFS uuid=bead5eb6:31c17a27:da120ba2:7dfda40d group_thread_cnt=4 HOMEHOST <system>
sync_speed_max=1000000 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. 16 change blocks. 
96 lines changed or deleted 97 lines changed or added

Home  |  About  |  Features  |  All  |  Newest  |  Dox  |  Diffs  |  RSS Feeds  |  Screenshots  |  Comments  |  Imprint  |  Privacy  |  HTTP(S)