llvupdate – Performs Live Library Update

Synopsis

Performs the Live Library Update (LLU) operation for the specified processes without a downtime for workloads.

Requirements

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

  • AIX >= 7.3

  • Python >= 3.6

  • Privileged user with authorization: aix.system.install

Parameters

action (True, str, None)

Controls what action is performed.

update performs live update operation on the specified processes.

preview performs live update operation in preview mode.

clean performs clean up of kernel state and also uncleaned processes.

processes_to_include (optional, list, None)

Initiates the Live Library Update for the specified processes.

When used, the llvupdate command monitors the progress of the LLU operation of each process and stops the operation for any process that does not complete the update operation within the timeout period.

include_all (optional, bool, False)

Scans all the processes and initiates the Live Library Update operation for all LLU-capable processes according to the timeout policy.

processes_to_exclude (optional, list, None)

Performs LLU operation on all LLU-capable processes except the ones provided using this flag.

logfile (optional, str, None)

Specifies the log file that you want to use.

By default, the log file is /var/adm/ras/liveupdate/logs/llvupdlog.<date.time>.

retries (optional, int, None)

Specifies the number of times the Live Library Update operation must be attempted.

The default value is 3.

timeout (optional, int, None)

Specifies the time for all threads in a process to reach a state after which the LLU operation can be performed.

If the LLU operation cannot be started within this timeout period, the operation is canceled for that process and is retried after 10 seconds up to a number of attempts that are specified.

The default timeout period is 30 seconds. The maximum timeout value is 300 seconds.

auto_cleanup (optional, bool, False)

Specifies if cleanup needs to be automatically performed after performing live update for any process(s)

When set to auto_cleanup=true, cleanup will be performed after llvupdate command is run, regardless of the return code.

Notes

Note

Examples

- name: Perform LLU in preview mode
  ibm.power_aix.llvupdate:
    action: preview

- name: Perform LLU on one process.
  ibm.power_aix.llvupdate:
    action: update
    processes_to_include: 13369744

- name: Perform LLU on multiple processes
  ibm.power_aix.llvupdate:
    action: update
    processes_to_include: 12845566, 9568716

- name: Perform LLU on every process except one
  ibm.power_aix.llvupdate:
    action: update
    include_all: true
    processes_to_exclude: 13828604

- name: Perform LLU on all applicable processes.
  ibm.power_aix.llvupdate:
    action: update
    include_all: true

- name: Clean up kernal state and uncleaned processes
  ibm.power_aix.llvupdate:
    action: clean

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.

cmd (always, str, )

Command that was run

Status

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

  • This module is maintained by community.

Authors

  • AIX Development Team (@schamola)