Chapter 8. Bare metal drivers
You can configure bare metal nodes to use one of the drivers that are enabled in the Bare Metal Provisioning service. Each driver includes a provisioning method and a power management type. Some drivers require additional configuration. Each driver described in this section uses PXE for provisioning. Drivers are listed by their power management type.
You can add drivers by configuring the IronicEnabledHardwareTypes
parameter in your ironic.yaml
file. By default, ipmi
and redfish
are enabled.
For the full list of supported plug-ins and drivers, see Component, Plug-In, and Driver Support in Red Hat OpenStack Platform.
8.1. Intelligent Platform Management Interface (IPMI) power management driver
IPMI is an interface that provides out-of-band remote management features, including power management and server monitoring. To use this power management type, all Bare Metal Provisioning service nodes require an IPMI that is connected to the shared Bare Metal network. IPMI power manager driver uses the ipmitool
utility to remotely manage hardware. You can use the following driver_info
properties to configure the IPMI power manager driver for a node:
Property | Description | Equivalent ipmitool option |
---|---|---|
| (Mandatory) The IP address or hostname of the node. |
|
| The IPMI user name. |
|
|
The IPMI password. The password is written to a temporary file. You pass the filename to the |
|
| The hexadecimal Kg key for IPMIv2 authentication. |
|
| The remote IPMI RMCP port. |
|
| IPMI privilege level. Set to one of the following valid values:
|
|
| The version of the IPMI protocol. Set to one of the following valid values:
|
|
| The type of bridging. Use with nested chassis management controllers (CMCs). Set to one of the following valid values:
| n/a |
|
Destination channel for a bridged request. Required only if |
|
|
Destination address for a bridged request. Required only if |
|
|
Transit channel for a bridged request. Required only if |
|
|
Transit address for bridged request. Required only if |
|
|
Local IPMB address for bridged requests. Use only if |
|
|
Set to | n/a |
|
Set to | n/a |
| The IPMI cipher suite version to use on the node. Set to one of the following valid values:
| n/a |
8.2. Redfish
A standard RESTful API for IT infrastructure developed by the Distributed Management Task Force (DMTF). You can use the following driver_info
properties to configure the Bare Metal Provisioning serive (ironic) connection to Redfish:
Property | Description |
---|---|
|
(Mandatory) The IP address of the Redfish controller. The address must include the authority portion of the URL. If you do not include the scheme it defaults to |
|
The canonical path to the system resource the Redfish driver interacts with. The path must include the root service, version, and the unique path to the system within the same authority as the |
| The Redfish username. |
| The Redfish password. |
|
Either a Boolean value, a path to a CA_BUNDLE file, or a directory with certificates of trusted CAs. If you set this value to |
| The Redfish HTTP client authentication method. Set to one of the following valid values:
|
8.3. Dell Remote Access Controller (DRAC)
DRAC is an interface that provides out-of-band remote management features, including power management and server monitoring. To use this power management type, all Bare Metal Provisioning service nodes require a DRAC that is connected to the shared Bare Metal Provisioning network. Enable the idrac
driver, and set the following information in the driver_info
of the node:
-
drac_address
- The IP address of the DRAC NIC. -
drac_username
- The DRAC user name. -
drac_password
- The DRAC password. -
Optional:
drac_port
- The port to use for the WS-Management endpoint. The default is port443
. -
Optional:
drac_path
- The path to use for the WS-Management endpoint. The default path is/wsman
. -
Optional:
drac_protocol
- The protocol to use for the WS-Management endpoint. Valid values:http
,https
. The default protocol ishttps
.
8.4. Integrated Remote Management Controller (iRMC)
iRMC from Fujitsu is an interface that provides out-of-band remote management features including power management and server monitoring. To use this power management type on a Bare Metal Provisioning service node, the node requires an iRMC interface that is connected to the shared Bare Metal network. Enable the irmc
driver, and set the following information in the driver_info
of the node:
-
irmc_address
- The IP address of the iRMC interface NIC. -
irmc_username
- The iRMC user name. -
irmc_password
- The iRMC password.
To use IPMI to set the boot mode or SCCI to get sensor data, you must complete the following additional steps:
Enable the sensor method in the
ironic.conf
file:$ openstack-config --set /etc/ironic/ironic.conf \ irmc sensor_method METHOD
Replace METHOD with
scci
oripmitool
.If you enabled SCCI, install the
python-scciclient
package:# dnf install python-scciclient
Restart the Bare Metal conductor service:
# systemctl restart openstack-ironic-conductor.service
To use the iRMC driver, iRMC S4 or higher is required.
8.5. Integrated Lights-Out (iLO)
iLO from Hewlett-Packard is an interface that provides out-of-band remote management features including power management and server monitoring. To use this power management type, all Bare Metal nodes require an iLO interface that is connected to the shared Bare Metal network. Enable the ilo
driver, and set the following information in the driver_info
of the node:
-
ilo_address
- The IP address of the iLO interface NIC. -
ilo_username
- The iLO user name. -
ilo_password
- The iLO password.
You must also install the python-proliantutils
package and restart the Bare Metal conductor service:
# dnf install python-proliantutils # systemctl restart openstack-ironic-conductor.service