Ansible role to manage Xymon client configuration
Go to file
Jeremy Gardais e1de38fa96 Manage mq plugin. 2017-09-04 17:24:40 +02:00
defaults Manage mq plugin. 2017-09-04 17:24:40 +02:00
handlers Notify xymon-client handler when modification to default cli config. 2017-08-11 14:42:49 +02:00
meta Install `xymon-client` packages for Debian based distros. 2017-08-11 13:58:39 +02:00
tasks Manage mq plugin. 2017-09-04 17:24:40 +02:00
templates/etc Manage mq plugin. 2017-09-04 17:24:40 +02:00
tests Install `xymon-client` packages for Debian based distros. 2017-08-11 13:58:39 +02:00
vars Install `xymon-client` packages for Debian based distros. 2017-08-11 13:58:39 +02:00
.travis.yml Install `xymon-client` packages for Debian based distros. 2017-08-11 13:58:39 +02:00
CHANGELOG.md Manage mq plugin. 2017-09-04 17:24:40 +02:00
README.md Manage mq plugin. 2017-09-04 17:24:40 +02:00

README.md

Xymon

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

Overview

Manage Xymon (client) installation and configuration.

Role Variables

  • xymon_cli_manage: If xymon-client should be managed with this role [default: true].
  • xymon_cli_pkg_state: State of new xymon-client package(s) [default: installed].
  • xymon_cli_default_conf_path: Configuration file for xymon-client [default: /etc/default/xymon-client].
  • xymon_cli_default_conf_tpl: Template used to generate the previous config file [default: etc/default/xymon-client.j2].
  • xymon_cli_hostname: Allow to override default value of CLIENTHOSTNAME var [default: {{ ansible_fqdn }}].
  • xymon_user_groups: List of 'xymon' user's groups [default: xymon].
  • xymon_cli_service_manage: If xymon-client service should be managed with this role [default: true].
  • xymon_cli_service_name: xymon-client service name [default: xymon-client].
  • xymon_cli_service_enabled: Set xymon-client service available at startup [default: true].
  • xymon_srv_list: The list of Xymon servers (you must give an hostname, IP,… reachable from any clients) [defaults: monitoring.{{ ansible_domain }}].
  • xymon_plug_manage: [default: true].
  • xymon_plug_mq_path: [default: /etc/xymon/clientlaunch.d/mq.cfg].
  • xymon_plug_mq_tpl: [default: etc/xymon/clientlaunch.d/mq.cfg.j2].

OS Specific Variables

Please see default value by Operating System file in vars directory.

  • xymon_cli_pkg_list: The list of packages to install to provide xymon-client.

Example Playbook

  • Use defaults vars:
- hosts: serverXYZ
  roles:
    - role: ipr-cnrs.xymon

Configuration

This role will:

  • Install needed packages to provide xymon-client.
  • Manage xymon-client configuration and service.
  • Add 'xymon' user to new groups.

Plugins

Some plugins and options can be managed with this role:

  • mq: Check mail queue.

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