community.general.ilo_redfish_config module – Sets or updates configuration attributes on HPE iLO with Redfish OEM extensions

Note

This module is part of the community.general collection (version 10.7.5).

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.ilo_redfish_config.

New in community.general 4.2.0

Synopsis

  • Builds Redfish URIs locally and sends them to iLO to set or update a configuration attribute.

  • For use with HPE iLO operations that require Redfish OEM extensions.

Parameters

Parameter

Comments

attribute_name

string / required

Name of the attribute to be configured.

attribute_value

string

Value of the attribute to be configured.

auth_token

string

Security token for authenticating to iLO.

baseuri

string / required

Base URI of iLO.

ca_path

path

added in community.general 10.6.0

PEM formatted file that contains a CA certificate to be used for validation.

Only used if validate_certs=true.

category

string / required

Command category to execute on iLO.

Choices:

  • "Manager"

ciphers

list / elements=string

added in community.general 10.6.0

TLS/SSL Ciphers to use for the request.

When a list is provided, all ciphers are joined in order with :.

See the OpenSSL Cipher List Format for more details.

The available ciphers is dependent on the Python and OpenSSL/LibreSSL versions.

command

list / elements=string / required

List of commands to execute on iLO.

password

string

Password for authenticating to iLO.

timeout

integer

Timeout in seconds for HTTP requests to iLO.

Default: 10

username

string

Username for authenticating to iLO.

validate_certs

boolean

added in community.general 10.6.0

If false, TLS/SSL certificates will not be validated.

Set this to true to enable certificate checking. Should be used together with ca_path.

Choices:

  • false ← (default)

  • true

Attributes

Attribute

Support

Description

check_mode

Support: none

Can run in check_mode and return changed status prediction without modifying target.

diff_mode

Support: none

Will return details on what has changed (or possibly needs changing in check_mode), when in diff mode.

Examples

- name: Disable WINS Registration
  community.general.ilo_redfish_config:
    category: Manager
    command: SetWINSReg
    baseuri: 15.X.X.X
    username: Admin
    password: Testpass123
    attribute_name: WINSRegistration

- name: Set Time Zone
  community.general.ilo_redfish_config:
    category: Manager
    command: SetTimeZone
    baseuri: 15.X.X.X
    username: Admin
    password: Testpass123
    attribute_name: TimeZone
    attribute_value: Chennai

- name: Set NTP Servers
  community.general.ilo_redfish_config:
    category: Manager
    command: SetNTPServers
    baseuri: 15.X.X.X
    username: Admin
    password: Testpass123
    attribute_name: StaticNTPServers
    attribute_value: X.X.X.X

Return Values

Common return values are documented here, the following are the fields unique to this module:

Key

Description

msg

string

Message with action result or error description.

Returned: always

Sample: "Action was successful"

Authors

  • Bhavya B (@bhavya06)