Manage Xymon server configuration
Go to file
Jeremy Gardais 7b3f2cf8e5 Add example usage and fix comments 2018-03-09 12:08:05 +01:00
defaults Add example usage and fix comments 2018-03-09 12:08:05 +01:00
handlers Restart `xymon` service if configuration change 2018-03-02 14:39:42 +01:00
meta Install `xymon` packages for Debian based distros 2018-03-01 13:46:21 +01:00
tasks Add example usage and fix comments 2018-03-09 12:08:05 +01:00
templates/etc/xymon Forgot to add templates dir 2018-03-02 14:39:53 +01:00
tests Install `xymon` packages for Debian based distros 2018-03-01 13:46:21 +01:00
.travis.yml Install `xymon` packages for Debian based distros 2018-03-01 13:46:21 +01:00
CHANGELOG.md Restart `xymon` service if configuration change 2018-03-02 14:39:42 +01:00
README.md Add example usage and fix comments 2018-03-09 12:08:05 +01:00

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