Dell EMC OpenManage Ansible Modules Version 1.3 Installation Guide OMAM Install
User Manual:
Open the PDF directly: View PDF .
Page Count: 7
Dell EMC OpenManage Ansible Modules
Version 1.3 Installation Guide
Notes, cautions, and warnings
NOTE: A NOTE indicates important information that helps you make better use of your product.
CAUTION: A CAUTION indicates either potential damage to hardware or loss of data and tells you how to avoid the problem.
WARNING: A WARNING indicates a potential for property damage, personal injury, or death.
Dell EMC OpenManage Ansible Modules
Version 1.3
© Copyright 2019 Dell Inc.
GNU General Public License v3.0+ (see COPYING or https://www.gnu.org/licenses/gpl-3.0.txt)
All rights reserved. Dell, EMC, and other trademarks are trademarks of Dell Inc. or its subsidiaries. Other trademarks may be trademarks of their respective
owners.
2019 - 03
Rev. A01
Contents
1 Overview........................................................................................................................................................4
Prerequisites....................................................................................................................................................................... 4
OpenManage Ansible Modules Support Matrix............................................................................................................. 4
2 Install Dell EMC OpenManage Ansible Modules version 1.3 from GitHub........................................................6
3 Uninstall Dell EMC OpenManage Ansible Modules version 1.3 when downloaded from GitHub...................... 7
Contents 3
Overview
Dell EMC OpenManage Ansible Modules allows data center and IT administrators to use RedHat Ansible to automate and orchestrate the
conguration, deployment, and update of Dell EMC PowerEdge Servers (12th generation of PowerEdge servers and later) by leveraging
the management automation capabilities in-built into the Integrated Dell Remote Access Controller (iDRAC).
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, congure, and update rmware of devices managed by
OpenManage Enterprise.
This installation guide provides information about installation and uninstallation of Dell EMC OpenManage Ansible Modules.
The latest stable version of OpenManage Ansible Modules is available at dell.com/support. In addition to dell.com/support, you can
download OpenManage Ansible modules from https://github.com/dell/dellemc-openmanage-ansible-modules. Modules that are
downloaded from this GitHub location are supported by Dell EMC.
Topics:
• Prerequisites
• OpenManage Ansible Modules Support Matrix
Prerequisites
Following are the requirements to install Dell EMC OpenManage Ansible Modules:
• Ensure that you install Ansible version 2.7.5 or later.
• Ensure that you install Python version 2.7.5 or later.
For OpenManage Ansible modules for iDRAC, install the supported version of OpenManage Python Software Development Kit (OMSDK).
NOTE: To install OMSDK, run pip install omsdk.
NOTE: Ensure that either internet connectivity exists or the local Python Package Index (PyPI) repository exists.
NOTE: In the 14th Generation of PowerEdge Servers, WSMan runs as non-root user and you need to set 644 as a permission on
the share to access the les.
NOTE: It is recommended to update the ansible conguration setting environment variables to point to the current module paths,
if any.
OpenManage Ansible Modules Support Matrix
Table 1. Control Machine Requirements
Python Version Supported Operating System
2.7.5 and later • Red Hat Enterprise Linux (RHEL) 7.6 and above
• SLES 15
1
4 Overview
Table 2. Managed Node Requirements
Dell EMC Device Supported Firmware Versions
12th and 13th generations of PowerEdge servers 2.60.60.60 and above
14th generation of PowerEdge servers 3.21.21.21 and above
Overview 5
Install Dell EMC OpenManage Ansible Modules
version 1.3 from GitHub
If you want to take advantage of the new features when they are implemented, then you can go to the GitHub repository using the given
steps. You can either clone the repository or download a specic release.
• To install the latest development version:
# Clone the development branch
git clone -b devel --single-branch https://github.com/dell/dellemc-openmanage-ansible-modules
cd dellemc-openmanage-ansible-modules
# Install the latest version. Run the below command using the sudo or super-user privileges if
Ansible is installed using root permission.
python install.py
NOTE: If previous version of Dell EMC OpenManage Ansible Modules is installed, you are prompted with an upgrade
message. Press Y to upgrade to the latest version.
• To install the latest stable version:
# Clone the master branch
git clone https://github.com/dell/dellemc-openmanage-ansible-modules
cd dellemc-openmanage-ansible-modules
# Install the latest version. Run the below command using the sudo or super-user privileges if
Ansible is installed using root permission.
python install.py
• To install a specic release:
# Clone v1.3 release version
git clone -b v1.3 --single-branch https://github.com/dell/dellemc-openmanage-ansible-modules
cd dellemc-openmanage-ansible-modules
# Install the latest version. Run the below command using the sudo or super-user privileges if
Ansible is installed using root permission.
python install.py
NOTE: If previous version of Dell EMC OpenManage Ansible Modules is installed, you are prompted with an upgrade message.
Press Y to upgrade to the latest version.
NOTE: The above example clones the v1.3 release.
2
6 Install Dell EMC OpenManage Ansible Modules version 1.3 from GitHub
Uninstall Dell EMC OpenManage Ansible Modules
version 1.3 when downloaded from GitHub
To uninstall Dell EMC OpenManage Ansible Modules version 1.3 when downloaded from GitHub:
1 Navigate to the directory dellemc-openmanage-ansible-modules.
2 Run python uninstall.py. If you are using python version 3.x, then run python3 uninstall.py.
Dell EMC OpenManage Ansible Modules version 1.3 is uninstalled successfully.
3
Uninstall Dell EMC OpenManage Ansible Modules version 1.3 when downloaded from GitHub 7