openstack/ironic
Code Issues Proposed changes
cb7dcca028
ironic/doc/source/deploy/drivers.rst
Chris Krelle 8a008c39ed Add IPA to enable drivers doc's page 
This adds IPA to the Enabling Drivers doc's page. It also corrects a
very minor formatting issue in the drac section.

Change-Id: I01df63fd6b5b20046e6507a624bd08ce3e3f0ab9
2015-03-30 16:28:21 -07:00

4.3 KiB
Raw Blame History

Enabling Drivers

Ironic-Python-Agent (agent)

To enable IPA add the appropriate Ironic agent driver to the enabled_drivers line of the ironic.conf file.

Several variants are currently supported, they are:
  • agent_ilo
  • agent_ipmitool
  • agent_pyghmi
  • agent_ssh
  • agent_vbox

Note

Starting with the Kilo release IPA ramdisk may also be used with Ironic PXE drivers.

For more information see the ironic-python-agent GitHub repo

DRAC

DRAC with PXE deploy

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

AMT

../drivers/amt

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 analogously to the SNMP community in early SNMP versions.

iLO driver

../drivers/ilo

SeaMicro driver

../drivers/seamicro

iRMC

The iRMC driver enables PXE Deploy to control power via ServerView Common Command Interface (SCCI).

Software Requirements

Enabling the iRMC Driver

  • Add pxe_irmc 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 iRMC with PXE Deploy by setting the Ironic node object's driver property to be pxe_irmc. Further configuration values are added to driver_info:

  • irmc_address: hostname or IP of iRMC
  • irmc_username: username for iRMC with administrator privileges
  • irmc_password: password for irmc_username
  • irmc_port: port number of iRMC (optional, either 80 or 443. defalut 443)
  • irmc_auth_method: authentication method for iRMC (optional, either 'basic' or 'digest'. default is 'basic')

Supported Platforms

This driver supports FUJITSU PRIMERGY BX S4 or RX S8 servers and above.

  • PRIMERGY BX920 S4
  • PRIMERGY BX924 S4
  • PRIMERGY RX300 S8

VirtualBox drivers

../drivers/vbox