diff options
-rw-r--r-- | doc/source/admin/drivers.rst | 5 | ||||
-rw-r--r-- | doc/source/admin/drivers/idrac.rst | 69 | ||||
-rw-r--r-- | driver-requirements.txt | 2 |
3 files changed, 75 insertions, 1 deletions
diff --git a/doc/source/admin/drivers.rst b/doc/source/admin/drivers.rst index f6041bf3b..bd3e16bf5 100644 --- a/doc/source/admin/drivers.rst +++ b/doc/source/admin/drivers.rst @@ -32,6 +32,11 @@ IPMITool driver DRAC driver ----------- +.. toctree:: + :maxdepth: 1 + + drivers/idrac + DRAC with PXE deploy ^^^^^^^^^^^^^^^^^^^^ diff --git a/doc/source/admin/drivers/idrac.rst b/doc/source/admin/drivers/idrac.rst new file mode 100644 index 000000000..0033fb528 --- /dev/null +++ b/doc/source/admin/drivers/idrac.rst @@ -0,0 +1,69 @@ +============ +iDRAC driver +============ + +Overview +======== + +iDRAC_ hardware is supported by the ``idrac`` hardware type. It is also +supported by the standard ``ipmi`` hardware type, though with a smaller +feature set. + +.. TODO(dtantsur): supported hardware + +Enabling +======== + +The ``idrac`` hardware type requires the ``python-dracclient`` library to be +installed, for example:: + + sudo pip install 'python-dracclient>=1.3.0,<2.0.0' + +To enable the ``idrac`` hardware type, add the following to your +``/etc/ironic/ironic.conf``: + +.. code-block:: ini + + [DEFAULT] + enabled_hardware_types=idrac + enabled_management_interfaces=idrac + enabled_power_interfaces=idrac + +To enable all optional features (inspection, RAID and vendor passthru), use +the following configuration: + +.. code-block:: ini + + [DEFAULT] + enabled_hardware_types=idrac + enabled_inspect_interfaces=idrac + enabled_management_interfaces=idrac + enabled_power_interfaces=idrac + enabled_raid_interfaces=idrac + enabled_vendor_interfaces=idrac + +Enrolling +========= + +The following command will enroll a bare metal node with the ``idrac`` +hardware type:: + + openstack baremetal node create --driver idrac \ + --driver-info drac_address=http://drac.host \ + --driver-info drac_username=user \ + --driver-info drac_password=pa$$w0rd + +.. TODO(dtantsur): describe RAID support and inspection + +Known Issues +============ + +Nodes go into maintenance mode +------------------------------ + +After some period of time, nodes managed by the ``idrac`` hardware type may go +into maintenance mode in Ironic. This issue can be worked around by changing +the Ironic power state poll interval to 70 seconds. See +``[conductor]sync_power_state_interval`` in ``/etc/ironic/ironic.conf``. + +.. _iDRAC: http://www.dell.com/learn/us/en/15/solutions/integrated-dell-remote-access-controller-idrac diff --git a/driver-requirements.txt b/driver-requirements.txt index 356deba03..7784e468a 100644 --- a/driver-requirements.txt +++ b/driver-requirements.txt @@ -10,7 +10,7 @@ python-ironic-inspector-client>=1.5.0 python-oneviewclient<3.0.0,>=2.5.2 python-scciclient>=0.5.0 UcsSdk==0.8.2.2 -python-dracclient>=1.3.0 +python-dracclient>=1.3.0,<2.0.0 # The CIMC drivers use the Cisco IMC SDK version 0.7.2 or greater ImcSdk>=0.7.2 |