Salt module to manage RAID arrays with mdadm
salt.modules.mdadm_raid.
add
(name, device)¶Add new device to RAID array.
CLI Example:
salt '*' raid.add /dev/md0 /dev/sda1
salt.modules.mdadm_raid.
assemble
(name, devices, test_mode=False, **kwargs)¶Assemble a RAID device.
CLI Examples:
salt '*' raid.assemble /dev/md0 ['/dev/xvdd', '/dev/xvde']
Note
Adding test_mode=True
as an argument will print out the mdadm
command that would have been run.
The name of the array to assemble.
The list of devices comprising the array to assemble.
Optional arguments to be passed to mdadm.
Prints out the full command.
Executes command on the host(s) and prints out the mdadm output.
For more info, read the mdadm
manpage.
salt.modules.mdadm_raid.
create
(name, level, devices, metadata='default', test_mode=False, **kwargs)¶Create a RAID device.
Changed in version 2014.7.0.
Warning
Use with CAUTION, as this function can be very destructive if not used properly!
CLI Examples:
salt '*' raid.create /dev/md0 level=1 chunk=256 devices="['/dev/xvdd', '/dev/xvde']" test_mode=True
Note
Adding test_mode=True
as an argument will print out the mdadm
command that would have been run.
The name of the array to create.
The RAID level to use when creating the raid.
A list of devices used to build the array.
Version of metadata to use when creating the array.
Optional arguments to be passed to mdadm.
Prints out the full command.
Executes command on remote the host(s) and Prints out the mdadm output.
Note
It takes time to create a RAID array. You can check the progress in "resync_status:" field of the results from the following command:
salt '*' raid.detail /dev/md0
For more info, read the mdadm(8)
manpage
salt.modules.mdadm_raid.
destroy
(device)¶Destroy a RAID device.
WARNING This will zero the superblock of all members of the RAID array..
CLI Example:
salt '*' raid.destroy /dev/md0
salt.modules.mdadm_raid.
detail
(device='/dev/md0')¶Show detail for a specified RAID device
CLI Example:
salt '*' raid.detail '/dev/md0'
salt.modules.mdadm_raid.
examine
(device, quiet=False)¶Show detail for a specified RAID component device
Device to examine, that is part of the RAID
If the device is not part of the RAID, do not show any error
CLI Example:
salt '*' raid.examine '/dev/sda1'
salt.modules.mdadm_raid.
list_
()¶List the RAID devices.
CLI Example:
salt '*' raid.list
salt.modules.mdadm_raid.
save_config
()¶Save RAID configuration to config file.
Same as: mdadm --detail --scan >> /etc/mdadm/mdadm.conf
Fixes this issue with Ubuntu REF: http://askubuntu.com/questions/209702/why-is-my-raid-dev-md1-showing-up-as-dev-md126-is-mdadm-conf-being-ignored
CLI Example:
salt '*' raid.save_config
salt.modules.mdadm_raid.
stop
()¶Shut down all arrays that can be shut down (i.e. are not currently in use).
CLI Example:
salt '*' raid.stop