create_service_event – Creates a serviceable event on the Hardware Management Console (HMC) to report a problem that occurred on the managed system.

Synopsis 

Creates a serviceable event on the Hardware Management Console (HMC) to report a problem that occurred on either the power server or the HMC itself, and initiates a service request for repair.

Requirements 

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

Python >= 3.9

Parameters 

hmc_host (True, str, None)
The IP Address or hostname of the HMC.

hmc_auth (True, dict, None)
Username and Password credential of the HMC.

username (True, str, None)
Username of the HMC to login.

password (optional, str, None)
Password of the HMC.

system_name (True, str, None)
The name or mtms (machine type model serial) of the managed system.

description (True, str, None)
The problem description.

types (True, str, None)
The type of event to create.

sys to report a problem with managed-system.

vios to report a problem with a Virtual I/O Server on managed-system.

lpm to report a partition migration problem where managed-system is the source system for the partition migration operation.

hmc to report a problem with this HMC.

cloudconn to report a problem with the cloud connector on this HMC.

attributes (True, dict, None)
The serviceable event attributes to set.

title (True, str, None)
Title for the serviceable event.

severity (True, int, None)
The priority for the serviceable event.

contact_name (True, str, None)
The contact name for the serviceable event.

contact_email (True, str, None)
The contact email for the serviceable event.

contact_phone (True, int, None)
The contact phone number for the serviceable event.

target_lpar_name (optional, str, None)
The target logical partition name for the serviceable event.

Required for lpm

target_mtms (optional, str, None)
The target managed system MTMS for the serviceable event.

Required for lpm

lpar_name (optional, str, None)
The logical partition name for the serviceable event.

Required for lpm and vios

service_file (True, list, None)
The name of the log file which is attached to the serviceable event.

Required for lpm and vios

pedbgq4 HMC pedbg data. Valid with sys/hmc/vios/lpm type.

pedbgq8 Cloud connector pedbg data. Valid with cloudconn type.

vios VIOS snap data. Valid with vios type.

lpmffdc Partition migration debug data. Valid with lpm type.

rscdump Non-disruptive system dump. Valid with sys type.

spdump Service processor dump . Valid with sys type.

state (optional, str, None)
created to create a serviceable event.

Notes 

Note

This module requires the HMC which has Power10 or Power 11 systems licensed for advanced automation and monitoring.

Examples 

- name: Create a serviceable event for collection of vios logs
  create_service_event:
    hmc_host: '{{ inventory_hostname }}'
    hmc_auth: "{{ curr_hmc_auth }}"
    system_name: <system name>
    description: Test Description
    types: vios
    attributes:
        title: test
        severity: 4
        contact_name: Test
        contact_phone: < phone-num >
        contact_email: test@abc.com
        lpar_name: < partition >
        service_file:
            - pedbgq4
            - vios
    state: created

- name: Create a serviceable event for collection of lpm logs
  create_service_event:
    hmc_host: '{{ inventory_hostname }}'
    hmc_auth: "{{ curr_hmc_auth }}"
    system_name: <system name>
    description: Test Description
    types: vios
    attributes:
        title: test
        severity: 4
        contact_name: Test
        contact_phone: < phone-num >
        contact_email: test@abc.com
        lpar_name: < partition1 >
        target_lpar_name: <partition2 >
        target_mtms: < target-sys >
        service_file:
            - pedbgq4
            - vios
    state: created

Status 

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

Authors

Sreenidhi S(@SreenidhiS1)