It's relatively easy to use [http://docs.univention.de/manual-3.2.html#nagios::general Nagios to monitor UCS servers]. The idea here is to show how to integrate Univention Corporate Clients (UCC) into the monitoring set up of an UCS-Nagios server.

+

It's relatively easy to use [http://docs.univention.de/manual-3.2.html#nagios::general Nagios to monitor UCS servers]. The idea here is to show how to integrate Univention Corporate Clients (UCC) into the monitoring setup of an UCS Nagios server.

−

We will first install the NRPE packages (Nagios Remote Plugin Executor) in UCC to make the system a Nagios client. As part of the set up we need to manually copy Nagios plugins to UCC.

+

We will first install the NRPE packages (Nagios Remote Plugin Executor) in UCC to make the system a Nagios client. As part of the setup, we need to manually copy Nagios plugins to UCC.

−

Finally, the Nagios server has to be aware of this new clients to monitor. For that, we will generate the corresponding Nagios configuration for the UCC hostgroup.

+

Finally, the Nagios server has to be aware of these new clients to monitor. For that, we will enable the Nagios services for the UCC hosts.

−

= UCC set up (Nagios client) =

+

{{TOC}}

−

In some environments would be preferable to perform this steps within the image file before a roll out (by mounting it as described in the [http://docs.univention.de/ucc-manual-1.0.html#imagegen:modify UCC Manual]).

+

== UCC setup (Nagios client) ==

−

Install Nagios-NRPE packages (agent and plug-ins):

+

'''Note:''' In some environments, it would be preferable to perform these steps within the image file before a roll out (by mounting it as described in the [http://docs.univention.de/ucc-manual-1.0.html#imagegen:modify UCC manual]).

+

+

Install the Nagios NRPE packages (agent and plug-ins):

apt-get install nagios-nrpe-server

apt-get install nagios-nrpe-server

−

Accept monitoring from UCS-Nagios Server:

+

Open '''/etc/nagios/nrpe.cfg''' with an editor and allow the Nagios server as host in the nrpe.cfg file:

−

vi /etc/nagios/nrpe.cfg

−

−

Allow the Nagios server in nrpe.cfg:

#---

#---

allowed_hosts=server.example.com

allowed_hosts=server.example.com

#---

#---

−

For this set up it's helpful to use an UCS system that is already being monitored (it has the univention-nagios-client package installed). The idea is to copy the needed plug-ins and files into our UCC system.

Since the Nagios services attribute is not defined for UCC Objects, we will have to create this part manually. I suspect there are simpler ways to do this, but for now let us create a host file and add the new host to a hostgroup file.

Latest revision as of 14:03, 8 September 2017

Version 4.1

Version 3.0

Note: Cool Solutions are articles documenting additional functionality based on Univention products.
Not all of the shown steps in the article are covered by Univention Support. For questions about your support coverage contact your contact person at Univention before you want to implement one of the shown steps.

Note: If working on the UCC image, it could be better to move the files before performing the chroot to it.

Restart NRPE service

service nagios-nrpe-server restart

Note: This won't have any effect if you are modifying an UCC image.

UCS setup (Nagios server)

The next step is to set the UCC host to be monitored.

For this, you have to open the Univention Management Console and switch to the "Computers" module.
Now open the settings of the UCC host, switch to the "Options" tab and tick the "Nagios support" option
As the final step, you have to assign the Nagios services "UNIVENTION_DISK_ROOT" and "UNIVENTION_PING" in the "Advanced settings" tab below "Nagios services".

Now you should be able to see the computer in your Nagios web interface. After some minutes the plug-ins will start returning status information to the Nagios server.