Openmanage

1. Overview
2. Role Variables
3. Example Playbook
4. Configuration
5. Development
6. License
7. Author Information

Overview

This is a role for managing OpenManage tools (like omreport and omconfig), its web interface (OMSA - OpenManage Server Administrator), and iDrac (using racadm).

Role Variables

• openmanage__repositories: List of APT repositories that provide OpenManage.
• openmanage__deploy_state: The target state this role should achieve (default for Dell hardware: present).
• openmanage__install_recommends: If recommended packages should be installed (default: false).
• openmanage__dep_packages: List of dependency packages needed to run racadm.
• openmanage__base_packages: List of basic packages for using racadm.
• openmanage__stretch_packages: List of specific packages for Debian Stretch (or Ubuntu Xenial) and earlier versions.
• openmanage__snmpd_service_name: Name of the SNMPD service to manage (default: snmpd).
• openmanage__snmpd_service_enabled: If the SNMPD service should start automatically (default: true).
• openmanage__snmpd_service_override_path: Path for custom SNMPD configuration (default: /etc/systemd/system/snmpd.service.d/override.conf).
• openmanage__snmpd_service_override_content: Template for custom SNMPD configuration (default: etc/systemd/system/snmpd.service.d/override.conf.j2).
• openmanage__webgui_state: Desired state for the OMSA web interface (default: absent).
• openmanage__webgui_packages: List of packages to provide the OMSA web interface.
• openmanage__webgui_service_name: Name of the systemd unit for the web interface (default: dsm_om_connsvc).

Example Playbook

• Using default variables:

- hosts: mynode.DOMAIN
  roles:
    - role: ipr-cnrs.openmanage
      tags: ['role::openmanage', 'ipr', 'idrac']

• Enable the web interface for OMSA (accessible at https://:1311/):

- hosts: mynode.DOMAIN
  roles:
    - role: ipr-cnrs.openmanage
      openmanage__webgui_state: "present"
      tags: ['role::openmanage', 'ipr', 'idrac']

Configuration

This role will:

• Add an APT repository to provide OpenManage.
• Install necessary dependency packages.
• Install base packages needed for all racadm functions.
• Start the dataeng service to use OpenManage applications.
• Install and enable the web interface on https://:1311 if requested.
• Fix executable permissions for idrac7.
• Resolve libssl error RAC1170 (for Debian Stretch or Ubuntu Xenial).
• Create symlinks to run applications from $PATH.

Development

This code is hosted on our Gogs instance, and the GitHub repository is only for sharing the role on Ansible Galaxy.

Feel free to report issues or submit pull requests here.

Updates from our Gogs instance are automatically sent to GitHub thanks to this hook.

Thanks to @roumano.

License

WTFPL.

Author Information

Jérémy Gardais

• Source: on IPR's Gogs
• [IPR](Institut de Physique de Rennes) ipr website.