Skip to content

dell/dellemc-openmanage-ansible-modules

Dell OpenManage Ansible Modules

Contributor Covenant License Python version Ansible version GitHub release (latest by date including pre-releases) codecov

Dell OpenManage Ansible Modules allows data center and IT administrators to use RedHat Ansible to automate and orchestrate the configuration, deployment, and update of Dell PowerEdge Servers and modular infrastructure by leveraging the management automation capabilities in-built into the Integrated Dell Remote Access Controller (iDRAC), OpenManage Enterprise (OME), OpenManage Enterprise Modular (OMEM) and OpenManage Enterprise Integration for VMWare vCenter Plug-in.

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.

Table of Contents

Supported Platforms

  • iDRAC8 based Dell PowerEdge Servers with firmware versions 2.85.85.85 and above.
  • iDRAC9 based Dell PowerEdge Servers with firmware versions 6.10.80.00 and above.
  • Dell OpenManage Enterprise versions 3.10 and 4.2.
  • Dell OpenManage Enterprise Modular versions 2.10.10 and above.

Requirements

  • Ansible Core >= 2.17.5 and 2.16.12
  • 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
  • Operating System
    • Red Hat Enterprise Linux (RHEL) 9.4 and 8.10
    • SUSE Linux Enterprise Server (SLES) 15 SP5 and 15 SP4
    • Ubuntu 24.04.1 and 24.04

Installation

  • From Galaxy or Automation Hub:
    Install the latest Ansible collection from the Ansible Galaxy or Automation hub

    ansible-galaxy collection install dellemc.openmanage
    
  • From GitHub:
    Install the Ansible collection from the GitHub repository using the latest commit with the branch name 'collections'

    ansible-galaxy collection install git+https://github.com/dell/dellemc-openmanage-ansible-modules.git,collections
    
  • To Upgrade: Update the dellemc.openmanage collection to the latest version available on Galaxy and Automation Hub

    ansible-galaxy collection install dellemc.openmanage --upgrade
    
  • To specific version:
    Install a specifc version of the collection from the Galaxy and Automation Hub

    ansible-galaxy collection install dellemc.openmanage:==<version>
    
  • Offline Installation:
    For offline installation on the Ansible control machine, download the required tar archive version of the collection from Dell OpenManage collection and run the command given below:

    ansible-galaxy collection install dellemc-openmanage-<version>.tar.gz
    

For more details, see Using Ansible collections

Use Cases

For more information about how to use the collection, refer to OME modules, iDRAC modules, Redfish modules and roles.

Testing

For more information about Unit testing, see Unit testing.

For more information about Integration testing, see Integration testing.

Support

For support, see SUPPORT.md.

Release Notes

For release notes, see CHANGELOG.rst.

Related Information

Refer the Table of Contents for any other information on the Dell OpenManage Ansible Modules documentations.

License Information

Dell OpenManage Ansible Modules is 100% open source and community-driven. All components are available under GPL-3.0-only on GitHub.