IPMITool driver

官网链接：

https://docs.openstack.org/ironic/latest/admin/drivers/ipmitool.html

IPMITool driver

概述
IPMI(Intelligent Platform Management Interface) drivers通过IPMI协议2.0或1.5来管理节点。使用IPMITool工具来控制使能的IPMI设备，这个工具是一个开源的命令行。
下面的hardware types和classic drivers使用IPMITool来进行电源和其他管理：
hardware types:
ipmi
classic drivers:
agent_ipmitool
pxe_ipmitool
agent_ipmitool_socat
pxe_ipmitool_socat

词汇表
IPMI - Intelligent Platform Management Interface.
IPMB - Intelligent Platform Management Bus/Bridge.
BMC - Baseboard Management Controller.
RMCP - Remote Management Control Protocol.

配置IPMItool driver(s)
1.ipmi hardware type在Ocata版本开始默认使能。为更准确的使能它，在你的ironic.conf配置文件中添加如下配置：
[DEFAULT]
enabled_hardware_types = ipmi
2. pxe_ipmitool classic driver默认使能。为了使能更多其他的IPMI classic drivers，添加需要的driver到ironic.conf文件的enabled_drivers配置项。下面使能了pxe_ipmitool和agent_ipmitool驱动：
[DEFAULT]
enabled_drivers = pxe_ipmitool,agent_ipmitool
3. 重起ironic conductor服务。
Please see Enabling drivers and hardware types for more details.

用IPMITool driver注册一个节点
要给节点配置IPMITool drivers，需要给节点的driver域设置成ipmi(hardware type)或者使用classic drivers中某种支持IPMITool的driver的名字
下面是需要的的配置值，来添加到节点的driver_info域：
ipmi_address: BMC的IP地址或者主机名
其他选项需要匹配到BMC的配置，下面的项是可选的，但是大多数情况下，设置上他们是个好的选择：
ipmi_username：访问BMC的用户名；默认是NULL用户。
ipmi_password：访问BMC的密码；默认是NULL。
ipmi_port：远程IPMI RMCP端口。默认ipmitool会使用端口623.
注意：高度推荐为你的BMC设置好用户名和密码。

openstack baremetal node create命令可以用来登记一个node，使用基于IPMITool的driver。例如：
openstack baremetal node create --driver ipmi \
--driver-info ipmi_address=<address> \
--driver-info ipmi_username=<username> \
--driver-info ipmi_password=<password>

高级配置
只提供了address、username和password的简单配置是不够的，IPMITool driver包含很多其他的配置项，可以用来指示特定的用法。
Single/Double bridging functionality
注意：IPMITool的版本要大于等于1.8.12才可以使用bridging功能。
基于IPMITool的drivers支持两种bridging功能：单桥和双桥。
要使桥可以使用，需要添加下面的配置项到节点的driver_info：
ipmi_bridging：桥的类型；默认值为no，其他支持的值有single和dual，分别为单桥和双桥。
ipmi_local_address：桥请求的本地IPMI地址
只有当ipmi_bridging设置为single或dual时才需要。这个配置项是可选的，如果没有指定，则由IPMITool自动发现。
ipmi_target_address：桥请求的目的地址。只有ipmi_bridging设置为single或者dual才需要。
ipmi_target_channel：桥请求的目的频道。只有ipmi_bridging设置为single或者dual
才需要。
双桥特定的配置项：
ipmi_transit_address：桥请求的传输地址。只有ipmi_bridging设置dual才需要。
ipmi_transit_channel：桥请求的传输频道。只有ipmi_bridging设置dual才需要。

参数ipmi_bridging需要指定桥需要的类型：single或dual，来访问裸机节点。如果参数没有知道你给，默认值会设置为no。

openstack baremetal node set命令可以用来设置登记的Ironic节点（使用了IPMITool driver）需要的桥的信息。例如：
单桥
openstack baremetal node set <UUID or name> \
--driver-info ipmi_local_address=<address> \
--driver-info ipmi_bridging=single \
--driver-info ipmi_target_channel=<channel> \
--driver-info ipmi_target_address=<target address>
双桥
openstack baremetal node set <UUID or name> \
--driver-info ipmi_local_address=<address> \
--driver-info ipmi_bridging=dual \
--driver-info ipmi_transit_channel=<transit channel> \
--driver-info ipmi_transit_address=<transit address> \
--driver-info ipmi_target_channel=<target channel> \
--driver-info ipmi_target_address=<target address>

修改IPMI协议的版本
基于IPMITool的drivers可以应用于2.0和1.5的IPMI协议版本。默认版本号为2.0.
为了修改裸机节点上IPMI协议版本，下面的选择需要设置到driver_info域：
ipmi_protocol_version：IPMI协议版本；默认是2.0，支持的值为1.5和2.0.
openstack baremetal node set命令可以用来设置想要的版本号：
openstack baremetal node set <UUID or name> --driver-info ipmi_protocol_version=<version>

警告：1.5版本的IPMI协议不支持加密。因此，高度推荐使用2.0版本。