Vh=[ddlmZmZmZeZdZdZdZddl Z ddl Z ddl m Z m Z ddlmZddlmZmZdd lmZd Zd Zd Zd ZdZdZdZdZdZdZd dZdZ dZ!dZ"dZ#dZ$dZ%dZ&dZ'dZ(dZ)e*dk(re)yy)!)absolute_importdivisionprint_functionaE --- module: idrac_attributes short_description: Configure the iDRAC attributes. version_added: "6.0.0" description: - This module allows to configure the iDRAC attributes. extends_documentation_fragment: - dellemc.openmanage.idrac_x_auth_options options: idrac_attributes: type: dict description: - "Dictionary of iDRAC attributes and value. The attributes should be part of the Integrated Dell Remote Access Controller Attribute Registry. To view the list of attributes in Attribute Registry for iDRAC9 and above, see, U(https://I(idrac_ip)/redfish/v1/Managers/iDRAC.Embedded.1/Oem/Dell/DellAttributes/iDRAC.Embedded.1) and U(https://I(idrac_ip)/redfish/v1/Registries/ManagerAttributeRegistry)." - "For iDRAC8 based servers, derive the manager attribute name from Server Configuration Profile. If the manager attribute name in Server Configuration Profile is .# (for Example, 'SNMP.1#AgentCommunity') then the equivalent attribute name for Redfish is .. (for Example, 'SNMP.1.AgentCommunity')." system_attributes: type: dict description: - "Dictionary of System attributes and value. The attributes should be part of the Integrated Dell Remote Access Controller Attribute Registry. To view the list of attributes in Attribute Registry for iDRAC9 and above, see, U(https://I(idrac_ip)/redfish/v1/Managers/iDRAC.Embedded.1/Oem/Dell/DellAttributes/System.Embedded.1) and U(https://I(idrac_ip)/redfish/v1/Registries/ManagerAttributeRegistry)." - "For iDRAC8 based servers, derive the manager attribute name from Server Configuration Profile. If the manager attribute name in Server Configuration Profile is .# (for Example, 'ThermalSettings.1#ThermalProfile') then the equivalent attribute name for Redfish is .. (for Example, 'ThermalSettings.1.ThermalProfile')." lifecycle_controller_attributes: type: dict description: - "Dictionary of Lifecycle Controller attributes and value. The attributes should be part of the Integrated Dell Remote Access Controller Attribute Registry.To view the list of attributes in Attribute Registry for iDRAC9 and above, see, U(https://I(idrac_ip)/redfish/v1/Managers/iDRAC.Embedded.1/Oem/Dell/DellAttributes/LifecycleController.Embedded.1) and U(https://I(idrac_ip)/redfish/v1/Registries/ManagerAttributeRegistry)." - "For iDRAC8 based servers, derive the manager attribute name from Server Configuration Profile. If the manager attribute name in Server Configuration Profile is .# (for Example, 'LCAttributes.1#AutoUpdate') then the equivalent attribute name for Redfish is .. (for Example, 'LCAttributes.1.AutoUpdate')." resource_id: type: str description: Redfish ID of the resource. requirements: - "python >= 3.9.6" author: - Husniya Abdul Hameed (@husniya-hameed) - Felix Stephen (@felixs88) notes: - Run this module from a system that has direct access to Dell iDRAC. - This module supports C(check_mode). - For iDRAC8 based servers, the value provided for the attributes are not be validated. Ensure appropriate values are passed. a --- - name: Configure iDRAC attributes dellemc.openmanage.idrac_attributes: idrac_ip: "192.168.0.1" idrac_user: "user_name" idrac_password: "user_password" ca_path: "/path/to/ca_cert.pem" idrac_attributes: SNMP.1.AgentCommunity: public - name: Configure System attributes dellemc.openmanage.idrac_attributes: idrac_ip: "192.168.0.1" idrac_user: "user_name" idrac_password: "user_password" ca_path: "/path/to/ca_cert.pem" system_attributes: ThermalSettings.1.ThermalProfile: Sound Cap - name: Configure Lifecycle Controller attributes dellemc.openmanage.idrac_attributes: idrac_ip: "192.168.0.1" idrac_user: "user_name" idrac_password: "user_password" ca_path: "/path/to/ca_cert.pem" lifecycle_controller_attributes: LCAttributes.1.AutoUpdate: Enabled - name: Configure the iDRAC attributes for email alert settings. dellemc.openmanage.idrac_attributes: idrac_ip: "192.168.0.1" idrac_user: "user_name" idrac_password: "user_password" ca_path: "/path/to/ca_cert.pem" idrac_attributes: EmailAlert.1.CustomMsg: Display Message EmailAlert.1.Enable: Enabled EmailAlert.1.Address: test@test.com - name: Configure the iDRAC attributes for SNMP alert settings. dellemc.openmanage.idrac_attributes: idrac_ip: "192.168.0.1" idrac_user: "user_name" idrac_password: "user_password" ca_path: "/path/to/ca_cert.pem" idrac_attributes: SNMPAlert.1.Destination: 192.168.0.2 SNMPAlert.1.State: Enabled SNMPAlert.1.SNMPv3Username: username - name: Configure the iDRAC attributes for SMTP alert settings. dellemc.openmanage.idrac_attributes: idrac_ip: "192.168.0.1" idrac_user: "user_name" idrac_password: "user_password" ca_path: "/path/to/ca_cert.pem" idrac_attributes: RemoteHosts.1.SMTPServerIPAddress: 192.168.0.3 RemoteHosts.1.SMTPAuthentication: Enabled RemoteHosts.1.SMTPPort: 25 RemoteHosts.1.SMTPUserName: username RemoteHosts.1.SMTPPassword: password - name: Configure the iDRAC attributes for webserver settings. dellemc.openmanage.idrac_attributes: idrac_ip: "192.168.0.1" idrac_user: "user_name" idrac_password: "user_password" ca_path: "/path/to/ca_cert.pem" idrac_attributes: WebServer.1.SSLEncryptionBitLength: 128-Bit or higher WebServer.1.TLSProtocol: TLS 1.1 and Higher - name: Configure the iDRAC attributes for SNMP settings. dellemc.openmanage.idrac_attributes: idrac_ip: "192.168.0.1" idrac_user: "user_name" idrac_password: "user_password" ca_path: "/path/to/ca_cert.pem" idrac_attributes: SNMP.1.SNMPProtocol: All SNMP.1.AgentEnable: Enabled SNMP.1.TrapFormat: SNMPv1 SNMP.1.AlertPort: 162 SNMP.1.AgentCommunity: public - name: Configure the iDRAC LC attributes for collecting system inventory. dellemc.openmanage.idrac_attributes: idrac_ip: "192.168.0.1" idrac_user: "user_name" idrac_password: "user_password" ca_path: "/path/to/ca_cert.pem" lifecycle_controller_attributes: LCAttributes.1.CollectSystemInventoryOnRestart: Enabled - name: Configure the iDRAC system attributes for LCD configuration. dellemc.openmanage.idrac_attributes: idrac_ip: "192.168.0.1" idrac_user: "user_name" idrac_password: "user_password" ca_path: "/path/to/ca_cert.pem" system_attributes: LCD.1.Configuration: Service Tag LCD.1.vConsoleIndication: Enabled LCD.1.FrontPanelLocking: Full-Access LCD.1.UserDefinedString: custom string - name: Configure the iDRAC attributes for Timezone settings. dellemc.openmanage.idrac_attributes: idrac_ip: "192.168.0.1" idrac_user: "user_name" idrac_password: "user_password" ca_path: "/path/to/ca_cert.pem" idrac_attributes: Time.1.Timezone: CST6CDT NTPConfigGroup.1.NTPEnable: Enabled NTPConfigGroup.1.NTP1: 192.168.0.5 NTPConfigGroup.1.NTP2: 192.168.0.6 NTPConfigGroup.1.NTP3: 192.168.0.7 - name: Configure all attributes dellemc.openmanage.idrac_attributes: idrac_ip: "192.168.0.1" idrac_user: "user_name" idrac_password: "user_password" ca_path: "/path/to/ca_cert.pem" idrac_attributes: SNMP.1.AgentCommunity: test SNMP.1.AgentEnable: Enabled SNMP.1.DiscoveryPort: 161 system_attributes: ServerOS.1.HostName: demohostname lifecycle_controller_attributes: LCAttributes.1.AutoUpdate: Disabled - name: Enable idrac basic syslog dellemc.openmanage.idrac_attributes: idrac_ip: "192.168.0.1" idrac_user: "user_name" idrac_password: "user_password" ca_path: "/path/to/ca_cert.pem" idrac_attributes: SysLog.1.SysLogEnable: Enabled SysLog.1.Server1: 192.168.0.2 SysLog.1.Server2: 192.168.0.3 SysLog.1.Server3: 192.168.0.4 SysLog.1.Port: 514 - name: Disable idrac basic syslog dellemc.openmanage.idrac_attributes: idrac_ip: "192.168.0.1" idrac_user: "user_name" idrac_password: "user_password" ca_path: "/path/to/ca_cert.pem" idrac_attributes: SysLog.1.SysLogEnable: Disabled - name: Enable idrac secure syslog dellemc.openmanage.idrac_attributes: idrac_ip: "192.168.0.1" idrac_user: "user_name" idrac_password: "user_password" ca_path: "/path/to/ca_cert.pem" idrac_attributes: SysLog.1.securesyslogenable: Enabled SysLog.1.secureserver1: 192.168.0.2 SysLog.1.secureport: 6511 SysLog.1.secureclientauth: Anonymous - name: Disable idrac secure syslog dellemc.openmanage.idrac_attributes: idrac_ip: "192.168.0.1" idrac_user: "user_name" idrac_password: "user_password" ca_path: "/path/to/ca_cert.pem" idrac_attributes: SysLog.1.securesyslogenable: Disabled a --- msg: type: str description: Status of the attribute update operation. returned: always sample: "Successfully updated the attributes." invalid_attributes: type: dict description: Dict of invalid attributes provided. returned: on invalid attributes or values. sample: { "LCAttributes.1.AutoUpdate": "Invalid value for Enumeration.", "LCAttributes.1.StorageHealthRollupStatus": "Read only Attribute cannot be modified.", "SNMP.1.AlertPort": "Not a valid integer.", "SNMP.1.AlertPorty": "Attribute does not exist.", "SysLog.1.PowerLogInterval": "Integer out of valid range.", "ThermalSettings.1.AirExhaustTemp": "Invalid value for Enumeration." } error_info: description: Error information of the operation. returned: when attribute value is invalid. type: dict sample: { "error": { "@Message.ExtendedInfo": [ { "Message": "The value 'false' for the property LCAttributes.1.BIOSRTDRequested is of a different type than the property can accept.", "MessageArgs": [ "false", "LCAttributes.1.BIOSRTDRequested" ], "MessageArgs@odata.count": 2, "MessageId": "Base.1.12.PropertyValueTypeError", "RelatedProperties": [ "#/Attributes/LCAttributes.1.BIOSRTDRequested" ], "RelatedProperties@odata.count": 1, "Resolution": "Correct the value for the property in the request body and resubmit the request if the operation failed.", "Severity": "Warning" } ], "code": "Base.1.12.GeneralError", "message": "A general error has occurred. See ExtendedInfo for more information" } } N)URLError HTTPError)ConnectionError)iDRACRedfishAPIIdracAnsibleModule)get_manager_res_idz$Successfully updated the attributes.zNo changes found to be applied.zChanges found to be applied.zQApplication of some of the attributes failed due to invalid value or enumeration.zSystem.Embedded.1ziDRAC.Embedded.1zLifecycleController.Embedded.1z/redfish/v1/Managers Attributesz//redfish/v1/Managers/{manager_id}/Jobs/{job_id}cd}d}i}|jD]?\}}tjdd|}|dj||z }t |||<A|j||}||fS)Nz%{1}z\.(?!\d)#z%{1})itemsresubformatstr) attrbitefqdd componentattr json_datakvkeyroots w/home/dcms/DCMS/lib/python3.12/site-packages/ansible_collections/dellemc/openmanage/plugins/modules/idrac_attributes.pyxml_data_conversionrDs;I DI  1ff[#q) 7>>sAFFQ #    D$ 'D ?ci}|Dcic]!}|d|jvs|d|d#}}t|t|k(s1|jD]}||vs|jdd}d||< ||fScc}w)NNameValuer.Attribute does not exist.)keyslenreplace) attributereq_data invalid_attrr data_dictract_keys rvalidate_attr_namer.PsL9Bfd6lV^VcVcVeFeftG},fIf y>S] *==? DC)#++c3/(C W% D l "" gs A; A;c|jdddd}|jdd}iiiif\}}} } |D]} |r=| jdtk(r%t | d |\}} | r| j | |r=| jdt k(r%t | d |\}} | r| j | |s| jdtk(st | d |\} } | s| j | | r|jd | tt|jt|jz xsztt|jt|jz xs<tt| jt|jz g} |jr%t| dur|jtd y|jr t!| d us|js%t!| d ur|jt"yyy)NJSONDefaultz iDRAC,System,LifecycleControllerT) export_format export_usetargetjob_waitSystemConfiguration ComponentsFQDDr Attributes have invalid values.)msginvalid_attributesr:changedFr:) export_scprget MANAGER_IDr.update SYSTEM_IDLC_ID fail_jsonboolsetr check_modeany exit_json CHANGES_MSGallNO_CHANGES_MSG)moduleidrac idrac_jsonsys_jsonlc_json scp_responsecomp exist_idrac exist_sysexist_lcinvalidcmpr+ diff_changes rget_check_moder[[s##&Y+MX\$^L  ! !"7 8 FD02BB-KHg - #''&/Z7(:3|;Lj(Y %K|, 94&8\9JH&U #I||, swwv%/%7L8I7%S "Hl|, ->SZ[K--/03z7G7G7I3JJKFIOO-.X^^5E1FFGFHNN,-GMMO0DDEGKS-5[$7   K 0E 9""s;'75'@^,(A"r c|jjdd}|jjd}|jjd}|jjd}d}d}iii} } } |t|t\} } || z }|t|t\} } || z }|t|t \}} ||z }t ||| | | |j|}|j|d d }|jd jd d}tj||}|j||}|S)Nr5Tidrac_attributessystem_attributeslifecycle_controller_attributesz.{0}r)rALLF) import_bufferr4r5Location/) manager_idjob_id)r5) paramsr@rrArCrDr[r import_scpheaderssplitJOB_URIwait_for_job_completion)rNrOres_idr5 idrac_attr system_attrlc_attrrridrac_json_datasystem_json_data lc_json_dataidrac_xml_payloadsystem_xml_payloadlc_xml_payloadpayloadresprfjob_urijob_resps rscp_idrac_attributesr{ysY}}  T2H""#56J--##$78Kmm ABG ?DI68"b|%O-@R\-]*?&& /B;U^/_,,'' ':7'O$ ^# 65/3C\Skk)$G   '%%  PD \\* % + +C 0 4Fnnvn>G,,Wx,HH Or ci}d}|j|j|d}|jD]P}|jtj||j|k7s8|j|||<|dz }R||fS)NrGET)invoke_requestr@r&rATTR)rOidrac_idruri_dict response_attrdiffresponsers rget_response_attrrsM D##HLL$:EBH YY[   d # ' ' *dhhqk 9#xx{M!  AID   r cTi} |jdd}|jjdg}|rb|djd}|j|d}|jjdjd}td|D}|S#t$ri}Y|SwxYw) Nz//redfish/v1/Registries/ManagerAttributeRegistryr}rbrdUriRegistryEntriesr c3*K|] }|d|f yw) AttributeNameN).0xs r z*get_attributes_registry..sDQ!O,a0Ds)rrr@dict Exception)rOreggyrxloc_list reg_json_urireg_resp attr_lists rget_attributes_registryrs E ##$UW\]>>%%j"5 #B<++E2L++L%@H **../@AEElSID)DDE L  LsBB B'&B'ci}|jD]\}}||vr|j|}|jdrd||<2|jd}|dk(r8d}|jdgD]}||jdk(sd}n|sd ||<|d k(s t|} |jd | cxkr|jd krnd ||<d||<|S#t$rd||<YwxYw)NReadonlyz'Read only Attribute cannot be modified.Type EnumerationFr#ValueDisplayNameTzInvalid value for Enumeration.Integer LowerBound UpperBoundzInteger out of valid range.zNot a valid integer.r%)rr@intr) registry attr_dictrXrrval_dicttypefoundvalis rvalidate_vs_registryrsG!51 =||AH||J'F ||F+=(!E'||GR8"(: ;;$(E!"!%E 9$GF!) \ :a ]8<SYS053r<)rr MANAGERS_URIrr@rjrgrrrArBrrCrDrJr{ status_coderM SUCCESS_MSGrE ATTR_FAIL_MSG)rOrNrmrridrac_response_attrsystem_response_attrlc_response_attrrdell_attributesitemuriattr_idrnrorprX attr_registryrrz error_msgmessage message_ids rfetch_idrac_uri_attrrs DH##I$4$4\6$JERH((,,Wb9==eRHLLVUWX\\]mnO# $D((;'CiinR(G #HW  $]]&&'9: mm''(;< --##$EF/6  !%6uj*V^%_ "A" NN/ ?RS T AID  "&7y+W_&` #A# NN/ ?ST U AID  "3E5'8"T A NN/ ?OP Q AID    D.Odk  l'v>   3 &ZbdI((3G!++K8JX%  ^ 4x'  [$ ?I%  ] 3  W - .0DFV VVr c|s|jty|r%|jr|jtdyyy)Nr>Tr<)rJrMrHrK)rNrs rprocess_check_moders; ^, &##[$7$r c,i}|jjd}|jjd}|jjd} |>|<|j|jtdt|i} | j |d<|>|<|j|jt dt|i} | j |d<| >|<|j|jtdt| i} | j |d<|S) Nr]r^r_PATCH)dataiDRACSystemzLifecycle Controller)rgr@rrArrrCrD) rOrNrrrrrx idrac_payloadsystem_payload lc_payloadidrac_responsesystem_response lc_responses rupdate_idrac_attributesrs DMM%%&89M]]&&':;N""#DEJ %8%D--hll:.FW[]jVk-l&00W !&:&F..x||I/FW[]kVl.m(22X"2">**8<<+>tU_N`*a '2'<'< #$ Kr c  ddddddddddddd}t|dgd} t|jd 5}|jjd }|s t |}t |||\}}}}}t ||t|||||||jtd dddy#1swYyxYw#t$r9} |jt| tj|  Yd} ~ yd} ~ wt$r&} |jt| d Yd} ~ yd} ~ wt t"t$t&t(t*t,f$r9} |jt| tj|  Yd} ~ yd} ~ wwxYw)NFr)requiredrr)r]r^r_ resource_id)r]r^r_T) argument_specrequired_one_ofsupports_check_mode) req_sessionrr<)r: error_info)r: unreachable)r r rgr@r rrrrJrrrErjsonloadrIOError ValueError TypeErrorrAttributeError IndexErrorKeyError) specsrNrOrmrrrrrerrs rmainrsz).?*/@8=v+N$)59  E ef F B V]] = <]]&&}5F+E2Znotv|E[F WD(/1EGW vt , #E68=PRfhx y   d  ; < < < BSX$))C.AA 9SX488 ZO^ZYa bBSX$))C.AABsMB?A/B3*B?3B<8B?<B?? F /C<< F D))+F /FF __main__)N)+ __future__rrrr __metaclass__ DOCUMENTATIONEXAMPLESRETURNrr+ansible.module_utils.six.moves.urllib.errorrransible.module_utils.urlsrIansible_collections.dellemc.openmanage.plugins.module_utils.idrac_redfishr r Aansible_collections.dellemc.openmanage.plugins.module_utils.utilsr rrMrKrrCrArDrrrkrr.r[r{rrrrrrr__name__rr rrsCB 9 vr h. ` K5y`5 2, c   (%  ; #-<4