Manage Xymon server configuration
Go to file
Jeremy Gardais 82564f655e Merge pull request 'refresh-2024' (#1) from refresh-2024 into master
Reviewed-on: #1
2024-09-30 17:10:30 +02:00
defaults Replace flatten jinja filter with list 2024-09-30 17:06:27 +02:00
handlers Fix small warnings from linter 2018-08-06 15:40:05 +02:00
meta Update git.ipr domain 2023-11-09 10:35:17 +01:00
tasks Call modules with FQCN 2024-09-30 17:06:48 +02:00
templates/etc/xymon Use comment jinja filter with ansible_managed 2024-09-30 17:07:03 +02: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 Use comment jinja filter with ansible_managed 2024-09-30 17:07:03 +02:00
README.md Update git.ipr domain 2023-11-09 10:35:17 +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