ironic/doc/source/deploy/drivers.rst
Harshada Mangesh Kakad 919e6744bf Add documentation for SeaMicro driver
This commit documents the information on enabling and
configuring SeaMicro driver.
Closes-Bug: #1394918

Change-Id: Ic65557638234bf4cbf404fc6ddf6c2e6288752e2
2014-12-02 06:36:43 -08:00

2.4 KiB

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.

iLO driver

../drivers/ilo

SeaMicro driver

../drivers/seamicro