bootlist – Alters the list of boot devices available to the system.

Synopsis 

Alters the list of possible boot devices from which the system may be booted. When the system is booted, it will scan the devices in the list and attempt to boot from the first device it finds containing a boot image.

Requirements 

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

AIX >= 7.1 TL3
Python >= 3.6
Root user or member of security group is required.

Parameters 

force (optional, bool, False)
Indicates that the boot list must be modified even if the validation of the speed and duplex attributes, if specified, is not possible.

normal (optional, list, None)
Normal boot list. The normal list designates possible boot devices for when the system is booted in normal mode.

Mutually exclusive with both.

device (True, str, None)
Specifies the name of the specific or generic device to include in the boot list.

The following generic device keywords are supported:

fd specifies any standard I/O-attached diskette drive.

scdisk specifies any SCSI-attached disk.

badisk specifes any direct bus-attached disk.

cd specifies any SCSI-attached CD-ROM.

rmt specifies any SCSI-attached tape device.

ent specifies any Ethernet adapter.

tok specifies any Token-Ring adapter.

fddi specifies any Fiber Distributed Data Interface adapter.

blv (optional, str, None)
Specifies the boot logical volume on the target disk that is to be included in the boot list.

pathid (optional, str, None)
Specifies the path ID of the target disk.

You can specify one or more path IDs by entering a comma-separated list of the required paths to be added to the boot list.

bserver (optional, str, None)
Specifies the IP address of the BOOTP server.

gateway (optional, str, None)
Specifies the IP address of the gateway.

client (optional, str, None)
Specifies the IP address of the client.

speed (optional, str, None)
Specifies the network adapter speed.

duplex (optional, str, None)
Specifies the mode of the network adapter.

vlan_tag (optional, int, None)
Specifies the virtual local area network (VLAN) identification value.

vlan_pri (optional, int, None)
Specifies the VLAN priority value.

filename (optional, str, None)
Specifies the name of the file that is loaded by Trivial File Transfer Protocol (TFTP) from the BOOTP server.

service (optional, list, None)
Service boot list. The service list designates possible boot devices for when the system is booted in service mode.

Mutually exclusive with both.

device (True, str, None)
Specifies the name of the specific or generic device to include in the boot list.

The following generic device keywords are supported:

fd specifies any standard I/O-attached diskette drive.

scdisk specifies any SCSI-attached disk.

badisk specifes any direct bus-attached disk.

cd specifies any SCSI-attached CD-ROM.

rmt specifies any SCSI-attached tape device.

ent specifies any Ethernet adapter.

tok specifies any Token-Ring adapter.

fddi specifies any Fiber Distributed Data Interface adapter.

blv (optional, str, None)
Specifies the boot logical volume on the target disk that is to be included in the boot list.

pathid (optional, str, None)
Specifies the path ID of the target disk.

You can specify one or more path IDs by entering a comma-separated list of the required paths to be added to the boot list.

bserver (optional, str, None)
Specifies the IP address of the BOOTP server.

gateway (optional, str, None)
Specifies the IP address of the gateway.

client (optional, str, None)
Specifies the IP address of the client.

speed (optional, str, None)
Specifies the network adapter speed.

duplex (optional, str, None)
Specifies the mode of the network adapter.

vlan_tag (optional, int, None)
Specifies the virtual local area network (VLAN) identification value.

vlan_pri (optional, int, None)
Specifies the VLAN priority value.

filename (optional, str, None)
Specifies the name of the file that is loaded by Trivial File Transfer Protocol (TFTP) from the BOOTP server.

both (optional, list, None)
Both the normal boot list and the service boot list will be set to the same list of devices.

Mutually exclusive with normal and service.

device (True, str, None)
Specifies the name of the specific or generic device to include in the boot list.

The following generic device keywords are supported:

fd specifies any standard I/O-attached diskette drive.

scdisk specifies any SCSI-attached disk.

badisk specifes any direct bus-attached disk.

cd specifies any SCSI-attached CD-ROM.

rmt specifies any SCSI-attached tape device.

ent specifies any Ethernet adapter.

tok specifies any Token-Ring adapter.

fddi specifies any Fiber Distributed Data Interface adapter.

blv (optional, str, None)
Specifies the boot logical volume on the target disk that is to be included in the boot list.

pathid (optional, str, None)
Specifies the path ID of the target disk.

You can specify one or more path IDs by entering a comma-separated list of the required paths to be added to the boot list.

bserver (optional, str, None)
Specifies the IP address of the BOOTP server.

gateway (optional, str, None)
Specifies the IP address of the gateway.

client (optional, str, None)
Specifies the IP address of the client.

speed (optional, str, None)
Specifies the network adapter speed.

duplex (optional, str, None)
Specifies the mode of the network adapter.

vlan_tag (optional, int, None)
Specifies the virtual local area network (VLAN) identification value.

vlan_pri (optional, int, None)
Specifies the VLAN priority value.

filename (optional, str, None)
Specifies the name of the file that is loaded by Trivial File Transfer Protocol (TFTP) from the BOOTP server.

Notes 

Note

You can refer to the IBM documentation for additional information on the bootlist command at https://www.ibm.com/support/knowledgecenter/ssw_aix_72/b_commands/bootlist.html.

Examples 

- name: Set normal and service boot lists
  bootlist:
    normal:
      - device: hdisk0
        blv: hd5
      - device: hdisk1
        blv: hd5
        pathid: "1"
      - device: ent0
        client: 129.35.9.23
        gateway: 129.35.21.1
        bserver: 129.12.2.10
    service:
      - device: cd0

- name: Set both normal and service boot lists to the same device
  bootlist:
    both:
      - device: hdisk0

- name: Retrieve normal and service boot lists
  bootlist:
- name: Print the boot lists
  debug:
    var: ansible_facts.bootlist

Return Values 

msg (always, str, )

The execution message.

stdout (always, str, )

The standard output

stderr (always, str, )

The standard error

ansible_facts (always, complex, )

Facts to add to ansible_facts about the normal and service boot lists.

bootlist (always, dict, )

Contains information about normal and service boot lists.

normal (always, list, {‘normal’: [{‘blv’: ‘hd5’, ‘device’: ‘hdisk0’, ‘pathid’: ‘0’}, {‘bserver’: ‘129.12.2.10’, ‘client’: ‘129.35.9.23’, ‘device’: ‘ent0’, ‘gateway’: ‘129.35.21.1’}]}): Normal boot list.
service (always, list, ): Service boot list.

Status 

This module is not guaranteed to have a backwards compatible interface. [preview]
This module is maintained by community.

Authors

AIX Development Team (@pbfinley1911)

bootlist – Alters the list of boot devices available to the system.

Synopsis

Requirements

Parameters

Notes

Examples

Return Values

Status