Using Adagios

Posted 2014-12-13

This page documents the steps to install and run Adagios from source, on an up-to-date Debian jessie (testing) workstation. Adagios provides a user interface to a Nagios3 installation. We investigated this solution since Kaji (Adagios with Shinken) is not ready yet.


This section is based on the instructions from the Adagios wiki.


Some packages in the instructions already were installed on my workstation.

Already installed:

  • git
  • apache2
  • libapache2-mod-wsgi
  • python-django
  • python-simplejson
  • libgmp-dev
  • python-dev
  • python-paramiko


  • check-mk-livestatus (installed from sid, not in jessie)
  • nagios3 (password 'admin')
  • pnp4nagios (v0.6.24+dfsg1-2 from sid, not in jessie) -- Had to manually remove the recommended package 'pnp4nagios-web-config-icinga', and install 'pnp4nagios-web-config-nagios3'
  • pynag (v0.9.1 from sid)

Install source and configure

Cloned to ~/src, then copied to /opt. So, root:root owns the files.

adagios.conf: Followed instructions to change references from 'nagios' to 'nagios3'. Also performed the steps below.

adagios.conf: Updated entry 'destination_directory' to reference 'nagios3' rather than 'nagios'. Added the line below to /etc/nagios3/nagios.cfg:


adagios.conf: Updated entry 'nagios_binary' to reference 'nagios3' rather than 'nagios'.

adagios.conf: Updated entry 'pnp_filepath' to actual path:


Ran pynag commands for mk-livestatus broker_module and use of /etc/adagios.

Created /etc/apache2/sites-available/adagios.conf and generated password entry (adagios:admin).

Usage Notes

After restarting Adagios, see two messages:

Folder /var/lib/adagios/userdata can't be created. Be sure Adagios has write access on its parent.
Configs have changed. You need to reload for changes to take effect.

Created the /var/lib/adagios/userdata directory and changed owner to nagios:www-data, although probably did not need to create the 'userdata' subdirectory.

Copied /opt/adagios/adagios/etc/sudoers.d/adagios to /etc/sudoers.d. Changed command line to reference 'nagios3' rather than 'nagios'. This allows restarting nagios.

With these changes, all host and service checks run as expected.

PNP4Nagios not working:

perfdata directory "/var/lib/pnp4nagios/perfdata/" is empty. Please check your Nagios config. <a href="">Read FAQ online</a>

Changed livestatus configuration in /etc/pnp4nagios/config.php:

$conf['livestatus_socket'] = "unix:/var/lib/nagios3/rw/livestatus";

Changed /etc/nagios3/nagios.cfg to process performance data, per Debian README for pnp4nagios:

process_performance_data = 1
broker_module=/usr/lib/pnp4nagios/npcdmod.o config_file=/etc/pnp4nagios/npcd.cfg

Also confirmed 'RUN="yes"' in /etc/default/npcd.

Installing and Running okconfig

Before installation, modified several files to reference 'nagios3' rather than 'nagios'.


Did not modify ./usr/share/okconfig/pnp4nagios.cfg. Not sure if /var/spool/nagios... should change to use 'nagios3'

Did not modify ./etc/nagios/cgi.cfg, ./etc/nagios/nagios.cfg, or ./etc/httpd/conf.d/nagios.conf. I already have these files installed, and they are OK. Just saving time -- the files may need to be changed for a different installation.

In general, did not change /usr/lib/nagios for plugins. It looks like the monitoring-plugins packages still use this directory.

Stopped at ./etc/okconfig.conf. Rerun the command below, change other references to 'nagios', and reinstall:

find . -type f -exec grep -H "nagios" {} \; |less

Issues adding a host

Tried to add a new host via the Adagios web UI. Ran into several issues:

  • Adagios attempted to create an \etc\nagios3\.git repository, but git failed with 'empty ident name not allowed'. Set up git repository as shown below.
  • Permission failures also occured, so changed owner of \etc\nagios3 tree to 'nagios:root'.
root@verix:/etc/nagios3# git config "nagios@verix"
root@verix:/etc/nagios3# git config "nagios"

Issues adding a service

Must define a check command, so used "return-ok".