Dell EMC OpenManage Ansible Modules
Version 1.0.1 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.0.1
© Copyright 2018 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.
2018 - 04
Rev. A01
Contents
1 Overview........................................................................................................................................................ 4
Prerequisites....................................................................................................................................................................... 4
OpenManage Ansible Modules Support Matrix............................................................................................................. 4
2 Installing Dell EMC OpenManage Ansible Modules 1.0.1 from GitHub............................................................. 6
3 Uninstalling Dell EMC OpenManage Ansible Modules version 1.0.1................................................................. 7
Contents 3
1
Overview
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 (12th generation of PowerEdge servers and later) by leveraging
the management automation capabilities in-built into the integrated Dell Remote Access Controller (iDRAC).
This installation guide provides information about installation and uninstallation of Dell EMC OpenManage Ansible Modules.
In addition to dell.com/support, Ansible modules can also be downloaded from https://github.com/dell/Dell-EMC-Ansible-Modules-for-
iDRAC. Modules 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.2 or later.
• Install the latest version of OpenManage Python Software Development Kit (OMSDK).
NOTE: To install OMSDK, run pip install omsdk.
NOTE: To uninstall OMSDK, run pip uninstall omsdk.
• Ensure that you install Python version 2.7 or later.
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 files.
OpenManage Ansible Modules Support Matrix
Table 1. Software
Python Version 2.7 and above
• Red Hat Enterprise Linux (RHEL) 7.3
Supported Operating System
• SLES 12 SP3
Table 2. Hardware
Dell EMC Device Supported Firmware Versions
12th generation of PowerEdge servers 2.50.50.50 and 2.41.40.40
4 Overview
13th generation of PowerEdge servers 2.50.50.50 and 2.41.40.40
14th generation of PowerEdge servers 3.17.17.17, 3.15.15.15, 3.11.11.11 and 3.00.00.00
Overview 5
2
Installing Dell EMC OpenManage Ansible Modules
1.0.1 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
following steps and either clone the repository or download a specific release.
NOTE: Download and install the latest version of the OpenManage Python SDK. Please see https://github.com/dell/omsdk for
information about installing the latest version of OpenManage Python SDK.
• To install the latest stable version:
# Uninstall the previous version of the modules
# Clone the master branch
git clone https://github.com/dell/Dell-EMC-Ansible-Modules-for-iDRAC.git
cd Dell-EMC-Ansible-Modules-for-iDRAC
# 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 the latest development version:
# Uninstall the previous version of the modules
# Clone the development branch
git clone -b devel --single-branch https://github.com/dell/Dell-EMC-Ansible-Modules-for-
iDRAC.git
cd Dell-EMC-Ansible-Modules-for-iDRAC
# 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 specific release:
# Uninstall the previous version of the modules
# Clone v1.0.1 release version
git clone -b v1.0.1 --single-branch https://github.com/dell/Dell-EMC-Ansible-Modules-for-
iDRAC.git
cd Dell-EMC-Ansible-Modules-for-iDRAC
# 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: The above example clones the v1.0.1 release.
6 Installing Dell EMC OpenManage Ansible Modules 1.0.1 from GitHub
3
Uninstalling Dell EMC OpenManage Ansible
Modules version 1.0.1
To uninstall Dell EMC OpenManage Ansible Modules version 1.0.1.
1 Navigate to the directory Dell-EMC-Ansible-Modules-for-iDRAC.
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.0.1 is uninstalled successfully.
Uninstalling Dell EMC OpenManage Ansible Modules version 1.0.1 7
