diff --git a/doc/source/admin/drivers/ilo.rst b/doc/source/admin/drivers/ilo.rst index 0a4d59de92..cde615b2cb 100644 --- a/doc/source/admin/drivers/ilo.rst +++ b/doc/source/admin/drivers/ilo.rst @@ -10,16 +10,21 @@ iLO drivers enable to take advantage of features of iLO management engine in HPE ProLiant servers. iLO drivers are targeted for HPE ProLiant Gen 8 systems and above which have `iLO 4 management engine `_. -For more details, please refer the iLO driver document of Juno, Kilo and Liberty releases, -and for up-to-date information (like tested platforms, known issues, etc), please check the -`iLO driver wiki page `_. +For more details and for up-to-date information (like tested platforms, +known issues, etc), please check the `iLO driver wiki page `_. -Currently there are 3 iLO drivers: +ProLiant hardware is supported by the ``ilo`` hardware type and the following +classic drivers: * ``iscsi_ilo`` * ``agent_ilo`` * ``pxe_ilo`` +.. note:: + All HPE ProLiant servers support reference hardware type ``ipmi`` + (see :doc:`ipmitool`). HPE ProLiant Gen10 servers also support + hardware type ``redfish`` (see :doc:`redfish`). + The ``iscsi_ilo`` and ``agent_ilo`` drivers provide security enhanced PXE-less deployment by using iLO virtual media to boot up the bare metal node. These drivers send management info through the management channel and separate @@ -35,6 +40,134 @@ and local-boot of instance. and deploys from ironic conductor. Additionally it supports automatic setting of requested boot mode from nova. This driver doesn't require iLO Advanced license. +Hardware Interfaces +^^^^^^^^^^^^^^^^^^^ + +The ``ilo`` hardware type supports following hardware interfaces: + +* boot + ``ilo-virtual-media`` and ``ilo-pxe``. They can be enabled via the + ``enabled_boot_interfaces`` option: + + .. code-block:: ini + + [DEFAULT] + enabled_hardware_types = ilo + enabled_boot_interfaces = ilo-virtual-media,ilo-pxe + + .. note:: + ``ilo-virtual-media`` is the default ``boot`` interface for ``ilo`` + hardware type. + +* inspect + ``ilo`` and ``inspector``. They can be enabled via the + ``enabled_inspect_interfaces`` option: + + .. code-block:: ini + + [DEFAULT] + enabled_hardware_types = ilo + enabled_inspect_interfaces = ilo,inspector + + .. note:: + ``ilo`` is the default ``inspect`` interface for ``ilo`` + hardware type. `Ironic Inspector `_ + needs to be configured to use ``inspector`` as the inspect interface. + +* management + ``ilo``. It can be enabled via the + ``enabled_management_interfaces`` option: + + .. code-block:: ini + + [DEFAULT] + enabled_hardware_types = ilo + enabled_management_interfaces = ilo + +* power + ``ilo``. It can be enabled via the + ``enabled_power_interfaces`` option: + + .. code-block:: ini + + [DEFAULT] + enabled_hardware_types = ilo + enabled_power_interfaces = ilo + +The following command can be used to enroll a ProLiant node with +``ilo`` hardware type: + + .. code-block:: console + + openstack baremetal node create --os-baremetal-api-version=1.31 \ + --driver ilo \ + --deploy-interface direct \ + --raid-interface agent \ + --driver-info ilo_address= \ + --driver-info ilo_username= \ + --driver-info ilo_password= \ + --driver-info ilo_deploy_iso= + +Please refer to :doc:`/install/enabling-drivers` for detailed +explanation of hardware type. + +To enable the same feature set as provided by all iLO classic drivers, +apply the following configuration: + + .. code-block:: ini + + [DEFAULT] + enabled_hardware_types = ilo + enabled_boot_interfaces = ilo-virtual-media,ilo-pxe + enabled_power_interfaces = ilo + enabled_console_interfaces = ilo + enabled_raid_interfaces = agent + enabled_management_interfaces = ilo + enabled_inspect_interfaces = ilo + +The following commands can be used to enroll a node with the same +feature set as one of the classic drivers, but using the ``ilo`` +hardware type: + +* ``iscsi_ilo``: + + .. code-block:: console + + openstack baremetal node create --os-baremetal-api-version=1.31 \ + --driver ilo \ + --deploy-interface iscsi \ + --boot-interface ilo-virtual-media \ + --driver-info ilo_address= \ + --driver-info ilo_username= \ + --driver-info ilo_password= \ + --driver-info ilo_deploy_iso= + +* ``pxe_ilo``: + + .. code-block:: console + + openstack baremetal node create --os-baremetal-api-version=1.31 \ + --driver ilo \ + --deploy-interface iscsi \ + --boot-interface ilo-pxe \ + --driver-info ilo_address= \ + --driver-info ilo_username= \ + --driver-info ilo_password= \ + --driver-info deploy_kernel= \ + --driver-info deploy_ramdisk= + +* ``agent_ilo``: + + .. code-block:: console + + openstack baremetal node create --os-baremetal-api-version=1.31 \ + --driver ilo \ + --deploy-interface direct \ + --boot-interface ilo-virtual-media \ + --driver-info ilo_address= \ + --driver-info ilo_username= \ + --driver-info ilo_password= \ + --driver-info ilo_deploy_iso= Prerequisites =============