Version information
This version is compatible with:
- Debian
Start using this module
Add this module to your Puppetfile:
mod 'gardouille-ipmi', '0.1.2'
Learn more about managing modules with a PuppetfileDocumentation
ipmi
Table of Contents
Overview
The ipmi module provide a simple way to install IPMI service on a machine. You also can configure user and device.
Module Description
The module install all needed packages and load the modules to be able to manage the BMC with a Debian family system.
Setup
What IPMI affects
- Package for IPMI
- Kernel modules at boot time
Beginning with IPMI
To begin using ipmi with default parameters, declare the main class with:
include ipmi
for upgrading, you may wish to include an additional section here: Upgrading (For an example, see http://forge.puppetlabs.com/puppetlabs/firewall).
Usage
Put the classes, types, and resources for customizing, configuring, and doing the fancy stuff with your module here.
Reference
Classes
ipmi
: Main class, load all subclasses to install and configure IPMI.
Defined types
ipmi::ressource::channel
: Manage IPMI's channel configuration (only lan right now).
ipmi::ressource::channel { '1':
ipaddr => '192.168.100.1',
netmask => '255.255.255.0',
}
ipmi::ressource::user
: Manage IPMI's user (can't create a new one):
ipmi::ressource::user { 'admin':
password => 'my_new_password',
}
Parameters
ipmi
pkg_ensure
: What to set the packages to. Can be 'present', 'absent' or 'version'. Defaults to 'present'.pkg_name
: The list of packages. Can be an array [ 'ipmitool', 'openipmi' ].modules_list
: The modules list to load at boot time.modules_file_path
: The configuration file will contain the modules list. Defaults to '/etc/modules-load.d/ipmi.conf'.modules_file_content
: Template file to use to generate the previous configuration file. Defaults to 'ipmi/ipmi_modules.conf.erb'.needed_module_name
: The module it's necessary to load one time to be able to use ipmi devices.
Limitations
This module will work only on Debian 7.x versions and maybe on Debian 8.x (to test).
Development
Free to send contributions, fork it, ...
License
WTFPL (http://wtfpl.org/)
0.1.2 - 2015/02/09
Minor release but it correct the possibility to disable a channel :)
Changes
- (#1) If the remote_access for a channel is set to 'off', the ressource disable it.
0.1.1 - 2015/01/20
Minor release to correct some mistakes.
Changes
- Edit dependencies range.
- Change optional parameter order for the ipmi::ressource::user
- Try to correct the Warning 'String containing only a variable'
0.1.0 - 2015/01/19
Inital release.
Changes
- Install package ipmitool
- Ensure needed modules load at boot time
- Load one needed module (for Debian) one time
- Update README.md file.
- Add a defined type to manage IPMI's user and channel.
- Add .gitignore for swp and puppet module's pkg files.
Dependencies
- puppetlabs/stdlib (4.x)