NPC Quick Start Guide

Purpose

The purpose of this guide is to outline the minimum steps necessary to get NPC installed and running.

Requirements

Below are the minimum requirements:

• PHP 5.2
•  NDOUtils 1.4b7
•  Nagios 3.x
•  Cacti 0.8.7b
•  Cacti Plugin Architecture v2.0

NPC has been tested with the above application versions. PHP 5.2 is required do to the use of PDO and JSON. PHP 5.1 with PDO and JSON modules installed "may" work but will not be supported.

NDO2DB

NOD2DB is part of the NDOUtils package. Nagios hands events off to NDO2DB via the event broker. NDO2DB handles the actual inserts of Nagios data into the NPC tables.

Nagios Configuration

Refer to the Nagios documentation for installation. Some parts of NPC like reporting and the status map use the Nagios interface by wrapping the Nagios CGI's in an Iframe. Be sure to have the Nagios web UI working if you want to use the reporting and status map features.

The following parameters are found in the Nagios configuration file nagios.cfg

The power of NPC is greatly enhanced by the ability to issue commands to the Nagios process. To enable external commands in Nagios set:

check_external_commands=1

Check external commands as often as possible.

command_check_interval=-1

Broker all events.

event_broker_options=-1

Set this to the actual location of the even broker module and config that you used when setting up NDO2DB above.

broker_module=/usr/local/nagios/bin/ndomod.o config_file=/usr/local/nagios/etc/ndomod.cfg

If you want to use performance data from Nagios plugins to create graphs in cacti then set the following parameter. Setting host_perfdata_command and service_perfdata_command is not necessary. The performance data will be written to the NPC database where it can be polled by cacti using the perfdata.php script included with NPC.

process_performance_data=1