Skip to main content

SUMA Overview

SUMA Overview​

SUMA stands for Service Update Management Assistant, which sets up an automated interface to download fixes from the IBM Fix Central website to your systems. SUMA provides flexible, task-based options to periodically check the availability of specific new fixes, technology levels (TL), and service packs (SP). System administrators do not have to manually retrieve maintenance updates as SUMA automates this process.

How to Use SUMA​

SUMA can perform various actions such as downloading and installing fixes, previewing available updates, listing all SUMA tasks, editing existing tasks, running tasks, unscheduling tasks, deleting tasks, and listing global SUMA configuration settings. SUMA tasks can be scheduled to run at specific times, and the results of these tasks are logged in the system for review.

Requirements​

SUMA requires AIX version 7.1 TL3 or higher and Python version 3.6 or higher.

Example Usage​

This example demonstrates how to check, download, and install system updates for the current oslevel of the system using SUMA.

The following code snippets show how to use SUMA to check, download, and install system updates for different oslevels.

- name: Check, download and install system updates for the current oslevel of the system
  suma:
    action: download
    oslevel: Latest
    download_dir: /usr/sys/inst.images

- name: Check and download required to update to SP 7.2.3.2
  suma:
    action: download
    oslevel: '7200-03-02'
    download_only: true
    download_dir: /tmp/dl_updt_7200-03-02
  when: ansible_distribution == 'AIX'

- name: Check, download and install to latest SP of TL 7.2.4
  suma:
    action: download
    oslevel: '7200-04'
    last_sp: true
    extend_fs: false

Main Functions​

There are several main functions in this folder. Some of them are suma_download, suma_list, suma_edit, suma_unschedule, suma_delete, suma_run, suma_config, and suma_default. We will dive a little into suma_download and suma_list.

suma_download​

The suma_download function handles the download and installation (or preview) of updates. It computes all SUMA request options, performs a preview to check for available updates, and if updates are found, it proceeds to download and install them.

The suma_download function is responsible for downloading and installing updates. It first computes all SUMA request options, performs a preview to check for available updates, and if updates are found, it proceeds to download and install them.

def suma_download():
    """
    Download / Install (or preview) action

    suma_params['action'] should be set to either 'preview' or 'download'.

    First compute all Suma request options. Then preform a Suma preview, parse
    output to check there is something to download, if so, do a suma download
    if needed (if action is Download). If suma download output mentions there
    is downloaded items, then use install_all_updates command to install them.

    note:
        Exits with fail_json in case of error
    """

    # Check oslevel format
    if not suma_params['oslevel'].strip() or suma_params['oslevel'].upper() == 'LATEST':
        suma_params['oslevel'] = 'Latest'
    else:
        if re.match(r"^[0-9]{4}(|-00|-00-00|-00-00-0000)$", suma_params['oslevel']):
            msg_oslevel = suma_params['oslevel']

suma_list​

The suma_list function lists all SUMA tasks or the task associated with a given task ID. It constructs the appropriate command and executes it, capturing the output and handling any errors.

 

This is an auto-generated document by Swimm 🌊 and has not yet been verified by a human