bosboot – Creates boot image.

Synopsis

The bosboot command creates the boot image that interfaces with the machine boot ROS (Read-Only Storage) EPROM (Erasable Programmable Read-Only Memory).

The bosboot command creates a boot file (boot image) from a RAM (Random Access Memory) disk file system and a kernel. This boot image is transferred to a particular media that the ROS boot code recognizes. When the machine is powered on or rebooted, the ROS boot code loads the boot image from the media into memory. ROS then transfers control to the loaded images kernel. version_added:’1.6.0’

Requirements

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

  • AIX >= 7.1 TL3

  • Python >= 3.6

  • Privileged user with authorization: aix.system.install

Parameters

disk_device (optional, str, hd5)

Specifies the boot device.

prototype_file (optional, str, None)

Uses the specified prototype file for the RAM disk file system.

only_verify (optional, bool, False)

Verify, but do not build boot image for directory and image_name.

create_image (optional, bool, False)

Creates the complete boot image with image_name in directory.

directory (optional, str, /tmp)

Specifies the directory in which the boot image will be stored.

image_name (optional, str, lv.bosboot)

Specifies the name of the output image from the bosboot command.

The image will be stored in/as ‘directory/image_name’.

If both directory and image_name are not given, the default value will be used i.e. The image will be saved as “/tmp/lv.bosboot”

table_entry (optional, str, None)

Specifies which boot pointer table entry to update.

primary Specifies the table entry that was most recently used.

standby Specifies the table entry that was not most recently used.

both Specifies both boot pointer table entries.

increase_space (optional, bool, False)

Takes user permession to increase the file space.

Notes

Note

Examples

- name: Only Verify
  bosboot:
    only_verify: true
    disk_device: "hd5"
    prototype_file: "usr/lib/boot/chrp.cd.proto"
- name: Table Entry
  bosboot:
    only_verify: true
    table_entry: primary
    prototype_file: "usr/lib/boot/chrp.cd.proto"
- name: Create Image
  bosboot:
    increase_space: true
    disk_device: "hd5"
    prototype_file: "usr/lib/boot/chrp.cd.proto"
    table_entry: "both"
    directory: "/tmp"
    image_name: "New_Boot_Image"
    create_image: true

Return Values

msg (always, str, )

The execution message.

stdout (If the command failed., str, )

The standard output.

stderr (If the command failed., str, )

The standard error.

Status

  • This module is not guaranteed to have a backwards compatible interface. [preview]

  • This module is maintained by community.

Authors

  • AIX Development Team (@schamola)