diff options
author | mallikarjuna.kolagatla <mallikarjuna.reddy@hpe.com> | 2018-09-27 10:26:41 +0000 |
---|---|---|
committer | Mallikarjuna Reddy Kolagatla <mallikarjuna.reddy@hpe.com> | 2018-10-03 05:01:56 +0000 |
commit | 021e631950a853aab5751848d11af9dde2f5ced0 (patch) | |
tree | b5fc9ac376d50e7f55cce139999a5040a6bc6f4e | |
parent | 41670839f6016a5878f603c2b1b995e872bef01a (diff) | |
download | ironic-021e631950a853aab5751848d11af9dde2f5ced0.tar.gz |
Add admin documentation for rescue mode in iLO driver
Adding rescue mode documentation for admin user in iLO driver
Depends-on: I02776ba4028de3b93ba1bccec59601d28648fd0a
Change-Id: I43f6ea7a2a76e23fcfc9c0964abc29ae5d38a12b
(cherry picked from commit 3387c9c2bfeb17b8e02e4dbd09565b6d1de805ff)
-rw-r--r-- | doc/source/admin/drivers/ilo.rst | 35 |
1 files changed, 33 insertions, 2 deletions
diff --git a/doc/source/admin/drivers/ilo.rst b/doc/source/admin/drivers/ilo.rst index 53c75434b..b7c43ce2e 100644 --- a/doc/source/admin/drivers/ilo.rst +++ b/doc/source/admin/drivers/ilo.rst @@ -47,6 +47,7 @@ The hardware type ``ilo`` supports following HPE server features: * `Activating iLO Advanced license as manual clean step`_ * `Firmware based UEFI iSCSI boot from volume support`_ * `Certificate based validation in iLO`_ +* `Rescue mode support`_ Hardware interfaces ^^^^^^^^^^^^^^^^^^^ @@ -156,6 +157,17 @@ The ``ilo`` hardware type supports following hardware interfaces: Please refer to :doc:`/admin/boot-from-volume` for configuring ``cinder`` as a storage interface. +* rescue + Supports ``agent`` and ``no-rescue``. The default is ``no-rescue``. + They can be enabled by using the ``[DEFAULT]enabled_rescue_interfaces`` + option in ``ironic.conf`` as given below: + + .. code-block:: ini + + [DEFAULT] + enabled_hardware_types = ilo + enabled_rescue_interfaces = agent,no-rescue + ``ilo`` hardware type supports all standard ``deploy`` and ``network`` interface implementations, see :ref:`enable-hardware-interfaces` for details. @@ -164,14 +176,16 @@ The following command can be used to enroll a ProLiant node with .. code-block:: console - openstack baremetal node create --os-baremetal-api-version=1.31 \ + openstack baremetal node create --os-baremetal-api-version=1.38 \ --driver ilo \ --deploy-interface direct \ --raid-interface agent \ + --rescue-interface agent \ --driver-info ilo_address=<ilo-ip-address> \ --driver-info ilo_username=<ilo-username> \ --driver-info ilo_password=<ilo-password> \ - --driver-info ilo_deploy_iso=<glance-uuid-of-deploy-iso> + --driver-info ilo_deploy_iso=<glance-uuid-of-deploy-iso> \ + --driver-info ilo_rescue_iso=<glance-uuid-of-rescue-iso> Please refer to :doc:`/install/enabling-drivers` for detailed explanation of hardware type. @@ -201,12 +215,20 @@ Node configuration - ``instance info/ilo_boot_iso`` property to be either boot iso Glance UUID or a HTTP(S) URL. This is optional property and is used when ``boot_option`` is set to ``netboot``. + - ``ilo_rescue_iso``: The glance UUID of the rescue ISO image. This is optional + property and is used when ``rescue`` interface is set to ``agent``. * The following properties are also required in node object’s ``driver_info`` if ``ilo-pxe`` boot interface is used: - ``deploy_kernel``: The glance UUID or a HTTP(S) URL of the deployment kernel. - ``deploy_ramdisk``: The glance UUID or a HTTP(S) URL of the deployment ramdisk. + - ``rescue_kernel``: The glance UUID or a HTTP(S) URL of the rescue kernel. + This is optional property and is used when ``rescue`` interface is set to + ``agent``. + - ``rescue_ramdisk``: The glance UUID or a HTTP(S) URL of the rescue ramdisk. + This is optional property and is used when ``rescue`` interface is set to + ``agent``. * The following parameters are mandatory in ``driver_info`` if ``ilo-inspect`` inspect inteface is used and SNMPv3 inspection @@ -382,6 +404,7 @@ Enable driver enabled_raid_interfaces = agent enabled_management_interfaces = ilo enabled_inspect_interfaces = ilo + enabled_rescue_interfaces = agent 5. Restart the ironic conductor service:: @@ -1668,6 +1691,14 @@ generating Certificate Signing Request (CSR). Use the same value as `ilo_address` while enrolling node to Bare Metal service to avoid SSL certificate validation errors related to hostname mismatch. +Rescue mode support +^^^^^^^^^^^^^^^^^^^ +The hardware type ``ilo`` supports rescue functionality. Rescue operation can +be used to boot nodes into a rescue ramdisk so that the ``rescue`` user can +access the node. + +Please refer to :doc:`/admin/rescue` for detailed explanation of rescue +feature. .. _`ssacli documentation`: https://support.hpe.com/hpsc/doc/public/display?docId=c03909334 .. _`proliant-tools`: https://docs.openstack.org/diskimage-builder/latest/elements/proliant-tools/README.html |