Release 5.0.0

AUTHORS.md

@@ -9,6 +9,7 @@
 * Anirudh Kumar <Anirudh_Kumar1@Dell.com>
 * Jaya Gupta <Jaya_Gupta@Dell.com>
 * Sachin Apagundi <Sachin_Apagundi@Dell.com>
+* Husniya Hameed <Husniya.Hameed@Dellteam.com>
 * Chris Clonch (@cacack)
 * Mario Lenz (@mariolenz)
 * Grant Curell (@grantcurell)

CHANGELOG.rst

@@ -5,6 +5,43 @@ Dell EMC OpenManage Ansible Modules Release Notes
 .. contents:: Topics
 
 
+v5.0.0
+======
+
+Release Summary
+---------------
+
+HTTPS SSL support for all modules and quick deploy settings.
+
+Major Changes
+-------------
+
+- All modules now support SSL over HTTPS and socket level timeout.
+
+Bugfixes
+--------
+
+- idrac_bios - The issue while configuring boot sources is fixed (https://github.com/dell/dellemc-openmanage-ansible-modules/issues/347)
+
+Known Issues
+------------
+
+- ome_device_quick_deploy - Issue(216352) - The module does not display a proper error message if an unsupported value is provided for the ipv6_prefix_length and vlan_id parameters.
+- ome_device_local_access_configuration - Issue(217865) - The module does not display a proper error message if an unsupported value is provided for the user_defined and lcd_language parameters.
+- ome_device_local_access_configuration - Issue(215035) - The module reports ``Successfully updated the local access setting`` if an unsupported value is provided for the parameter timeout_limit. However, this value is not actually applied on OpenManage Enterprise Modular.
+- ome_device_network_services - Issue(212681) - The module does not provide a proper error message if unsupported values are provided for the parameters-port_number, community_name, max_sessions, max_auth_retries, and idle_timeout.
+- ome_application_alerts_syslog - Issue(215374) - The module does not provide a proper error message if the destination_address is more than 255 characters.
+- ome_application_alerts_smtp - Issue(212310) - The module does not provide a proper error message if the destination_address is more than 255 characters.
+- idrac_user - Issue(192043) The module may error out with the message ``unable to perform the import or export operation because there are pending attribute changes or a configuration job is in progress``. Wait for the job to complete and run the task again.
+- ome_smart_fabric_uplink - Issue(186024) - The module does not allow the creation of multiple uplinks of the same name even though it is supported by OpenManage Enterprise Modular. If an uplink is created using the same name as an existing uplink, the existing uplink is modified.
+- ome_device_power_settings - Issue(212679) - The module errors out with the following message if the value provided for the parameter ``power_cap`` is not within the supported range of 0 to 32767, ``Unable to complete the request because PowerCap does not  exist or is not applicable for the resource URI.``
+
+New Modules
+-----------
+
+- dellemc.openmanage.ome_device_quick_deploy - Configure Quick Deploy settings on OpenManage Enterprise Modular
+
+
 v4.4.0
 ======
 

README.md

@@ -13,7 +13,7 @@ OpenManage Ansible Modules simplifies and automates provisioning, deployment, an
 
 ## Prerequisites
   * [Ansible >= 2.10.0](https://github.com/ansible/ansible)
-  * Python >=2.7.17 or >=3.6.5
+  * Python >= 3.8.6
   * To run the iDRAC modules, install OpenManage Python Software Development Kit (OMSDK) 
   using either ```pip install omsdk --upgrade``` or ```pip install -r requirements.txt```. 
   OMSDK can also be installed from [Dell EMC OpenManage Python SDK](https://github.com/dell/omsdk)

changelogs/changelog.yaml

@@ -484,4 +484,45 @@ releases:
     - description: Configure local access settings on OpenManage Enterprise Modular
       name: ome_device_local_access_configuration
       namespace: ''
-    release_date: '2021-12-24'
+    release_date: '2021-12-24'
+  5.0.0:
+    changes:
+      major_changes:
+      - All modules now support SSL over HTTPS and socket level timeout.
+      bugfixes:
+      - idrac_bios - The issue while configuring boot sources is fixed (https://github.com/dell/dellemc-openmanage-ansible-modules/issues/347)
+      known_issues:
+      - ome_device_quick_deploy - Issue(216352) - The module does not display a proper error message
+        if an unsupported value is provided for the ipv6_prefix_length and vlan_id parameters.
+      - ome_device_local_access_configuration - Issue(217865) - The module does not
+        display a proper error message if an unsupported value is provided for the
+        user_defined and lcd_language parameters.
+      - ome_device_local_access_configuration - Issue(215035) - The module reports
+        ``Successfully updated the local access setting`` if an unsupported value is
+        provided for the parameter timeout_limit. However, this value is not
+        actually applied on OpenManage Enterprise Modular.
+      - ome_device_network_services - Issue(212681) - The module does not provide a
+        proper error message if unsupported values are provided for the parameters-
+        port_number, community_name, max_sessions, max_auth_retries, and idle_timeout.
+      - ome_application_alerts_syslog - Issue(215374) - The module does not provide a
+        proper error message if the destination_address is more than 255 characters.
+      - ome_application_alerts_smtp - Issue(212310) - The module does not provide a
+        proper error message if the destination_address is more than 255 characters.
+      - idrac_user - Issue(192043) The module may error out with the message ``unable
+        to perform the import or export operation because there are pending attribute
+        changes or a configuration job is in progress``. Wait for the job to complete
+        and run the task again.
+      - ome_smart_fabric_uplink - Issue(186024) - The module does not allow the creation
+        of multiple uplinks of the same name even though it is supported by OpenManage
+        Enterprise Modular. If an uplink is created using the same name as an existing
+        uplink, the existing uplink is modified.
+      - ome_device_power_settings - Issue(212679) - The module errors out with the
+        following message if the value provided for the parameter ``power_cap`` is
+        not within the supported range of 0 to 32767, ``Unable to complete the request
+        because PowerCap does not  exist or is not applicable for the resource URI.``
+      release_summary: HTTPS SSL support for all modules and quick deploy settings.
+    modules:
+    - description: Configure Quick Deploy settings on OpenManage Enterprise Modular
+      name: ome_device_quick_deploy
+      namespace: ''
+    release_date: '2022-01-30'

docs/README.md

@@ -54,6 +54,7 @@ OpenManage Ansible Modules simplifies and automates provisioning, deployment, an
 - [ome_device_mgmt_network](modules/ome_device_mgmt_network.rst)
 - [ome_device_network_services](modules/ome_device_network_services.rst)
 - [ome_device_power_settings](modules/ome_device_power_settings.rst)
+- [ome_device_quick_deploy](modules/ome_device_quick_deploy.rst)
 - [ome_diagnostics](modules/ome_diagnostics.rst)
 - [ome_discovery](modules/ome_discovery.rst)
 - [ome_domain_user_groups](modules/ome_domain_user_groups.rst)

docs/modules/dellemc_configure_idrac_eventing.rst

@@ -21,7 +21,7 @@ Requirements
 The below requirements are needed on the host that executes this module.
 
 - omsdk
-- python >= 2.7.5
+- python >= 3.8.6
 
 
 
@@ -116,6 +116,24 @@ Parameters
     iDRAC port.
 
 
+  validate_certs (optional, bool, True)
+    If ``False``, the SSL certificates will not be validated.
+
+    Configure ``False`` only on personally controlled sites where self-signed certificates are used.
+
+    Prior to collection version ``5.0.0``, the *validate_certs* is ``False`` by default.
+
+
+  ca_path (optional, path, None)
+    The Privacy Enhanced Mail (PEM) file that contains a CA certificate to be used for the validation.
+
+    *ca_path* is required if *validate_certs* is ``True``
+
+
+  timeout (optional, int, 30)
+    The socket level timeout in seconds.
+
+
 
 
 
@@ -142,6 +160,7 @@ Examples
            idrac_ip:   "192.168.0.1"
            idrac_user: "user_name"
            idrac_password:  "user_password"
+           ca_path: "/path/to/ca_cert.pem"
            share_name: "192.168.0.1:/share"
            share_password:  "share_user"
            share_user: "share_password"
@@ -170,11 +189,11 @@ msg (always, str, Successfully configured the iDRAC eventing settings.)
   Successfully configured the iDRAC eventing settings.
 
 
-eventing_status (success, dict, {'CompletionTime': '2020-04-02T02:43:28', 'Description': 'Job Instance', 'EndTime': None, 'Id': 'JID_12345123456', 'JobState': 'Completed', 'JobType': 'ImportConfiguration', 'Message': 'Successfully imported and applied Server Configuration Profile.', 'MessageArgs': [], 'MessageId': 'SYS053', 'Name': 'Import Configuration', 'PercentComplete': 100, 'StartTime': 'TIME_NOW', 'Status': 'Success', 'TargetSettingsURI': None, 'retval': True})
+eventing_status (success, dict, AnsibleMapping([('CompletionTime', '2020-04-02T02:43:28'), ('Description', 'Job Instance'), ('EndTime', None), ('Id', 'JID_12345123456'), ('JobState', 'Completed'), ('JobType', 'ImportConfiguration'), ('Message', 'Successfully imported and applied Server Configuration Profile.'), ('MessageArgs', []), ('MessageId', 'SYS053'), ('Name', 'Import Configuration'), ('PercentComplete', 100), ('StartTime', 'TIME_NOW'), ('Status', 'Success'), ('TargetSettingsURI', None), ('retval', True)]))
   Configures the iDRAC eventing attributes.
 
 
-error_info (on HTTP error, dict, {'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.'}]}})
+error_info (on HTTP error, dict, AnsibleMapping([('error', AnsibleMapping([('code', 'Base.1.0.GeneralError'), ('message', 'A general error has occurred. See ExtendedInfo for more information.'), ('@Message.ExtendedInfo', [AnsibleMapping([('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.')])])]))]))
   Details of the HTTP Error.
 
 

docs/modules/dellemc_configure_idrac_services.rst

@@ -21,13 +21,43 @@ Requirements
 The below requirements are needed on the host that executes this module.
 
 - omsdk
-- python >= 2.7.5
+- python >= 3.8.6
 
 
 
 Parameters
 ----------
 
+  idrac_ip (True, str, None)
+    iDRAC IP Address.
+
+
+  idrac_user (True, str, None)
+    iDRAC username.
+
+
+  idrac_password (True, str, None)
+    iDRAC user password.
+
+
+  idrac_port (optional, int, 443)
+    iDRAC port.
+
+
+  validate_certs (optional, bool, True)
+    If ``False``, the SSL certificates will not be validated.
+
+    Configure ``False`` only on personally controlled sites where self-signed certificates are used.
+
+    Prior to collection version ``5.0.0``, the *validate_certs* is ``False`` by default.
+
+
+  ca_path (optional, path, None)
+    The Privacy Enhanced Mail (PEM) file that contains a CA certificate to be used for the validation.
+
+    *ca_path* is required if *validate_certs* is ``True``
+
+
   share_name (True, str, None)
     Network share or a local path.
 
@@ -101,22 +131,6 @@ Parameters
 
 
 
-  idrac_ip (True, str, None)
-    iDRAC IP Address.
-
-
-  idrac_user (True, str, None)
-    iDRAC username.
-
-
-  idrac_password (True, str, None)
-    iDRAC user password.
-
-
-  idrac_port (optional, int, 443)
-    iDRAC port.
-
-
 
 
 
@@ -143,6 +157,7 @@ Examples
            idrac_ip:   "192.168.0.1"
            idrac_user: "user_name"
            idrac_password:  "user_password"
+           ca_path: "/path/to/ca_cert.pem"
            share_name: "192.168.0.1:/share"
            share_mnt: "/mnt/share"
            enable_web_server: "Enabled"
@@ -169,11 +184,11 @@ msg (always, str, Successfully configured the iDRAC services settings.)
   Overall status of iDRAC service attributes configuration.
 
 
-service_status (success, dict, {'CompletionTime': '2020-04-02T02:43:28', 'Description': 'Job Instance', 'EndTime': None, 'Id': 'JID_12345123456', 'JobState': 'Completed', 'JobType': 'ImportConfiguration', 'Message': 'Successfully imported and applied Server Configuration Profile.', 'MessageArgs': [], 'MessageId': 'SYS053', 'Name': 'Import Configuration', 'PercentComplete': 100, 'StartTime': 'TIME_NOW', 'Status': 'Success', 'TargetSettingsURI': None, 'retval': True})
+service_status (success, dict, AnsibleMapping([('CompletionTime', '2020-04-02T02:43:28'), ('Description', 'Job Instance'), ('EndTime', None), ('Id', 'JID_12345123456'), ('JobState', 'Completed'), ('JobType', 'ImportConfiguration'), ('Message', 'Successfully imported and applied Server Configuration Profile.'), ('MessageArgs', []), ('MessageId', 'SYS053'), ('Name', 'Import Configuration'), ('PercentComplete', 100), ('StartTime', 'TIME_NOW'), ('Status', 'Success'), ('TargetSettingsURI', None), ('retval', True)]))
   Details of iDRAC services attributes configuration.
 
 
-error_info (on HTTP error, dict, {'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.'}]}})
+error_info (on HTTP error, dict, AnsibleMapping([('error', AnsibleMapping([('code', 'Base.1.0.GeneralError'), ('message', 'A general error has occurred. See ExtendedInfo for more information.'), ('@Message.ExtendedInfo', [AnsibleMapping([('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.')])])]))]))
   Details of the HTTP Error.
 
 

docs/modules/dellemc_get_firmware_inventory.rst

@@ -21,7 +21,7 @@ Requirements
 The below requirements are needed on the host that executes this module.
 
 - omsdk
-- python >= 2.7.5
+- python >= 3.8.6
 
 
 
@@ -44,6 +44,24 @@ Parameters
     iDRAC port.
 
 
+  validate_certs (optional, bool, True)
+    If ``False``, the SSL certificates will not be validated.
+
+    Configure ``False`` only on personally controlled sites where self-signed certificates are used.
+
+    Prior to collection version ``5.0.0``, the *validate_certs* is ``False`` by default.
+
+
+  ca_path (optional, path, None)
+    The Privacy Enhanced Mail (PEM) file that contains a CA certificate to be used for the validation.
+
+    *ca_path* is required if *validate_certs* is ``True``
+
+
+  timeout (optional, int, 30)
+    The socket level timeout in seconds.
+
+
 
 
 
@@ -69,6 +87,7 @@ Examples
           idrac_ip:   "192.168.0.1"
           idrac_user: "user_name"
           idrac_password:  "user_password"
+          ca_path: "/path/to/ca_cert.pem"
 
 
 

docs/modules/dellemc_get_system_inventory.rst

@@ -21,7 +21,7 @@ Requirements
 The below requirements are needed on the host that executes this module.
 
 - omsdk
-- python >= 2.7.5
+- python >= 3.8.6
 
 
 
@@ -44,6 +44,24 @@ Parameters
     iDRAC port.
 
 
+  validate_certs (optional, bool, True)
+    If ``False``, the SSL certificates will not be validated.
+
+    Configure ``False`` only on personally controlled sites where self-signed certificates are used.
+
+    Prior to collection version ``5.0.0``, the *validate_certs* is ``False`` by default.
+
+
+  ca_path (optional, path, None)
+    The Privacy Enhanced Mail (PEM) file that contains a CA certificate to be used for the validation.
+
+    *ca_path* is required if *validate_certs* is ``True``
+
+
+  timeout (optional, int, 30)
+    The socket level timeout in seconds.
+
+
 
 
 
@@ -69,6 +87,7 @@ Examples
         idrac_ip: "192.168.0.1"
         idrac_user: "user_name"
         idrac_password: "user_password"
+        ca_path: "/path/to/ca_cert.pem"