Install Check_MK Agent

This role is no longer being maintained. Instead, use checkmk_agent, which is a new version created using improved practices and naming conventions. This repository will not receive any further updates.

This is an Ansible Role for installing the agent/client for Check_MK RAW.

All tasks in this role are marked with install-check-mk-agent.

This role uses SSH for Unix systems instead of the default port 6556. This helps encrypt communication and avoids the need to open a new port for monitoring.

It has been manually tested using the Ansible Role Test Shim Script from Jeff Geerling on these distributions:

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

It has also been manually tested on the following operating systems:

• FreeBSD 10.3
• FreeBSD 11.0
• Microsoft Windows
• openSUSE 13.2

Requirements

For the host running this role, the following are needed:

• groupadd
• groupdel
• groupmod

If the role is run with APT, these packages are required:

• python-apt (for Python 2)
• python3-apt (for Python 3)
• aptitude (before version 2.4)

If using YUM, you need:

• yum

If the server is running Windows and has a firewall turned on, you'll need to adjust it to allow incoming packets on TCP port 6556.

Role Variables

Default Variables

Variable	Description	Default Value
install_check_mk_agent_prereqs	Packages to install before configuring the agent	sudo
install_check_mk_agent_user	The user to configure	cmkagent
install_check_mk_agent_home	Home directory of the user	"/home/{{ install_check_mk_agent_user }}"
install_check_mk_agent_count_users_warn	Warning threshold for logged in users	10
install_check_mk_agent_count_users_crit	Critical threshold for logged in users	15
install_check_mk_agent_count_zombie_procs_warn	Warning threshold for zombie processes	5
install_check_mk_agent_count_zombie_procs_crit	Critical threshold for zombie processes	10
install_check_mk_agent_freebsd_plugins	Active FreeBSD plugins	[]
install_check_mk_agent_local_checks	Active local checks	count_users, count_zombie_procs
install_check_mk_agent_plugins	Active Linux plugins	See NOTE A
install_check_mk_agent_win_tmp	Temporary location for Windows installation file	"c:\{{ install_check_mk_agent_win_filename }}"
install_check_mk_agent_win_filename	Windows installation file name	check_mk_agent.msi
install_check_mk_agent_win_config	Windows configuration template file name	check_mk.example.ini.j2
install_check_mk_agent_win_folder	Folder for agent installation	C:\Program Files (x86)\check_mk\
install_check_mk_agent_win_plugins	Active Windows plugins	mk_inventory.vbs

NOTE A

For install_check_mk_agent_plugins, the following are included:

• lvm
• mk_inventory.linux
• mk_iptables
• mk_nfsiostat
• mk_sshd_config
• netstat.linux
• nfsexports
• smart

Dependencies

This role does not depend on any others.

Example Playbook

Here’s a complete example:

- hosts: all
  roles:
     - { role: install-check_mk-agent, install_check_mk_agent_user: agent }

License

This project uses the GNU General Public License version 2.

Author Information

Chris Lindbergh @kso512