3.3 KiB
Wake-On-Lan driver
Overview
Wake-On-Lan is a standard that allows a computer to be powered on by a network message. This is widely available and doesn't require any fancy hardware to work with1.
The Wake-On-Lan driver is a testing driver not meant for production. And useful for users that wants to try Ironic with real bare metal instead of virtual machines.
It's important to note that Wake-On-Lan is only capable of powering on the machine. When power off is called the driver won't take any action and will just log a message, the power off require manual intervention to be performed.
Also, since Wake-On-Lan does not offer any means to determine the current power state of the machine, the driver relies on the power state set in the Ironic database. Any calls to the API to get the power state of the node will return the value from the Ironic's database.
Requirements
- Wake-On-Lan should be enabled in the BIOS
Configuring and Enabling
Add
staging-wol
to the list ofenabled_hardware_types
in /etc/ironic/ironic.conf. Also enable thestaging-wol
power interface and thefake
management interface. For example:[DEFAULT] enabled_hardware_types = staging-wol,ipmi enabled_management_interfaces = fake,ipmitool enabled_power_interfaces = staging-wol,ipmitool
Restart the Ironic conductor service:
service ironic-conductor restart
Registering a node
Nodes configured for Wake-On-Lan driver should have the
driver
property set to staging-wol
.
The node should have at least one port registered with it because the Wake-On-Lan driver will use the MAC address of the ports to create the magic packet2.
The following configuration values are optional and can be added to
the node's driver_info
as needed to match the network
configuration:
wol_host
: The broadcast IP address; defaults to 255.255.255.255.wol_port
: The destination port; defaults to 9.
Note
Say the ironic-conductor
is connected to more than one
network and the node you are trying to wake up is in the
192.0.2.0/24
range. The wol_host
configuration
should be set to 192.0.2.255 (the broadcast IP) so the
packets will get routed correctly.
The following sequence of commands can be used to enroll a node with the Wake-On-Lan driver.
Create node:
openstack baremetal node create --driver staging-wol \ --driver-info wol_host=<broadcast ip> \ --driver-info wol_port=<destination port>
The above command ironic node-create
will return UUID of
the node, which is the value of $NODE in the following
command.
Associate port with the node created:
openstack baremetal port create --node $NODE <MAC address>
Additional requirements
- Boot device order should be set to "PXE, DISK" in the BIOS setup
- BIOS must try next boot device if PXE boot failed
- Cleaning should be disabled, see3.
- Node should be powered off before start of deploy
References
Wake-On-Lan - https://en.wikipedia.org/wiki/Wake-on-LAN↩︎
Magic packet - https://en.wikipedia.org/wiki/Wake-on-LAN#Sending_the_magic_packet↩︎
Ironic node cleaning - https://docs.openstack.org/ironic/latest/admin/cleaning.html↩︎