install-check_mk-server

This role is no longer recommended. Please use checkmk_server instead, which follows better practices and naming rules. No more updates will be made here.

This is an Ansible Role to install Check_MK RAW and create an initial site.

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

I do NOT recommend using the default settings for direct internet connections, as it includes unprotected HTTP access.

It has been tested manually using the Ansible Role Test Shim Script by Jeff Geerling on the following Linux distributions:

• CentOS-7
• CentOS-8
• Debian 9 "Stretch"
• Debian 10 "Buster"
• Ubuntu 18.04 LTS "Bionic Beaver"

Requirements

For hosts using APT:

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

For hosts using YUM:

• EPEL
• yum
• perl-Net-SNMP (minimum for CentOS 7)

If the server has a firewall, you may need to adjust it to allow incoming connections on TCP port 80 for web access, and TCP port 514, plus UDP ports 162 & 514 for event input.

As with any modern Linux setup, SELinux might be involved.

To meet these requirements, I suggest using another Ansible Role. For example, this role by Jeff Geerling can manage EPEL if needed.

Role Variables

To support multiple distributions, the role defines specific variables using the include_vars and with_first_found methods.

Defaults

Variable	Description	Value
install_check_mk_server_adminpw	Optional password for the cmkadmin user	undefined
install_check_mk_server_build	Build number in RPM source filename	38
install_check_mk_server_key_url	URL for the Check_MK GPG key file download	https://download.checkmk.com/checkmk/Check_MK-pubkey.gpg
install_check_mk_server_prereqs	List of packages needed before installing Check_MK RAW	apache2 apt-utils cron dpkg-sig python-passlib
install_check_mk_server_site	Name of the initial Check_MK RAW 'site' to set up	test
install_check_mk_server_source	File name 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 for the Check_MK RAW installation file download	https://download.checkmk.com/checkmk/{{ install_check_mk_server_version }}/{{ install_check_mk_server_source }}
install_check_mk_server_version	Version of Check_MK RAW to install	2.0.0p9
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	Packages needed for Check_MK RAW before installation	cronie python-passlib
install_check_mk_server_source	File name 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

CentOS 8 Distro Overrides

Variable	Description	Value
install_check_mk_server_prereqs	Packages needed for Check_MK RAW before installation	cronie python3-passlib graphviz-gd
install_check_mk_server_source	File name 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	Packages needed for Check_MK RAW before installation	apache2 apt-utils aptitude cron dpkg-sig iproute2 libfl2 man python3-passlib rsync xz-utils

Dependencies

This role does not depend on any others.

Example Playbook

Here's a complete example:

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

License

GNU General Public License version 2

Author Information

Chris Lindbergh @kso512 with contributions from GitHub users:

• sylekta
• timorunge
• judouk
• JWhy