net-mgmt/pnp-icinga2 0.6.26_4 FreeBSD

Configuration

No options to configure.

Service scripts

none

Message after installing

You just installed/upgraded PNP graphing tool for icinga.

You will need to read the documentation at
  http://docs.pnp4nagios.org/pnp-0.6/doc_complete
both for new installations and upgrades from 0.4, since you will
need to tweak your icinga and PNP configuration according to the
0.6.x recipes.

We recommend to start with the following restrictive Apache configuration for
the PNP area:
{{{
# PNP graphing tool
Alias /icingaweb2/pnp /usr/local/www/pnp
<Directory "/usr/local/www/pnp/">
    Order deny,allow
    Allow from all
    Deny from all

    AddHandler application/x-httpd-php .php
    DirectoryIndex index.php

    RewriteEngine on
    RewriteBase /icingaweb2/pnp/
    # Protect application and system files from being viewed
    RewriteRule ^(application|modules|system) - [F,L]
    # Allow any files or directories that exist to be displayed directly
    RewriteCond %{REQUEST_FILENAME} !-f
    RewriteCond %{REQUEST_FILENAME} !-d
    # Rewrite all other URLs to index.php/URL
    RewriteRule .* index.php/$0 [PT,L]
</Directory>
# PNP graphing tool
Alias /icingaweb2/pnp /usr/local/www/pnp

<Directory /usr/local/www/pnp>
   <IfModule mod_authz_core.c>
      # Apache 2.4
      <RequireAll>
         Require all granted
         # Require local
         Require valid-user
      </RequireAll>
   </IfModule>
   <IfModule !mod_authz_core.c>
      # Apache 2.2
      Order allow,deny
      Allow from all
      #  Order deny,allow
      #  Deny from all
      #  Allow from 127.0.0.1
      Require valid-user
   </IfModule>

    AuthName "PNP Access"
    AuthType Basic
    AuthUserFile /usr/local/etc%%NAGIOSHTMURL%%/htpasswd.users

    AddHandler application/x-httpd-php .php
    DirectoryIndex index.php

    RewriteEngine on
    RewriteBase /icingaweb2/pnp/
    # Protect application and system files from being viewed
    RewriteRule ^(application|modules|system) - [F,L]
    # Allow any files or directories that exist to be displayed directly
    RewriteCond %{REQUEST_FILENAME} !-f
    RewriteCond %{REQUEST_FILENAME} !-d
    # Rewrite all other URLs to index.php/URL
    RewriteRule .* index.php/$0 [PT,L]
</Directory>
}}}

Don't forget to install and enable www/mod_php5 as well as mod_rewrite.

If you use another web server like nginx or lighttpd, take a look at
/usr/local/share/examples/pnp

Create /usr/local/www/pnp/install.ignore to disable sanity check
and start using PNP.

Please, note that user who runs Apache processes should be able to
read PNP RRD spool files from
  /var/spool/icinga2/pnp/rrd
so you should tune path permissions accordingly.  Probably one could
start from adding Apache user to the group 'icinga'.

Remember to restart NPCD service after upgrade if you're using
'bulk' mode with NPCD.

===>   NOTICE:

The pnp-icinga2 port currently does not have a maintainer. As a result, it is
more likely to have unresolved issues, not be up-to-date, or even be removed in
the future. To volunteer to maintain this port, please create an issue at:

https://bugs.freebsd.org/bugzilla

More information about port maintainership is available at:

https://docs.freebsd.org/en/articles/contributing/#ports-contributing