VhhxddlmZmZmZeZdZdZdZddl Z ddl Z ddl Z ddl m Z mZddlmZmZddlmZdd lmZmZdd lmZmZmZmZmZd Zd Zd ZdZ dZ!dZ"dZ#dZ$dZ%dZ&dZ'dZ(dZ)dZ*dZ+dZ,dZ-dZ.dZ/dZ0dZ1d Z2d!Z3d"Z4d#Z5d$Z6d%Z7d&Z8d'Z9d(Z:gd)Z;d*d+gZd/Z?Gd0d1Z@Gd2d3ZAd4ZBeCd5k(reByy)6)absolute_importdivisionprint_functiona --- module: idrac_reset short_description: Factory reset the iDRACs version_added: "2.1.0" description: - This module resets the iDRAC to factory default settings. extends_documentation_fragment: - dellemc.openmanage.idrac_x_auth_options options: reset_to_default: type: str description: - If this value is not set the default behaviour is to restart the iDRAC. - C(All) Discards all settings and reset to default credentials. - C(ResetAllWithRootDefaults) Discards all settings and reset the default username to root and password to the shipping value. - C(Default) Discards all settings, but preserves user and network settings. - C(CustomDefaults) All configuration is set to custom defaults.This option is supported on firmware version 7.00.00.00 and newer versions. choices: ['Default', 'All', 'ResetAllWithRootDefaults', 'CustomDefaults'] version_added: 9.2.0 custom_defaults_file: description: - Name of the custom default configuration file in the XML format. - This option is applicable when I(reset_to_default) is C(CustomDefaults). - I(custom_defaults_file) is mutually exclusive with I(custom_defaults_buffer). type: str version_added: 9.2.0 custom_defaults_buffer: description: - This parameter provides the option to import the buffer input in XML format as a custom default configuration. - This option is applicable when I(reset_to_default) is C(CustomDefaults). - I(custom_defaults_buffer) is mutually exclusive with I(custom_defaults_file). type: str version_added: 9.2.0 wait_for_idrac: description: - This parameter provides the option to wait for the iDRAC to reset and lifecycle controller status to be ready. type: bool default: true version_added: 9.2.0 job_wait_timeout: description: - Time in seconds to wait for job completion. - This is applicable when I(wait_for_idrac) is C(true). type: int default: 600 version_added: 9.2.0 force_reset: description: - This parameter provides the option to force reset the iDRAC without checking the iDRAC lifecycle controller status. - This option is applicable only for iDRAC9. type: bool default: false version_added: 9.2.0 default_username: description: - This parameter is only applied when I(reset_to_default) is C(All) or C(ResetAllWithRootDefaults). - This parameter is required to track LifeCycle status of the server after the reset operation is performed. If this parameter is not provided, then the LifeCycle status is not tracked after the reset operation. type: str version_added: 9.4.0 default_password: description: - This parameter is only applied when I(reset_to_default) is C(All) or C(ResetAllWithRootDefaults). - This parameter is required to track LifeCycle status of the server after the reset operation is performed. If this parameter is not provided, then the LifeCycle status is not tracked after the reset operation. type: str version_added: 9.4.0 requirements: - "python >= 3.9.6" author: - "Felix Stephen (@felixs88)" - "Anooja Vardhineni (@anooja-vardhineni)" - "Lovepreet Singh (@singh-lovepreet1)" - "Abhishek Sinha (@ABHISHEK-SINHA10)" notes: - Run this module from a system that has direct access to Dell iDRAC. - This module supports both IPv4 and IPv6 address for I(idrac_ip). - This module supports C(check_mode). - If reset_to_default option is not specified, then this module triggers a graceful restart. - This module skips the execution if reset options are not supported by the iDRAC. a --- - name: Reset the iDRAC to default and do not wait till the iDRAC is accessible. dellemc.openmanage.idrac_reset: idrac_ip: "192.168.0.1" idrac_user: "user_name" idrac_password: "user_password" ca_path: "/path/to/ca_cert.pem" reset_to_default: "Default" wait_for_idrac: false - name: Reset the iDRAC to All and wait for lifecycle controller status to be ready. dellemc.openmanage.idrac_reset: idrac_ip: "192.168.0.1" idrac_user: "user_name" idrac_password: "user_password" ca_path: "/path/to/ca_cert.pem" reset_to_default: "All" wait_for_idrac: true default_username: "user_name" default_password: "user_password" - name: Force reset the iDRAC to default. dellemc.openmanage.idrac_reset: idrac_ip: "192.168.0.1" idrac_user: "user_name" idrac_password: "user_password" ca_path: "/path/to/ca_cert.pem" reset_to_default: "Default" force_reset: true - name: Gracefully restart the iDRAC. dellemc.openmanage.idrac_reset: idrac_ip: "192.168.0.1" idrac_user: "user_name" idrac_password: "user_password" ca_path: "/path/to/ca_cert.pem" - name: Reset the iDRAC to custom defaults XML and do not wait till the iDRAC is accessible. dellemc.openmanage.idrac_reset: idrac_ip: "192.168.0.1" idrac_user: "user_name" idrac_password: "user_password" ca_path: "/path/to/ca_cert.pem" reset_to_default: "CustomDefaults" custom_defaults_file: "/path/to/custom_defaults.xml" - name: Reset the iDRAC to custom defaults buffer input and do not wait till the iDRAC is accessible. dellemc.openmanage.idrac_reset: idrac_ip: "192.168.0.1" idrac_user: "user_name" idrac_password: "user_password" ca_path: "/path/to/ca_cert.pem" reset_to_default: "CustomDefaults" custom_defaults_buffer: "\n\n Disabled\n \n\n" aq --- msg: type: str description: Status of the iDRAC reset operation. returned: always sample: "Successfully performed iDRAC reset." reset_status: type: dict description: Details of iDRAC reset operation. returned: reset operation is triggered. sample: { "idracreset": { "Data": { "StatusCode": 204 }, "Message": "none", "Status": "Success", "StatusCode": 204, "retval": true } } error_info: description: Details of the HTTP Error. returned: on HTTP error type: dict sample: { "error": { "code": "Base.1.0.GeneralError", "message": "A general error has occurred. See ExtendedInfo for more information.", "@Message.ExtendedInfo": [ { "MessageId": "GEN1234", "RelatedProperties": [], "Message": "Unable to process the request because an error occurred.", "MessageArgs": [], "Severity": "Critical", "Resolution": "Retry the operation. If the issue persists, contact your system administrator." } ] } } N) HTTPErrorURLError)iDRACRedfishAPIIdracAnsibleModule) LooseVersion)ConnectionErrorSSLValidationError)get_idrac_firmware_version remove_keyget_dynamic_uri&validate_and_get_first_resource_id_uriidrac_redfish_job_trackingz/redfish/v1/ManagersOemDellActions2z3/redfish/v1/Managers/iDRAC.Embedded.1/Jobs/{job_id}z{reset_to_default} is not supported. The supported values are {supported_values}. Enter the valid values and retry the operation.z${reset_to_default} is not supported.z{reset_to_default} is not supported on this firmware version of iDRAC. The supported values are {supported_values}. Enter the valid values and retry the operation.z/iDRAC restart operation completed successfully.z#Successfully performed iDRAC reset.z-iDRAC reset operation triggered successfully.z/iDRAC restart operation triggered successfully.z,Provided directory path '{path}' is invalid.z&Failed to perform the reset operation.zhiDRAC reset is in progress. Changes will apply once the iDRAC reset operation is successfully completed.ztThe value of `job_wait_timeout` parameter cannot be negative or zero. Enter the valid value and retry the operation.zRFile extension is invalid. Supported extension for 'custom_default_file' is: .xml.z]Lifecycle controller status check is {lc_status} after {retries} number of retries, Exiting..zlProvided directory path '{path}' is not writable. Please check if the directory has appropriate permissions.z3Lifecycle controller status check is not supported.z7.00.00zNo changes found to commit!zChanges found to commit!z @odata.id (.*?)@odataz SuccessFailed)iiAllResetAllWithRootDefaultsz Oem.#DellManager.ResetToDefaults#Manager.Resetc>eZdZdZdZdZdZdZdZdZ d d Z y) ValidationcJ||_||_|j|_y)N)idracmodule get_base_uribase_uri)selfr#r$s r/home/dcms/DCMS/lib/python3.12/site-packages/ansible_collections/dellemc/openmanage/plugins/modules/idrac_reset.py__init__zValidation.__init__s   ))+ ct|j|jt\}}|r|jj |d|S)NTmsgfailed)rr$r# MANAGERS_URI exit_json)r'uri error_msgs r(r%zValidation.get_base_uris>? KK\3Y  KK ! !i ! = r*c|jj|jd}|jjj d}|j dd}d}d}|d|jdvrF|d|jd|dvr,|jd|d|d}|d}|}||vrd }||fSd }||fS) NGETreset_to_default.Trr!ResetType@Redfish.AllowableValuesF)r#invoke_requestr&r$paramsgetsplit json_data) r'api_keyresr5key_listis_validallowed_valuesreset_to_defaults_valreset_type_valuess r(validate_reset_optionsz!Validation.validate_reset_options sjj'' u=;;--112DE==a( A;#-- 2 2x{cmmT]F^_ghi_jFk7k$'MM)$r?rArCrDs r( validate_graceful_restart_optionz+Validation.validate_graceful_restart_optionssjj'' u= cmmI. .$'MM)$ ((<,001LbQC \ ))#u5 \xx?* %%*@*G*GYi}L*G+MW[%\\+ \sA11 C :ACC NN) __name__ __module__ __qualname__r)r%rErHrNrYr^rnr*r(r!r!s., ( Qq E \r*r!cdeZdZdZdZdZdZdZddZdZ dZ d Z dd Z d Z d Zd ZdZy) FactoryResetc||_||_||_|jjj d|_|jjj d|_|jjj d|_t|j|j|_ |jj|_ t|j|_ y)Nr5 force_resetrJ)r#r$rjr:r;r5rwrJr! validate_objr&r1r idrac_firmware_version)r'r#r$rjs r(r)zFactoryReset.__init__Ds  . $ 2 2 6 67I J;;--11-@"kk00445EF&tzz4;;?$$--&@&L#r*czd\}}|jj|j}|s|jr|jj t \}}|j jr"|s |j jt|s;|j jtj|jd|j jr|j||r*|jr|js|jddDcic]}||j}}|j!|j"|j$d |t'|j\}}|r(|j(r|jr|j||fScc}w) Nror-)r5TrcF)post_op)Defaultrr)CustomDefaultsNone)rxrNis_check_idrac_latestr5rE RESET_KEYr$ check_moder0CHANGES_NOT_FOUNDRESET_TO_DEFAULT_ERROR_MSGrTcheck_mode_outputrwcheck_lcstatusreset_to_default_mappedupdatereset_custom_defaultsgraceful_restartstrrJ)r'msg_resjob_res is_idrac9rBis_valid_optionkeyreset_status_mappings r(executezFactoryReset.executeOs% ..0..0 T22.2.?.?.V.VW`.a +NO{{%%o %%*;%<" %%*D*K*K]a]r]r*K*s.2&4 ;; ! !  " "9 - ..t7G7G     .M{|cT%A%A A||##"88))%  L/D4I4I0JKM ,,1F1F    ! }s,F8c|rK|jdk(rr*c|jjjdx}rK|jjjdx}r#||j_||j_yyy)Ndefault_usernamedefault_passwordT)r$r:r;r#usernamepassword)r'rrs r(+update_credentials_for_post_lc_statuc_checkz8FactoryReset.update_credentials_for_post_lc_statuc_check|sm $ 2 2 6 67I J J  J $ 2 2 6 67I J J  J"2DJJ "2DJJ  K Kr*c|jtvr|r|jsyi}d|d<d}t|j|j d}|j tij tij dij ti}|rMt|j|}|j tij dij di}n!|jjtd |tkry |jjd d d }|j j d} | |d<|j ddk(rn$t#j$d|dz}|tkry|tk(rW|j ddk7rB|jjt(j+|j d|d yyy#t&$r\t#j$d|dz}|tk(r6|jjt(j+dtdYwxYw)NLCStatusr7Links DellLCServicez)#DellLCService.GetRemoteServicesAPIStatustargetTr,POSTz{}F)datadumpReady unreachable) lc_statusretriesr-r)r5PASSWORD_CHANGE_OPTIONSrrr#r1r;rerfODATA_IDACTIONSr$r0UNSUPPORTED_LC_STATUS_MSGIDRAC_RESET_RETRIESr9r=timesleepr LC_STATUS_MSGrT) r'r|lc_status_dict retry_countrlrk action_resplc_urllcstatus lcstatus_datas r(rzFactoryReset.check_lcstatuss$  $; ;??A %'z" tzz488W=hhsB##L"599/2NRRS[]_` )$**c:K __Wb1556acefjjksuwxF KK ! !&? ! M// L::44VV$UZ4[ ( 2 2 6 6z B -:z*!%%j1W< 2)Ao // - -.2D2DZ2PT[2[ KK ! !m&:&:^EWEWXbEcmx&:&yCG ! H3\ -  L 2)Ao "55KK))m.B.B]dw.B.xGK)L  LsAG1,G11A"IIci}i}i|d<d|i|dd<||dd<d\}}|tvr|jr3|j\}}}|r|jj |d|jrt nt |d<d|d<|jrt nt |dd <d |dd <d|dd <n*t|d<d |d<t|dd <d|dd <d |dd <|jrd}||fS)N idracreset StatusCodeDataroTrr-rMessagerStatusretValFFAILED) STATUS_SUCCESSrJwait_for_port_openr$r0IDRAC_RESET_SUCCESS_MSGIDRAC_RESET_RESET_TRIGGER_MSGFAILED_RESET_MSGr5)r'statusresulttmp_res track_failedwait_msg status_codes r( create_outputzFactoryReset.create_outputs3!|(4f'=|V$-3|\*!+ h ^ #""6:6M6M6O3 k8KK))h)E8<8K8K4QnGEN!%GI IMI\I\.EbF<  +-6F<  *-1F<  *-GEN!&GI .>F<  +-5F<  *-2F<  *  Fr*cNd\}}d}t|j|jt}|r6|j t ij dij di}|jj |d|}|j}|j|\}}||fS)Nroz#DellManager.ResetToDefaultsrrr) rr#r1rr;rer9rr)r'payloadrr?rkrlrun_reset_statusrs r(perform_operationzFactoryReset.perform_operations! tzz488W= ((3#''(FKOOPXZ\]C::44S&w4O!--))&1 |r*cd|i}|jjjd}d}t|j|j t }|r6|jtijdijdi}|jj|d|}|jjdx}r|jdd }tj| } t|j| |d \} } } } t| d } | r.|jj| jd| dyyy)Nr~rKz#DellManager.SetCustomDefaultsrrrLocation/)job_idr7)max_job_wait_secsleep_interval_secsr) regex_patternrT)r- job_statusr.)r$r:r;rr#r1rrer9headersr< IDRAC_JOB_URIrTrrr0)r'rrrKrkrljob_respjob_tracking_urirjob_uri job_failedr-job_dict wait_times r(upload_cd_contentzFactoryReset.upload_cd_contents5#T*;;--112DEtzz488W= ((3#''(H"MQQRZ\^_C::,,S&w,G ( 0 0 4 4Z @ @  @%++C04F#**&*9G3MdjjZa_obc4e 0JXy"(-HH %%(,,y*Ah_c%d Ar*c6|jjjd}tj|t }|}d}d}t |dkDrA |jjtdtj|t}d}d} |||fS#t$r@}|j}|dk(r%tj|d zt}d}Yd}~DYd}~n,d}~wt$rtj|||z }YnwxYwt |dkDrŌ) NrKTirr4Fri)r$r:r;rr RESET_UNTRACKintr#r9r/rrrg Exception)r'interval timeout_waitr-waitrrrms r(rzFactoryReset.wait_for_port_opens{{))--.@A  8  $i!m ' )),> 8$-$ ! [#-- !hh #%JJx1}-1C#(L &  ' 8$h '$i!ms?B D$1C&DDcd|ji}|jjt\|_}|sF|j j tj|j|jd|j|S)N ResetTyperaTrc) r5rxrErrjr$r0rirTr)r'rrs r(rz$FactoryReset.reset_to_default_mappeds 5 56040A0A0X0XYb0c-o KK ! !&<&C&CUYUjUj~B~R~R&C'S*. " 0%%g..r*cjt|d5}|j}ddd|S#1swYSxYw)Nr)openread)r'rXfile xml_contents r(get_xml_contentzFactoryReset.get_xml_contents5 )S ! &T))+K & &s(2c|jjt\|_}t |j t krF|jjtj|j|jd|jjjd}|jjjd}d}d}|rJ|jj||jj|d}|j!|}n|rd}|}|r|j#||jj%|j|j|j'S)NraTrcrrF)rxrErrjr ryrr$r0 CUSTOM_ERRORrTr5r:r;rYr^rrrnr)r'rrr upload_perfom default_datas r(rz"FactoryReset.reset_custom_defaultssH040A0A0X0XYb0c-o 33 47Y Y KK ! !l&9&94K`K`KOK_K_':'ajn " p"kk00445KL $ 2 2 6 67O P      + +,? @    2 23F G M//0CDL " M0L   " "< 0 001F1FH\H\]++--r*cd}t|j|jt}|r"|j dij di}ddi}|jj |d|}|j }|j|\}}|tvr't|d<|jrtnt|dd <||fS) NrrrrGrrr-rr) rr#r1rr;r9rrrrrJIDRAC_RESET_RESTART_SUCCESS_MSGIDRAC_RESET_RESTART_TRIGGER_MSG)r'rkrlrrrrs r(rzFactoryReset.graceful_restartstzz488W= ((+R044XrBC 12::44S&w4O!--**62  ^ #4GENOSObOb,KiHD y )}r*N)T)-)rprqrrr)rrrrrrrrrrrrrrsr*r(ruruCsL M 29 HB6 e$.6/ ., r*ruc dgdiddiddiddddd ddd dddiddd d }t|d gdgd} t|j5}|dd}t|||}|j \}}|rX|j ds#|j |j d|d|j |j d|dnU|j ds"|j |j dd|j |j dddddy#1swYyxYw#t$r:}|j t|tj|dYd}~yd}~wt$r&}|j t|dYd}~yd}~wttttt t"t$f$r&}|j t|dYd}~yd}~wwxYw)Nchoices)rrr}r~typerboolT)rdefaultriXF)rno_log)r5rrrJrKrwrr)rr)rr) argument_specmutually_exclusiverequired_togethersupports_check_moder5rr-)r- reset_statusr.)r-rrr,r)r- error_infor.r)r rr:rurr;r0rrjsonloadr RuntimeErrorr r TypeErrorKeyError ValueErrorOSError)specsr$r#rj reset_obj message_respoutputrms r(mainr*s&(hi!'#)5/#)d;%*s; &59#UO%*d; E NOCD "F 4 V]] + Lu#$67 BO$UFODI#,#4#4#6 L&#'' 2$$)9)9%)@v^b$c  \%5%5e%<6[_ `#'' 2$$)9)9%)@$N  \%5%5e%r-s]CB U n8 t* X ,y<IAA&   E ]C1 "S? O"SF;z  Vgo )W%Q%."1*     * "<= . 'C\C\LddN#4L zFr*