Skip to content

Commit

Permalink
Merge pull request #272 from felixs88/collections
Browse files Browse the repository at this point in the history
Release 3.3.0
  • Loading branch information
rajeevarakkal authored Apr 27, 2021
2 parents 95ca93d + 2b42a77 commit 9f8ac7a
Show file tree
Hide file tree
Showing 17 changed files with 2,409 additions and 69 deletions.
31 changes: 29 additions & 2 deletions CHANGELOG.rst
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,33 @@ Dell EMC OpenManage Ansible Modules Release Notes
.. contents:: Topics


v3.3.0
======

Release Summary
---------------

OpenManage Enterprise device group and device discovery support added

Minor Changes
-------------

- ome_firmware_baseline - Allows to retrieve the device even if it not in the first 50 device IDs

Known Issues
------------

- idrac_user - Issue(192043) 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_configuration_compliance_info - Issue(195592) Module may error out with the message ``unable to process the request because an error occurred``. If the issue persists, report it to the system administrator.
- ome_smart_fabric - Issue(185322) Only three design types are supported by OpenManage Enterprise Modular but the module successfully creates a fabric when the design type is not supported.
- ome_smart_fabric_uplink - Issue(186024) ome_smart_fabric_uplink module does not allow the creation of multiple uplinks of the same name even though this is supported by OpenManage Enterprise Modular. If an uplink is created using the same name as an existing uplink, the existing uplink is modified.

New Modules
-----------

- dellemc.openmanage.ome_device_group - Manages device group settings on OpenManage Enterprise
- dellemc.openmanage.ome_discovery - Create, modify or delete a discovery job on OpenManage Enterprise

v3.2.0
======

Expand All @@ -21,10 +48,10 @@ Minor Changes
Known Issues
------------

- idrac_user - Issue(192043) 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_configuration_compliance_info - Issue(195592) Module may error out with the message ``unable to process the request because an error occurred``. If the issue persists, report it to the system administrator.
- ome_smart_fabric - Issue(185322) Only three design types are supported by OpenManage Enterprise Modular but the module successfully creates a fabric when the design type is not supported.
- ome_smart_fabric_uplink - Issue(186024) ome_smart_fabric_uplink module does not allow the creation of multiple uplinks of the same name even though this 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_configuration_compliance_info - Issue(195592) Module may error out with the message "unable to process the request because an error occurred". If the issue persists, report it to the system administrator.
- idrac_user - Issue(192043) 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.

New Modules
-----------
Expand Down
6 changes: 3 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,9 +5,9 @@ Dell EMC OpenManage Ansible Modules allows data center and IT administrators to
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.

## Supported Platforms
* iDRAC 7 and 8 based Dell EMC PowerEdge Servers with Firmware versions 2.60.60.60 and above.
* iDRAC 9 based Dell EMC PowerEdge Servers with Firmware versions 3.34.34.34 and above.
* Dell EMC OpenManage Enterprise versions 3.2.1 and above.
* iDRAC 7 and 8 based Dell EMC PowerEdge Servers with Firmware versions 2.70.70.70 and above.
* iDRAC 9 based Dell EMC PowerEdge Servers with Firmware versions 4.32.10.00 and above.
* Dell EMC OpenManage Enterprise versions 3.4 and above.
* Dell EMC OpenManage Enterprise-Modular versions 1.20.00 and above.

## Prerequisites
Expand Down
18 changes: 18 additions & 0 deletions changelogs/changelog.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -220,3 +220,21 @@ releases:
name: ome_configuration_compliance_info
namespace: ''
release_date: '2021-03-24'
3.3.0:
changes:
release_summary: OpenManage Enterprise device group and device discovery support added
known_issues:
- ome_smart_fabric - Issue(185322) Only three design types are supported by OpenManage Enterprise Modular but the module successfully creates a fabric when the design type is not supported.
- ome_smart_fabric_uplink - Issue(186024) ome_smart_fabric_uplink module does not allow the creation of multiple uplinks of the same name even though this 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_configuration_compliance_info - Issue(195592) Module may error out with the message ``unable to process the request because an error occurred``. If the issue persists, report it to the system administrator.
- idrac_user - Issue(192043) 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.
minor_changes:
- ome_firmware_baseline - Allows to retrieve the device even if it not in the first 50 device IDs
modules:
- description: Create, modify or delete a discovery job on OpenManage Enterprise
name: ome_discovery
namespace: ''
- description: Manages device group settings on OpenManage Enterprise
name: ome_device_group
namespace: ''
release_date: '2021-04-28'
3 changes: 2 additions & 1 deletion galaxy.yml
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
namespace: dellemc
name: openmanage
version: 3.2.0
version: 3.3.0
readme: README.md
authors:
- Rajeev Arakkal <[email protected]>
Expand Down Expand Up @@ -28,3 +28,4 @@ repository: https://github.com/dell/dellemc-openmanage-ansible-modules/tree/coll
homepage: https://github.com/dell/dellemc-openmanage-ansible-modules

issues: https://github.com/dell/dellemc-openmanage-ansible-modules/issues

31 changes: 31 additions & 0 deletions playbooks/ome/ome_device_group.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,31 @@
---
- hosts: ome
connection: local
name: Dell OpenManage Ansible device inventory details.
gather_facts: False

collections:
- dellemc.openmanage

tasks:
- name: Adding a set of devices to a group using device ids.
ome_device_group:
hostname: "{{ hostname }}"
username: "{{ username }}"
password: "{{ password }}"
name: "Storage Services"
device_ids:
- 11111
- 11112
tags: device-id

- name: Adding a set of devices to a group using device service tags.
ome_device_group:
hostname: "{{ hostname }}"
username: "{{ username }}"
password: "{{ password }}"
name: "Storage Services"
device_service_tags:
- GHRT2R
- KJHDF3
tags: device-service-tags
181 changes: 181 additions & 0 deletions playbooks/ome/ome_discovery.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,181 @@
---
- hosts: ome
connection: local
name: Dell EMC OpenManage Ansible discovery operations.
gather_facts: False

collections:
- dellemc.openmanage

tasks:
- name: Discover servers in a range
ome_discovery:
hostname: "{{hostname}}"
username: "{{username}}"
password: "{{password}}"
discovery_job_name: "Discovery_server_1"
discovery_config_targets:
- network_address_detail:
- 192.96.24.1-192.96.24.255
device_types:
- SERVER
wsman:
username: user
password: password
tags:
- server_discovery

- name: Discover chassis in a range
ome_discovery:
hostname: "{{hostname}}"
username: "{{username}}"
password: "{{password}}"
discovery_job_name: "Discovery_chassis_1"
discovery_config_targets:
- network_address_detail:
- 192.96.24.1-192.96.24.255
device_types:
- CHASSIS
wsman:
username: user
password: password
tags:
- chassis_discovery

- name: Discover switches in a range
ome_discovery:
hostname: "{{hostname}}"
username: "{{username}}"
password: "{{password}}"
discovery_job_name: "Discover_switch_1"
discovery_config_targets:
- network_address_detail:
- 192.96.24.1-192.96.24.255
device_types:
- NETWORK SWITCH
snmp:
community: snmp_creds
tags:
- switch_discovery

- name: Discover storage in a range
ome_discovery:
hostname: "{{hostname}}"
username: "{{username}}"
password: "{{password}}"
discovery_job_name: "Discover_storage_1"
discovery_config_targets:
- network_address_detail:
- 192.96.24.1-192.96.24.255
device_types:
- STORAGE
storage:
username: user
password: password
snmp:
community: community_str
tags:
- storage_discovery

- name: Delete a discovery job
ome_discovery:
hostname: "{{hostname}}"
username: "{{username}}"
password: "{{password}}"
state: "absent"
discovery_job_name: "Discovery-123"
tags:
- delete_discovery

- name: Schedule the discovery of multiple devices ignoring partial failure and enable trap to receive alerts
ome_discovery:
hostname: "{{hostname}}"
username: "{{username}}"
password: "{{password}}"
state: "present"
discovery_job_name: "Discovery-123"
discovery_config_targets:
- network_address_detail:
- 192.96.24.1-192.96.24.255
- 192.96.0.0/24
- 192.96.26.108
device_types:
- SERVER
- CHASSIS
- STORAGE
- NETWORK SWITCH
wsman:
username: wsman_user
password: wsman_pwd
redfish:
username: redfish_user
password: redfish_pwd
snmp:
community: snmp_community
- network_address_detail:
- 192.96.25.1-192.96.25.255
- ipmihost
- esxiserver
- sshserver
device_types:
- SERVER
ssh:
username: ssh_user
password: ssh_pwd
vmware:
username: vm_user
password: vmware_pwd
ipmi:
username: ipmi_user
password: ipmi_pwd
schedule: RunLater
cron: "0 0 9 ? * MON,WED,FRI *"
ignore_partial_failure: True
trap_destination: True
community_string: True
email_recipient: [email protected]
tags:
- schedule_discovery

- name: Discover servers with ca check enabled
ome_discovery:
hostname: "{{hostname}}"
username: "{{username}}"
password: "{{password}}"
discovery_job_name: "Discovery_server_ca1"
discovery_config_targets:
- network_address_detail:
- 192.96.24.108
device_types:
- SERVER
wsman:
username: user
password: password
ca_check: True
certificate_data: "{{ lookup('ansible.builtin.file', '/path/to/certificate_data_file') }}"
tags:
- server_ca_check

- name: Discover chassis with ca check enabled data
dellemc.openmanage.ome_discovery:
hostname: "192.168.0.1"
username: "username"
password: "password"
discovery_job_name: "Discovery_chassis_ca1"
discovery_config_targets:
- network_address_detail:
- 192.96.24.108
device_types:
- CHASSIS
redfish:
username: user
password: password
ca_check: True
certificate_data: "-----BEGIN CERTIFICATE-----\r\n
ABCDEFGHIJKLMNOPQRSTUVWXYZaqwertyuiopasdfghjklzxcvbnmasdasagasvv\r\n
ABCDEFGHIJKLMNOPQRSTUVWXYZaqwertyuiopasdfghjklzxcvbnmasdasagasvv\r\n
ABCDEFGHIJKLMNOPQRSTUVWXYZaqwertyuiopasdfghjklzxcvbnmasdasagasvv\r\n
aqwertyuiopasdfghjklzxcvbnmasdasagasvv=\r\n
-----END CERTIFICATE-----"
tags:
- chassis_ca_check_data
Loading

0 comments on commit 9f8ac7a

Please sign in to comment.