Skip to content

Commit

Permalink
Browse files Browse the repository at this point in the history
Release 2.0.4
  • Loading branch information
felixs88 committed Nov 18, 2019
1 parent 81a0777 commit fbf3388
Show file tree
Hide file tree
Showing 23 changed files with 3,331 additions and 57 deletions.
12 changes: 12 additions & 0 deletions CHANGELOG.md
Expand Up @@ -4,6 +4,18 @@ Dell EMC OpenManage Ansible Modules allows Data Center and IT administrators to

With the latest release of Dell EMC OpenManage Ansible Modules, the capabilities have improved with support for OpenManage Enterprise. OpenManage Ansible Modules allows users to retrieve device inventory information of each device discovered in the OpenManage Enterprise.

# 2.0.4 (November 8, 2019)

* A new OpenManage Enterprise(OME) module (ome_firmware_catalog) to
create a firmware catalog.

* A new OME module (ome_firmware_baseline) to create a firmware baseline form existing catalog.

* A new OME module (ome_firmware_baseline_compliance_info) to retrieve:

- Firmware compliance report for specified identifiers (device ids, service tags, group names).
- Baseline compliance reports for specified baseline.

# 2.0.3 (October 16, 2019)

* The following enhancements have been made to the idrac_firmware module:
Expand Down
42 changes: 42 additions & 0 deletions examples/ome_firmware_baseline.yml
@@ -0,0 +1,42 @@
---
- hosts: hosts
connection: local
name: Dell OpenManage Ansible OME firmware baseline operations.
gather_facts: False

tasks:
- name: create baseline from device Ids.
ome_firmware_baseline:
hostname: "{{hostname}}"
username: "{{username}}"
password: "{{password}}"
baseline_name: "baseline_name"
baseline_description: "baseline_description"
catalog_name: "catalog_name"
device_ids:
- 1010
- 2020

- name: create baseline from servicetags.
ome_firmware_baseline:
hostname: "{{hostname}}"
username: "{{username}}"
password: "{{password}}"
baseline_name: "baseline_name"
baseline_description: "baseline_description"
catalog_name: "catalog_name"
device_service_tags:
- "SVCTAG1"
- "SVCTAG2"

- name: create baseline from device groups.
ome_firmware_baseline:
hostname: "{{hostname}}"
username: "{{username}}"
password: "{{password}}"
baseline_name: "baseline_name"
baseline_description: "baseline_description"
catalog_name: "catalog_name"
group_names:
- "Group1"
- "Group2"
45 changes: 45 additions & 0 deletions examples/ome_firmware_baseline_compliance_info.yml
@@ -0,0 +1,45 @@
---
- hosts: hosts
connection: local
name: Dell OpenManage Ansible template inventory details.
gather_facts: False

tasks:
- name: Retrieve baseline report for specific device IDs.
ome_firmware_baseline_compliance_info:
hostname: "{{hostname}}"
username: "{{username}}"
password: "{{password}}"
device_ids:
- 11111
- 22222
tags: device_ids

- name: Retrieve baseline report for specific device service Tags.
ome_firmware_baseline_compliance_info:
hostname: "{{hostname}}"
username: "{{username}}"
password: "{{password}}"
device_service_tags:
- MXL1234
- MXL4567
tags: device_service_tags

- name: Retrieve baseline report for specific group names.
ome_firmware_baseline_compliance_info:
hostname: "{{hostname}}"
username: "{{username}}"
password: "{{password}}"
group_names:
- group1
- group2
tags: group_names

- name: Retrieve compliance report for a specific baseline.
ome_firmware_baseline_compliance_info:
hostname: "{{hostname}}"
username: "{{username}}"
password: "{{password}}"
baseline_name: "baseline_name"
report_type: "baseline_device"
tags: baseline_device
60 changes: 60 additions & 0 deletions examples/ome_firmware_baseline_compliance_info_filters.yml
@@ -0,0 +1,60 @@
---
-
connection: local
gather_facts: false
hosts: hosts
name: "OME - Ansible Modules"

tasks:

- name: "Retrieve baseline information for specific device ids."
ome_firmware_baseline_compliance_info:
hostname: "{{ hostname }}"
username: "{{ username }}"
password: "{{ password }}"
device_ids:
- 11111
- 11112
register: result

tags:
- overall-compliance-report

- name: "Firmware baseline compliance info based on FirmwareStatus - Non-Compliant"
set_fact:
non_compliance_fact: "{{ item }}"
when:
- item.DeviceComplianceReports.0.FirmwareStatus=='Non-Compliant'
with_items:
- "{{ result.baseline_compliance_info }}"
loop_control:
label: "{{ item.Name }} - {{ item.DeviceComplianceReports.0.FirmwareStatus }}"

tags:
- non-compliance-report

- name: "Firmware baseline compliance info based on Device ID"
set_fact:
device_fact: "{{ item }}"
when:
- item.DeviceComplianceReports.0.DeviceId==11111
with_items:
- "{{ result.baseline_compliance_info }}"
loop_control:
label: "{{ item.Name }} - {{ item.DeviceComplianceReports.0.DeviceId }}"

tags:
- device-id-report

- name: "Firmware baseline compliance info based on Device Service Tag"
set_fact:
service_tag_fact: "{{ item }}"
when:
- item.DeviceComplianceReports.0.ServiceTag=='1X1X1'
with_items:
- "{{ result.baseline_compliance_info }}"
loop_control:
label: "{{ item.Name }} - {{ item.DeviceComplianceReports.0.ServiceTag }}"

tags:
- device-service-tag-report
59 changes: 59 additions & 0 deletions examples/ome_firmware_catalog.yml
@@ -0,0 +1,59 @@
---
- hosts: hosts
connection: local
name: "OME - Create Catalog using Repository."
gather_facts: False

tasks:
- name: create catalog from repository on a HTTPS.
ome_firmware_catalog:
hostname: "{{ hostname }}"
username: "{{ username }}"
password: "{{ password }}"
catalog_name: catalog1
catalog_description: catalog description
source: downloads.company.com
repository_type: HTTPS
source_path: "catalog"
file_name: "catalog.gz"
check_certificate: True

- name: create catalog from repository on a HTTP.
ome_firmware_catalog:
hostname: "{{ hostname }}"
username: "{{ username }}"
password: "{{ password }}"
catalog_name: "{{ catalog_name }}"
catalog_description: catalog description
source: downloads.company.com
repository_type: HTTP
source_path: "catalog"
file_name: "catalog.gz"

- name: create catalog from CIFS network share.
dellemc_ome_job_facts:
hostname: "{{ hostname }}"
username: "{{ username }}"
password: "{{ password }}"
catalog_name: "{{ catalog_name }}"
catalog_description: catalog description
source: "192.166.0.1"
repository_type: CIFS
source_path: "cifs/R940"
file_name: "catalog.gz"
repository_username: "{{ repository_username }}"
repository_password: "{{ repository_password }}"
repository_domain: "{{ repository_domain }}"

- name: create catalog from NFS network share.
dellemc_ome_job_facts:
hostname: "{{ hostname }}"
username: "{{ username }}"
password: "{{ password }}"
catalog_name: "{{ catalog_name }}"
catalog_description: catalog description
source: "192.166.0.2"
repository_type: NFS
source_path: "/nfs/R940"
file_name: "catalog.xml"

36 changes: 36 additions & 0 deletions examples/ome_firmware_catalog_with_job_tracking.yml
@@ -0,0 +1,36 @@
---
- hosts: hosts
vars:
retries_count: 30
polling_interval: 15 #in seconds
connection: local
name: "OME - Catalog creation details tracking"
gather_facts: False

tasks:
- name: "Triggers job for catalog creation."
ome_firmware_catalog:
hostname: "{{ hostname }}"
username: "{{ username }}"
password: "{{ password }}"
catalog_name: catalog1
catalog_description: HTTPS Desc
source: downloads.company.com
repository_type: HTTPS
source_path: catalog
file_name: catalog.gz
register: result
failed_when: "'catalog_status' not in result"

- name: "Get job details using job id from ome firmware catalog creation."
dellemc_ome_job_facts:
hostname: "{{ hostname }}"
username: "{{ username }}"
password: "{{ password }}"
job_id: "{{ result.catalog_status.TaskId }}"
register: job_result
failed_when: "'job_facts' not in job_result"
until: job_result.job_facts.LastRunStatus.Name == 'Completed' or job_result.job_facts.LastRunStatus.Name == 'Failed'
retries: "{{ retries_count }}"
delay: "{{ polling_interval }}"

Expand Up @@ -2,13 +2,13 @@
Dell EMC OpenManage Ansible Modules

*******************************************************************************
Version: 2.0.3
Version: 2.0.4

*******************************************************************************
Release Date: October 2019
Release Date: November 2019

*******************************************************************************
Previous Version: 2.0.2
Previous Version: 2.0.3

*******************************************************************************
Importance
Expand All @@ -24,39 +24,33 @@ Platform(s) Affected
--------------------

For the list of supported platforms, see the section "Support Matrix" in the
"Dell EMC OpenManage Ansible Modules version 2.0.3 Installation Guide".
"Dell EMC OpenManage Ansible Modules version 2.0.4 Installation Guide".

*******************************************************************************
What is Supported
-----------------

For information on the hardware and software requirements, see
"Dell EMC OpenManage Ansible Modules version 2.0.3 Installation Guide".
"Dell EMC OpenManage Ansible Modules version 2.0.4 Installation Guide".

*******************************************************************************
What’s New
----------
The key features in OpenManage Ansible Modules version 2.0.4 include-

The key features in OpenManage Ansible Modules version 2.0.3 include:
* A new OpenManage Enterprise(OME) module (ome_firmware_catalog) to
create a firmware catalog.

* The following enhancements have been made to the idrac_firmware module:
- Support for installing firmware from HTTP/HTTPS/FTP based repository.
- Support for viewing individual component update job ids.
- The apply_update option is added, which specifies if the packages from
the Catalog XML are queued for update.
- The ignore_cert_warning option is added, which specifies if certificate
warnings must be ignored.
* A new OME module (ome_firmware_baseline) to create a firmware baseline
from existing catalog.

* The following enhancements have been made to the installation script:
- All the modules present by default in the remote_management/dellemc
folder are now overwritten with updated versions.
- Modules will be installed to the custom path, if it is set by the
environment variable ANSIBLE_LIBRARY.
- The default python interpreter is now located using #!/usr/bin/env python
instead of #!/usr/bin/python.
* A new OME module (ome_firmware_baseline_compliance_info) to retrieve:
- Firmware compliance report for specified identifiers (device ids,
service tags, group names).
- Baseline compliance reports for specified baseline.

For a complete list of supported features that you can leverage,
see the “Dell EMC OpenManage Ansible Modules Version 2.0.3 User’s Guide”.
see the “Dell EMC OpenManage Ansible Modules Version 2.0.4 User’s Guide”.

*******************************************************************************
Known Issues
Expand Down Expand Up @@ -89,8 +83,9 @@ Known Issues
for more details.

* Issue 4(150664):
Description: Firmware update through "downloads.dell.com" does not work
on 13G via WSMAN in case of HTTP/HTTPS/FTP.
Description: Firmware update using "idrac_firmware" through
"downloads.dell.com" does not work on 13G via WSMAN in case of
HTTP/HTTPS/FTP.

*******************************************************************************
Limitations
Expand All @@ -109,19 +104,19 @@ Limitations
Installation Prerequisites
--------------------------
For installation prerequisites, see "Dell EMC OpenManage Ansible Modules
Version 2.0.3 Installation Guide".
Version 2.0.4 Installation Guide".

Software Requirements
---------------------

* For information on the hardware and software requirements, see
"Dell EMC OpenManage Ansible Modules Version 2.0.3 Installation Guide".
"Dell EMC OpenManage Ansible Modules Version 2.0.4 Installation Guide".

Installation Procedure
-------------------------

For the installation instructions, see "Dell EMC OpenManage Ansible Modules
Version 2.0.3 Installation Guide".
Version 2.0.4 Installation Guide".

*******************************************************************************
Accessing Documents from Dell Support Site
Expand Down Expand Up @@ -189,7 +184,7 @@ technical support, or customer service issues:


Dell EMC OpenManage Ansible Modules
Version 2.0.3
Version 2.0.4
Copyright (C) 2019 Dell Inc.

GNU General Public License v3.0+
Expand Down
Binary file removed guides/OMAM_2.0.3_Users_Guide.pdf
Binary file not shown.
Binary file not shown.
Binary file added guides/OMAM_2.0.4_Users_Guide.pdf
Binary file not shown.

0 comments on commit fbf3388

Please sign in to comment.