Skip to content

Commit 14064b2

Browse files
felixs88felixs88
authored
5.0.1 Patch Release (#361)
* 5.0.1 Patch Release
1 parent 16424fe commit 14064b2

File tree

157 files changed

+1344
-1785
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

157 files changed

+1344
-1785
lines changed

‎CHANGELOG.rst

+32
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,38 @@ Dell EMC OpenManage Ansible Modules Release Notes
55
.. contents:: Topics
66

77

8+
v5.0.1
9+
======
10+
11+
Release Summary
12+
---------------
13+
14+
Support to provide custom or organizational CA signed certificate for SSL validation from the environment variable.
15+
16+
Major Changes
17+
-------------
18+
19+
- All modules can read custom or organizational CA signed certificate from the environment variables. Please refer to `SSL Certificate Validation <https://github.com/dell/dellemc-openmanage-ansible-modules#ssl-certificate-validation>`_ section in the `README.md <https://github.com/dell/dellemc-openmanage-ansible-modules/blob/collections/README.md#SSL-Certificate-Validation>`_ for modification to existing playbooks or setting environment variable.
20+
21+
Bugfixes
22+
--------
23+
24+
- All playbooks require modification because the validate_certs argument is set to True by default (https://github.com/dell/dellemc-openmanage-ansible-modules/issues/357)
25+
- The ome_application_network_time and ome_application_network_proxy modules are breaking due to the changes introduced for SSL validation.(https://github.com/dell/dellemc-openmanage-ansible-modules/issues/360)
26+
27+
Known Issues
28+
------------
29+
30+
- 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.
31+
- ome_application_alerts_smtp - Issue(212310) - The module does not provide a proper error message if the destination_address is more than 255 characters.
32+
- ome_application_alerts_syslog - Issue(215374) - The module does not provide a proper error message if the destination_address is more than 255 characters.
33+
- 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.
34+
- 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.
35+
- 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.
36+
- 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.``
37+
- 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.
38+
- 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.
39+
840
v5.0.0
941
======
1042

‎README.md

+10-6
Original file line numberDiff line numberDiff line change
@@ -1,15 +1,15 @@
11
# Dell EMC OpenManage Ansible Modules
22

3-
Dell EMC OpenManage Ansible Modules allows data center and IT administrators to use RedHat Ansible to automate and orchestrate the configuration, deployment, and update of Dell EMC PowerEdge Servers and modular infrastructure by leveraging the management automation capabilities in-built into the Integrated Dell Remote Access Controller (iDRAC), OpenManage Enterprise and OpenManage Enterprise Modular.
3+
Dell EMC OpenManage Ansible Modules allows data center and IT administrators to use RedHat Ansible to automate and orchestrate the configuration, deployment, and update of Dell EMC PowerEdge Servers and modular infrastructure by leveraging the management automation capabilities in-built into the Integrated Dell Remote Access Controller (iDRAC), OpenManage Enterprise (OME) and OpenManage Enterprise Modular (OMEM).
44

55
OpenManage Ansible Modules simplifies and automates provisioning, deployment, and updates of PowerEdge servers and modular infrastructure. It allows system administrators and software developers to introduce the physical infrastructure provisioning into their software provisioning stack, integrate with existing DevOps pipelines and manage their infrastructure using version-controlled playbooks, server configuration profiles, and templates in line with the Infrastructure-as-Code (IaC) principles.
66

77
## Supported Platforms
88
* iDRAC 7 based Dell EMC PowerEdge Servers with firmware versions 2.63.60.62 and above.
99
* iDRAC 8 based Dell EMC PowerEdge Servers with firmware versions 2.81.81.81 and above.
1010
* iDRAC 9 based Dell EMC PowerEdge Servers with firmware versions 5.00.10.20 and above.
11-
* Dell EMC OpenManage Enterprise versions 3.8.0 and above.
12-
* Dell EMC OpenManage Enterprise-Modular versions 1.30.10 and above.
11+
* Dell EMC OpenManage Enterprise versions 3.8.2 and above.
12+
* Dell EMC OpenManage Enterprise Modular versions 1.40.00 and above.
1313

1414
## Prerequisites
1515
* [Ansible >= 2.10.0](https://github.com/ansible/ansible)
@@ -42,11 +42,15 @@ To enable SSL certificate validation, perform the following steps:
4242
* Generate and upload the custom or organizational CA signed certificates on the iDRACs, OpenManage Enterprise, and OpenManage Enterprise-Modular, as required.
4343
* For iDRAC, see the section `SSL server certificates` in the `Integrated Dell Remote Access Controller Users Guide`.
4444
* For OpenManage Enterprise, see the section `Security Certificates` in the `OpenManage Enterprise Users Guide`.
45-
* For OpenManage Enterprise-Modular Edition, see the section `Managing certificates` in the `OpenManage Enterprise-Modular Edition for PowerEdge MX7000 Chassis Users Guide`.
45+
* For OpenManage Enterprise Modular, see the section `Managing certificates` in the `OpenManage Enterprise Modular for PowerEdge MX7000 Chassis Users Guide`.
4646
* After you have uploaded the custom or organizational CA signed certificate to iDRAC or OME or OME-M, you must have the CA file or bundle available on your Ansible controller. For example, copy the CA file or bundle in the following path: /usr/share/ssl-certs/
4747
> **_NOTE_**: Ensure that the user running the Ansible modules has permission to access the certificate file or bundle.
48-
* In your playbook, set the ca_path argument to the file path of your custom or organization CA certificate file or bundle.
48+
* You can then use either of the following methods to specify the custom or organization CA certificate file or bundle path to the module:
49+
* In your playbook tasks, set the `ca_path` argument to the file path of your custom or organization CA certificate file or bundle.
4950
```ca_path: /usr/share/ssl-certs/ca-cert.pem```
51+
* Use any of the following environment variables to specify the custom or organization CA certificate file or bundle path. The modules reads the environment variable in the following order of preference: ```REQUESTS_CA_BUNDLE```, ```CURL_CA_BUNDLE```, ```OMAM_CA_BUNDLE```.
52+
> **_NOTE_**: Use the following command to set the environment variable with the custom or organization CA certificate file or bundle:
53+
<br>```export REQUESTS_CA_BUNDLE=/usr/share/ssl-certs/ca-cert.pem```
5054
5155
### Ignore SSL certificate validation
5256
It is common to run a test environment without a proper SSL certificate configuration. To disable the certificate validation for a module, set the validate_certs module argument to ```False``` in the playbook.
@@ -88,4 +92,4 @@ To debug OpenManage Ansible Modules using IDE, see [here](https://github.com/del
8892
* To provide feedback to the development team, send an email to **OpenManageAnsible@Dell.com**.
8993

9094
## Authors
91-
* OpenManageAnsible (OpenManageAnsible@dell.com)
95+
* OpenManageAnsible (OpenManageAnsible@dell.com)

‎changelogs/changelog.yaml

+41
Original file line numberDiff line numberDiff line change
@@ -529,3 +529,44 @@ releases:
529529
name: ome_device_quick_deploy
530530
namespace: ''
531531
release_date: '2022-01-27'
532+
5.0.1:
533+
changes:
534+
major_changes:
535+
- All modules can read custom or organizational CA signed certificate from the environment variables.
536+
Please refer to `SSL Certificate Validation <https://github.com/dell/dellemc-openmanage-ansible-modules#ssl-certificate-validation>`_ section in the `README.md <https://github.com/dell/dellemc-openmanage-ansible-modules/blob/collections/README.md#SSL-Certificate-Validation>`_ for modification to existing playbooks or setting environment variable.
537+
bugfixes:
538+
- The ome_application_network_time and ome_application_network_proxy modules are breaking due
539+
to the changes introduced for SSL validation.(https://github.com/dell/dellemc-openmanage-ansible-modules/issues/360)
540+
- All playbooks require modification because the validate_certs argument is set to True by default
541+
(https://github.com/dell/dellemc-openmanage-ansible-modules/issues/357)
542+
known_issues:
543+
- ome_device_quick_deploy - Issue(216352) - The module does not display a proper error message
544+
if an unsupported value is provided for the ipv6_prefix_length and vlan_id parameters.
545+
- ome_device_local_access_configuration - Issue(217865) - The module does not
546+
display a proper error message if an unsupported value is provided for the
547+
user_defined and lcd_language parameters.
548+
- ome_device_local_access_configuration - Issue(215035) - The module reports
549+
``Successfully updated the local access setting`` if an unsupported value is
550+
provided for the parameter timeout_limit. However, this value is not
551+
actually applied on OpenManage Enterprise Modular.
552+
- ome_device_network_services - Issue(212681) - The module does not provide a
553+
proper error message if unsupported values are provided for the parameters-
554+
port_number, community_name, max_sessions, max_auth_retries, and idle_timeout.
555+
- ome_application_alerts_syslog - Issue(215374) - The module does not provide a
556+
proper error message if the destination_address is more than 255 characters.
557+
- ome_application_alerts_smtp - Issue(212310) - The module does not provide a
558+
proper error message if the destination_address is more than 255 characters.
559+
- idrac_user - Issue(192043) The module may error out with the message ``unable
560+
to perform the import or export operation because there are pending attribute
561+
changes or a configuration job is in progress``. Wait for the job to complete
562+
and run the task again.
563+
- ome_smart_fabric_uplink - Issue(186024) - The module does not allow the creation
564+
of multiple uplinks of the same name even though it is supported by OpenManage
565+
Enterprise Modular. If an uplink is created using the same name as an existing
566+
uplink, the existing uplink is modified.
567+
- ome_device_power_settings - Issue(212679) - The module errors out with the
568+
following message if the value provided for the parameter ``power_cap`` is
569+
not within the supported range of 0 to 32767, ``Unable to complete the request
570+
because PowerCap does not exist or is not applicable for the resource URI.``
571+
release_summary: Support to provide custom or organizational CA signed certificate for SSL validation from the environment variable.
572+
release_date: '2022-02-11'

‎docs/modules/dellemc_configure_idrac_eventing.rst

+1-3
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,7 @@ Requirements
2020
------------
2121
The below requirements are needed on the host that executes this module.
2222

23-
- omsdk
23+
- omsdk >= 1.2.488
2424
- python >= 3.8.6
2525

2626

@@ -127,8 +127,6 @@ Parameters
127127
ca_path (optional, path, None)
128128
The Privacy Enhanced Mail (PEM) file that contains a CA certificate to be used for the validation.
129129

130-
*ca_path* is required if *validate_certs* is ``True``
131-
132130

133131
timeout (optional, int, 30)
134132
The socket level timeout in seconds.

‎docs/modules/dellemc_configure_idrac_services.rst

+1-3
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,7 @@ Requirements
2020
------------
2121
The below requirements are needed on the host that executes this module.
2222

23-
- omsdk
23+
- omsdk >= 1.2.488
2424
- python >= 3.8.6
2525

2626

@@ -55,8 +55,6 @@ Parameters
5555
ca_path (optional, path, None)
5656
The Privacy Enhanced Mail (PEM) file that contains a CA certificate to be used for the validation.
5757

58-
*ca_path* is required if *validate_certs* is ``True``
59-
6058

6159
share_name (True, str, None)
6260
Network share or a local path.

‎docs/modules/dellemc_get_firmware_inventory.rst

+1-3
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,7 @@ Requirements
2020
------------
2121
The below requirements are needed on the host that executes this module.
2222

23-
- omsdk
23+
- omsdk >= 1.2.488
2424
- python >= 3.8.6
2525

2626

@@ -55,8 +55,6 @@ Parameters
5555
ca_path (optional, path, None)
5656
The Privacy Enhanced Mail (PEM) file that contains a CA certificate to be used for the validation.
5757

58-
*ca_path* is required if *validate_certs* is ``True``
59-
6058

6159
timeout (optional, int, 30)
6260
The socket level timeout in seconds.

‎docs/modules/dellemc_get_system_inventory.rst

+1-3
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,7 @@ Requirements
2020
------------
2121
The below requirements are needed on the host that executes this module.
2222

23-
- omsdk
23+
- omsdk >= 1.2.488
2424
- python >= 3.8.6
2525

2626

@@ -55,8 +55,6 @@ Parameters
5555
ca_path (optional, path, None)
5656
The Privacy Enhanced Mail (PEM) file that contains a CA certificate to be used for the validation.
5757

58-
*ca_path* is required if *validate_certs* is ``True``
59-
6058

6159
timeout (optional, int, 30)
6260
The socket level timeout in seconds.

‎docs/modules/dellemc_idrac_lc_attributes.rst

+1-3
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,7 @@ Requirements
2020
------------
2121
The below requirements are needed on the host that executes this module.
2222

23-
- omsdk
23+
- omsdk >= 1.2.488
2424
- python >= 3.8.6
2525

2626

@@ -75,8 +75,6 @@ Parameters
7575
ca_path (optional, path, None)
7676
The Privacy Enhanced Mail (PEM) file that contains a CA certificate to be used for the validation.
7777

78-
*ca_path* is required if *validate_certs* is ``True``
79-
8078

8179
timeout (optional, int, 30)
8280
The socket level timeout in seconds.

‎docs/modules/dellemc_idrac_storage_volume.rst

+1-3
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,7 @@ Requirements
2020
------------
2121
The below requirements are needed on the host that executes this module.
2222

23-
- omsdk
23+
- omsdk >= 1.2.488
2424
- python >= 3.8.6
2525

2626

@@ -139,8 +139,6 @@ Parameters
139139
ca_path (optional, path, None)
140140
The Privacy Enhanced Mail (PEM) file that contains a CA certificate to be used for the validation.
141141

142-
*ca_path* is required if *validate_certs* is ``True``
143-
144142

145143
timeout (optional, int, 30)
146144
The socket level timeout in seconds.

‎docs/modules/dellemc_system_lockdown_mode.rst

+1-3
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,7 @@ Requirements
2020
------------
2121
The below requirements are needed on the host that executes this module.
2222

23-
- omsdk
23+
- omsdk >= 1.2.488
2424
- python >= 3.8.6
2525

2626

@@ -75,8 +75,6 @@ Parameters
7575
ca_path (optional, path, None)
7676
The Privacy Enhanced Mail (PEM) file that contains a CA certificate to be used for the validation.
7777

78-
*ca_path* is required if *validate_certs* is ``True``
79-
8078

8179
timeout (optional, int, 30)
8280
The socket level timeout in seconds.

‎docs/modules/idrac_bios.rst

+1-3
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,7 @@ Requirements
2020
------------
2121
The below requirements are needed on the host that executes this module.
2222

23-
- omsdk
23+
- omsdk >= 1.2.488
2424
- python >= 3.8.6
2525

2626

@@ -125,8 +125,6 @@ Parameters
125125
ca_path (optional, path, None)
126126
The Privacy Enhanced Mail (PEM) file that contains a CA certificate to be used for the validation.
127127

128-
*ca_path* is required if *validate_certs* is ``True``
129-
130128

131129
timeout (optional, int, 30)
132130
The socket level timeout in seconds.

‎docs/modules/idrac_firmware.rst

+1-3
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,7 @@ Requirements
2626
------------
2727
The below requirements are needed on the host that executes this module.
2828

29-
- omsdk
29+
- omsdk >= 1.2.488
3030
- python >= 3.8.6
3131

3232

@@ -107,8 +107,6 @@ Parameters
107107
ca_path (optional, path, None)
108108
The Privacy Enhanced Mail (PEM) file that contains a CA certificate to be used for the validation.
109109

110-
*ca_path* is required if *validate_certs* is ``True``
111-
112110

113111
timeout (optional, int, 30)
114112
The socket level timeout in seconds.

‎docs/modules/idrac_firmware_info.rst

+1-3
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,7 @@ Requirements
2020
------------
2121
The below requirements are needed on the host that executes this module.
2222

23-
- omsdk
23+
- omsdk >= 1.2.488
2424
- python >= 3.8.6
2525

2626

@@ -55,8 +55,6 @@ Parameters
5555
ca_path (optional, path, None)
5656
The Privacy Enhanced Mail (PEM) file that contains a CA certificate to be used for the validation.
5757

58-
*ca_path* is required if *validate_certs* is ``True``
59-
6058

6159
timeout (optional, int, 30)
6260
The socket level timeout in seconds.

‎docs/modules/idrac_lifecycle_controller_job_status_info.rst

+1-3
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,7 @@ Requirements
2020
------------
2121
The below requirements are needed on the host that executes this module.
2222

23-
- omsdk
23+
- omsdk >= 1.2.488
2424
- python >= 3.8.6
2525

2626

@@ -59,8 +59,6 @@ Parameters
5959
ca_path (optional, path, None)
6060
The Privacy Enhanced Mail (PEM) file that contains a CA certificate to be used for the validation.
6161

62-
*ca_path* is required if *validate_certs* is ``True``
63-
6462

6563
timeout (optional, int, 30)
6664
The socket level timeout in seconds.

‎docs/modules/idrac_lifecycle_controller_jobs.rst

+1-3
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,7 @@ Requirements
2020
------------
2121
The below requirements are needed on the host that executes this module.
2222

23-
- omsdk
23+
- omsdk >= 1.2.488
2424
- python >= 3.8.6
2525

2626

@@ -61,8 +61,6 @@ Parameters
6161
ca_path (optional, path, None)
6262
The Privacy Enhanced Mail (PEM) file that contains a CA certificate to be used for the validation.
6363

64-
*ca_path* is required if *validate_certs* is ``True``
65-
6664

6765
timeout (optional, int, 30)
6866
The socket level timeout in seconds.

‎docs/modules/idrac_lifecycle_controller_logs.rst

+1-3
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,7 @@ Requirements
2020
------------
2121
The below requirements are needed on the host that executes this module.
2222

23-
- omsdk
23+
- omsdk >= 1.2.488
2424
- python >= 3.8.6
2525

2626

@@ -73,8 +73,6 @@ Parameters
7373
ca_path (optional, path, None)
7474
The Privacy Enhanced Mail (PEM) file that contains a CA certificate to be used for the validation.
7575

76-
*ca_path* is required if *validate_certs* is ``True``
77-
7876

7977
timeout (optional, int, 30)
8078
The socket level timeout in seconds.

‎docs/modules/idrac_lifecycle_controller_status_info.rst

+1-3
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,7 @@ Requirements
2020
------------
2121
The below requirements are needed on the host that executes this module.
2222

23-
- omsdk
23+
- omsdk >= 1.2.488
2424
- python >= 3.8.6
2525

2626

@@ -55,8 +55,6 @@ Parameters
5555
ca_path (optional, path, None)
5656
The Privacy Enhanced Mail (PEM) file that contains a CA certificate to be used for the validation.
5757

58-
*ca_path* is required if *validate_certs* is ``True``
59-
6058

6159
timeout (optional, int, 30)
6260
The socket level timeout in seconds.

‎docs/modules/idrac_network.rst

+1-3
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,7 @@ Requirements
2020
------------
2121
The below requirements are needed on the host that executes this module.
2222

23-
- omsdk
23+
- omsdk >= 1.2.488
2424
- python >= 3.8.6
2525

2626

@@ -147,8 +147,6 @@ Parameters
147147
ca_path (optional, path, None)
148148
The Privacy Enhanced Mail (PEM) file that contains a CA certificate to be used for the validation.
149149

150-
*ca_path* is required if *validate_certs* is ``True``
151-
152150

153151
timeout (optional, int, 30)
154152
The socket level timeout in seconds.

0 commit comments

Comments
 (0)