openstack/ironic
Code Issues Proposed changes
a31f3679b8
ironic/doc/source/drivers/iboot.rst
Lucas Alvares Gomes 0b778bba24 Add iBoot driver documentation 
The iBoot driver have been in tree for a long time but it never had any
documentation. This patch is adding one.

Change-Id: I5326911d2fec6bab042a3afe28a748793aa4d1f6
2015-06-25 09:37:15 +01:00

1.9 KiB
Raw Blame History

iBoot driver

Overview

The iBoot power driver enables you to take advantage of power cycle management of nodes using Dataprobe iBoot devices over the DxP protocol.

Drivers

pxe_iboot

Overview

The pxe_iboot driver uses iBoot to control the power state of the node, PXE/iPXE technology for booting and the iSCSI methodology for deploying the node.

Requirements

Tested platforms

  • iBoot-G2

Configuring and enabling the driver

  1. Add pxe_iboot to the list of enabled_drivers in /etc/ironic/ironic.conf. For example:

    [DEFAULT]
...
enabled_drivers = pxe_ipmitool,pxe_iboot

  2. Restart the Ironic conductor service:

    service ironic-conductor restart

Registering a node with the iBoot driver

Nodes configured for the iBoot driver should have the driver property set to pxe_iboot.

The following configuration values are also required in driver_info:

  • iboot_address: The IP address of the iBoot PDU.
  • iboot_username: User name used for authentication.
  • iboot_password: Password used for authentication.

In addition, there are optional properties in driver_info:

  • iboot_port: iBoot PDU port. Defaults to 9100.
  • iboot_relay_id: iBoot PDU relay ID. This option is useful in order to support multiple nodes attached to a single PDU. Defaults to 1.

The following sequence of commands can be used to enroll a node with the iBoot driver.

  1. Create node:

    ironic node-create -d pxe_iboot -i iboot_username=<username> -i iboot_password=<password> -i iboot_address=<address>

References