Vh2ddlmZmZmZeZdZdZdZddl Z ddl Z ddl m Z m Z ddlmZddlmZmZdd lmZdd lmZmZdd lmZdd lmZd ZdZdZdZdZdZ dZ!dZ"dZ#dZ$dZ%dZ&dZ'dZ(dZ)dZ*dZ+dZ,dZ-d Z.Gd!d"Z/Gd#d$e/Z0d%Z1e2d&k(re1yy)')absolute_importdivisionprint_functiona --- module: omevv_firmware short_description: Update the firmware of a specific host in the cluster version_added: "9.10.0" description: This module allows you to update the firmware of a specific host in the cluster. extends_documentation_fragment: - dellemc.openmanage.omevv_auth_options options: check_vSAN_health: description: - Check vSAN health while updating the firmware. - C(true) checks the vSAN health while updating the firmware. - C(false) does not check the vSAN health while updating the firmware. type: bool date_time: description: - Date and time when the job must run. This is applicable when I(run_now) is C(false). - The supported format is YYYY-MM-DDThh:mm:ss. type: str delete_job_queue: description: - Whether to delete the job queue in iDRAC while updating firmware. - C(true) deletes the job queue in iDRAC while updating firmware. - C(false) does not delete the job queue in iDRAC while updating firmware. type: bool drs_check: description: - Allows you to check if DRS of the cluster is enabled or not. - C(true) checks if Distributed Resource Scheduler (DRS) of the cluster is enabled. - C(false) does not check if DRS of the cluster is enabled. type: bool default: false enter_maintenance_mode_options: description: - VM migration policy during management mode. - C(FULL_DATA_MIGRATION) for full data migration. - C(ENSURE_ACCESSIBILITY) for ensuring accessibility. - C(NO_DATA_MIGRATION) does not migrate any data. type: str choices: [FULL_DATA_MIGRATION, ENSURE_ACCESSIBILITY, NO_DATA_MIGRATION] enter_maintenance_mode_timeout: description: - Time out value during maintenance mode in minutes. type: int default: 60 evacuate_VMs: description: - Allows to move the virtual machine (VM) to other host when current host is powered off. - C(true) moves the VM to another host when the current host is powered off. - C(false) does not move the VM to another host when the current host is powered off. type: bool default: false exit_maintenance_mode: description: - Whether to exit management mode after Update. - C(true) exits the management mode after Update. - C(false) does not exit the management mode after Update. type: bool default: false job_description: description: - Update job description. type: str job_name: description: - Update job name. type: str job_wait: description: - Whether to wait till completion of the job. This is applicable when I(power_on) is C(true). - C(true) waits for job completion. - C(false) does not wait for job completion. type: bool default: true job_wait_timeout: description: - The maximum wait time of I(job_wait) in seconds. The job is tracked only for this duration. - This option is applicable when I(job_wait) is C(true). type: int default: 1200 maintenance_mode_count_check: description: - Allows to check if any host in cluster is in management mode. - C(true) checks if any host in cluster is in management mode. - C(false) does not check if any host in cluster is in management mode. type: bool reboot_options: description: - Host reboot option for firmware update. - C(FORCEREBOOT) will force reboot the server. - C(SAFEREBOOT) reboots the server in safe mode. - C(NEXTREBOOT) does not reboot the server. type: str choices: [FORCEREBOOT, SAFEREBOOT, NEXTREBOOT] default: SAFEREBOOT reset_idrac: description: - Whether to reset the iDRAC while performing firmware update. - C(true) resets the iDRAC while performing firmware update. - C(false) does not reset the iDRAC while performing firmware update. type: bool run_now: description: - Whether to run the update job now or later. - C(true) runs the update job instantly. - C(false) runs the update at the specified I(date_time). type: bool required: true targets: description: - The target details for the firmware update operation. - Either I(cluster), I(servicetag) or I(host) is required for the firmware update operation. type: list elements: dict required: true suboptions: cluster: description: - Name of the cluster to which firmware needs to updated. - I(cluster) is mutually exclusive with I(servicetag) and I(host). - This module supports only single cluster update. type: str required: false firmware_components: description: - List of host firmware components to update. - M(dellemc.openmanage.omevv_firmware_compliance_info) module can be used to fetch the supported firmware components. type: list elements: str required: true host: description: - The IP address or hostname of the host. - I(host) is mutually exclusive with I(servicetag) and I(cluster). - M(dellemc.openmanage.omevv_device_info) module can be used to fetch the device information. type: str servicetag: description: - The service tag of the host. - I(servicetag) is mutually exclusive with I(host) and I(cluster). - M(dellemc.openmanage.omevv_device_info) module can be used to fetch the device information. type: str requirements: - "python >= 3.9.6" author: - "Rajshekar P(@rajshekarp87)" attributes: check_mode: description: Can run in check_mode and return changed status prediction without modifying target, if not supported the action will be skipped. support: full diff_mode: description: Will return details on what has changed (or possibly needs changing in check_mode), when in diff mode. support: full notes: - Run this module from a system that has direct access to Dell OpenManage Enterprise. - This module supports IPv4 and IPv6 addresses. a\ --- - name: Immediately update the firmware of a single component for a specific host dellemc.openmanage.omevv.omevv_firmware: hostname: "XXX.XXX.XXX.XX" vcenter_uuid: "xxxxx" vcenter_username: "username" vcenter_password: "password" ca_path: "path/to/ca_file" run_now: false date_time: "2024-09-10T20:50:00Z" enter_maintenance_mode_timeout: 60 enter_maintenance_mode_options: FULL_DATA_MIGRATION drs_check: true evacuate_VMs: true exit_maintenance_mode: true reboot_options: NEXTREBOOT maintenance_mode_count_check: true check_vSAN_health: true reset_idrac: true delete_job_queue: true targets: - servicetag: SVCTAG1 firmware_components: - "DCIM:INSTALLED#802__Diagnostics.Embedded.1:LC.Embedded.1" - name: Update the firmware of multiple components at scheduled time for a specific host dellemc.openmanage.omevv.omevv_firmware: hostname: "XXX.XXX.XXX.XY" vcenter_uuid: "xxxxx" vcenter_username: "username" vcenter_password: "password" ca_path: "path/to/ca_file" run_now: false date_time: "2024-09-10T20:50:00+05:30" enter_maintenance_mode_timeout: 60 enter_maintenance_mode_options: ENSURE_ACCESSIBILITY drs_check: true evacuate_VMs: true exit_maintenance_mode: true reboot_options: FORCEREBOOT maintenance_mode_count_check: true check_vSAN_health: true reset_idrac: false delete_job_queue: false targets: - host: "XXX.XXX.XXX.XZ" firmware_components: - "DCIM:INSTALLED#iDRAC.Embedded.1-1#IDRACinfo" - "DCIM:INSTALLED#301_C_BOSS.SL.14-1" - "DCIM:INSTALLED#807__TPM.Integrated.1-1" - name: Update the firmware of multiple components at scheduled time for a cluster dellemc.openmanage.omevv.omevv_firmware: hostname: "XXX.XXX.XXX.XX" vcenter_uuid: "xxxxx" vcenter_username: "username" vcenter_password: "password" ca_path: "path/to/ca_file" run_now: false date_time: "2024-09-10T20:50:00+05:30" enter_maintenance_mode_timeout: 60 enter_maintenance_mode_options: ENSURE_ACCESSIBILITY drs_check: true evacuate_VMs: true exit_maintenance_mode: true reboot_options: SAFEREBOOT maintenance_mode_count_check: true check_vSAN_health: true reset_idrac: false delete_job_queue: false targets: - cluster: cluster_a firmware_components: - "DCIM:INSTALLED#iDRAC.Embedded.1-1#IDRACinfo" - "DCIM:INSTALLED#301_C_BOSS.SL.14-1" - "DCIM:INSTALLED#807__TPM.Integrated.1-1" - name: Retrieve firmware compliance report of all hosts in the specific cluster dellemc.openmanage.omevv_firmware_compliance_info: hostname: "XXX.XXX.XXX.XX" vcenter_uuid: "xxxxx" vcenter_username: "username" vcenter_password: "password" ca_path: "path/to/ca_file" clusters: - cluster_name: cluster_a register: compliance_data - name: Initialize compliance status results ansible.builtin.set_fact: source_names: [] service_tag: "" - name: Flatten host compliance reports ansible.builtin.set_fact: host_reports: "{{ compliance_data.firmware_compliance_info | map(attribute='hostComplianceReports') | flatten(levels=1) }}" - name: Flatten and filter concompliant components ansible.builtin.set_fact: non_compliant_components: >- {{ host_reports | map(attribute='componentCompliances') | flatten(levels=1) | selectattr('driftStatus', 'equalto', 'NonCompliant') }} - name: Gather components source name and set service tag ansible.builtin.set_fact: source_names: "{{ source_names + [item.sourceName] }}" service_tag: "{{ host_report.serviceTag }}" loop: "{{ non_compliant_components }}" vars: host_report: >- {{ host_reports | selectattr('componentCompliances', 'contains', item) | first }} - name: Combine the final non compliance report ansible.builtin.set_fact: noncompliance_report: sourceNames: "{{ source_names }}" serviceTag: "{{ service_tag }}" - name: Update firmware at the scheduled time for a specific host dellemc.openmanage.omevv.omevv_firmware: hostname: "192.168.0.1" vcenter_uuid: "{{ vcenter_uuid }}" vcenter_username: "username" vcenter_password: "password" ca_path: "path/to/ca_file" run_now: false date_time: "2024-09-10T20:50:00Z" enter_maintenance_mode_timeout: 60 enter_maintenance_mode_options: NO_DATA_MIGRATION drs_check: true evacuate_VMs: false exit_maintenance_mode: true reboot_options: SAFEREBOOT maintenance_mode_count_check: true check_vSAN_health: true reset_idrac: true delete_job_queue: true targets: - servicetag: "{{ noncompliance_report.serviceTag }}" firmware_components: "{{ noncompliance_report.sourceNames }}" a --- msg: type: str description: Status of the firmware update operation. returned: always sample: "Successfully created the OMEVV baseline profile." error_info: description: Details of the module HTTP Error. returned: on HTTP error type: dict sample: { "errorCode": "20058", "message": "Update Job already running for group id 1004 corresponding to cluster OMAM-Cluster-1. Wait for its completion and trigger." } N)URLError HTTPError)ConnectionError) RestOMEVVOMEVVAnsibleModule)validate_job_wait)OMEVVFirmwareUpdateOMEVVBaselineProfile) OMEVVInfo)datetimez0Successfully submitted the firmware updated job.z+Successfully completed the firmware update.z/Successfully scheduled the firmware update job.z'Failed to complete the firmware update.z0Firmware update job timed out after {0} seconds.zQInvalid date time. Enter a valid date time in the format of YYYY-MM-DDTHH:MM:SSZ.zYThe value for the 'enter_maintenance_mode_timeout' parameter must be between 60 and 1440.z;parameters are mutually exclusive: cluster|host|servicetag.z=Either 'cluster' or 'host' or 'servicetag' must be specified.zwUpdate job is either running or in a scheduled state for cluster '{cluster_name}'. Wait for its completion and trigger.zBJob with name '{job_name}' already exists. Provide different name.z&No managed hosts found in the cluster.z4Host '{managed_host}' not found under managed hosts.z4Provided cluster name '{cluster_name}' is not valid.zChanges found to be applied.zNo changes found to be applied.zJThe value for the 'job_wait_timeout' parameter cannot be negative or zero.z/The URL with the {ip}:{port} cannot be reached.z'The Requested resource cannot be found.z)/Consoles/{vcenter_uuid}/CanTriggerUpdatecHeZdZdZdZdZdZdZdZdZ dZ d Z d Z y ) FirmwareUpdatec||_||_t|j|_t |j|_t |j|_y)z Initializes the FirmwareUpdate object. Args: module (Any): The module to execute. rest_obj (Any): The rest object. Returns: None N)moduleobjromevv_info_objr omevv_update_objr omevv_baseline_obj)selfrrest_objs u/home/dcms/DCMS/lib/python3.12/site-packages/ansible_collections/dellemc/openmanage/plugins/modules/omevv_firmware.py__init__zFirmwareUpdate.__init__sE '1 3DHH ="6txx"@c0|}|jj}|d}ddgii}|d}|dj|j|||j ||}|j ||}|dj|j ||||S)z Retrieves the payload details for the firmware update. Args: host_id (str): The ID of the host. Returns: dict: The payload details for the firmware update. targetsfirmware)rparamsupdate set_firmware set_scheduleset_job_details add_targets)rhost_id device_id parameters target_listpayloadrs rget_payload_detailsz"FirmwareUpdate.get_payload_detailss [[''  +  2/:& ""4#4#4Xz#JK##GZ8&&w ; ""4#3#3Hk9#UVrcJgd}|D]\}}|j|||<|S)a Adds optional fields to the firmware dictionary based on the parameters. Args: firmware (dict): The firmware dictionary. parameters (dict): The parameters dictionary. Returns: None ) )check_vSAN_healthcheckvSANHealth)delete_job_queuedeleteJobsQueue) drs_checkdrsCheck)enter_maintenance_mode_optionsenterMaintenanceModeOption)enter_maintenance_mode_timeoutenterMaintenanceModetimeout) evacuate_VMs evacuateVMs)exit_maintenance_modeexitMaintenanceMode)maintenance_mode_count_checkmaintenanceModeCountCheck)reboot_options rebootOptions) reset_idrac resetIDracget)rrr(optional_fields param_key firmware_keys rr"zFirmwareUpdate.set_firmwares9  (7 ? #I|%/^^I%>H\ " ?rcpd|jdi|d<|dds|jd|dd<|S)z Sets the schedule for the payload. Args: payload (dict): The payload dictionary. parameters (dict): The parameters dictionary. Returns: None runNowrun_nowschedule date_timedateTimerA)rr*r(s rr#zFirmwareUpdate.set_schedulesF ( )BC z"8,.8nn[.IGJ  +rc ~|jdr|jd|d<nd|d<|jdr|jd|d<|Stj}d|j|jd|j dd|j d|jd|jd}||d<|S) z Sets the job details in the payload dictionary. Args: payload (dict): The payload dictionary. parameters (dict): The parameters dictionary. Returns: None job_descriptionjobDescriptionNjob_namejobNameomam_firmware_update_job_02_) rBrnowyearmonthdayhourminutesecond)rr*r(rJrOs rr$zFirmwareUpdate.set_job_detailss >>+ ,(27H(IG$ %(,G$ % >>* %!+ !;GI  ! I+INN+;IOOB;OPYP]P]^`Oaab>>"%i&6&6r%:9;K;KB:OQ "*GI rc|D]R}t|tr$|D]}|d|d}|dj| 7|d|d}|dj|T|S)a& Adds targets to the firmware dictionary. Args: firmware (dict): The firmware dictionary. target_list (list): The list of targets. device_id (Union[str, list]): The device ID or list of device IDs. Returns: None firmware_components)firmwarecomponentsidr) isinstancelistappend)rrr)r'targetsingle_device_id actual_targets rr%zFirmwareUpdate.add_targetss" :F)T*(1>$.45J.K.%MY'..}= >+11F*G#! #**=9 : rcn|jjjdgD]}|jd}|jd}|jd}|r|s|r|s|r#|r!|jjtd|rf|ri|rl|jjt dy)z Check the existence of host and servicetag in the targets. Args: self (object): The instance of the class. Returns: None rclusterhost servicetagTmsgfailedN)rr rB exit_json,CLUSTER_HOST_SERVICETAG_MUTUAL_EXCLUSIVE_MSG%CLUSTER_HOST_SERVICETSAG_REQUIRED_MSG)rrbrfrgrhs rhost_servicetag_existencez(FirmwareUpdate.host_servicetag_existenceskk((,,Y; ^Fjj+G::f%DL1J'zg %%*V-1&3 7 %%*OX\%] ^rc tj|jjj dd}|S#t $r%|jj tdYSwxYw)a Validates the date and time format. This function takes the date and time string from the 'date_time' parameter and attempts to parse it using the specified format. If the parsing is successful, the parsed datetime object is returned. If the parsing fails, the function exits with a failure message. Returns: datetime: The parsed datetime object. rJz%Y-%m-%dT%H:%M:%S%zTri)rstrptimerr rB ValueErrorrlINVALID_DATE_TIME_MSG)rftimes rvalidate_date_timez!FirmwareUpdate.validate_date_time+sg J%%dkk&8&8&<&<[&IK`aE  J KK ! !&;D ! I  Js9=*A+*A+c|jjjd}|dks|dkDr"|jjtdyy)a Validates the timeout value for entering maintenance mode. This function checks if the value of the 'enter_maintenance_mode_timeout' parameter is within the valid range (60 to 1440). If the value is outside the valid range, the function exits with a failure message. Parameters: self (object): The instance of the class. Returns: None Raises: SystemExit: If the value of 'enter_maintenance_mode_timeout' is outside the valid range. r5<iTriN)rr rBrl$MAINTENANCE_MODE_TIMEOUT_INVALID_MSG)rr5s rr5z-FirmwareUpdate.enter_maintenance_mode_timeout=sP"*.););)?)?@`)a& )B .2PSW2W KK ! !&JSW ! X3Xrcf|jt|jr!|jjtd|jj j dr|j|jj j dr|jyy)a Validates the parameters of the class. This function checks the existence of the 'host' and 'servicetag' parameters. It also validates the 'job_wait' parameter and the 'date_time' parameter. Additionally, it validates the 'enter_maintenance_mode_timeout' parameter. Parameters: self (object): The instance of the class. Returns: None TrirJr5N) ror rrlTIMEOUT_NEGATIVE_OR_ZERO_MSGr rBrur5)rs rvalidate_paramszFirmwareUpdate.validate_paramsRs &&( T[[ ) KK ! !&B4 ! P ;;   ! !+ .  # # % ;;   ! !"B C  / / 1 DrN) __name__ __module__ __qualname__rr+r"r#r$r%rorur5r{rrrrs7A".<"4<^*$Y*2rrcleZdZdZdZdZ ddZdZdZdZ d Z d Z d Z d Z d ZdZdZdZy) UpdateClustercd}d}d}d}d}|j|jjjd}|jj}|j |d}|d}|dr|j |\}}}n|j |\}}}}t|ts|g}|g}|j||||j||jjjd|j||||d|\} } } |jjr|j| | | | r|j||||| | y|jjt | | ddy) a  Executes the firmware update process. This function validates the parameters, retrieves the target cluster and payload, checks if the update job is allowed, and handles the firmware update process. Returns: None N vcenter_uuidrrfrObeforeafterF)rjdiffchanged)r{rr rB get_targetprocess_cluster_targetprocess_non_cluster_targetr_r`is_update_job_allowedis_job_name_existingis_firmware_update_needed check_modehandle_check_modehandle_firmware_updaterlCHANGES_NOT_FOUND_MSG) r cluster_namecluster_group_idhost_service_tags new_host_idr*rr(rbfirmware_update_needed before_dict after_dicts rexecutezUpdateCluster.executess    {{))--n= [['' I!67i( ) 595P5PQW5X 2 g{CGCbCbcmCn @L*G[+t,&-K!2 3  ""<1A<P !!, 0B0B0F0Fz0RS:>:X:X *KI9NPa;c7 Z ;; ! !  " "#9; S !  ' ' 6FQ[(3Z A KK ! !&;2=1;(=FK " Mrc0|jjjd}|j||\}}||s!|jj t d|d}|j j||}|j|}|||fS)z Process the cluster target. Args: target (dict): The target cluster. Returns: tuple: A tuple containing the cluster group ID, payload, and new host ID. rTrjskippedrfr&) rr rB&get_host_id_either_host_or_service_tagrlCLUSTER_HOST_NOT_FOUND_MSGrget_group_id_of_clusterr+)rrbrhost_idsrrrr*s rrz$UpdateCluster.process_cluster_targets{{))--n= &*&Q&QR^`f&g##  8 KK ! !&@$ ! Oi( ..FF|GSU**8*<(22rc|jjjd}|j|d}|j ||\}}|n|dr5|jj t j|ddn4|jj t j|dd|jj||}|jj||}|j|}||||fS) z Process the non-cluster target. Args: parameters (dict): The parameters dictionary. Returns: tuple: A tuple containing the cluster group ID, payload, and new host ID. rrrg) managed_hostTrrhr) rr rBrget_host_from_parametersrlHOST_NOT_FOUND_MSGformatrget_cluster_namerr+) rr(rrbr&rrrr*s rrz(UpdateCluster.process_non_cluster_targets{{))--n= I!67%)%B%B&@ %%*<*C*C!' !5+D+7@D&F**;;L'R ..FF|GSU**7*;-w??rNcn|j|d}|dr||fS|j||\}}||fS)a Retrieves the host and service tags from the given parameters. Args: vcenter_uuid (str): The UUID of the vCenter. parameters (dict): The parameters dictionary. host_ids (list, optional): The list of host IDs. Defaults to None. host_service_tags (list, optional): The list of host service tags. Defaults to None. Returns: tuple: A tuple containing the host IDs and host service tags. rrf)rr)rrr(rrrbs rrz&UpdateCluster.get_host_from_parameterssQI!67 ) .. .*.*U*UVbdj*k 'H'.. .rc~|r^|jjr&|jjtd||dy|jjtdy|jjr&|jjtd||dy|jjtdy)ar Handles the check mode for firmware update. Args: firmware_update_needed (bool): Indicates if firmware update is needed. before_dict (dict): The dictionary representing the state before the update. after_dict (dict): The dictionary representing the state after the update. Returns: None Tr)rjrr)rjrFN)r_diffrlCHANGES_FOUND_MSGr)rrrrs rrzUpdateCluster.handle_check_modes "{{   %%*;T6AJ+W&Y %%*;T%J{{   %%*?6A5?,A&B %%*?%Orc|j||||||}|jjjdr'|jj t d|||dy|jj t d|||dy)a Executes the firmware update job and handles the response. Args: vcenter_uuid (str): The UUID of the vCenter. cluster_group_id (str): The ID of the cluster group. payload (dict): The payload for the firmware update. parameters (dict): The parameters for the firmware update. before_dict (dict): The state of the system before the update. after_dict (dict): The state of the system after the update. Returns: None rHTrrjr job_detailsrN)execute_update_jobrr rBrlSUCCESS_UPDATE_MSGSUCCESS_UPDATE_SCHEDULED_MSG)rrrr*r(rrjob_resps rrz$UpdateCluster.handle_firmware_updates **<9I7T^+6 D ;;   ! !) , KK ! !&8$T\2= 'S " U KK ! !&BD.62= 'S " Urc|D]}|cSy)z Returns the first item in the target_list. Args: target_list (list): The list of targets. Returns: Any: The first item in the target_list. Nr)rr)rbs rrzUpdateCluster.get_targets" FM rc|d}|d}|d}|r%|jj|d|\}}||fS|r%|jj||d\}}||fS|jj||}|dk(r2|jj t j |d y|jj||\} } | | fS) a= Retrieves the host ID and service tag for a given target. Args: vcenter_uuid (str): The UUID of the vCenter. target (dict): The target containing the cluster, service tag, and host. Returns: tuple: A tuple containing the host ID and service tag. rfrhrgN)hostnamerhrTr)rrrrrlCLUSTER_NOT_FOUND_MSGr get_cluster_managed_host_details) rrrbr service_tagrgr&host_service_tagrrrs rrz4UpdateCluster.get_host_id_either_host_or_service_tag(si( \* f~ (,(;(;(b(bt )c)E %G%,, , (,(;(;(b(bt)c)> %G%,, ,#22JJBB<PO*G*J*N*NOegi*j '"&"5"5"]"].#9 ,?,C,CD[,\ );A>BB<PO*=*A*A'+--.+0034JB0O ((.ay1F'G$5 OI%@ O!$\2i?)+<^+LDNK 1, ?@*+<_+MCOJ0>?  O O#.";%{JOOrc |jj||y#t$r4|jj t j |dYywxYw)aN Check if an update job is allowed. Args: vcenter_uuid (str): The UUID of the vCenter. cluster_group_id (str): The ID of the cluster group. cluster_name (str): The name of the cluster. Returns: bool: True if the update job is allowed, False otherwise. rTrN)rcheck_existing_update_job ExceptionrrlUPDATE_JOB_PRESENT_MSGr)rrrrs rrz#UpdateCluster.is_update_job_allowedsY 0  ! ! ; ;LJZ [ 0 KK ! !&<&C&CQ]&C&^*. " 0 0s:AAc|jj||}|dur2|jjtj |dyy)a Check if a job name already exists. Args: vcenter_uuid (str): The UUID of the vCenter. job_name (str): The name of the job. Returns: bool: True if the job name exists, False otherwise. T)rOrN)rcheck_existing_job_namerrlJOB_NAME_ALREADY_EXISTS_MSGr)rrrOjob_exist_statuss rrz"UpdateCluster.is_job_name_existingsW 00HHW_` t # KK ! !&A&H&HRZ&H&[*. " 0 $rc d|ddi|dd|dd|dd|dd|dd|dd |dd |dd |dd |dd |ddd d}|dddur|dd|dd<i}|jdii|djD]\} } |  |dj| | i |d|d<|dd|d<n|d|d<|d|d<|jj||fi|\} } | jrB|jj || j \} }|j||| | |||| S|jjtd|  S)a5 Executes the firmware update job for a cluster. Args: vcenter_uuid (str): The UUID of the vCenter. cluster_group_id (str): The ID of the cluster group. payload (dict): The payload for the firmware update. parameters (dict): The parameters for the firmware update. before_dict (dict): The state of the system before the update. after_dict (dict): The state of the system after the update. Returns: dict: The response from the firmware update job. rGrIrr6r2r8r:r>r4r<r.r@r0r) r6r2r8r:r>r4r<r.r@r0r)rIrFrKrPrNTrjrk error_info) r!itemsrupdate_clustersuccessfirmware_update_job_track json_datahandle_job_responserrlFAILED_UPDATE_MSG)rrrr*r(rr tmp_payload final_payloadkeyvalueresp error_msgrerr_msgs rrz UpdateCluster.execute_update_jobs&$'*-h707z/BC`/a#J/ ;&z2=A'.z':;P'Q!(!4_!E.5j.AB^._-4Z-@A\-]#*:#67H#I%j1,?#*:#67H#I":.y9   $ : x (E 129*2Ej2QK #J / j"-.%j1779 ?JC j)00#u> ?$+9#5 i # $ ,.0M* +.56F.GM* +$+J$7 j!>$//>>|?ObS`bi << $ 5 5 O OP\PTP^P^!` Hg  $ $ZtXw%0* > KK ! !&7QZ ! [rc@|jd}|s'|jjtd|||dy|jjjd} | r|j ||||||y|jjt d|||dy)a\ Handle the response from the firmware update job. Args: parameters (dict): The parameters for the firmware update. vcenter_uuid (str): The UUID of the vCenter. resp (Response): The response from the firmware update. job_resp (dict): The response from the firmware update job. err_msg (str): The error message from the firmware update. before_dict (dict): The state of the system before the update. after_dict (dict): The state of the system after the update. Returns: None rHTrrjob_waitN)rBrrlrr wait_for_job_completionSUCCESS_UPDATE_SUBMIT_MSG) rr(rrrrrrrHrs rrz!UpdateCluster.handle_job_responses"..+ KK ! !&BD.62= 'S " U{{))--j9H,,\47-8*F %%*CT2:6AJ+W&Yrc4|jjjd}|dz}|ddvrU|dkDrPtjd|j j ||j\}}|dz}|ddvr|dkDrP|dkr1|jjtj|d||dd k(r2|d d d k(r'|jjtd|||d y|jjtd|y)a4 Waits for the firmware update job to complete. Args: vcenter_uuid (str): The UUID of the vCenter. resp (Response): The response from the firmware update. job_resp (dict): The response from the firmware update job. err_msg (str): The error message from the firmware update. before_dict (dict): The state of the system before the update. after_dict (dict): The state of the system after the update. Returns: None Raises: None job_wait_timeoutstate) COMPLETEDFAILEDrT)rjrkrrlastExecutionHistory statusSummary SUCCESSFULrrrN) rr rBtimesleeprrrrlFAILED_UPDATE_TIMEOUT_MSGrrr) rrrrrrrrcounts rrz%UpdateCluster.wait_for_job_completions-& ;;--112DE A%w'>>519 JJqM $ 5 5 O OP\PTP^P^!` Hg QJE w'>>519 A: KK ! !&?&F&FGW&X)-8 " E G  +9O0PQ`0aeq0q KK ! !&8$T\2= 'S " U KK ! !&7QX ! Yr)NN)r|r}r~rrrrrrrrrrrrrrrrrrrrqse/Mb3(@4KO37/*P4U4  3D&IP,P\0$0 8tY@#Zrrc idddidddidddidddd d dgd d d ddd dddd dddd dddidddidddd dddd dddiddgddddddiddddd d!d"dd!ddd#ddiddiddid$d%}t|gd&gd'} t|j5}t||}|j d(d(d(y(#1swYy(xYw#t $r}t |dd)}i} tj|}n"#t$rt ||d*<d+|d<YnwxYw|jd,k(r|jd*t ||d-<nF|jd.k(r t|d-<n-|j|jd*t ||d/|jd8i|Yd(}~y(d(}~wt$rg}d0|jjd1d2|jjd3d4dt |d5d6d7}|jd8i|Yd(}~y(d(}~wt tt"t$t&t(t*t,f$r&}|jt |d)Yd(}~y(d(}~wwxYw)9a\ The main function of the module. It sets up the argument spec and initializes the OMEVVAnsibleModule. It then creates an instance of the UpdateCluster class and calls its execute method. If any exceptions occur, it handles them and exits the module with the appropriate response. Args: None Returns: None r-typeboolrJrr/r1F)rdefaultr3)FULL_DATA_MIGRATIONENSURE_ACCESSIBILITYNO_DATA_MIGRATION)rchoicesr5rrwr7r9rMrOrTrir;r=) FORCEREBOOT SAFEREBOOT NEXTREBOOTr )rr rr?rH)rrequiredrr`dict)relementsr)r\rfrgrh)rrroptions)rHF)rJ) argument_spec required_ifsupports_check_modeNrimessagerirji)rjrzThe URL with IP rz and port portz cannot be reached.r)rr)rj unreachablerr)r r r rrrrjsonloadrrcoderBSOURCE_NOT_FOUND_MSGr!rlrIOError TypeErrorrAttributeError IndexErrorKeyErrorOSError) rrr omevv_objhttperr response_datarurlerrgenerrs rmainr(Bs=/ff-/fe_/ VV,/ f7 / )+ / )5R*H/ E:/ &U!C/ FE?!/" VUO#/$ V5%/& Ut<'/( '(8)/*  $ +/< '=/> F5?/@ # % $( #E?%uo   A/Mb # . ! F"7 v}} % %fh7I        * #G =   -7+J -$'LJy !!,Jv  - <<3 #->>)S_#MM% \\S #7M%  !~~iZA("  )=) *%fmm&7&7 &C%DJv}}O`O`agOhNii|}&)&k:F )=) ZO J' ;7S[667st CC<CC CC I2F.+DF.D F.D  B F.. I2:AH0I2 I--I2__main__)3 __future__rrrr __metaclass__ DOCUMENTATIONEXAMPLESRETURNrr+ansible.module_utils.six.moves.urllib.errorrransible.module_utils.urlsrAansible_collections.dellemc.openmanage.plugins.module_utils.omevvr r Aansible_collections.dellemc.openmanage.plugins.module_utils.utilsr \ansible_collections.dellemc.openmanage.plugins.module_utils.omevv_utils.omevv_firmware_utilsr r Xansible_collections.dellemc.openmanage.plugins.module_utils.omevv_utils.omevv_info_utilsrrrrrrrrsrxrmrnrrrrrrrrzUNREACHABLE_MSGrTRIGGER_UPDATE_CHECK_URIrrr(r|rrrr7s CB ` DX t $ K5k_SnNBP=N0(P$0U,)8%RbEKN29 3C@Fi2i2XNZNNZbg7T zFr