openstack/ironic
Code Issues Proposed changes

Update iRMC document for classic driver deprecation

Browse Source 
As a part of deprecating classic drivers, this patch updates the
documentation of iRMC driver. We still mention the classic drivers with
warning. The description for the classic drivers will be removed in
Rocky.

Change-Id: I6331072b44bf33c6bfa75703bf2ab46dac96a5e7
Related-Bug: #1690185
This commit is contained in:
Hironori Shiina
2018-02-06 16:47:26 +09:00
parent 12d3157a96
commit ffdfa5eb53
1 changed files with 132 additions and 66 deletions
Download Patch File Download Diff File Expand all files Collapse all files

198
doc/source/admin/drivers/irmc.rst
View File

@@ -8,17 +8,9 @@ Overview
======== ========
The iRMC driver enables control FUJITSU PRIMERGY via ServerView The iRMC driver enables control FUJITSU PRIMERGY via ServerView
Common Command Interface (SCCI). Common Command Interface (SCCI). Support for FUJITSU PRIMERGY servers consists
of the ``irmc`` hardware type and a few hardware interfaces specific for that
Support for FUJITSU PRIMERGY servers consists of the ``irmc`` hardware hardware type.
type, along with three classic drivers that were instituted before the
implementation of the functionality enabling the hardware type.
The classic drivers are:
* ``pxe_irmc``
* ``iscsi_irmc``
* ``agent_irmc``
Prerequisites Prerequisites
============= =============
@@ -31,11 +23,9 @@ Prerequisites
Hardware Type Hardware Type
============= =============
The ``irmc`` hardware type is introduced to support the new Ironic driver The ``irmc`` hardware type is available for FUJITSU PRIMERGY servers. For
model. It is recommended to use ``irmc`` hardware type for FUJITSU PRIMERGY information on how to enable the ``irmc`` hardware type, see
hardware instead of the classic drivers. :ref:`enable-hardware-types`.
For how to enable ``irmc`` hardware type, see :ref:`enable-hardware-types`.
Hardware interfaces Hardware interfaces
^^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^^
@@ -45,14 +35,15 @@ hardware interfaces:
* boot * boot
Supports ``irmc-virtual-media``, ``irmc-pxe``, and ``pxe``. Supports ``irmc-virtual-media``, ``irmc-pxe``, and ``pxe``.
The default is ``irmc-virtual-media``. The default is ``irmc-virtual-media``. The ``irmc-virtual-media`` boot
interface enables the virtual media based deploy with IPA (Ironic Python
Agent).
.. warning:: .. warning::
We deprecated the ``pxe`` boot interface when used with ``irmc`` We deprecated the ``pxe`` boot interface when used with ``irmc``
hardware type. Support for this interface will be removed in the hardware type. Support for this interface will be removed in the
future. Instead, use ``irmc-pxe``. ``irmc-pxe`` boot interface future. Instead, use ``irmc-pxe``. ``irmc-pxe`` boot interface
was introduced in Pike and is used in the ``pxe_irmc`` classic was introduced in Pike.
driver.
* console * console
Supports ``ipmitool-socat``, ``ipmitool-shellinabox``, and ``no-console``. Supports ``ipmitool-socat``, ``ipmitool-shellinabox``, and ``no-console``.
@@ -62,16 +53,17 @@ hardware interfaces:
Supports ``irmc``, ``inspector``, and ``no-inspect``. Supports ``irmc``, ``inspector``, and ``no-inspect``.
The default is ``irmc``. The default is ``irmc``.
.. note:: .. note::
`Ironic Inspector <https://docs.openstack.org/ironic-inspector/latest/>`_ `Ironic Inspector <https://docs.openstack.org/ironic-inspector/latest/>`_
needs to be present and configured to use ``inspector`` as the needs to be present and configured to use ``inspector`` as the
inspect interface. inspect interface.
* management * management
Supports only ``irmc``. Supports only ``irmc``.
* power * power
Supports only ``irmc``. Supports only ``irmc``, which enables power control via ServerView Common
Command Interface (SCCI).
For other hardware interfaces, ``irmc`` hardware type supports the For other hardware interfaces, ``irmc`` hardware type supports the
Bare Metal reference interfaces. For more details about the hardware Bare Metal reference interfaces. For more details about the hardware
@@ -106,8 +98,84 @@ Here is a command example to enroll a node with ``irmc`` hardware type.
--deploy-interface direct \ --deploy-interface direct \
--inspect-interface irmc --inspect-interface irmc
Node configuration
^^^^^^^^^^^^^^^^^^
* Each node is configured for ``irmc`` hardware type by setting the following
ironic node object’s properties:
- ``driver_info/irmc_address`` property to be ``IP address`` or
``hostname`` of the iRMC.
- ``driver_info/irmc_username`` property to be ``username`` for
the iRMC with administrator privileges.
- ``driver_info/irmc_password`` property to be ``password`` for
irmc_username.
- ``properties/capabilities`` property to be ``boot_mode:uefi`` if
UEFI boot is required.
- ``properties/capabilities`` property to be ``secure_boot:true`` if
UEFI Secure Boot is required. Please refer to `UEFI Secure Boot Support`_
for more information.
* The following properties are also required if ``irmc-virtual-media`` boot
interface is used:
- ``driver_info/irmc_deploy_iso`` property to be either deploy iso
file name, Glance UUID, or Image Service URL.
- ``instance info/irmc_boot_iso`` property to be either boot iso
file name, Glance UUID, or Image Service URL. This is optional
property when ``boot_option`` is set to ``netboot``.
* All of the nodes are configured by setting the following configuration
options in the ``[irmc]`` section of ``/etc/ironic/ironic.conf``:
- ``port``: Port to be used for iRMC operations; either 80
or 443. The default value is 443. Optional.
- ``auth_method``: Authentication method for iRMC operations;
either ``basic`` or ``digest``. The default value is ``basic``. Optional.
- ``client_timeout``: Timeout (in seconds) for iRMC
operations. The default value is 60. Optional.
- ``sensor_method``: Sensor data retrieval method; either
``ipmitool`` or ``scci``. The default value is ``ipmitool``. Optional.
* The following options are required if ``irmc-virtual-media`` boot
interface is enabled:
- ``remote_image_share_root``: Ironic conductor node's ``NFS`` or
``CIFS`` root path. The default value is ``/remote_image_share_root``.
- ``remote_image_server``: IP of remote image server.
- ``remote_image_share_type``: Share type of virtual media, either
``NFS`` or ``CIFS``. The default is ``CIFS``.
- ``remote_image_share_name``: share name of ``remote_image_server``.
The default value is ``share``.
- ``remote_image_user_name``: User name of ``remote_image_server``.
- ``remote_image_user_password``: Password of ``remote_image_user_name``.
- ``remote_image_user_domain``: Domain name of ``remote_image_user_name``.
* The following options are required if ``irmc`` inspect interface is enabled:
- ``snmp_version``: SNMP protocol version; either ``v1``, ``v2c`` or
``v3``. The default value is ``v2c``. Optional.
- ``snmp_port``: SNMP port. The default value is ``161``. Optional.
- ``snmp_community``: SNMP community required for versions ``v1``
and ``v2c``. The default value is ``public``. Optional.
- ``snmp_security``: SNMP security name required for version ``v3``.
Optional.
* Each node can be further configured by setting the following ironic
node object’s properties which override the parameter values in
``[irmc]`` section of ``/etc/ironic/ironic.conf``:
- ``driver_info/irmc_port`` property overrides ``port``.
- ``driver_info/irmc_auth_method`` property overrides ``auth_method``.
- ``driver_info/irmc_client_timeout`` property overrides ``client_timeout``.
- ``driver_info/irmc_sensor_method`` property overrides ``sensor_method``.
- ``driver_info/irmc_snmp_version`` property overrides ``snmp_version``.
- ``driver_info/irmc_snmp_port`` property overrides ``snmp_port``.
- ``driver_info/irmc_snmp_community`` property overrides ``snmp_community``.
- ``driver_info/irmc_snmp_security`` property overrides ``snmp_security``.
Upgrading to ``irmc`` hardware type Upgrading to ``irmc`` hardware type
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
When upgrading from a classic driver to the ``irmc`` hardware type, When upgrading from a classic driver to the ``irmc`` hardware type,
make sure you specify the hardware interfaces that are used by the make sure you specify the hardware interfaces that are used by the
@@ -115,8 +183,19 @@ classic driver. :doc:`/admin/upgrade-to-hardware-types` has more
information, including the hardware interfaces corresponding to information, including the hardware interfaces corresponding to
the classic drivers. the classic drivers.
Classic Drivers Classic Drivers (Deprecated)
=============== ============================
These are the classic drivers (deprecated) for FUJITSU PRIMERGY servers.
* ``pxe_irmc``
* ``iscsi_irmc``
* ``agent_irmc``
.. warning::
The classic drivers are deprecated in the Queens release and will be removed
in the Rocky release. The ``irmc`` hardware type should be used instead of
the classic drivers.
pxe_irmc driver pxe_irmc driver
^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^
@@ -218,12 +297,11 @@ Node configuration
- ``properties/capabilities`` property to be ``secure_boot:true`` if - ``properties/capabilities`` property to be ``secure_boot:true`` if
Secure Boot is required. Please refer to `UEFI Secure Boot Support`_ Secure Boot is required. Please refer to `UEFI Secure Boot Support`_
for more information. for more information.
- ``driver_info/irmc_deploy_iso`` property to be either ``deploy iso - ``driver_info/irmc_deploy_iso`` property to be either deploy iso
file name``, ``Glance UUID``, ``Glance URL`` or ``Image Service file name, Glance UUID, or Image Service URL.
URL``. - ``instance info/irmc_boot_iso`` property to be either boot iso
- ``instance info/irmc_boot_iso`` property to be either ``boot iso file name, Glance UUID, or Image Service URL. This is optional
file name``, ``Glance UUID``, ``Glance URL`` or ``Image Service property when ``boot_option`` is set to ``netboot``.
URL``. This is optional property for ``netboot``.
* All of nodes are configured by setting the following configuration * All of nodes are configured by setting the following configuration
options in ``[irmc]`` section of ``/etc/ironic/ironic.conf``: options in ``[irmc]`` section of ``/etc/ironic/ironic.conf``:
@@ -303,9 +381,11 @@ Node configuration
- ``properties/capabilities`` property to be ``secure_boot:true`` if - ``properties/capabilities`` property to be ``secure_boot:true`` if
Secure Boot is required. Please refer to `UEFI Secure Boot Support`_ Secure Boot is required. Please refer to `UEFI Secure Boot Support`_
for more information. for more information.
- ``driver_info/irmc_deploy_iso`` property to be either ``deploy iso - ``driver_info/irmc_deploy_iso`` property to be either deploy iso
file name``, ``Glance UUID``, ``Glance URL`` or ``Image Service file name, Glance UUID, or Image Service URL.
URL``. - ``instance info/irmc_boot_iso`` property to be either boot iso
file name, Glance UUID, or Image Service URL. This is optional
property when ``boot_option`` is set to ``netboot``.
* All of nodes are configured by setting the following configuration * All of nodes are configured by setting the following configuration
options in ``[irmc]`` section of ``/etc/ironic/ironic.conf``: options in ``[irmc]`` section of ``/etc/ironic/ironic.conf``:
@@ -352,12 +432,13 @@ Node configuration
- ``driver_info/irmc_snmp_community`` property overrides ``snmp_community``. - ``driver_info/irmc_snmp_community`` property overrides ``snmp_community``.
- ``driver_info/irmc_snmp_security`` property overrides ``snmp_security``. - ``driver_info/irmc_snmp_security`` property overrides ``snmp_security``.
Functionalities across drivers Optional functionalities for the ``irmc`` hardware type
============================== =======================================================
UEFI Secure Boot Support UEFI Secure Boot Support
^^^^^^^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^^^^^^^
The hardware type ``irmc`` and iRMC classic drivers support secure boot deploy. The hardware type ``irmc`` (and all iRMC classic drivers) supports secure boot
deploy.
.. warning:: .. warning::
Secure boot feature is not supported with ``pxe`` boot interface. Secure boot feature is not supported with ``pxe`` boot interface.
@@ -385,14 +466,8 @@ following sections describes both methods:
Node Cleaning Support Node Cleaning Support
^^^^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^^^^
The ``irmc`` hardware type and the following iRMC classic drivers support The ``irmc`` hardware type (and all iRMC classic drivers) supports node
node cleaning: cleaning. For more information on node cleaning, see :ref:`cleaning`.
* ``pxe_irmc``
* ``iscsi_irmc``
* ``agent_irmc``
For more information on node cleaning, see :ref:`cleaning`
Supported **Automated** Cleaning Operations Supported **Automated** Cleaning Operations
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -422,23 +497,18 @@ For more information on node automated cleaning, see :ref:`automated_cleaning`
Boot from Remote Volume Boot from Remote Volume
^^^^^^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^^^^^^
The iRMC driver supports the generic iPXE-based remote volume booting when The ``irmc`` hardware type (and ``pxe_irmc`` classic driver) supports the
using the ``pxe_irmc`` classic driver or the following boot interfaces with generic iPXE-based remote volume booting when using the following boot
the ``irmc`` hardware type: interfaces:
* ``irmc-pxe`` * ``irmc-pxe``
* ``pxe`` * ``pxe``
In addition, the iRMC driver also supports remote volume booting without iPXE. In addition, the ``irmc`` hardware type supports remote volume booting without
This is available when using the ``irmc-virtual-media`` boot interface with the iPXE. This is available when using the ``irmc-virtual-media`` boot interface
``irmc`` hardware type. It is also supported with the following classic (and ``iscsi_irmc`` and ``agent_irmc`` classic drivers). This feature
drivers: configures a node to boot from a remote volume by using the API of iRMC. It
supports iSCSI and FibreChannel.
* ``iscsi_irmc``
* ``agent_irmc``
This feature configures a node to boot from a remote volume by using the API of
iRMC. It supports iSCSI and FibreChannel.
Configuration Configuration
~~~~~~~~~~~~~ ~~~~~~~~~~~~~
@@ -494,12 +564,8 @@ Adapters supported by
Hardware Inspection Support Hardware Inspection Support
^^^^^^^^^^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^^^^^^^^^^
The ``irmc`` hardware type (only ``irmc`` inspect interface is supported) and The ``irmc`` hardware type (and all iRMC classic drivers) provides the
the following iRMC classic drivers support Hardware Inspection: iRMC-specific hardware inspection with ``irmc`` inspect interface.
* ``pxe_irmc``
* ``iscsi_irmc``
* ``agent_irmc``
.. note:: .. note::
SNMP requires being enabled in ServerView® iRMC S4 Web Server(Network SNMP requires being enabled in ServerView® iRMC S4 Web Server(Network