Files
ironic-staging-drivers/doc/source/drivers/iboot.rst
T
Lucas Alvares Gomes 6e8fc9fc4d Add iBoot driver
This patch is importing the iBoot driver and its documentation from
ironic to ironic-staging-driver.

Since we can't have duplicated entry points in setuptools we had to
rename the driver names as following:

pxe_iboot   -> pxe_iboot_iscsi
agent_iboot -> pxe_iboot_agent
fake_iboot  -> fake_iboot_fake

Change-Id: I2783b8e65408811858ffb00c372aa7ae269ad75b
2016-08-10 16:04:28 +01: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_iscsi 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 pxe_iboot_agent 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_iscsi and/or pxe_iboot_agent to the list of enabled_drivers in /etc/ironic/ironic.conf. For example:

    [DEFAULT]
    ...
    enabled_drivers = pxe_iboot_iscsi,pxe_iboot_agent
  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_iscsi or pxe_iboot_agent.

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_iscsi -i iboot_username=<username> -i iboot_password=<password> -i iboot_address=<address>

References