$OpenBSD: README-main,v 1.4 2017/11/11 11:01:21 kirby Exp $

+-----------------------------------------------------------------------
| Running pnp4nagios on OpenBSD
+-----------------------------------------------------------------------

General
=======

Pnp4nagios has no default runtime dependencies to a monitoring tool,
as well as to a monitoring webinterface or web server. Example
instructions below are given for icinga, icinga-web and Apache2, as
well as icinga2, icinga-web2 and nginx.

Log file in /var/log/pnp4nagios will need to be rotated. Here is
a sample line for newsyslog.conf:

/var/log/pnp4nagios/pnp4nagios.log _icinga:_icinga 644 7  250  * Z

Icinga, Icinga-web, Apache
==========================

Apache2 configuration
---------------------
Apache2 configuration for PNP4Nagios is stored under:
    /var/www/conf/modules.sample/pnp4nagios.conf

It needs to be enabled by running the following command:
# ln -s ../modules.sample/pnp4nagios.conf /var/www/conf/modules
# rcctl restart apache2

Icinga-web configuration
------------------------
To integrate PNP4Nagios into the Icinga Web frontend you will need to
install templates extensions which comes with icinga-web package:
% cd /var/www/icinga-web/app/modules/Cronks/data/xml/extensions
# ln -s pnp-host-extension.xml.dist pnp-host-extension.xml
# ln -s pnp-service-extension.xml.dist pnp-service-extension.xml

Icinga2, Icinga-web2, Nginx
===========================
Pnp4nagios runs with php_fpm behind nginx in a chrooted environment.

Prepare the chroot environment
------------------------------
 - follow the instructions in the rrdtool package README
   to chroot rrdtool
 - copy /bin/sh to /var/www/bin
 - copy /etc/pnp4nagios /var/www/etc/pnp4nagios
 - copy /usr/local/lib/kohana/system /var/www/usr/local/lib/kohana/system
 - edit /var/www/etc/pnp4nagios/config.php
   - ensure: $conf['rrdbase'] = "/pnp4nagios/rrd/";
   - ensure: $conf['nagios_base'] = "/icingaweb2";

Icinga2 configuration
---------------------
With Icinga2 enable the perfdata feature:

# icinga2 feature enable perfdata

Pnp4nagios will use the npcd daemon, and work in the 'bulk' mode.
In /etc/pnp4nagios/npcd.cfg update the 'perfdata_spool_dir'
to point to '/var/spool/icinga2/perfdata'. Additionally ensure
the 'perfdata_file_run_cmd_args' has a '--bulk' argument specified.

In /etc/pnp4nagios/process_perfdata.cfg ensure the
RRDPATH setting points to '/var/www/pnp4nagios/rrd'.

Finally enable npcd:

# rcctl enable npcd

Nginx configuration
-------------------
Below a minimal snippet for the nginx configuration:

server {

  ...

  location /pnp4nagios {

    alias /var/www/pnp4nagios;
  }

  location ~ ^(/pnp4nagios.*\.php)(.*)$ {


    root          /pnp4nagios;
    include       /etc/pnp4nagios/nginx/fastcgi_params;

    fastcgi_pass  unix:run/php-fpm-pnp4nagios.sock;
    fastcgi_split_path_info ^(.+\.php)(.*)$;
    fastcgi_param PATH_INFO       $fastcgi_path_info;
    fastcgi_param SCRIPT_FILENAME $document_root/index.php;
  }
}

Php_fpm configuration
---------------------
Configure php_fpm pool, the most important configuration
entries:

[pnp4nagios]
listen = /var/www/run/php-fpm-pnp4nagios.sock
listen.owner = www
listen.group = www
listen.mode = 0660
user = _icinga
group = _icinga
chroot = /var/www

Icinga-web2 configuration
-------------------------
Pnp4nagios integration with Icinga-web2 is done via PNP
module, that can be found here:
 - https://github.com/Icinga/icingaweb2-module-pnp
For installation and configuration follow the modules
instructions.

RRD tweaks.
=====================
Optionally you may want to use rrdcached to reduce disk I/O.
Here is a sample /etc/rc.conf.local part:
rrdcached_flags=-b /var/www/pnp4nagios/rrd -m 0660 -s _icinga -l unix:/var/www/pnp4nagios/rrd/rrdcached.sock -j /var/www/pnp4nagios/rrd//journal -p /var/www/pnp4nagios/rrd/rrdcached.pid -w 1800 -z 1800 -F -P FLUSH,PENDING
rrdcached_user=_icinga
