89c7500311
This commit documents the information on enabling and configuring iLO driver(s). Change-Id: I596b1c5631438bed783bf94df1fa92190b9ba0fd
79 lines
2.3 KiB
ReStructuredText
79 lines
2.3 KiB
ReStructuredText
.. _drivers:
|
|
|
|
=================
|
|
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
|
|
----------
|
|
|
|
.. toctree::
|
|
:maxdepth: 1
|
|
|
|
../drivers/ilo
|