openstack/ironic
Code Issues Proposed changes
b272e61218
ironic/doc/source/deploy/drivers.rst
Stig Telfer 8a6b72030c Adds SNMP power driver 
Add a new PowerDriver module for remote control of node power by
enabling or disabling sockets on a rack power strip via SNMP.

Implements: blueprint ironic-snmp-power-driver
Change-Id: Ib16781eaa9737525c4d8a9231ecd9e72d7e2645e
Co-authored-by: David Hewson <dhewson@cray.com>
Co-authored-by: Mark Goddard <mgoddard@cray.com>
2014-09-03 15:25:07 +01:00

2.2 KiB
Raw Blame History

Enabling Drivers

DRAC

DRAC with PXE deploy

  • Add pxe_drac to the list of enabled_drivers in /etc/ironic/ironic.conf
  • Install openwsman-python package

SNMP

The SNMP power driver enables control of power distribution units of the type frequently found in data centre racks. PDUs frequently have a management ethernet interface and SNMP support enabling control of the power outlets.

The SNMP power driver works with the PXE driver for network deployment and network-configured boot.

Supported PDUs

  • American Power Conversion (APC)
  • CyberPower (implemented according to MIB spec but not tested on hardware)
  • EatonPower (implemented according to MIB spec but not tested on hardware)
  • Teltronix

Software Requirements

- The PySNMP package must be installed, variously referred to as pysnmp or python-pysnmp

Enabling the SNMP Power Driver

  • Add pxe_snmp to the list of enabled_drivers in /etc/ironic/ironic.conf
  • Ironic Conductor must be restarted for the new driver to be loaded.

Ironic Node Configuration

Nodes are configured for SNMP control by setting the Ironic node object's driver property to be pxe_snmp. Further configuration values are added to driver_info:

  • snmp_address: the IPv4 address of the PDU controlling this node.

- snmp_port: (optional) A non-standard UDP port to use for SNMP operations. If not specified, the default port (161) is used. - snmp_outlet: The power outlet on the PDU (1-based indexing). - snmp_protocol: (optional) SNMP protocol version (permitted values 1, 2c or 3). If not specified, SNMPv1 is chosen. - snmp_community: (Required for SNMPv1 and SNMPv2c) SNMP community parameter for reads and writes to the PDU. - snmp_security: (Required for SNMPv3) SNMP security string.

PDU Configuration

This version of the SNMP power driver does not support handling PDU authentication credentials. When using SNMPv3, the PDU must be configured for NoAuthentication and NoEncryption. The security name is used analagously to the SNMP community in early SNMP versions.