OMD Network Monitoring Howto
EDIT - 26.1.2018
- changed code blocks for better viewing
EDIT - 16.10.2017
- added config changes to access all sites via http auth
- added mail notification configuration
- added nethserver-xinetd and nano install
- added optional tags and nethserver 6 compatibility
- changed from blockquotes to code blocks for better copy/paste, changed from bold text to headings
OMD is a web-manageable, feature-rich monitoring system. I know that there are better ways to integrate apps into Nethserver, but this was my first try. I’ll learn more about Nethserver and maybe I am able to present a better solution in the future. Some ideas: OMD site management via Nethserver web interface, adding sites to the applications automatically, setup Nethserver mail account for OMD. But for now, the quick and dirty way:
Install OMD
I just added the OMD Labs stable repo as described here: Consol Labs Repo:
Nethserver V7
rpm -Uvh "https://labs.consol.de/repo/stable/rhel7/i386/labs-consol-stable.rhel7.noarch.rpm"
Nethserver V6
rpm -Uvh "https://labs.consol.de/repo/stable/rhel6/i386/labs-consol-stable.rhel6.noarch.rpm"
Install OMD package
yum install omd-labs-edition nano nethserver-xinetd
or install specific OMD version(2.60 at the time of editing this article) with
yum install omd-2.60-labs-edition
Now you are able to create an OMD site. You may have multiple sites with different versions, which means multiple nagiosses, icingas etc.
omd create SITENAME
Then you may config your site:
omd config SITENAME
I set the core to nagios, which worked best for me.
I set multisite_auth to on and thruk_cookie_auth to off to have one http auth for all sites:
Then one may start OMD which starts your site.
omd start
That’s it. Just browse to “http(s)://NETHSERVER/SITENAME” and login with omdadmin and omd.
Application menu
To make the site available in the Nethserver applications menu I copied a php file in /usr/share/nethesis/NethServer/Module/Dashboard/Applications, named it OMD.php and opened it with nano:
cd /usr/share/nethesis/NethServer/Module/Dashboard/Applications
cp Roundcube.php OMD.php
nano OMD.php
My OMD.php:
<?php
namespace NethServer\Module\Dashboard\Applications;
class OMD extends \Nethgui\Module\AbstractModule implements \NethServer\Module\Dashboard\Interfaces\ApplicationInterface
{
public function getName()
{
return "OMD";
}
public function getInfo()
{
$host = explode(':',$_SERVER['HTTP_HOST']);
return array(
'url' => "https://".$host[0]."/SITENAME",
);
}
}
Update OMD and sites
yum update omd-labs-edition
After updating OMD you may want to update your site:
omd stop SITENAME
omd update SITENAME
omd start SITENAME
Install check_mk client and monitor your Nethserver
check_mk agent needs xinetd
rpm -i /opt/omd/versions/2.60-labs-edition/share/check_mk/agents/check-mk-agent-1.2.8p20-1.noarch.rpm
On other clients download Agent via OMD Web Interface:
check_mk agent needs xinetd!
Redhat, CentOS, Nethserver etc
yum install xinetd
wget --no-check-certificate --http-user=omdadmin --http-passwd=omd https://NETHSERVER/SITENAME/check_mk/agents/check-mk-agent-1.2.8p20-1.noarch.rpm
rpm -i check-mk-agent-1.2.8p20-1.noarch.rpm
Debian, Ubuntu etc
apt-get install xinetd
wget --no-check-certificate --http-user=omdadmin --http-passwd=omd https://NETHSERVER/SITENAME/check_mk/agents/check-mk-agent_1.2.8p20-1_all.deb
dpkg -i check-mk-agent-1.2.8p20-1.noarch.rpm
For installing Windows client just download the Agent via Web Interface or browse to https://NETHSERVER/SITENAME/check_mk/agents/windows/check_mk_agent.msi and install it.
Notice that firewall port 6556 has to be open on the client to allow Nethserver to ask for system information.
Setup the new client on Nethserver
Browse to https://NETHSERVER/SITENAME/omd/check_mk
Scroll down the menu on the left, select Hosts and on the top right click the “New Host” button. Enter the hostname of your Nethserver or “localhost” and click “Save and go to services” then “Save” again and “Apply Changes” by clicking the orange button on the top. That’s it.
Mail notification configuration
Go to “Notifications” in “WATO - Configuration” and edit the notification rule. Enter an allowed from email address. So use a Nethserver user mail address or if you use a smarthost just use a mail address from your provider.
Go to “Users” and edit the omdadmin user. Enter an email address which will receive the notifications. Then set the contact group of omdadmin to “Everything”.
Screenshots
My Nethserver monitoring:
Monitoring an Raspberry Pi 3 Nethserver via another Nethserver: