Thruk is an open-source web interface for monitoring and managing Naemon, Nagios, and Icinga monitoring systems. In this tutorial, we will learn how to install Thruk on FreeBSD.
Before starting with the installation process, make sure that your FreeBSD system is updated and that you have root access to it.
Thruk requires Perl and several Perl modules to run. We need to install these dependencies before installing Thruk. To install the required Perl modules, use the following command:
sudo pkg install p5-DBD-mysql p5-DBI p5-CGI p5-FCGI p5-FCGI-ProcManager p5-JSON p5-Template-Toolkit p5-DBIx-Simple
We can install Thruk from the FreeBSD ports collection by using the following command:
cd /usr/ports/net-mgmt/thruk
sudo make install
This command will download the Thruk package, compile and install it on your system.
After installing Thruk, we need to configure it to connect to our monitoring system. Thruk configuration is stored in the /usr/local/etc/thruk/thruk_local.conf file. So, we will edit this file using the following command:
sudo vi /usr/local/etc/thruk/thruk_local.conf
In this file, we will define connection settings for our monitoring system. Replace the following placeholders with your own values:
## Naemon, Nagios or Icinga core
$cfg->{nagios_cmd_pipe} = "/usr/local/icinga/var/rw/icinga.cmd";
## Naemon, Nagios or Icinga core objects.cache
$cfg->{nagios_objects_cache_file} = "/usr/local/icinga/var/objects.cache";
## Naemon, Nagios or Icinga core status.dat
$cfg->{status_file} = "/usr/local/icinga/var/status.dat";
## Naemon or Nagioscore cfg_file
$cfg->{cfg_file} = "/usr/local/icinga/etc/nagios.cfg";
Save and close the file.
To start Thruk, use the following command:
sudo service thruk start
To enable Thruk to start automatically at boot, use the following command:
sudo sysrc -f /etc/rc.conf thruk_enable="YES"
In this tutorial, we have learned how to install and configure Thruk on FreeBSD. We have also learned how to start and enable Thruk to run automatically at boot.
If you want to self-host in an easy, hands free way, need an external IP address, or simply want your data in your own hands, give IPv6.rs a try!
