megaraid
Version information
This version is compatible with:
- Puppet Enterprise 2017.2.x, 2016.4.x
- Puppet >= 4.10.0 < 5.0.0
- , , ,
Start using this module
Add this module to your Puppetfile:
mod 'm4ce-megaraid', '1.1.1'Learn more about managing modules with a PuppetfileDocumentation
Puppet types and providers for LSI MegaRAID
Table of Contents
- Overview
- Module Description - What the module does and why it is useful
- Setup - The basics of getting started with the megaraid module
- Reference - Types reference and additional functionalities
- Hiera integration
- Contact
Overview
This module implements native types and providers to manage some aspects of LSI MegaRAID devices.
Module Description
The megaraid module allows to automate the configuration of LSI MegaRAID devices. Currently, it only supports managing virtual disks.
Setup
The module requires the storcli package in order to manage MegaRAID volumes. An RPM version is available for download here.
A custom fact named 'has_megaraid' defines whether your system is equipped with one or more LSI MegaRAID devices.
You can use that fact to optionally include the megaraid class in your manifests as shown below:
if $::has_megaraid {
include megaraid
}
Reference
Types
megaraid_vd
megaraid_vd manages virtual disks using the StorCLI utility
megaraid_vd {"data":
controller => 0,
raid_type => 1,
drives => "1,2" # If the Enclosure ID is not given, the first one available will be picked (this will generate a warning message though)
}
name (required)
Name to describe the VD
vd_name
Virtual disk name, defaults to name
ensure (required)
Whether the resource is present or not. Valid values are 'present', 'absent'. Defaults to 'present'.
controller (required)
Controller Index, must be an Integer
raid_type (required)
RAID type. Valid values are: 0, 1, 5, 6, 10, 50, 60.
iopolicy
Logical drive cache policy. Valid values are: 'direct', 'cached'.
writepolicy
Write policy. Valid values are: 'wb', 'wt'.
accesspolicy
Access policy. Values values are: 'rw', 'ro', 'blocked', 'rmvblkd'.
readpolicy
Read policy. Values values are: 'ra', 'nora'.
drives (required)
Physical drives to use. Valid syntax is [e:]s|[e:]s-x|[e:]s-x,y,[e:]s-x,y,z
spares
Physical drives to be used as spares. Valid syntax is [e:]s|[e:]s-x|[e:]s-x,y,[e:]s-x,y,z
pdperarray
Number of physical drives per array. Must be an Integer between 0..15.
strip
Strip size. Valid values are: 8, 16, 32, 64, 128, 256, 512, 1024.
pdcache
Enables or disables PD cache. Valid values are: on, off, default.
sed
Creates security-enabled drives. Must be a Boolean.
pi
Enables protection information. Must be a Boolean.
dimmerswitch
Power-saving policy. Valid values are: automatic, none, max, maxnocache.
aftervd
Creates the VD in the adjacent free slot next to the specified VD.
force
Forces a security-capable physical drive to be added to a drive group without security. Must be a Boolean, default is false.
Hiera integration
You can optionally define your virtual disks in Hiera using the megaraid::virtual_disks class parameter.
---
megaraid::virtual_disks:
data1:
controller: 0
raid_type: 1
drives: 1,2
iopolicy: "direct"
writepolicy: "wb"
readpolicy: "ra"
data2:
controller: 0
raid_type: 10
drives: 3-6
strip: 512
Contact
Matteo Cerutti - matteo.cerutti@hotmail.co.uk
Dependencies
- puppetlabs/stdlib (>= 4.12.0 < 5.0.0)
Copyright 2015 Matteo Cerutti Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.