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
2.1 KiB
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_iscsidriver 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_agentdriver 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
python-ibootlibrary should be installed - https://github.com/darkip/python-iboot
Tested platforms
- iBoot-G2
Configuring and enabling the driver
Add
pxe_iboot_iscsiand/orpxe_iboot_agentto the list ofenabled_driversin /etc/ironic/ironic.conf. For example:[DEFAULT] ... enabled_drivers = pxe_iboot_iscsi,pxe_iboot_agentRestart 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.
Create node:
ironic node-create -d pxe_iboot_iscsi -i iboot_username=<username> -i iboot_password=<password> -i iboot_address=<address>