How to Install Checkmk System Monitoring Software on Ubuntu Linux

|

|

This tutorial provides a step-by-step guide on how to install and set up the Checkmk monitoring software on Ubuntu 16.04 and 18.04. Checkmk, an enhanced Nagios monitoring platform, updates users on infrastructure status, including disk failures and memory issues. Steps include updating Ubuntu, downloading and installing Checkmk, creating a Checkmk monitoring instance and adding a…

This brief tutorial shows students and new users how to install and configure the Checkmk monitoring and optimization package on Ubuntu 16.04 | 18.04 LTS desktops.

As a system administrator, you want to know the health status of your infrastructure. Before your users know, you want to be aware of disk failure, memory issues, and other server-related problems.

For that, you’ll need robust system health monitoring and maintenance software.

Checkmark is a great place to start if you need a full yet straightforward install and manage monitoring platform.

Checkmk is a self-contained software suite that combines Nagios with add-ons for gathering and monitoring and comes with a web portal interface for simple management.

This is Nagios with enhanced features and add-ons you might not find with the original Nagios monitoring platform.

For more about Checkmk, please visit its homepage.

When you’re ready to install Checkmk on Ubuntu, follow the steps below:

Install Checkmk

To use the Checkmk monitoring platform, you must first install it. The good thing is it has a.DEB package that you can easily install on Ubuntu.

To update Ubuntu, use the commands below:

sudo apt update
sudo apt upgrade
sudo apt autoremove

After updating Ubuntu, you may want to reboot.

Download and Install Checkmk

Now that Ubuntu is updated, run the commands below to download and install the Checkmk package.

On the download page with all the latest packages, visit this location.

You can simply run the commands below to get Checkmk installed.

cd /tmp
wget https://checkmk.com/support/1.6.0p8/check-mk-raw-1.6.0p8_0.bionic_amd64.deb
sudo apt install -y ./check-mk-raw-1.6.0p8_0.bionic_amd64.deb

The commands above will download and install Checkmk packages, including all dependencies and Apache2, providing a web interface for its monitoring platform.

After installing, run the commands below to display its command help commands and options.

sudo omd

That should display similar lines as shown below:

Usage (called as root):
omd help Show general help
omd setversion VERSION Sets the default version of OMD which will be used by new sites
omd version [SITE] Show version of OMD
omd versions List installed OMD versions
omd sites Show list of sites

After installing, continue below to create a Checkmk monitoring instance.

Create Checkmk Monitoring Instance

After installing Checkmk, run the commands below to create your first Checkmk instance.

Checkmk uses the concept of instances, or individual installations, to isolate multiple Checkmk copies on a server.

To create your first instance, run the commands below:

For this tutorial, we’re going to call our first instance monsvrs.

sudo omd create monsvrs

That should create an instance called monsvrs. After creating the instance, it should output a message similar to the one below:

Restarting Apache…OK
Created new site monsvrs with version 1.6.0p8.cre.
The site can be started with omd start monsvrs.
The default web UI is available at http://ubuntu1804/monsvrs/
The admin user for the web applications is cmkadmin with password: FPoBrO5Q
(It can be changed with 'htpasswd -m ~/etc/htpasswd cmkadmin' as site user.
)
Please do a su - monsvrs for administration of this site.

You’ll find a URL to access the instance portal, along with the default password to access.

Now run the commands below to start the instance created above.

sudo omd start monsvrs

After the instance is successfully started, it should output similar lines:

Starting mkeventd…OK
Starting rrdcached…OK
Starting npcd…OK
Starting nagios…OK
Starting apache…OK
Initializing Crontab…OK

Now you can go and access the portal and log in with the default password provided above.

http://sever-name/monsrvs

Log in and begin setting up your environment.

Now that the server is installed, you can focus on installing the client agent on the computers you want to monitor.

Install Checkmk Agent

You can quickly and easily get the client agent from the instance you created above. Just specify the server name with the instance name as shown with the commands below:

To install the Check agent on the machine, use the commands below:

cd /tmp
wget http://ubuntu1804/monsvrs/check_mk/agents/check-mk-agent_1.6.0p8-1_all.deb
sudo apt install -y ./check-mk-agent_1.6.0p8-1_all.deb

After installing the agent, run the commands below:

check_mk_agent

That should output similar lines as below:

<<>>
Version: 1.6.0p8
AgentOS: linux
Hostname: ubuntu1804
AgentDirectory: /etc/check_mk
DataDirectory: /var/lib/check_mk_agent
SpoolDirectory: /var/lib/check_mk_agent/spool
PluginsDirectory: /usr/lib/check_mk_agent/plugins
LocalDirectory: /usr/lib/check_mk_agent/local
<<>>

Now that the agent is installed on the host go to the server instance and add a new host agent.

To do that, go to the Hosts menu on the left in the WATO – Configuration menu. From here, click Create new host

You will be asked for information about the host you want to add. After a few scans, the host should be added and ready to be monitored.

That’s it!

Conclusion:

This post showed you how to install and configure Ubuntu’s Checkmk system monitoring platform. If you find any error above, please report it in the comment form below.

Thanks,

You may also like the post below:

Like this:



Leave a Reply

Your email address will not be published. Required fields are marked *

This site uses Akismet to reduce spam. Learn how your comment data is processed.