Vhq3&ddlmZmZmZeZdZdZdZddl Z ddl Z ddl Z ddl m Z ddlmZmZddlmZdd lmZmZdd lmZmZ dd lmZdd lmZd ZdZdZ dZ!dZ"dZ#dZ$dZ%dZ&dZ'dZ(dZ)dZ*dZ+dZ,d dZ-dZ.e/dk(re.yy#e$rdZY=wxYw)!)absolute_importdivisionprint_functiona --- module: redfish_firmware short_description: To perform a component firmware update using the image file available on the local or remote system version_added: "2.1.0" description: - This module allows the firmware update of only one component at a time. If the module is run for more than one component, an error message is returned. - Depending on the component, the firmware update is applied after an automatic or manual reboot. extends_documentation_fragment: - dellemc.openmanage.redfish_auth_options options: image_uri: description: - Firmware Image location URI or local path. - For example- U(http:///components.exe) or /home/firmware_repo/component.exe. type: str required: true transfer_protocol: description: Protocol used to transfer the firmware image file. Applicable for URI based update. type: str default: HTTP choices: ["CIFS", "FTP", "HTTP", "HTTPS", "NSF", "OEM", "SCP", "SFTP", "TFTP"] job_wait: description: Provides the option to wait for job completion. type: bool default: true job_wait_timeout: type: int 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). - "Note: If a firmware update needs a reboot, the job will get scheduled and waits for no of seconds specfied in I(job_wait_time). to reduce the wait time either give I(job_wait_time) minimum or make I(job_wait)as false and retrigger." default: 3600 requirements: - "python >= 3.9.6" - "urllib3" author: - "Felix Stephen (@felixs88)" - "Husniya Hameed (@husniya_hameed)" - "Shivam Sharma (@Shivam-Sharma)" - "Kritika Bhateja (@Kritika_Bhateja)" - "Abhishek Sinha (@ABHISHEK-SINHA10)" notes: - Run this module from a system that has direct access to Redfish APIs. - This module supports both IPv4 and IPv6 addresses. - This module supports only iDRAC9 and above. - This module does not support C(check_mode). a  --- - name: Update the firmware from a single executable file available in a HTTP protocol dellemc.openmanage.redfish_firmware: baseuri: "192.168.0.1" username: "user_name" password: "user_password" ca_path: "/path/to/ca_cert.pem" image_uri: "http://192.168.0.2/firmware_repo/component.exe" transfer_protocol: "HTTP" - name: Update the firmware from a single executable file available in a HTTP protocol with job_Wait dellemc.openmanage.redfish_firmware: baseuri: "192.168.0.1" username: "user_name" password: "user_password" ca_path: "/path/to/ca_cert.pem" image_uri: "http://192.168.0.2/firmware_repo/component.exe" transfer_protocol: "HTTP" job_wait: true job_wait_timeout: 600 - name: Update the firmware from a single executable file available in a local path dellemc.openmanage.redfish_firmware: baseuri: "192.168.0.1" username: "user_name" password: "user_password" ca_path: "/path/to/ca_cert.pem" image_uri: "/home/firmware_repo/component.exe" a( --- msg: description: Overall status of the firmware update task. returned: always type: str sample: "Successfully updated the firmware." task: description: Returns ID and URI of the created task. returned: success type: dict sample: { "id": "JID_XXXXXXXXXXXX", "uri": "/redfish/v1/TaskService/Tasks/JID_XXXXXXXXXXXX" } error_info: type: dict description: Details of http error. returned: on http error sample: { "error": { "@Message.ExtendedInfo": [ { "Message": "Unable to complete the operation because the JSON data format entered is invalid.", "Resolution": "Do the following and the retry the operation: 1) Enter the correct JSON data format and retry the operation. 2) Make sure that no syntax error is present in JSON data format. 3) Make sure that a duplicate key is not present in JSON data format.", "Severity": "Critical" }, { "Message": "The request body submitted was malformed JSON and could not be parsed by the receiving service.", "Resolution": "Ensure that the request body is valid JSON and resubmit the request.", "Severity": "Critical" } ], "code": "Base.1.2.GeneralError", "message": "A general error has occurred. See ExtendedInfo for more information." } } N)SSLError)RedfishRedfishAnsibleModule)missing_required_lib)ConnectionErrorSSLValidationError)URLError HTTPError) RequestField)encode_multipart_formdataTF UpdateServicezJobService/Jobs/{job_id}z%Job wait timed out after {0} seconds.zFirmware update failed.z"Successfully updated the firmware.z(Successfully scheduled the firmware job.successfailed timed_out schedulederroredcg}|jd\}}}|j}td||}|j||j |t |\}}||fS)z+Encode multipart/form-data for file upload.file)namedatafilename) content_type)getreadrmake_multipartappendr) payload_filefieldsf_namef_dataf_typef_binary req_fieldrrs w/home/dcms/DCMS/lib/python3.12/site-packages/ansible_collections/dellemc/openmanage/plugins/modules/redfish_firmware.py_encode_form_datar(sn F)--f5FFF{{}H&x&II &1 MM)26:D,  c~|jddj|jt}|jd}|j d}d}|jj d}|jj dj d}d |vrm|j d }|j d } t| tr|| vrd |vr|j d }n!|jd j| ||||jd t|t|t|fS)zFReturns all the URI which is required for firmware update dynamically.GET{0}{1}Actionstransfer_protocolN HttpPushUriFirmwareInventoryz @odata.idz#UpdateService.SimpleUpdatez(TransferProtocol@Redfish.AllowableValuestargetz6Target firmware version does not support {0} protocol.msgzATarget firmware version does not support redfish firmware update.) invoke_requestformatroot_uriUPDATE_SERVICE json_dataparamsr isinstancelist fail_jsonstr) objmodule action_resp action_attrprotocol update_uripush_uri inventory_uriupdate_serviceprotos r'_get_update_service_targetrHs)$$UHOOCLL.,YZK'' 2K}}01HJ$$((7H))--.ABFF{SM$ 3$)FG""#MN eT "x5'8X=W'++H5J   !Y!`!`ai!j  kX-1F`a } s8}c*o ==r)c  |jjd}|jd}t||\}}}|jdr||d}|j d||}|S|j d|} t t jj|d5} d |jt jd | d fi} t| \} } d d d d | jjdi}|jd i|j d| |d|jd}|jdk(r3d|jjdi}|j d||}|S|}|S#1swYxYw)zJFirmware update using single binary file from Local path or HTTP location. image_urir.http)ImageURITransferProtocolPOST)rr+rbrzmultipart/form-dataNzIf-Matchetagz Content-TypeFtimeout)rheadersdump api_timeoutrLlocation)r9rrH startswithr4openospathjoinsplitsepr(rSupdate status_code)r>r? image_path trans_protorErDrCpayload update_statusresp_invimg_filebinary_payloadrctyperS upload_statuss r'firmware_updaterjs"";/J-- 34K*DS&*Q'M8ZV$){K**6:G*L  %%e]; "'',,z*D 1 track_counterfinal_jobstatusjob_msgresponse error_messages r'wait_for_job_completionrs", V]] 6 :#M OG#33)"11%W^9_`H))--.?@CGHL^L^LbLbcmLnr}L}#--11+>$F.?O&5G.>O&2G!X-MJJx( #33$#%%))*;<AhFXFXF\F\]gFhlvFv&9O.G+112BCG&9O; :D G ###"8,)!X-MJJx()# : :< ,m$S\*+ G ## ,seF FBEFE F&A&F F)FFFFF F G,GGcdddddgdddddd dd d d d }t|d }ts|jtd d}t |j d5}t ||}|jr2d}|jjd}|jdd}n&|j|tj|ddd|j d}|j d}|r|dkDrtj} t|| |j d\} } | t k(r,|j#| |tj|ddy|j#| |tj|ddy|j#|tj|ddy#1swYxYw#t$$r:} |j#t'| tj(| dYd} ~ yd} ~ wt*t,t.t0t2t4t6t8t:t<t>t@f $r%} |jt'| Yd} ~ yd} ~ wwxYw) NTr=)requiredtypeHTTP) CIFSFTPrHTTPSNSFOEMSCPSFTPTFTP)rdefaultchoicesFbool)rrrinti)rJr.job_waitr) argument_specsupports_check_modeurllib3r2z*Failed to submit the firmware update task.rlz0Successfully submitted the firmware update task.Location/rP)r3 error_inforrr)job_id)r)iduri)r3taskr)r3rchanged)r3rr)!rHAS_LIBr<r rr9rjrrSrr]jsonloadsJOB_URIr5rrxrr r=load RuntimeErrorr r r KeyError ImportError ValueError TypeErrorIOErrorAssertionErrorOSErrorr)specsr?messager>statustask_urirrrrjob_resprerres r'mainr sB"&6&+LQR!&4H).$O  E"!#F 1)<=%> V]] 5 M$S&1F~~L!>>--j9!,R0  WF9K L M==,!==);< (1,nnFn3G 7Z`ZgZghzZ{ | Hg++  W&_eIf3gpt u  W&_eIf3gqu v   fW^^[a^Eb/cmq  r% M M& OSX$))C.NN ($6 YRZ \%SV$$%sKG !A1GBG (+G +G G G I30H  AI3I..I3__main__)i)0 __future__rrrr __metaclass__ DOCUMENTATIONEXAMPLESRETURNrrZrzsslrCansible_collections.dellemc.openmanage.plugins.module_utils.redfishrransible.module_utils.basicr ansible.module_utils.urlsr r +ansible.module_utils.six.moves.urllib.errorr r urllib3.fieldsrurllib3.filepostrrrr7rr~ryrwr}rvrxrr|rr(rHrjrr__name__r)r'rsCB 2 h >) X m;IK+:G! $6 ( 6=!! >(0$$N&%R zFqGsBBB