On this page
hpilo_info – Gather information through an HP iLO interface
Synopsis
- This module gathers information on a specific system using its HP iLO interface. These information includes hardware and network related information useful for provisioning (e.g. macaddress, uuid).
- This module requires the
hpilo
python module. - This module was called
hpilo_facts
before Ansible 2.9, returningansible_facts
. Note that the hpilo_info module no longer returnsansible_facts
!
Aliases: hpilo_facts
Requirements
The below requirements are needed on the host that executes this module.
- hpilo
Parameters
Parameter | Choices/Defaults | Comments |
---|---|---|
host
- / required
|
The HP iLO hostname/address that is linked to the physical system.
|
|
login
-
|
Default:
"Administrator"
|
The login name to authenticate to the HP iLO interface.
|
password
-
|
Default:
"admin"
|
The password to authenticate to the HP iLO interface.
|
ssl_version
-
added in 2.4
|
|
Change the ssl_version used.
|
Notes
Note
- This module ought to be run from a system that can access the HP iLO interface directly, either by using
local_action
or usingdelegate_to
.
Examples
# Task to gather facts from a HP iLO interface only if the system is an HP server
- hpilo_info:
host: YOUR_ILO_ADDRESS
login: YOUR_ILO_LOGIN
password: YOUR_ILO_PASSWORD
when: cmdb_hwmodel.startswith('HP ')
delegate_to: localhost
register: results
- fail:
msg: 'CMDB serial ({{ cmdb_serialno }}) does not match hardware serial ({{ results.hw_system_serial }}) !'
when: cmdb_serialno != results.hw_system_serial
Return Values
Common return values are documented here, the following are the fields unique to this module:
Key | Returned | Description |
---|---|---|
hw_bios_date
string
|
always |
BIOS date
Sample:
05/05/2011
|
hw_bios_version
string
|
always |
BIOS version
Sample:
P68
|
hw_eth_ilo
dictionary
|
always |
Interface information (for the iLO network interface)
Sample:
[{'macaddress': '00:11:22:33:44:BA'}, {'macaddress_dash': '00-11-22-33-44-BA'}]
|
hw_ethX
dictionary
|
always |
Interface information (for each interface)
Sample:
[{'macaddress': '00:11:22:33:44:55', 'macaddress_dash': '00-11-22-33-44-55'}]
|
hw_product_name
string
|
always |
Product name
Sample:
ProLiant DL360 G7
|
hw_product_uuid
string
|
always |
Product UUID
Sample:
ef50bac8-2845-40ff-81d9-675315501dac
|
hw_system_serial
string
|
always |
System serial number
Sample:
ABC12345D6
|
hw_uuid
string
|
always |
Hardware UUID
Sample:
123456ABC78901D2
|
Status
- This module is not guaranteed to have a backwards compatible interface. [preview]
- This module is maintained by the Ansible Community. [community]
Authors
- Dag Wieers (@dagwieers)
Hint
If you notice any issues in this documentation, you can edit this document to improve it.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.9/modules/hpilo_info_module.html