Keywords: Supervision, Icinga, Nagios, Linux

6.9. Integration of PNP4Nagios into Icinga Web
Prev | Chapter 6. User Interfaces | Next

## 6.9. Integration of PNP4Nagios into Icinga Web

Here we'll give you some instructions on how to integrate PNP4Nagios into the Icinga Web frontend. If you want to integrate PNP4Nagios into the Icinga Classic UI please follow the PNP4Nagios documentation.

Figure 6.40. Expander icon

On the left you will see the expander icon. Clicking on it opens a bar (shown below the OK sign).

Figure 6.41. Icon bar

On the right in the "PNP4Nagios" section there are two buttons.

Figure 6.42. Move icons to grid

Right-clicking on either of them and selecting "Move into grid" will move the appropriate icon into the grid.

Figure 6.43. New icons in grid

Selecting the new icon opens the PNP graph in a small window showing only one time frame or it will create a new tab showing the usual PNP view.

Clicking on "Setting" and selecting "Reset grid action icons" will remove the inserted icons restoring the default view.

Figure 6.44. Reset icon view

### 6.9.1. Install PNP4Nagios

1. Install PNP4Nagios as described in the PNP4Nagios documentation

2. Change the PNP4Nagios configuration to match your Icinga configuration. You probably may want to change these:

       #> vi npcd.cfg

           user = icinga
           group = icinga
           log_file = /var/log/icinga/npcd.log
           perfdata_spool_dir = /var/icinga/spool/
           perfdata_file = /var/icinga/perfdata.dump

       #> vi process_perfdata.cfg

           LOG_FILE = /var/log/icinga/perfdata.log
           XML_ENC = ISO-8859-1  # use if encountering national character issues

       #> vi config.php
           $conf['nagios_base'] = "/icinga/cgi-bin";

   | Note
   Be sure to use existing paths, create them if necessary, and/or adapt the settings to your distribution. Please verify that the Icinga command definitions for "process-host-perfdata-file" and "process-service-perfdata-file" (probably in `etc/objects/commands.cfg`) point to the same target directory as specified in perfdata_spool_dir.

### 6.9.2. Templates Extension

PNP integration is made with these extensions to be upgrade safe.

Excerpt from the `INSTALL` in `contrib/PNP_Integration/`

    #> cat contrib/PNP_Integration/INSTALL
        ************************
        * INSTALLATION
        ************************

        * To install this addon, simply copy both xml files under templateExtensions
        * to your icinga-webs app/modules/Cronks/data/xml/extensions folder
        * and clear the app/cache/CronkTemplates folder
        * To remove it, just delete the extension files and clear the cache folder again

Install Script

Because it's only copying the two files mentioned there is no script. Sorry.

| Note
Please note that you will have to reinstall the addon after Icinga-Web upgrade.

### 6.9.3. Clearing the cache

| Note
If you edit any *.xml file you have to clear the cache afterwards!

    #> rm -f app/cache/config/*.php

or /path/to/clearcache.sh

    #> /usr/local/icinga-web/bin/clearcache.sh

That's all, you're done!

Prev | Up | Next
6.8. Introduction to Icinga Web | Home | Chapter 7. Advanced Topics

© 1999-2009 Ethan Galstad, 2009-2015 Icinga Development Team, http://www.icinga.org