This is APAN, Advanced Performance Addon for Nagios.

Version 0.2.1

Introduction ----------------------------------------

Apan is a addon to Nagios that is used to collect results from Nagios
plugins and store it in RRD-files. You can the use Apan to view graphs
of the data in Nagios web-interface.


System Requirements ---------------------------------

To use this package you need Nagios (www.nagios.org), RRD-Tool
(http://people.ee.ethz.ch/~oetiker/webtools/rrdtool/), a bourne-shell
compatible UNIX-shell and the bc-command.


For information and installation look at http://apan.sourceforge.net.



Changes ---------------------------------------------

Apan handles spaces in service-names (the service_description-parameter
in Nagios). To use this feature you have to enclose $SERVICEDESK in the
checkcomand with double-qoutes. See the quick-install guide below.

One of the big changes between release 0.1 and 0.2 is the configuration
that has moved from the scripts to a global config-file (apan.defs)

The output from the plugins should be compatible with the previous 
release and no changes have been made in apan.cfg

For more info, look in CHANGELOG


Installation ----------------------------------------

Here is a short install-howto, for more info you should look att
apan.sourceforge.net:

1)  Unpack the distribution in Nagios base-directory (/usr/local/nagios)

2)  Check that the file apan.sh and the files in the plugs-dir is
    executable by the Nagios-user.

3)  Update the path's and vars in apan.defs. If you are installing apan
    in a different location than /usr/local/nagios/apan, then ypu have
    to edit apan.cgi, generate.cgi and apan.sh as well.

4)  Copy apan.cgi and generate.cgi to Nagios cgi-bin directory
    (/usr/local/nagios/sbin), and make them executable by the web-server.

5)  Copy the graph-icon, graph.png, to Nagios logo-directory
    (/usr/local/nagios/share/images/logos).

6)  Copy the contributed plugins from apan's libexec-dir to Nagios
    libexec-dir

7)  Add apan.sh to checkcommands.cfg;
	define command {
	command_name                   apan
	command_line                   /usr/local/nagios/apan/apan.sh $ARG1$ $HOSTNAME$ "$SERVICEDESC$" $TIMET$ $ARG2$ $ARG3$
	}

8)  Add sevices to nagios;
	define service {
	host_name                      host1,host2
	service_description            Disk-usage
	check_command                  apan!nt-disk!150!100
	use                            generic-test
	normal_check_interval          5
}

9)  Add the host/service to apan.cfg
	host1;Disk-usage;/usr/local/nagios/rrd/host1_Disk-usage.rrd;c|d;c-used:AREA c-free:STACK d-used:AREA d-free:STACK;Disk usage;Bytes;-l 1 -b 1024

10)  Create a RRD-file;
rrdtool create /usr/local/nagios/rrd/host1_Disk-usage.rrd -s 60 DS:c-used:GAUGE:900:0:U DS:c-free:GAUGE:900:0:U DS:d-used:GAUGE:900:0:U DS:d-free:GAUGE:900:0:U RRA:AVERAGE:0.5:1:50400 RRA:AVERAGE:0.5:60:43800
    Make sure that the Nagios-user have write-permissions on the file.

11) Add a link to the graphs as an extended service info;
	define serviceextinfo{  
	host_name               host1
	service_description     Disk-usage
	notes_url               /nagios/cgi-bin/apan.cgi?host=host1&service=Disk-usage
	icon_image              graph.png
	icon_image_alt          View graphs
}

12) Start Nagios!



-------------------------------------------------------
For more info:
apan.sourceforge.net
Fredrik Wnglund, fredrik.wanglund@datavis.se

Nagios is a registered trademark of Ethan Galstad.


