install-check_mk-server

An Ansible Role to install Check_MK RAW and set up an initial site.

All tasks are tagged with install-check-mk-server.

I do NOT recommend the default configuration for unprotected connection directly to the Internet, as the server configuration includes unencrypted HTTP access.

Tested with Travis continuous integration on the following distributions:

• CentOS-7
• CentOS-6
• Debian 9 "Stretch"
• Debian 10 "Buster"
• Ubuntu 16.04 LTS "Xenial Xerus"
• Ubuntu 18.04 LTS "Bionic Beaver"

Requirements

Required on host that executes role with APT:

• python-apt (python 2)
• python3-apt (python 3)

Required on host that executes role with YUM:

• EPEL
• yum
• perl-Net-SNMP (minimal CentOS7)

If the server has a firewall enabled, it may need to be altered to allow incoming packets on TCP port 80 for the web portal access, and/or TCP port 514, plus UDP ports 162 & 514 for event console input.

As with any modern Linux deployment, SELinux may come into play.

To fulfill these requirements, I recommend using another Ansible Role. For example, this role from Jeff Geerling may be used to handle EPEL if needed: https://galaxy.ansible.com/geerlingguy/repo-epel

Role Variables

To enable multi-distro support, the role defines distro-specific variables with the include_vars and with_first_found mechanisms.

Defaults

Variable	Description	Value
install_check_mk_server_adminpw	Optional password for cmkadmin user	undefined
install_check_mk_server_build	Build number included in RPM source filename	38
install_check_mk_server_prereqs	List of packages to install before installing Check_MK RAW	apt-utils cron python-passlib
install_check_mk_server_site	Name of initial Check_MK RAW 'site' to provision	test
install_check_mk_server_source	Filename of the installation source	check-mk-raw-{{ install_check_mk_server_version }}_0.{{ ansible_distribution_release }}_amd64.deb
install_check_mk_server_source_url	URL of Check_MK RAW installation file to download	https://checkmk.com/support/{{ install_check_mk_server_version }}/{{ install_check_mk_server_source }}
install_check_mk_server_version	Version of Check_MK RAW to install	1.6.0p6
install_check_mk_server_web_service	Name of the Apache2 service to control	apache2

CentOS Distro Overrides

Variable	Description	Value
install_check_mk_server_prereqs	List of packages to install before installing Check_MK RAW	cronie python-passlib
install_check_mk_server_source	Filename of the installation source	check-mk-raw-{{ install_check_mk_server_version }}-el{{ ansible_distribution_major_version }}-{{ install_check_mk_server_build }}.x86_64.rpm
install_check_mk_server_web_service	Name of the Apache2 service to control	httpd

Ubuntu 18.04 Distro Overrides

Variable	Description	Value
install_check_mk_server_prereqs	List of packages to install before installing Check_MK RAW	apache2 apt-utils aptitude cron iproute2 libfl2 man python-passlib rsync xz-utils

Dependencies

This role depends on no other roles.

Example Playbook

Complete example:

- hosts: monitoring-servers
  roles:
     - { role: install-check_mk-server, install_check_mk_server_site: boom }

License

BSD

Author Information

kso512 (Chris Lindbergh) with contributions from Github users:

• sylekta
• timorunge
• judouk