Skip to main content

Understanding VIOS Health Check

Purpose​

The Power AIX VIOS Health Check is a health assessment tool used for pre-install routines of VIOS (Virtual I/O Server). It checks if a VIO Server or a pair of VIO Servers can be updated by assessing various configurations. The tool evaluates active client LPARs, vSCSI mapping, NPIV Path for Fibre Channel configuration, SEA configuration, and VNIC configuration.

How to Use​

The tool should be executed on the NIM master and uses Curl (pycurl) to interact with the HMC REST API. It retrieves the HMC login/password from the HMC password file if not specified and uses an HMC session key for Curl requests.

Example Usage​

The health_check function in plugins/modules/nim_vios_hc.py performs a health assessment of the VIOS targets to ensure they can support a rolling update operation.

The health_check function is defined in plugins/modules/nim_vios_hc.py. It performs a health assessment of the VIOS targets to ensure they can support a rolling update operation. For each VIOS tuple, it calls roles/power_aix_vioshc/files/vioshc.py twice: first to collect the VIOS UUIDs and second to check the healthiness. The function returns a dictionary with the state of each VIOS tuple.

def health_check(module, targets):
    """
    Health assessment of the VIOS targets to ensure they can support
    a rolling update operation.

    For each VIOS tuple:
    - call vioshc.py a first time to collect the VIOS UUIDs
    - call vioshc.py a second time to check the healthiness

    return: a dictionary with the state of each VIOS tuple
    """

 

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