community.general.ipmi_boot – Management of order of boot devices
Note
This plugin is part of the community.general collection (version 3.8.3).
You might already have this collection installed if you are using the ansible
package.
It is not included in ansible-core
.
To check whether it is installed, run ansible-galaxy collection list
.
To install it, use: ansible-galaxy collection install community.general
.
To use it in a playbook, specify: community.general.ipmi_boot
.
Requirements
The below requirements are needed on the host that executes this module.
python >= 2.6
pyghmi
Parameters
Parameter |
Comments |
---|---|
Set boot device to use on next reboot The choices for the device are: - network – Request network boot - floppy – Boot from floppy - hd – Boot from hard drive - safe – Boot from hard drive, requesting ‘safe mode’ - optical – boot from CD/DVD/BD drive - setup – Boot into setup utility - default – remove any IPMI directed boot device request Choices:
|
|
Hostname or ip address of the BMC. |
|
Password to connect to the BMC. |
|
If set, ask that system firmware uses this device beyond next boot. Be aware many systems do not honor this. Choices:
|
|
Remote RMCP port. Default: 623 |
|
Whether to ensure that boot devices is desired. The choices for the state are: - present – Request system turn on - absent – Request system turn on Choices:
|
|
If set, request UEFI boot explicitly. Strictly speaking, the spec suggests that if not set, the system should BIOS boot and offers no “don’t care” option. In practice, this flag not being set does not preclude UEFI boot on any system I’ve encountered. Choices:
|
|
Username to use to connect to the BMC. |
Examples
- name: Ensure bootdevice is HD
community.general.ipmi_boot:
name: test.testdomain.com
user: admin
password: password
bootdev: hd
- name: Ensure bootdevice is not Network
community.general.ipmi_boot:
name: test.testdomain.com
user: admin
password: password
bootdev: network
state: absent
Return Values
Common return values are documented here, the following are the fields unique to this module:
Key |
Description |
---|---|
The boot device name which will be used beyond next boot. Returned: success Sample: “default” |
|
If True, system firmware will use this device beyond next boot. Returned: success Sample: false |
|
If True, system firmware will use UEFI boot explicitly beyond next boot. Returned: success Sample: false |
Authors
Bulat Gaifullin (@bgaifullin) <gaifullinbf@gmail.com>