VhddlmZmZmZeZdZdZdZddl Z ddl Z ddl Z ddl m Z mZddlmZmZddlmZmZdd lmZdd lmZmZmZmZmZmZd Zd Zd Z dZ!dZ"dZ#dZ$dZ%dZ&dZ'dZ(dZ)dZ*dZ+dZ,dZ-dZ.dZ/dZ0dZ1dZ2d Z3d!Z4d"Z5d#Z6d$Z7d%d&d'd(Z8Gd)d*Z9Gd+d,e9Z:Gd-d.e9Z;Gd/d0e9Z<Gd1d2Z=d3Z>d4Z?e@d5k(re>yy)6)absolute_importdivisionprint_functiona --- module: idrac_license short_description: Configure iDRAC licenses version_added: "8.7.0" description: - This module allows to import, export and delete licenses on iDRAC. extends_documentation_fragment: - dellemc.openmanage.idrac_x_auth_options options: license_id: description: - Entitlement ID of the license that is to be imported, exported or deleted. - I(license_id) is required when I(delete) is C(true) or I(export) is C(true). type: str aliases: ['entitlement_id'] delete: description: - Delete the license from the iDRAC. - When I(delete) is C(true), then I(license_id) is required. - I(delete) is mutually exclusive with I(export) and I(import). type: bool default: false export: description: - Export the license from the iDRAC. - When I(export) is C(true), I(license_id) and I(share_parameters) is required. - I(export) is mutually exclusive with I(delete) and I(import). type: bool default: false import: description: - Import the license from the iDRAC. - When I(import) is C(true), I(share_parameters) is required. - I(import) is mutually exclusive with I(delete) and I(export). type: bool default: false share_parameters: description: - Parameters that are required for the import and export operation of a license. - I(share_parameters) is required when I(export) or I(import) is C(true). type: dict suboptions: share_type: description: - Share type of the network share. - C(local) uses local path for I(import) and I(export) operation. - C(nfs) uses NFS share for I(import) and I(export) operation. - C(cifs) uses CIFS share for I(import) and I(export) operation. - C(http) uses HTTP share for I(import) and I(export) operation. - C(https) uses HTTPS share for I(import) and I(export) operation. type: str choices: [local, nfs, cifs, http, https] default: local file_name: description: - License file name for I(import) and I(export) operation. - I(file_name) is required when I(import) is C(true). - For the I(import) operation, when I(share_type) is C(local), the supported extensions for I(file_name) are '.txt' and '.xml'. For other share types, the supported extension is '.xml' type: str ip_address: description: - IP address of the network share. - I(ip_address) is required when I(share_type) is C(nfs), C(cifs), C(http) or C(https). type: str share_name: description: - Network share or local path of the license file. type: str workgroup: description: - Workgroup of the network share. - I(workgroup) is applicable only when I(share_type) is C(cifs). type: str username: description: - Username of the network share. - I(username) is required when I(share_type) is C(cifs). type: str password: description: - Password of the network share. - I(password) is required when I(share_type) is C(cifs). type: str ignore_certificate_warning: description: - Ignores the certificate warning while connecting to Share and is only applicable when I(share_type) is C(https). - C(on) ignores the certificate warning. - C(off) does not ignore the certificate warning. type: str choices: ["off", "on"] default: "off" proxy_support: description: - Specifies if proxy is to be used or not. - C(off) does not use proxy settings. - C(default_proxy) uses the default proxy settings. - C(parameters_proxy) uses the specified proxy settings. I(proxy_server) is required when I(proxy_support) is C(parameters_proxy). - I(proxy_support) is only applicable when I(share_type) is C(https) or C(https). type: str choices: ["off", "default_proxy", "parameters_proxy"] default: "off" proxy_type: description: - The proxy type of the proxy server. - C(http) to select HTTP proxy. - C(socks) to select SOCKS proxy. - I(proxy_type) is only applicable when I(share_type) is C(https) or C(https) and when I(proxy_support) is C(parameters_proxy). type: str choices: [http, socks] default: http proxy_server: description: - The IP address of the proxy server. - I(proxy_server) is required when I(proxy_support) is C(parameters_proxy). - I(proxy_server) is only applicable when I(share_type) is C(https) or C(https) and when I(proxy_support) is C(parameters_proxy). type: str proxy_port: description: - The port of the proxy server. - I(proxy_port) is only applicable when I(share_type) is C(https) or C(https) and when I(proxy_support) is C(parameters_proxy). type: int default: 80 proxy_username: description: - The username of the proxy server. - I(proxy_username) is only applicable when I(share_type) is C(https) or C(https) and when I(proxy_support) is C(parameters_proxy). type: str proxy_password: description: - The password of the proxy server. - I(proxy_password) is only applicable when I(share_type) is C(https) or C(https) and when I(proxy_support) is C(parameters_proxy). type: str resource_id: type: str description: - Id of the resource. - If the value for resource ID is not provided, the module picks the first resource ID available from the list of system resources returned by the iDRAC. requirements: - "python >= 3.9.6" author: - "Rajshekar P(@rajshekarp87)" notes: - Run this module from a system that has direct access to Dell iDRAC. - This module supports only iDRAC9 and above. - This module supports IPv4 and IPv6 addresses. - This module does not support C(check_mode). - When I(share_type) is C(local) for I(import) and I(export) operations, job_details are not displayed. a --- - name: Export a license from iDRAC to local dellemc.openmanage.idrac_license: idrac_ip: "192.168.0.1" idrac_user: "username" idrac_password: "password" ca_path: "/path/to/ca_cert.pem" license_id: "LICENSE_123" export: true share_parameters: share_type: "local" share_name: "/path/to/share" file_name: "license_file" - name: Export a license from iDRAC to NFS share dellemc.openmanage.idrac_license: idrac_ip: "192.168.0.1" idrac_user: "username" idrac_password: "password" ca_path: "/path/to/ca_cert.pem" license_id: "LICENSE_123" export: true share_parameters: share_type: "nfs" share_name: "/path/to/share" file_name: "license_file" ip_address: "192.168.0.1" - name: Export a license from iDRAC to CIFS share dellemc.openmanage.idrac_license: idrac_ip: "192.168.0.1" idrac_user: "username" idrac_password: "password" ca_path: "/path/to/ca_cert.pem" license_id: "LICENSE_123" export: true share_parameters: share_type: "cifs" share_name: "/path/to/share" file_name: "license_file" ip_address: "192.168.0.1" username: "username" password: "password" workgroup: "workgroup" - name: Export a license from iDRAC to HTTP share via proxy dellemc.openmanage.idrac_license: idrac_ip: "192.168.0.1" idrac_user: "username" idrac_password: "password" ca_path: "/path/to/ca_cert.pem" license_id: "LICENSE_123" export: true share_parameters: share_type: "http" share_name: "/path/to/share" file_name: "license_file" ip_address: "192.168.0.1" username: "username" password: "password" proxy_support: "parameters_proxy" proxy_type: socks proxy_server: "192.168.0.2" proxy_port: 1080 proxy_username: "proxy_username" proxy_password: "proxy_password" - name: Export a license from iDRAC to HTTPS share dellemc.openmanage.idrac_license: idrac_ip: "192.168.0.1" idrac_user: "username" idrac_password: "password" ca_path: "/path/to/ca_cert.pem" license_id: "LICENSE_123" export: true share_parameters: share_type: "https" share_name: "/path/to/share" file_name: "license_file" ip_address: "192.168.0.1" username: "username" password: "password" ignore_certificate_warning: "on" - name: Import a license to iDRAC from local dellemc.openmanage.idrac_license: idrac_ip: 198.162.0.1 idrac_user: "username" idrac_password: "password" ca_path: "/path/to/ca_cert.pem" import: true share_parameters: file_name: "license_file_name.xml" share_type: local share_name: "/path/to/share" - name: Import a license to iDRAC from NFS share dellemc.openmanage.idrac_license: idrac_ip: 198.162.0.1 idrac_user: "username" idrac_password: "password" ca_path: "/path/to/ca_cert.pem" import: true share_parameters: file_name: "license_file_name.xml" share_type: nfs ip_address: "192.168.0.1" share_name: "/path/to/share" - name: Import a license to iDRAC from CIFS share dellemc.openmanage.idrac_license: idrac_ip: 198.162.0.1 idrac_user: "username" idrac_password: "password" ca_path: "/path/to/ca_cert.pem" import: true share_parameters: file_name: "license_file_name.xml" share_type: cifs ip_address: "192.168.0.1" share_name: "/path/to/share" username: "username" password: "password" - name: Import a license to iDRAC from HTTP share dellemc.openmanage.idrac_license: idrac_ip: 198.162.0.1 idrac_user: "username" idrac_password: "password" ca_path: "/path/to/ca_cert.pem" import: true share_parameters: file_name: "license_file_name.xml" share_type: http ip_address: "192.168.0.1" share_name: "/path/to/share" username: "username" password: "password" - name: Import a license to iDRAC from HTTPS share via proxy dellemc.openmanage.idrac_license: idrac_ip: 198.162.0.1 idrac_user: "username" idrac_password: "password" ca_path: "/path/to/ca_cert.pem" import: true share_parameters: file_name: "license_file_name.xml" share_type: https ip_address: "192.168.0.1" share_name: "/path/to/share" username: "username" password: "password" proxy_support: "parameters_proxy" proxy_server: "192.168.0.2" proxy_port: 808 proxy_username: "proxy_username" proxy_password: "proxy_password" - name: Delete a License from iDRAC dellemc.openmanage.idrac_license: idrac_ip: 198.162.0.1 idrac_user: "username" idrac_password: "password" ca_path: "/path/to/ca_cert.pem" license_id: "LICENCE_123" delete: true a --- msg: type: str description: Status of the license operation. returned: always sample: "Successfully exported the license." job_details: description: Returns the output for status of the job. returned: For import and export operations type: dict sample: { "ActualRunningStartTime": "2024-01-09T05:16:19", "ActualRunningStopTime": "2024-01-09T05:16:19", "CompletionTime": "2024-01-09T05:16:19", "Description": "Job Instance", "EndTime": null, "Id": "JID_XXXXXXXXX", "JobState": "Completed", "JobType": "LicenseExport", "Message": "The command was successful.", "MessageArgs": [], "MessageId": "LIC900", "Name": "Export: License", "PercentComplete": 100, "StartTime": "2024-01-09T05:16:19", "TargetSettingsURI": null } error_info: description: Details of the HTTP Error. returned: on HTTP error type: dict sample: { "error": { "code": "Base.1.8.GeneralError", "message": "A general error has occurred. See ExtendedInfo for more information.", "@Message.ExtendedInfo": [ { "MessageId": "Base.1.8.AccessDenied", "Message": "The authentication credentials included with this request are missing or invalid.", "MessageArgs": [], "RelatedProperties": [], "Severity": "Critical", "Resolution": "Attempt to ensure that the URI is correct and that the service has the appropriate credentials." } ] } } N) HTTPErrorURLError)iDRACRedfishAPIIdracAnsibleModule)ConnectionErrorSSLValidationError) LooseVersion)get_idrac_firmware_versionget_dynamic_uriget_manager_res_id&validate_and_get_first_resource_id_uri remove_keyidrac_redfish_job_trackingz /redfish/v1z/redfish/v1/Managersz{res_uri}/Jobs/{job_id}OemDellDellLicenseManagementServiceActionsz+#DellLicenseManagementService.ExportLicensez9#DellLicenseManagementService.ExportLicenseToNetworkSharez+#DellLicenseManagementService.ImportLicensez;#DellLicenseManagementService.ImportLicenseFromNetworkSharez @odata.idz (.*?)@odataz;License with ID '{license_id}' does not exist on the iDRAC.z"Successfully exported the license.z!Successfully deleted the license.z"Successfully imported the license.zPUnable to '{operation}' the license with id '{license_id}' as it does not exist.zUnable to import the license.zLicense file not found.z(iDRAC firmware version is not supported.zATask is skipped as none of import, export or delete is specified.zFile extension is invalid. Supported extensions for local 'share_type' are: .txt and .xml, and for network 'share_type' is: .xml.z.Provided directory path '{path}' is not valid.zkProvided directory path '{path}' is not writable. Please check if the directory has appropriate permissionsz'Missing required parameter 'file_name'.Off DefaultProxyParametersProxyoff default_proxyparameters_proxyc6eZdZdZdZdZdZdZdZdZ y) Licensec ||_||_y)z Initializes the class instance with the provided idrac and module parameters. :param idrac: The idrac parameter. :type idrac: Any :param module: The module parameter. :type module: Any N)idracmodule)selfr!r"s t/home/dcms/DCMS/lib/python3.12/site-packages/ansible_collections/dellemc/openmanage/plugins/modules/idrac_license.py__init__zLicense.__init__s  cy)z Executes the function with the given module. :param module: The module to execute. :type module: Any :return: None N)r#s r$executezLicense.executesr&c|j}|d|z} |jj|d}|S#t$r4|jj t j|dYywxYw)a6 Check the license ID for a given operation. :param self: The object instance. :param module: The Ansible module. :param license_id: The ID of the license to check. :param operation: The operation to perform. :return: The response from the license URL. /GET license_idTmsgskippedN)get_license_urlr!invoke_request Exceptionr" exit_jsonINVALID_LICENSE_MSGformat)r#r. license_uri license_urlresponses r$check_license_idzLicense.check_license_ids|**, !a |$44  gzz00eDHO g KK ! !&9&@&@J&@&Wae ! f gs8:A54A5ct|jt}|jdijti}t|j|}|jdijti}|S)zp Retrieves the license URL for the current user. :return: The license URL as a string. LicenseServiceLicenses)rr!REDFISHgetODATA)r#v1_resplicense_service_urllicense_service_respr9s r$r2zLicense.get_license_urlsj "$**g6%kk*:B?CCE2N.tzz;NO*..z2>BB5"M r&ct|j|jt}|jj d}|j dd}tj||d}t|j|\}}}} t|t}|r-|jj|j dd| |S) z Get the status of a job. Args: module (object): The module object. license_job_response (object): The response object for the license job. Returns: dict: The job details. Locationr+rjob_idres_uri regex_patternMessageTr0failed job_details rr"r! MANAGERS_URIheadersr@split IDRAC_JOB_URIr7rr ODATA_REGEXr5 r#license_job_responserJjob_tracking_urirIjob_uri job_failedr0job_dict wait_times r$get_job_statuszLicense.get_job_statuss9djjR^_/77;;JG!'',R0&&fgaj&I/I$**V]/^, C9hkB  KK ! !LL+$ " &r&ci}|jjjdjd|d<|jjjdjd|d<|jjjdjd|d<|jjjdjd|d <|S) a Retrieves the share details from the given module. Args: module (object): The module object containing the share parameters. Returns: dict: A dictionary containing the share details with the following keys: - IPAddress (str): The IP address of the share. - ShareName (str): The name of the share. - UserName (str): The username for accessing the share. - Password (str): The password for accessing the share. share_parameters ip_address IPAddress share_name ShareNameusernameUserNamepasswordPassword)r"paramsr@)r# share_detailss r$get_share_detailszLicense.get_share_detailss %)[[%7%7%;%;NOTXT_T_TfTfTjTjk}T~UCUCDTUU.2kk.@.@.D.DEW.X.\.\]m.n l+/3{{/A/A/E/EFX/Y/]/]^n/o m,r&N) __name__ __module__ __qualname__r%r)r;r2r^rkrr(r&r$rrs&  g$ 0*r&rceZdZdZy) DeleteLicensec|jjjd}|j||j }|d|z}|j j |d}|j}|dk(r"|jjtdy |jjtjd|d y ) z Executes the delete operation for a given license ID. Args: module (object): The Ansible module object. Returns: object: The response object from the delete operation. r.r+DELETET)r0changeddelete operationr.r0rON) r"rir@r;r2r!r3 status_coder5SUCCESS_DELETE_MSG FAILURE_MSGr7)r#r.r9delete_license_urldelete_license_responsestatuss r$r)zDeleteLicense.execute/s[[''++L9  j)**, (Qzl+;;"&**";";eZdZddgZdZdZdZdZdZdZ d Z y ) ExportLicensec|jjjdjd}|jjjd}|j||j }i}|dk(r|j |}nv|dvr#|j |}|j|}nO|dk(r#|j|}|j|}n'|dk(r"|j|}|j|}j}||jvr#|jjtd| y |jjtjd | d| y )z Executes the export operation for a given license ID. :param module: The Ansible module object. :type module: AnsibleModule :return: The response from the export operation. :rtype: Response r`rmr.localhttphttpscifsnfsTr0rrPexportrrNN)r"rir@r;&_ExportLicense__get_export_license_url$_ExportLicense__export_license_local#_ExportLicense__export_license_httpr^#_ExportLicense__export_license_cifs"_ExportLicense__export_license_nfsrSTATUS_SUCCESSr5SUCCESS_EXPORT_MSGrr7)r#rmr.export_license_url job_statusexport_license_responsers r$r)zExportLicense.executeHsi[[''++,>?CCLQ [[''++L9  j)!::<  &*&A&ABT&U # , ,&*&@&@AS&T #,,-DEJ 6 !&*&@&@AS&T #,,-DEJ 5 &*&?&?@R&S #,,-DEJ(44 T(( ( KK ! !&8$T^ ! _ KK ! !k&8&88Xb&8&clpI ! Jr&cVi}|jjjd|d<|jjjdjd}tjj |sPtjj |s1|jjtj|dtj|tjs1|jjtj|d|jjjdjd}|r|}n|jjdd }|jj|d | }|j}t!j"|jd j%d }tjj'||} t)| d5} | j+|ddd|S#1swY|SxYw)a Export the license to a local directory. Args: module (object): The Ansible module object. export_license_url (str): The URL for exporting the license. Returns: object: The license status after exporting. r. EntitlementIDr`rcpathTr file_name_iDRAC_license.xmlPOSTdata LicenseFilezutf-8wN)r"rir@osrexistsisdirr5INVALID_DIRECTORY_MSGr7accessW_OK%INSUFFICIENT_DIRECTORY_PERMISSION_MSGr!r3 json_database64 b64decodedecodejoinopenwrite) r#rpayloadr license_namelicense_file_namelicense_status license_data license_filerfps r$__export_license_localz$ExportLicense.__export_license_localhs#';;#5#5#9#9,#G {{!!%%&89==lKt$ d(; KK ! !&;&B&B&B&MVZ ! [yyrww' KK ! !&K&R&RX\&R&]fj ! k{{))--.@AEEkR #/. #';;#5#5l#C"DDV W 223EvT[2\%// '' (8(8(GHOOPWX GGLL'89 )S ! #R HH\ " # #s HH(ci}|jjjd|d<|j}|j ||j ||}|S)z Export the license using the HTTP protocol. Args: module (object): The module object. export_license_url (str): The URL for exporting the license. Returns: str: The export status. r.r)r"rir@rr~_ExportLicense__export_license)r#rrr export_statuss r$__export_license_httpz#ExportLicense.__export_license_https[#';;#5#5#9#9,#G ..0 }%--g7IJ r&ci}|jjjd|d<d|d<|jjjdjdr7|jjjdjd|d<|j}|j ||j ||}|S)a Export the license using CIFS share type. Args: module (object): The Ansible module object. export_license_url (str): The URL for exporting the license. Returns: str: The export status. r.rCIFSrnr` workgroup Workgroup)r"rir@rkr~r)r#rrrjrs r$__export_license_cifsz#ExportLicense.__export_license_cifss#';;#5#5#9#9,#G %  ;;   ! !"4 5 9 9+ F#';;#5#5#9#9:L#M#Q#QR]#^GK ..0 }%--g7IJ r&cdi}|jjjd|d<d|d<|jjjdjd|d<|jjjdjd|d <|j||}|S) a Export the license using NFS share type. Args: module (object): The Ansible module object. export_license_url (str): The URL for exporting the license. Returns: dict: The export status of the license. r.rNFSrnr`rarbrcrd)r"rir@r)r#rrrs r$__export_license_nfsz"ExportLicense.__export_license_nfss#';;#5#5#9#9,#G $ #{{11556HIMMl[ #{{11556HIMMl[ --g7IJ r&ct|j|jt\}}|r|jj |dt |j|}|j dij tij tij tij ti}t |j|}|jjj dj ddk(rtnt}|j tij |ij di}|S)z Get the export license URL. :param module: The module object. :type module: object :return: The export license URL. :rtype: str TrLinksr`rmrtarget)rr"r!rRr5rr@OEM MANUFACTURERLICENSE_MANAGEMENT_SERVICErAri EXPORT_LOCALEXPORT_NETWORK_SHAREACTIONS)r#uri error_msgrespurl action_resplicense_service export_urls r$__get_export_license_urlz&ExportLicense.__get_export_license_url @ KK\3Y  KK ! !i ! =tzz3/hhw#''R044\2FJJKegijnnotvxy%djj#6 *.++*<*<*@*@AS*T*X*XYe*fjq*q,xL __Wb155orJNNxY[\ r&c|jjjdjd}|r|}n|jjdd}||d<|jj |d|}|S)aS Export the license to a file. Args: module (object): The Ansible module object. payload (dict): The payload containing the license information. export_license_url (str): The URL for exporting the license. Returns: dict: The license status after exporting. r`rr.rFileNamerrr"rir@r!r3)r#rrrrrs r$__export_licensezExportLicense.__export_licenses{{))--.@AEEkR #/. #';;#5#5l#C"DDV W / 223EvT[2\r&N) rrrrr)rrrrrrr(r&r$rrEs03ZNJ@>$*&(r&rcDeZdZddgZdZdZdZdZdZdZ d Z d Z y ) ImportLicenserrcd|jjjdjds!|jjtd|jjjdjd}|j |j }t|j}i}|dk(r|j||}ny|dvr$|j||}|j|}nQ|dk(r$|j||}|j|}n(|d k(r#|j||}|j|}j}||jvr#|jjt d| y |jjt"d| y ) z Executes the import license process based on the given module parameters. Args: module (object): The Ansible module object. Returns: object: The response object from the import license API call. r`rTrrmrrrrrrNN)r"rir@r5MISSING_FILE_NAME_PARAMETER_MSG$_ImportLicense__check_file_extension&_ImportLicense__get_import_license_urlrr!$_ImportLicense__import_license_local#_ImportLicense__import_license_httpr^#_ImportLicense__import_license_cifs"_ImportLicense__import_license_nfsrrSUCCESS_IMPORT_MSGFAILURE_IMPORT_MSG)r#rmimport_license_url resource_idrimport_license_responsers r$r)zImportLicense.executes{{!!%%&89==kJ KK ! !&Ed ! S[[''++,>?CCLQ  ##%!::<(4   &*&A&ABTVa&b # , ,&*&@&@ASU`&a #,,-DEJ 6 !&*&@&@ASU`&a #,,-DEJ 5 &*&?&?@RT_&` #,,-DEJ(44 T(( ( KK ! !&8$T^ ! _ KK ! !&8S] ! ^r&cNi}|jjjdjd}tjj |sPtjj |s1|jjtj|d|jjjdjddz|jjjdjdz}tjj |}|rJt|d5}|j}tj|jd } d d d n!|jjtd |d <||d <d |d< |j j#|d|} | S#1swY9xYw#t$$r} t't)j*| t,} | jdjdd} | jd}d|vr-|jj| jddn-|jj| jd| dYd } ~  Sd } ~ wwxYw)a8 Import a license locally. Args: module (object): The Ansible module object. import_license_url (str): The URL for importing the license. resource_id (str): The ID of the resource. Returns: dict: The import status of the license. r`rcrTrr+rrbasciiNrFQDDForce ImportOptionsrrrKerrorz@Message.ExtendedInfor MessageIdLIC018rMr/r0 error_inforO)r"rir@rrrrr5rr7rreadr encodebytesr NO_FILE_MSGr!r3rrjsonloadrV)r#rrrr file_path file_exitscert cert_content read_file import_statuserr filter_errmessage_details message_ids r$__import_license_localz$ImportLicense.__import_license_locals\{{!!%%&89==lKt$ d(; KK ! !&;&B&B&B&MVZ ! [KK&&**+=>BB<PSVVY]YdYdYkYkYoYoqCZDZHZHITZUU WW^^I. i& M$#yy{ "..|<CCGL  M M KK ! !k$ ! ?!* %#*  n JJ556H&W^5_M% M M n#DIIcN+NJ(nnW599:QRSTUO(,,[9J:% %%/*=*=i*HRV%W %%/*=*=i*HU_hl%m ns%?5G.GG J$#B6JJ$c i}|jjjdjd|d<||d<d|d<|j}|j ||j j |d|}|S) a/ Imports a license using HTTP. Args: module (object): The Ansible module object. import_license_url (str): The URL for importing the license. resource_id (str): The ID of the resource. Returns: object: The import status. r`r LicenseNamerrrrr)r"rir@rr~r!r3)r#rrrrrs r$__import_license_httpz#ImportLicense.__import_license_http7s!%!3!3!7!78J!K!O!OP[!\ %#* ..0 }% 112DfSZ1[ r&ci}d|d<|jjjdjd|d<||d<d|d<|jjjdjd r7|jjjdjd |d <|j}|j ||j j |d | }|S) a Imports a license using CIFS share type. Args: self (object): The instance of the class. module (object): The Ansible module object. import_license_url (str): The URL for importing the license. resource_id (str): The ID of the resource. Returns: object: The import status of the license. rrnr`rrrrrrrrr)r"rir@rkr~r!r3)r#rrrrjrs r$__import_license_cifsz#ImportLicense.__import_license_cifsLs% !%!3!3!7!78J!K!O!OP[!\ %#* ;;   ! !"4 5 9 9+ F#';;#5#5#9#9:L#M#Q#QR]#^GK ..0 }% 112DfSZ1[ r&ci}d|d<|jjjdjd|d<|jjjdjd|d<|jjjdjd|d <||d <d |d <|jj |d |}|S)aB Import a license from an NFS share. Args: module (object): The Ansible module object. import_license_url (str): The URL for importing the license. resource_id (str): The ID of the resource. Returns: dict: The import status of the license. rrnr`rarbrcrdrrrrrrrr)r#rrrrs r$__import_license_nfsz"ImportLicense.__import_license_nfses$ #{{11556HIMMl[ #{{11556HIMMl[ !%!3!3!7!78J!K!O!OP[!\ %#*  112DfSZ1[ r&c^|jjjdjd}|jjjdjd|dk(rddhndh}tfd|D}|s"|jj t d y y ) z Check if the file extension of the given file name is valid. :param module: The Ansible module object. :type module: AnsibleModule :return: None r`rmrrz.txtz.xmlc3\K|]#}jj|%ywN)lowerendswith).0extrs r$ z7ImportLicense.__check_file_extension..s#YY__.77<Ys),TrN)r"rir@anyr5INVALID_FILE_MSG)r#rmvalid_extensionsfile_extensionrs @r$__check_file_extensionz$ImportLicense.__check_file_extension{s[[''++,>?CCLQ KK&&**+=>BB;O /9W/DFF+6(YHXYY KK ! !&6t ! Dr&ct|j|jt\}}|r|jj |dt |j|}|j dij tij tij tij ti}t |j|}|jjj dj ddk(rtnt}|j tij |ij di}|S)z Get the import license URL. :param module: The module object. :type module: object :return: The import license URL. :rtype: str Trrr`rmrr)rr"r!rRr5rr@rrrrAri IMPORT_LOCALIMPORT_NETWORK_SHAREr)r#rrrrrr import_urls r$__get_import_license_urlz&ImportLicense.__get_import_license_urlrr&ct|j|jt}|jj d}|j dd}tj||d}t|j|\}}}} t|t}|rp|j ddk(r/|jj|j d d | |S|jj|j d d | |S) NrFr+rGrrHrKrrrMT)r0r1rPrNrQrWs r$r^zImportLicense.get_job_statuss8djjR^_/77;;JG!'',R0&&fgaj&I/I$**V]/^, C9hkB ||K(H4 %%(,,y*A4]e%f   %% Y/ (&*r&N) rrrrr)rrrrrrr^r(r&r$rrs73ZN _D%N*2,E (r&rc(eZdZeeedZedZy) LicenseTypeimportrrctfddDd}|sjtdtjj |}||S)aG Perform a license operation based on the given parameters. :param idrac: The IDRAC object. :type idrac: IDRAC :param module: The Ansible module object. :type module: AnsibleModule :return: The license class object based on the license type. :rtype: LicenseType c3BK|]}j|s|ywr$)ri)r'paramr"s r$r)z0LicenseType.license_operation..s guRXR_R_`eRfUgsr7NTr/)nextr5NO_OPERATION_SKIP_MSGr6_license_classesr@)r!r" license_type license_classs ` r$license_operationzLicenseType.license_operationsSg0Ngimn    !6  E#4488F UF++r&N) rrrrrrr> staticmethodrAr(r&r$r6r6s' ,,r&r6ct}t|dggdgdgdgd} t|j5}t |}t |dkr|j td tj||}|r|jd d d y #1swYy xYw#t$rK}ttj|t }|j t!||d Yd }~y d }~wt"$r&}|j t!|d Yd }~y d }~wt$t&t(t*t,f$r&}|j t!|d Yd }~y d }~wwxYw)a Main function that serves as the entry point for the program. This function retrieves the argument specification using the `get_argument_spec` function and updates it with the `idrac_auth_params`. It then creates an `AnsibleModule` object with the updated argument specification, specifying the mutually exclusive arguments, required arguments if conditions are met, and setting `supports_check_mode` to `False`. The function then attempts to establish a connection with the iDRAC Redfish API using the `iDRACRedfishAPI` class. It retrieves the iDRAC firmware version using the `get_idrac_firmware_version` function and checks if it is less than or equal to '3.0'. If it is, the function exits with a message indicating that the iDRAC firmware version is not supported and sets `failed` to `True`. If the iDRAC firmware version is supported, the function creates a `LicenseType` object using the `license_operation` method of the `LicenseType` class and calls the `execute` method on the `license_obj` object, passing in the `module` object. If an `HTTPError` occurs, the function loads the error response as JSON, removes a specific key using a regular expression pattern, and exits with the error message, the filtered error information, and sets `failed` to `True`. If a `URLError` occurs, the function exits with the error message and sets `unreachable` to `True`. If any of the following errors occur: `SSLValidationError`, `ConnectionError`, `TypeError`, `ValueError`, or `OSError`, the function exits with the error message and sets `failed` to `True`. Parameters: None Returns: None r7)r8T)r`)rT)r.r`)rTr-F) argument_specmutually_exclusive required_ifsupports_check_modez3.0TrNrKr )r0 unreachable)get_argument_specr rrir r r5UNSUPPORTED_FIRMWARE_MSGr6rAr)rrrrrVrrr r TypeError ValueErrorOSError)specsr"r!idrac_firmware_version license_objrrs r$mainrQs;:  E :; 3 A - " F4 V]] + &u%?%F "23u<  %=d K%77vFK##%  & & & K #kJ SX*TJJ 9SX488 J P4SXd334sNB(ABB(B%!B(%B(( E+1AC77 E+D$$!E+E&&E+cddgdddddddddddddgd d d did did did did didd d ddddgd ddgdd ddddgd d didddd didd d ddddggddddggddgdgddddggddddggdddgggd d!gd"d did#S)$a" Returns a dictionary containing the argument spec for the get_argument_spec function. The argument spec is a dictionary that defines the parameters and their types and options for the function. The dictionary has the following keys: - "license_id": A string representing the license ID. - "delete": A boolean representing whether to delete the license. - "export": A boolean representing whether to export the license. - "import": A boolean representing whether to import the license. - "share_parameters": A dictionary representing the share parameters. - "type": A string representing the share type. - "options": A dictionary representing the options for the share parameters. - "share_type": A string representing the share type. - "file_name": A string representing the file name. - "ip_address": A string representing the IP address. - "share_name": A string representing the share name. - "workgroup": A string representing the workgroup. - "username": A string representing the username. - "password": A string representing the password. - "ignore_certificate_warning": A string representing whether to ignore certificate warnings. - "proxy_support": A string representing the proxy support. - "proxy_type": A string representing the proxy type. - "proxy_server": A string representing the proxy server. - "proxy_port": A integer representing the proxy port. - "proxy_username": A string representing the proxy username. - "proxy_password": A string representing the proxy password. - "required_if": A list of lists representing the required conditions for the share parameters. - "required_together": A list of lists representing the required conditions for the share parameters. - "resource_id": A string representing the resource ID. rentitlement_id)typealiasesboolF)rTdefaultdictr)rrrrr)rTrWchoicesrTT)rTno_logronrrsocksintP)rmrrarcrrergrorqrsrurwryrzrmrcrrar)rarcrergrrqrru)rerg)ryrz)rToptionsrFrequired_together)r.rrr8r`rr(r(r&r$rIrIsF> %2B1CD!e4!e4!e4"&H %e_%uo%uo$e_#UO%*d;!$ %t}/ "$K" "% &0 "(',<#)5/+0D"A=Bw7u|\&BCv'[\v l'CDw|(DE "4~6FG )4"U. ^i5 5r&__main__)A __future__rrrrT __metaclass__ DOCUMENTATIONEXAMPLESRETURNrrr urllib.errorrrIansible_collections.dellemc.openmanage.plugins.module_utils.idrac_redfishrr ansible.module_utils.urlsr r #ansible.module_utils.compat.versionr Aansible_collections.dellemc.openmanage.plugins.module_utils.utilsr rrrrrr?rRrUrrrrrrr0r1rArVr6rrrrrr rJr=r+rrrrrrrrr6rQrIrr(r&r$rlsYCB U nh T0 f ,yI<TT % )   ; < R< T S989` 4' E[PH)d%"KTef yyxrGr.cGcLCGCL,,484vSl zFr&