Release 7.5.0 (#497)

Added roles idrac_firmware, redfish_firmware, redfish_storage_volume
enhanced modules ome_template and redfish_firmware to track the jobs

.github/workflows/ansible-test.yml

@@ -162,6 +162,15 @@ jobs:
         - name: Install ansible posix
           run: ansible-galaxy collection install ansible.posix
 
+        - name: Download migrated collection artifacts
+          uses: actions/download-artifact@v1
+          with:
+            name: collection
+            path: .cache/collection-tarballs
+
+        - name: Install collection build
+          run: ansible-galaxy collection install .cache/collection-tarballs/*.tar.gz
+
         - name: Run Ansible lint
           run: ansible-lint --show-relpath
           working-directory: /home/runner/work/dellemc-openmanage-ansible-modules/dellemc-openmanage-ansible-modules

.gitignore

@@ -7,3 +7,6 @@ __pycache__/
 .idea/
 *.bak
 rstdocgen.sh
+node_modules
+demo
+.vscode

CHANGELOG.rst

@@ -5,6 +5,36 @@ Dell OpenManage Ansible Modules Release Notes
 .. contents:: Topics
 
 
+v7.5.0
+======
+
+Release Summary
+---------------
+
+- redfish_firmware - This module is enhanced to include job tracking.
+- ome_template - This module is enhanced to include job tracking.
+- Role to support the iDRAC and Redfish firmware update and manage storage volume configuration is added.
+- Role to deploy the iDRAC operating system is enhanced to support ESXi version 8.X and HTTP or HTTPS for the destination.
+
+
+Known Issues
+------------
+
+- idrac_os_deployment- Issue(260496) - OS installation will support only NFS and CIFS share to store the custom ISO in the destination_path, HTTP/HTTPS/FTP not supported
+- idrac_redfish_storage_contoller - Issue(256164) - If incorrect value is provided for one of the attributes in the provided attribute list for controller configuration, then this module does not exit with error.
+- 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_application_alerts_syslog - Issue(215374) - The module does not provide a proper error message if the destination_address is more than 255 characters.
+- ome_device_network_services - Issue(212681) - The module does not provide a proper error message if unsupported values are provided for the following parameters- port_number, community_name, max_sessions, max_auth_retries, and idle_timeout.
+- ome_device_power_settings - Issue(212679) - The module displays 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.``
+- ome_smart_fabric_uplink - Issue(186024) - Despite the module supported by OpenManage Enterprise Modular, it does not allow the creation of multiple uplinks of the same name. If an uplink is created using the same name as an existing uplink, the existing uplink is modified.
+
+New Roles
+---------
+
+- dellemc.openmanage.idrac_firmware - Firmware update from a repository on a network share (CIFS, NFS, HTTP, HTTPS, FTP).
+- dellemc.openmanage.redfish_firmware - Update a component firmware using the image file available on the local or remote system.
+- dellemc.openmanage.redfish_storage_volume - Role to manage the storage volume configuration.
+
 v7.4.0
 ======
 

README.md

@@ -25,20 +25,20 @@ OpenManage Ansible Modules simplifies and automates provisioning, deployment, an
 ## Supported Platforms
   * iDRAC7 based Dell PowerEdge Servers with firmware versions 2.63.60.62 and above.
   * iDRAC8 based Dell PowerEdge Servers with firmware versions 2.82.82.82 and above.
-  * iDRAC9 based Dell PowerEdge Servers with firmware versions 6.10.00.00 and above.
-  * Dell OpenManage Enterprise versions 3.9.2 and above.
+  * iDRAC9 based Dell PowerEdge Servers with firmware versions 5.10.50.00 and above.
+  * Dell OpenManage Enterprise versions 3.10.0 and above.
   * Dell OpenManage Enterprise Modular versions 1.40.20 and above.
 
 ## Prerequisites
-  * [Ansible Core >= 2.13.8 and 2.14.3](https://github.com/ansible/ansible)
+  * [Ansible Core >= 2.13.8 and 2.14.4](https://github.com/ansible/ansible)
   * Python >= 3.9.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 OpenManage Python SDK](https://github.com/dell/omsdk)
   * Operating System
     * Red Hat Enterprise Linux (RHEL) 9.1 and 8.7
     * SUSE Linux Enterprise Server (SLES) 15 SP4 and 15 SP3
-    * Ubuntu 22.04.1 and 22.04
+    * Ubuntu 22.04.2 and 22.04.1
 
 ## Installation
 

changelogs/changelog.yaml

@@ -1187,31 +1187,34 @@ releases:
   7.4.0:
     changes:
       known_issues:
-        - idrac_redfish_storage_contoller - Issue(256164) - If incorrect value is provided
-          for one of the attributes in the provided attribute list for controller configuration,
-          then this module does not exit with error.
-        - 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_application_alerts_syslog - Issue(215374) - The module does not provide
-          a proper error message if the destination_address is more than 255 characters.
-        - ome_device_network_services - Issue(212681) - The module does not provide
-          a proper error message if unsupported values are provided for the following parameters-
-          port_number, community_name, max_sessions, max_auth_retries, and idle_timeout.
-        - ome_device_power_settings - Issue(212679) - The module displays 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.``
-        - ome_smart_fabric_uplink - Issue(186024) - Despite the module supported by OpenManage Enterprise Modular,
-          it does not allow the creation of multiple uplinks of the same name. If an uplink is created using the
-          same name as an existing uplink, the existing uplink is modified.
-        - idrac_os_deployment- Issue(260496) - OS installation will support only NFS and CIFS
-          share to store the custom ISO in the destination_path, HTTP/HTTPS/FTP not supported
-      release_summary: | 
-        - Role to support the Import server configuration profile, Manage iDRAC power states, Manage iDRAC certificate,
-          Gather facts from iDRAC and Deploy operating system is added.
-        - Plugin OME inventory is enhanced to support the environment variables for the input parameters.
+      - idrac_os_deployment- Issue(260496) - OS installation will support only NFS
+        and CIFS share to store the custom ISO in the destination_path, HTTP/HTTPS/FTP
+        not supported
+      - idrac_redfish_storage_contoller - Issue(256164) - If incorrect value is provided
+        for one of the attributes in the provided attribute list for controller configuration,
+        then this module does not exit with error.
+      - 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_application_alerts_syslog - Issue(215374) - The module does not provide
+        a proper error message if the destination_address is more than 255 characters.
+      - ome_device_network_services - Issue(212681) - The module does not provide
+        a proper error message if unsupported values are provided for the following
+        parameters- port_number, community_name, max_sessions, max_auth_retries, and
+        idle_timeout.
+      - ome_device_power_settings - Issue(212679) - The module displays 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.``
+      - ome_smart_fabric_uplink - Issue(186024) - Despite the module supported by
+        OpenManage Enterprise Modular, it does not allow the creation of multiple
+        uplinks of the same name. If an uplink is created using the same name as an
+        existing uplink, the existing uplink is modified.
+      release_summary: "- Role to support the Import server configuration profile,
+        Manage iDRAC power states, Manage iDRAC certificate,\n  Gather facts from
+        iDRAC and Deploy operating system is added.\n- Plugin OME inventory is enhanced
+        to support the environment variables for the input parameters.\n"
     objects:
       role:
       - description: Role to manage the iDRAC certificates - generate CSR, import/export
@@ -1224,10 +1227,57 @@ releases:
       - description: Role to import iDRAC Server Configuration Profile (SCP).
         name: idrac_import_server_config_profile
         namespace: null
+      - description: Role to deploy specified operating system and version on the
+          servers.
+        name: idrac_os_deployment
+        namespace: null
       - description: Role to manage the different power states of the specified device.
         name: idrac_server_powerstate
         namespace: null
-      - description: Role to deploy specified operating system and version on the servers.
-        name: idrac_os_deployment
-        namespace: null
     release_date: '2023-03-30'
+  7.5.0:
+    changes:
+      known_issues:
+      - idrac_os_deployment- Issue(260496) - OS installation will support only NFS
+        and CIFS share to store the custom ISO in the destination_path, HTTP/HTTPS/FTP
+        not supported
+      - idrac_redfish_storage_contoller - Issue(256164) - If incorrect value is provided
+        for one of the attributes in the provided attribute list for controller configuration,
+        then this module does not exit with error.
+      - 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_application_alerts_syslog - Issue(215374) - The module does not provide
+        a proper error message if the destination_address is more than 255 characters.
+      - ome_device_network_services - Issue(212681) - The module does not provide
+        a proper error message if unsupported values are provided for the following
+        parameters- port_number, community_name, max_sessions, max_auth_retries, and
+        idle_timeout.
+      - ome_device_power_settings - Issue(212679) - The module displays 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.``
+      - ome_smart_fabric_uplink - Issue(186024) - Despite the module supported by
+        OpenManage Enterprise Modular, it does not allow the creation of multiple
+        uplinks of the same name. If an uplink is created using the same name as an
+        existing uplink, the existing uplink is modified.
+      release_summary: 
+      - redfish_firmware - This module is enhanced to include job tracking.
+      - ome_template - This module is enhanced to include job tracking.
+      - Role to support the iDRAC and Redfish firmware update and manage storage volume configuration is added.
+      - Role to deploy the iDRAC operating system is enhanced to support ESXi version 8.X and HTTP or HTTPS for the destination.
+    objects:
+      role:
+      - description: Firmware update from a repository on a network share (CIFS, NFS,
+          HTTP, HTTPS, FTP).
+        name: idrac_firmware
+        namespace: null
+      - description: To perform a component firmware update using the image file available
+          on the local or remote system.
+        name: redfish_firmware
+        namespace: null
+      - description: Role to manage the storage volume configuration.
+        name: redfish_storage_volume
+        namespace: null
+    release_date: '2023-04-30'

docs/DOCUMENTATION.md

@@ -8,7 +8,10 @@ You may obtain a copy of the License at
     https://www.gnu.org/licenses/gpl-3.0.txt
 -->
 ## Playbooks and Tutorials
-* For the latest sample playbooks and examples, see [playbooks](https://github.com/dell/dellemc-openmanage-ansible-modules/tree/collections/playbooks).
+* For the latest sample playbooks and example for idrac, see [idrac playbooks](https://github.com/dell/dellemc-openmanage-ansible-modules/tree/collections/playbooks/idrac).
+* For the latest sample playbooks and examples for redfish, see [redfish playbooks](https://github.com/dell/dellemc-openmanage-ansible-modules/tree/collections/playbooks/redfish).
+* For the latest sample playbooks and examples for ome, see [ome playbooks](https://github.com/dell/dellemc-openmanage-ansible-modules/tree/collections/playbooks/ome).
+* For the latest sample playbooks and examples for roles, see [roles playbooks](https://github.com/dell/dellemc-openmanage-ansible-modules/tree/collections/playbooks/roles).
 * For the tutorials and sample use cases, see the tutorials available at [developer.dell.com](https://developer.dell.com/).
 
 ## Module documentations
@@ -36,5 +39,5 @@ You may obtain a copy of the License at
        ```export REQUESTS_CA_BUNDLE=/usr/share/ssl-certs/ca-cert.pem```
 
 ### Ignore SSL certificate validation
-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.
+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.
 

galaxy.yml

@@ -1,6 +1,6 @@
 namespace: dellemc
 name: openmanage
-version: 7.4.0
+version: 7.5.0
 readme: README.md
 authors:
   - Jagadeesh N V <Jagadeesh.N.V@Dell.com>

playbooks/roles/README.md

@@ -0,0 +1,45 @@
+# Roles Playbooks
+
+### Using the Example playbooks
+
+1. Update the inventory
+Update the idrac IP's, hostnames in the `inventory` file.
+
+1. Update the varaibles required for a role under `vars_files` folder.
+
+1. Run the following command to run the role
+`ansible-playbook <role_folder>/<role_file>.yml -i inventory
+
+### Folder Tree
+
+```
+.
+├── idrac_certificate
+│   └── idrac_certificate.yml
+├── idrac_export_server_config_profile
+│   └── idrac_export_server_config_profile.yml
+├── idrac_firmware
+│   └── idrac_firmware.yml
+├── idrac_gather_facts
+│   └── idrac_gather_facts.yml
+├── idrac_import_server_config_profile
+│   └── idrac_import_server_config_profile.yml
+├── idrac_os_deployment
+│   └── idrac_os_deployment.yml
+├── idrac_server_powerstate
+│   └── idrac_server_powerstate.yml
+├── inventory
+├── README.md
+├── redfish_firmware
+│   └── redfish_firmware.yml
+├── redfish_storage_volume
+│   └── redfish_storage_volume.yml
+└── vars_files
+    ├── certificates.yml
+    ├── credentials.yml
+    ├── export.yml
+    ├── firmware.yml
+    ├── import.yml
+    ├── osd.yml
+    └── storage.yml
+```

playbooks/roles/idrac_certificate/idrac_certificate.yml

@@ -0,0 +1,9 @@
+---
+- name: Manage certificates in iDRAC
+  hosts: idrac
+  gather_facts: false
+  vars_files:
+    - ../vars_files/credentials.yml
+    - ../vars_files/certificates.yml
+  roles:
+    - dellemc.openmanage.idrac_certificate

playbooks/roles/idrac_export_server_config_profile/idrac_export_server_config_profile.yml

@@ -0,0 +1,9 @@
+---
+- name: Export Server configuration profile
+  hosts: idrac
+  gather_facts: false
+  vars_files:
+    - ../vars_files/credentials.yml
+    - ../vars_files/export.yml
+  roles:
+    - dellemc.openmanage.idrac_export_server_config_profile

playbooks/roles/idrac_firmware/idrac_firmware.yml

@@ -0,0 +1,11 @@
+---
+- name: Firmware update using catalog for iDRAC
+  hosts: idrac
+  gather_facts: false
+  vars_files:
+    - ../vars_files/credentials.yml
+    - ../vars_files/firmware.yml
+  vars:
+    hostname: "{{ inventory_hostname }}"
+  roles:
+    - dellemc.openmanage.idrac_firmware

playbooks/roles/idrac_gather_facts/idrac_gather_facts.yml

@@ -0,0 +1,10 @@
+---
+- name: Get iDRAC information
+  hosts: idrac
+  gather_facts: false
+  vars_files:
+    - ../vars_files/credentials.yml
+  vars:
+    target: "System"
+  roles:
+    - dellemc.openmanage.idrac_server_powerstate

playbooks/roles/idrac_import_server_config_profile/idrac_import_server_config_profile.yml

@@ -0,0 +1,9 @@
+---
+- name: Import Server configuration profile
+  hosts: idrac
+  gather_facts: false
+  vars_files:
+    - ../vars_files/credentials.yml
+    - ../vars_files/import.yml
+  roles:
+    - dellemc.openmanage.idrac_import_server_config_profile

playbooks/roles/idrac_os_deployment/idrac_os_deployment.yml

@@ -0,0 +1,9 @@
+---
+- name: Operating System Deployment in iDRAC
+  hosts: idrac
+  gather_facts: false
+  vars_files:
+    - ../vars_files/credentials.yml
+    - ../vars_files/osd.yml
+  roles:
+    - dellemc.openmanage.idrac_os_deployment

playbooks/roles/idrac_server_powerstate/idrac_server_powerstate.yml

@@ -0,0 +1,10 @@
+---
+- name: Manage iDRAC server power cycle
+  hosts: idrac
+  gather_facts: false
+  vars_files:
+    - ../vars_files/credentials.yml
+  vars:
+    reset_type: "On"
+  roles:
+    - dellemc.openmanage.idrac_server_powerstate

playbooks/roles/inventory

@@ -0,0 +1,4 @@
+[idrac]
+192.168.0.1
+192.168.0.2
+192.168.0.3

playbooks/roles/redfish_firmware/redfish_firmware.yml

@@ -0,0 +1,9 @@
+---
+- name: Firmware update using DUP file
+  hosts: idrac
+  gather_facts: false
+  vars_files:
+    - ../vars_files/credentials.yml
+    - ../vars_files/firmware.yml
+  roles:
+    - dellemc.openmanage.redfish_firmware

playbooks/roles/redfish_storage_volume/redfish_storage_volume.yml

@@ -0,0 +1,9 @@
+---
+- name: Redfish Storage volume Configurations
+  hosts: idrac
+  gather_facts: false
+  vars_files:
+    - ../vars_files/credentials.yml
+    - ../vars_files/storage.yml
+  roles:
+    - dellemc.openmanage.redfish_storage_volume

playbooks/roles/vars_files/certificates.yml

@@ -0,0 +1,13 @@
+command: "generate_csr"
+certificate_type: "HTTPS"
+certificate_path: "/home/omam/mycerts"
+cert_params:
+  common_name: "sample.domain.com"
+  organization_unit: "OrgUnit"
+  locality_name: "Bangalore"
+  state_name: "Karnataka"
+  country_code: "IN"
+  email_address: "admin@domain.com"
+  organization_name: "OrgName"
+  subject_alt_name:
+    - 192.168.0.3