ansible.hpilo_boot(3) - Linux man page

Name

hpilo_boot - Boot system using specific media through HP iLO interface

Description

This module boots a system through its HP iLO interface. The boot media can be one of: cdrom, floppy, hdd, network or usb.

This module requires the hpilo python module.

Options

state The state of the boot media.no_boot: Do not boot from the deviceboot_once: Boot from the device once and then notthereafterboot_always: Boot from the device each time the serveris rebootedconnect: Connect the virtual media device and set to boot_alwaysdisconnect: Disconnects the virtual media device and set to no_bootpoweroff: Power off the server Choices: boot_always,boot_once,connect,disconnect,no_boot,poweroff. (default: boot_once) force Whether to force a reboot (even when the system is already booted).As a safeguard, without force, hpilo_boot will refuse to reboot a server that is already running. Choices: yes,no. media The boot media to boot the system from Choices: cdrom,floppy,hdd,network,normal,usb. (default: network) image The URL of a cdrom, floppy or usb boot media image. 'protocol://username:password@hostname:port/filename'protocol is either 'http' or 'https'username:password is optionalport is optional
password: The password to authenticate to the HP iLO interface. (default: admin)
host The HP iLO hostname/address that is linked to the physical system.(required) login The login name to authenticate to the HP iLO interface. (default: Administrator)."

Notes

To use a USB key image you need to specify floppy as boot media.

This module ought to be run from a system that can access the HP iLO interface directly, either by using local_action or using delegate_to.

Examples

- local_action: fail msg="CMDB serial ($cmdb_serialno) does not match hardware serial ($hw_system_serial) !"
  only_if: "'$cmdb_serialno' != '$hw_system_serial'"
- local_action: hpilo_boot host=$ilo_address login=$ilo_login password=$ilo_password media=cdrom image=$iso_url
  only_if: "'$cmdb_hwmodel'.startswith('HP ')"

local_action: hpilo_boot host=$ilo_address login=$ilo_login password=$ilo_password state=poweroff

Author

Dag Wieers