Puppet mdadm Module
Table of Contents
Overview
Manages the mdadm util for Linux software RAID arrays
Description
This module installs the
mdadm
package for the management of Linux Software RAID arrays, and provides limited
configuration support. Specifically, this module does not presently provide
any support for the creation, modification, or removal of md arrays.
Management is limited to configuring monitoring of pre-existing md arrays,
and array health checks.
Usage
Examples
Simple
include ::mdadmSet mdmonitor email address
class { '::mdadm':
config_file_options => { 'mailaddr' => 'root' },
}Classes
mdadm
# defaults
class { '::mdadm':
config_file_manage => true,
config_file_options => {},
service_force => false,
service_ensure => 'running',
service_enable => true,
raid_check_manage => true
raid_check_options => {},
}config_file_manage
Bool defaults to true
Enables/disables management of the mdadm.conf configuration file.
config_file_options
Hash defaults to '{}'
Keyword/value pairs to be set in the mdadm.conf configuration file.
Currently, mailaddr is the only supported key. Example:
config_file_options => { 'mailaddr' => 'root' },service_force
Bool defaults to false
By default, the mdadm class will not attempt to start the mdmonitor service
unless the $::mdadm_arrays fact lists md arrays. If this parameter is set to true the class will always attempt to start the mdmonitor service.
service_ensure
String defaults to 'running'
Sets the state of the mdmonitor service. Valid strings are: 'running',
'stopped'
service_enable
Bool defaults to 'true'
Enables/disables the mdmonitor service on boot.
raid_check_manage
Bool defaults to true
Enables/disables management of the EL specific raid-check cron task.
raid_check_options
Hash defaults to '{}'
Keyword/value pairs to be set in the /etc/sysconfig/raid-check configuration
file. Example:
raid_check_options => {
'ENABLED' => 'yes',
'CHECK' => 'check',
'NICE' => 'low',
'CHECK_DEVS' => '/dev/md0 /dev/md1',
'REPAIR_DEVS' => '/dev/md0',
'SKIP_DEVS' => '/dev/md1',
'MAXCONCURRENT' => '2',
},Facts
mdadm
Path to the mdadm executable. Example:
/sbin/mdadm
mdadmversion
Version string of the mdadm executable. Example:
v3.2.3
mdadm_arrays
A listing of /dev/<foo> md devices. Example:
/dev/md0,/dev/md1
Limitations
Tested Platforms
- el6.x
- el5.x
Versioning
This module is versioned according to the Semantic Versioning 2.0.0 specification.
Support
Please log tickets and issues at github