Baseboard Management Controller module

Overview
Module Description
Setup
- Requirements
- Installation
Usage
Operating Systems Support
Development

Overview

This module configures the Remote Management System (Baseboard Management Controller) on Enterprise servers.

##Module Description

You can configure the BMC's LAN, LDAP and SSL certificates and manage the local users.

Can use IPMItool require at least version 1.8.18 or a server provider specific tool (ie. racadm) to do the actual communication with the BMC.

Setup

What this module affects: This module affect's configures the BMC controller.

Setup Requirements

PuppetLabs stdlib module
PuppetLabs apt module
Puppet version >= 4.0.x
Facter version >= 2.4.3

###Beginning with bmc To begin using the bmc module just include the bmc module and it will install ipmitools or 3rd party OEM sofware if it is on supported hardware.

  include bmc

If you don't have access to the internet you can manage if 3rd party repositores should be installed.

  class { 'bmc':
    manage_oem_repo => false,
  }

##Usage ###Simple user To setup a bmc_user with username 'simple' with password: password

  bmc_user { 'simple':
    password => 'password',
  }

###A more complex user A bmc user that only can use ipmi

  bmc_user { 'More complex':
    password => 'password',
    callin   => false,
    ipmi     => true,
    link     => false,
  }

###A very complex user A bmc user with administrator privilege on channel 2 and user privilege on channem 1.

  bmc_user { 'Very complex':
    password  => 'password',
    callin    => false,
    ipmi      => true,
    privilege => 
      {
        '1' => user,
        '2' => administrator,
      }
  }

###With access to iDRAC with admin rights

  bmc_user { 'idrac_admin':
    password => 'password',
    callin   => true,
    ipmi     => true,
    link     => true,
    idrac    => 0x1ff,
  }

There is no support for separate rules pr channel for a user yet. ###To change the SSL certificate

  bmc_ssl { 'IDRAC ssl':
    certificate_file => '/etc/ssl/private/idrac.pem',
    certificate_key  => '/etc/ssl/private/idrac.key',
    bmc_username     => 'root',
    bmc_password     => '<idrac_root_password>',
    bmc_server_host  => '192.168.0.2',
  }

###A normal setup would be

  bmc_user { 'root':
    password => 'mypassword',
  }
  
  bmc_ssl { 'IDRAC ssl':
    certificate_file => '/etc/ssl/private/idrac.pem',
    certificate_key  => '/etc/ssl/private/idrac.key',
    password         => 'mypassword',
    require          => Bmc_user['root'],
  }

###To configure the NIC to use DHCP

  bmc_network { 'bmc_network':
  }

###To configure a static NIC setup

  bmc_network { 'bmc_network':
    ipsrc   => static,
    ipaddr  => '192.168.0.2',
    gateway => '10.235.70.254',
    netmask => '255.255.255.0',
  }

if bmc_server_host is not set it ask ipmitool lan print It only support racadm7

###To configure LDAP

  bmc_ldap{'iDrac_ldap' :
    server  => 'ldap.example.com',
    base_dn => 'CN=users,CN=accounts,DC=example,DC=com',
  }

###To configure LDAP groups

  bmc_ldap_group{'1' :
    server  => 'ldap.example.com',
    base_dn => 'CN=users,CN=accounts,DC=example,DC=com',
  }

##Operating Systems Support

This is tested on these OS:

Ubuntu 14.04
Centos 7.4

##Development To develop (and test) providers we need access to as many and divert BMC's as possible. So if you have access to a server from HP, Dell, Intel, IBM, Oracle(SUN) where you will provide us admin rights for both BMC and OS please contact us.

ltning/bmc

Baseboard Management Controller module

Table of Contents

Overview

Setup

Setup Requirements