Forge Home


Install and manage Dell OpenManage Server Administrator (OMSA)


6,133 latest version

2.9 quality score

We run a couple of automated
scans to help you access a
module's quality. Each module is
given a score based on how well
the author has formatted their
code and documentation and
modules are also checked for
malware using VirusTotal.

Please note, the information below
is for guidance only and neither of
these methods should be considered
an endorsement by Puppet.

Version information

  • 0.4.1 (latest)
  • 0.4.0
  • 0.3.0
  • 0.2.0
  • 0.1.0
released Jul 13th 2017
This version is compatible with:
  • , , ,

Start using this module

  • r10k or Code Manager
  • Bolt
  • Manual installation
  • Direct download

Add this module to your Puppetfile:

mod 'vide-omsa', '0.4.1'
Learn more about managing modules with a Puppetfile

Add this module to your Bolt project:

bolt module add vide-omsa
Learn more about using this module with an existing project

Manually install this module globally with Puppet module tool:

puppet module install vide-omsa --version 0.4.1

Direct download is not typically how you would use a Puppet module to manage your infrastructure, but you may want to download the module in order to inspect the code.

Tags: hardware, dell, omsa


vide/omsa — version 0.4.1 Jul 13th 2017


Table of Contents

  1. Description
  2. Usage
  3. Limitations - OS compatibility, etc.
  4. Development - Guide for contributing to the module
  5. Changelog


OMSA is the Dell OpenManage System Administrator and it's a useful tool to check and configure your Dell HW from within the operating system This puppet module takes care of installing it from Dell's repos and and creates a basic configuration

This module was sponsored by Billy Mobile Performance Network By the way, we are hiring!


The most easy way to install puppet-omsa is to simply include the main class:

include ::omsa

This will install the basic package, the storage (RAID) module and the RAC5 module.

NOTE: if you are installing OMSA with a manual puppet run, you have to log out and log in again to have omreport and omconfig executables in your path

By default puppet-omsa enable external Dell's repositories (based on your OS), but if you want you can disable this feature

class { '::omsa':
  manage_repo => false,

SNMP integration

SNMP integration, if you enable the enable_snmp flag, is done with razorsedge-snmp Puppet module, which takes care of installing snmpd in your machine.

To enable integration between OMSA and SNMP you have to change a couple of default parameters in the snmp module:

snmp::openmanage_enable: true
    - 'systemview included .'
    - 'systemview included .'
    # add Dell's OIDs to the default view
    - 'systemview included .'
    - 'systemview included .'

As a last note, you should know that if you want to customize the SNMP installation (read-only community, traps etc.), you must use Hiera because this omsa module does not support passing all the parameters down to the snmp module.


omsa class

  • apt_key Hash containing the GPG key server and key id, as expected by Puppetlabs apt module. Useful only if manage_repo is true and if $::osfamily is Debian. Defaults should be sane though.

  • manage_repo Let this module manage the repositories for Dell OMSA installation

  • service_name The service name used to start OMSA. Default: dataeng

  • service_ensure Controls whether the service should be running or not. Default: running

  • service_enable Controls whether the service should be enabled at boot. Default: enabled

  • install_storage If true, enable the "omreport storage" subset. Default: true

  • install_webserver If true, enable the OMSA local webserver

  • install_rac4 Install components to manage the Dell Remote Access Card 4 (RedHat only)

  • install_rac5 Install components to manage the Dell Remote Access Card 5 (RedHat only)

  • enable_snmp Enable SNMP integration by installing SNMP on the machine. Default: false

  • force_install Force OMSA installation even when $manufacturer is not Dell. Default: false

  • install_idrac Install the idrac meta package for iDRAC6. Default: false (RedHat only)

  • install_idrac7 Install the idrac7 meta package for iDRAC7. Default: false

  • install_idrac8 Install the idrac8 meta package for iDRAC8. Default: false (Debian only)

  • install_all Install all srvadmin-packages available from the repository. Default: false


This module is for Puppet3! It should work with Puppet>=4 but it forces dependencies that are known to work well with Puppet3, since the author is still on Puppet3.

This module has been tested on real hardware by the author only on CentOS7, but it should work with CentOS6 and RHEL6 and 7. It has been tested in Vagrant with Ubuntu 14.04 LTS and it should work on bare metal with Debian 7 and Debian 8 too, and Ubuntu 16.04 LTS.

Missing components on a distribution basis are not author's choiches, it's an upstream packagement issue. Please complain to Dell :)


If you find any bug (they are there for sure!) or if you have any new feature, you are very warmly welcomed to submit an issue and if you can a PR. I promise that I'll try to answer everything ASAP (I've been burnt by maintainers completely ignoring bugs and PRs too, so I know how it is).

Testing your changes

Install the needed gems with bundle install and check your code with:

  • bundle exec rake validate
  • bundle exec rake lint (don't worry about string containing only one variables warnings, they are due to the str2bool() use)

If you have Vagrant + VirtualBox installed, you can run a VM to test the code with:

$ librarian-puppet install
$ vagrant up centos|ubuntu|debian

Opening a PR

Please open the PR against the development branch, not against master. Thanks!




  • Version 0.4.0 broke RHEL support. Update to 0.4.1.


  • Add iDRAC8 packages under Debian, removed racadm packages always under Debian (fixes #4)
  • Updated documentation and testing


  • Add iDRAC7 packages installation (thanks to @palsveningson)
  • Add srvadmin-all package installation (thanks to @palsveningson)
  • Slightly changed contribution workflow


  • SNMP integration
  • Start WS server when needed (thanks to @jschaeff)
  • Vagrant testing made easier


  • Initial release