ironic/doc/source/drivers/iboot.rst
Dan Prince 030304d7c2 Add agent_iboot entrypoint
This patch adds a new driver combination/entrypoint so that
the Iboot power driver can be used with an IPA agent
based deployment workflow.

Change-Id: I677e60a333ec65cbd2852270fb091f17428e5e36
Closes-bug: #1514439
2015-11-10 09:30:53 +00:00

2.1 KiB

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

There are two iboot drivers:

  • 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.
  • The agent_iboot driver uses iBoot to control the power state of the node, PXE/iPXE technology for booting and the Ironic Python Agent for deploying an image to the node.

Requirements

Tested platforms

  • iBoot-G2

Configuring and enabling the driver

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

    [DEFAULT]
    ...
    enabled_drivers = pxe_iboot,agent_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 or agent_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