dellemc.openmanage.idrac_boot module – Configure the boot order settings.

Note

This module is part of the dellemc.openmanage collection (version 9.8.0).

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 dellemc.openmanage. You need further requirements to be able to use this module, see Requirements for details.

To use it in a playbook, specify: dellemc.openmanage.idrac_boot.

New in dellemc.openmanage 6.1.0

Synopsis

  • This module allows to configure the boot order settings.

Requirements

The below requirements are needed on the host that executes this module.

  • python >= 3.9.6

Parameters

Parameter

Comments

boot_options

list / elements=dictionary

Options to enable or disable the boot devices.

This is mutually exclusive with boot_order, boot_source_override_mode, boot_source_override_enabled boot_source_override_target, and uefi_target_boot_source_override.

boot_option_reference

string

FQDD of the boot device.

This is mutually exclusive with display_name.

display_name

string

Display name of the boot source device.

This is mutually exclusive with boot_option_reference.

enabled

boolean / required

Enable or disable the boot device.

Choices:

  • false

  • true

boot_order

list / elements=string

This option allows to set the boot devices in the required boot order sequences.

This is mutually exclusive with boot_options.

boot_source_override_enabled

string

The state of the Boot Source Override feature.

disabled The system boots normally.

once The system boots (one time) to the boot_source_override_target.

continuous The system boots to the target specified in the boot_source_override_target until this property is set to Disabled.

The state is set to once for the one-time boot override and continuous for the remain-active-until—canceled override. If the state is set once or continuous, the value is reset to disabled after the boot_source_override_target actions have completed successfully.

Changes to this options do not alter the BIOS persistent boot order configuration.

This is mutually exclusive with boot_options.

Choices:

  • "continuous"

  • "disabled"

  • "once"

boot_source_override_mode

string

The BIOS boot mode (either Legacy or UEFI) to be used when boot_source_override_target boot source is booted from.

legacy The system boot in non-UEFI(Legacy) boot mode to the boot_source_override_target.

uefi The system boot in UEFI boot mode to the boot_source_override_target.

This is mutually exclusive with boot_options.

Choices:

  • "legacy"

  • "uefi"

boot_source_override_target

string

The boot source override target device to use during the next boot instead of the normal boot device.

pxe performs PXE boot from the primary NIC.

floppy, cd, hdd, sd_card performs boot from their devices respectively.

bios_setup performs boot into the native BIOS setup.

utilities performs boot from the local utilities.

uefi_target performs boot from the UEFI device path found in uefi_target_boot_source_override.

If the boot_source_override_target is set to a value other than none then the boot_source_override_enabled is automatically set to once.

Changes to this options do not alter the BIOS persistent boot order configuration.

This is mutually exclusive with boot_options.

Choices:

  • "uefi_http"

  • "sd_card"

  • "uefi_target"

  • "utilities"

  • "bios_setup"

  • "hdd"

  • "cd"

  • "floppy"

  • "pxe"

  • "none"

ca_path

path

added in dellemc.openmanage 5.0.0

The Privacy Enhanced Mail (PEM) file that contains a CA certificate to be used for the validation.

idrac_ip

string / required

iDRAC IP Address.

idrac_password

aliases: idrac_pwd

string

iDRAC user password.

If the password is not provided, then the environment variable IDRAC_PASSWORD is used.

Example: export IDRAC_PASSWORD=password

idrac_port

integer

iDRAC port.

Default: 443

idrac_user

string

iDRAC username.

If the username is not provided, then the environment variable IDRAC_USERNAME is used.

Example: export IDRAC_USERNAME=username

job_wait

boolean

Provides the option to wait for job completion.

This is applicable when reset_type is force_reset or graceful_reset.

Choices:

  • false

  • true ← (default)

job_wait_timeout

integer

The maximum wait time of job_wait in seconds. The job is tracked only for this duration.

This option is applicable when job_wait is true.

Default: 900

reset_type

string

none Host system is not rebooted and job_wait is not applicable.

force_restart Forcefully reboot the Host system.

graceful_restart Gracefully reboot the Host system.

Choices:

  • "graceful_restart" ← (default)

  • "force_restart"

  • "none"

resource_id

string

Redfish ID of the resource.

timeout

integer

added in dellemc.openmanage 5.0.0

The socket level timeout in seconds.

Default: 30

uefi_target_boot_source_override

string

The UEFI device path of the device from which to boot when boot_source_override_target is uefi_target.

boot_source_override_enabled cannot be set to c(continuous) if boot_source_override_target set to uefi_target because this settings is defined in UEFI as a one-time-boot setting.

Changes to this options do not alter the BIOS persistent boot order configuration.

This is required if boot_source_override_target is uefi_target.

This is mutually exclusive with boot_options.

validate_certs

boolean

added in dellemc.openmanage 5.0.0

If false, the SSL certificates will not be validated.

Configure false only on personally controlled sites where self-signed certificates are used.

Prior to collection version 5.0.0, the validate_certs is false by default.

Choices:

  • false

  • true ← (default)

x_auth_token

string

added in dellemc.openmanage 9.3.0

Authentication token.

If the x_auth_token is not provided, then the environment variable IDRAC_X_AUTH_TOKEN is used.

Example: export IDRAC_X_AUTH_TOKEN=x_auth_token

Notes

Note

  • Run this module from a system that has direct access to Dell iDRAC.

  • This module supports check_mode.

Examples

---
- name: Configure the system boot options settings.
  dellemc.openmanage.idrac_boot:
    idrac_ip: "192.168.0.1"
    idrac_user: "user_name"
    idrac_password: "user_password"
    ca_path: "/path/to/ca_cert.pem"
    boot_options:
      - display_name: Hard drive C
        enabled: true
      - boot_option_reference: NIC.PxeDevice.2-1
        enabled: true

- name: Configure the boot order settings.
  dellemc.openmanage.idrac_boot:
    idrac_ip: "192.168.0.1"
    idrac_user: "user_name"
    idrac_password: "user_password"
    ca_path: "/path/to/ca_cert.pem"
    boot_order:
      - Boot0001
      - Boot0002
      - Boot0004
      - Boot0003

- name: Configure the boot source override mode.
  dellemc.openmanage.idrac_boot:
    idrac_ip: "192.168.0.1"
    idrac_user: "user_name"
    idrac_password: "user_password"
    ca_path: "/path/to/ca_cert.pem"
    boot_source_override_mode: legacy
    boot_source_override_target: cd
    boot_source_override_enabled: once

- name: Configure the UEFI target settings.
  dellemc.openmanage.idrac_boot:
    idrac_ip: "192.168.0.1"
    idrac_user: "user_name"
    idrac_password: "user_password"
    ca_path: "/path/to/ca_cert.pem"
    boot_source_override_mode: uefi
    boot_source_override_target: uefi_target
    uefi_target_boot_source_override: "VenHw(3A191845-5F86-4E78-8FCE-C4CFF59F9DAA)"

- name: Configure the boot source override mode as pxe.
  dellemc.openmanage.idrac_boot:
    idrac_ip: "192.168.0.1"
    idrac_user: "user_name"
    idrac_password: "user_password"
    ca_path: "/path/to/ca_cert.pem"
    boot_source_override_mode: legacy
    boot_source_override_target: pxe
    boot_source_override_enabled: continuous

Return Values

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

Key

Description

boot

dictionary

Configured boot settings details.

Returned: success

Sample: {"BootOptions": {"Description": "Collection of BootOptions", "Members": [{"BootOptionEnabled": false, "BootOptionReference": "HardDisk.List.1-1", "Description": "Current settings of the Legacy Boot option", "DisplayName": "Hard drive C:", "Id": "HardDisk.List.1-1", "Name": "Legacy Boot option", "UefiDevicePath": "VenHw(D6C0639F-C705-4EB9-AA4F-5802D8823DE6)"}], "Name": "Boot Options Collection"}, "BootOrder": ["HardDisk.List.1-1"], "BootSourceOverrideEnabled": "Disabled", "BootSourceOverrideMode": "Legacy", "BootSourceOverrideTarget": "None", "UefiTargetBootSourceOverride": null}

error_info

dictionary

Details of the HTTP Error.

Returned: on HTTP error

Sample: {"error": {"@Message.ExtendedInfo": [{"Message": "Unable to process the request because an error occurred.", "MessageArgs": [], "MessageId": "GEN1234", "RelatedProperties": [], "Resolution": "Retry the operation. If the issue persists, contact your system administrator.", "Severity": "Critical"}], "code": "Base.1.0.GeneralError", "message": "A general error has occurred. See ExtendedInfo for more information."}}

job

dictionary

Configured job details.

Returned: success

Sample: {"ActualRunningStartTime": "2019-06-19T00:57:24", "ActualRunningStopTime": "2019-06-19T01:00:27", "CompletionTime": "2019-06-19T01:00:27", "Description": "Job Instance", "EndTime": "TIME_NA", "Id": "JID_609237056489", "JobState": "Completed", "JobType": "BIOSConfiguration", "Message": "Job completed successfully.", "MessageArgs": [], "MessageId": "PR19", "Name": "Configure: BIOS.Setup.1-1", "PercentComplete": 100, "StartTime": "2019-06-19T00:55:05", "TargetSettingsURI": null}

msg

string

Successfully updated the boot settings.

Returned: success

Sample: "Successfully updated the boot settings."

Authors

  • Felix Stephen (@felixs88)