diff options
author | Dmitry Tantsur <divius.inside@gmail.com> | 2017-10-11 15:32:07 +0200 |
---|---|---|
committer | Dmitry Tantsur <divius.inside@gmail.com> | 2017-10-20 11:34:46 +0200 |
commit | 1b5f380daa2e0d8cdb91376f44ac2edd3148f58c (patch) | |
tree | f7be81c81c03cd05adc6d09da2c451cafbe9a1e6 | |
parent | 871803504dcbbbba6fb60668fb7cebdc546655e4 (diff) | |
download | ironic-1b5f380daa2e0d8cdb91376f44ac2edd3148f58c.tar.gz |
Finish the guide on upgrading to hardware types
This change adds missing information about the iDrac, CIMC and UCSM drivers,
as well as socat variants of the ipmitool drivers. Added a column for
the inspect interface. The resulting table is sorted by the classic
driver name to reflect how people are likely to use it.
Change-Id: I645c0a2a33dedecce37796a7eef7480dceef262a
(cherry picked from commit 87e142f6cee53c65c21fd2b797547f3e93886005)
-rw-r--r-- | doc/source/admin/upgrade-to-hardware-types.rst | 63 |
1 files changed, 38 insertions, 25 deletions
diff --git a/doc/source/admin/upgrade-to-hardware-types.rst b/doc/source/admin/upgrade-to-hardware-types.rst index 9adcd55d3..7a5d401fa 100644 --- a/doc/source/admin/upgrade-to-hardware-types.rst +++ b/doc/source/admin/upgrade-to-hardware-types.rst @@ -10,34 +10,47 @@ Planning the upgrade -------------------- It is necessary to figure out which hardware types and hardware interfaces -correspond to which classic drivers used in your deployment. -Use the following table: - -================== ============= ==================== ============== ========== ========= - Classic Driver Hardware Type Boot Deploy Management Power -================== ============= ==================== ============== ========== ========= -pxe_ilo ilo ilo-pxe iscsi ilo ilo -agent_ilo ilo ilo-virtual-media direct ilo ilo -iscsi_ilo ilo ilo-virtual-media iscsi ilo ilo -pxe_ipmitool ipmi pxe iscsi ipmitool ipmitool -agent_ipmitool ipmi pxe direct ipmitool ipmitool -pxe_irmc irmc irmc-pxe iscsi irmc irmc -iscsi_irmc irmc irmc-virtual-media iscsi irmc irmc -agent_irmc irmc irmc-virtual-media direct irmc irmc -agent_pxe_oneview oneview pxe oneview-direct oneview oneview -iscsi_pxe_oneview oneview pxe oneview-iscsi oneview oneview -pxe_snmp snmp pxe iscsi fake snmp -================== ============= ==================== ============== ========== ========= - -.. TODO(dtantsur): finish this table +correspond to which classic drivers used in your deployment. The following +table lists the classic drivers with their corresponding hardware types and +the boot, deploy, inspect, management, and power hardware interfaces: + +===================== ==================== ==================== ============== ========== ========== ========= + Classic Driver Hardware Type Boot Deploy Inspect Management Power +===================== ==================== ==================== ============== ========== ========== ========= +agent_ilo ilo ilo-virtual-media direct ilo ilo ilo +agent_ipmitool ipmi pxe direct inspector ipmitool ipmitool +agent_ipmitool_socat ipmi pxe direct inspector ipmitool ipmitool +agent_irmc irmc irmc-virtual-media direct irmc irmc irmc +agent_pxe_oneview oneview pxe oneview-direct oneview oneview oneview +agent_ucs cisco-ucs-managed pxe direct inspector ucsm ucsm +iscsi_ilo ilo ilo-virtual-media iscsi ilo ilo ilo +iscsi_irmc irmc irmc-virtual-media iscsi irmc irmc irmc +iscsi_pxe_oneview oneview pxe oneview-iscsi oneview oneview oneview +pxe_agent_cimc cisco-ucs-standalone pxe direct inspector cimc cimc +pxe_drac idrac pxe iscsi idrac idrac idrac +pxe_drac_inspector idrac pxe iscsi inspector idrac idrac +pxe_ilo ilo ilo-pxe iscsi ilo ilo ilo +pxe_ipmitool ipmi pxe iscsi inspector ipmitool ipmitool +pxe_ipmitool_socat ipmi pxe iscsi inspector ipmitool ipmitool +pxe_iscsi_cimc cisco-ucs-standalone pxe iscsi inspector cimc cimc +pxe_irmc irmc irmc-pxe iscsi irmc irmc irmc +pxe_snmp snmp pxe iscsi no-inspect fake snmp +pxe_ucs cisco-ucs-managed pxe iscsi inspector ucsm ucsm +===================== ==================== ==================== ============== ========== ========== ========= -.. warning:: - This table does not currently cover hardware interfaces other than - boot, deploy, management and power. +.. note:: + The ``inspector`` *inspect* interface was only used if + explicitly enabled in the configuration. Otherwise, ``no-inspect`` + was used. .. note:: - For out-of-tree drivers you may need to reach out to their maintainers or - figure out the appropriate interfaces by researching the source code. + ``pxe_ipmitool_socat`` and ``agent_ipmitool_socat`` use + ``ipmitool-socat`` *console* interface (the default for the ``ipmi`` + hardware type), while ``pxe_ipmitool`` and ``agent_ipmitool`` use + ``ipmitool-shellinabox``. See Console_ for details. + +For out-of-tree drivers you may need to reach out to their maintainers or +figure out the appropriate interfaces by researching the source code. Configuration ------------- |