ansible.xymon_server/README.md

Xymon Server

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

Overview

Manage Xymon server installation and configuration.

Role Variables

• xymon_server__base_packages : List of base packages in order to provide xymon server [default : xymon].
• xymon_server__deploy_state : The desired state this role should achieve [default : present].
• ymon_server__etc_src : Directory used as source to templating /etc/xymon configuration content [default : ../templates/etc/xymon].
• xymon_server__service_manage : If the Xymon server service should be managed [default : True].
• xymon_server__service_name : The service name to manage [default : xymon].

Example Playbook

• Use defaults vars :

- hosts: serverXYZ
  roles:
    - role: ipr-cnrs.xymon_server

• Use your own Xymon's configuration as source :

- hosts: xymon.DOMAIN
  roles:
    - role: ipr-cnrs.xymon_server
      xymon_server__etc_src: '{{ inventory_dir + "/../resources/host/xymon.DOMAIN/etc/xymon/" }}'

• Ensure your directory contains only templates or sub-directories, such as :

xymon.DOMAIN
└── etc
    └── xymon
        ├── alerts.cfg.j2
        ├── analysis.cfg.j2
        ├── client-local.cfg.j2
        ├── hosts.cfg.j2
        └── hosts.d
            ├── common.lxc.cfg.j2
            ├── common.storage.cfg.j2
            └── test.cfg.j2

Configuration

This role will :

• Install needed packages to provide xymon server.
• Manage xymon server configuration (/etc/xymon).
• Ensure xymon server service is enabled and started.
• Ensure to restart xymon server service if configuration changed.

Development

This source code comes from our Gogs instance and the Github repo exist just to be able to send the role to Ansible Galaxy…

But feel free to send issue/PR here :)

Thanks to this hook, Github automatically got updates from our Gogs instance :)

License

WTFPL

Author Information

Jérémy Gardais

• Source : on IPR's Gogs
• IPR (Institut de Physique de Rennes)