Summary
=======
NRPE is an addon that allows you to execute Nagios plugins on remote 
Linux/Unix hosts. This is useful if you need to monitor local 
resources/attributes like disk usage, CPU load, memory usage, etc. 
on a remote host. Similiar functionality can be accomplished by 
using the check_by_ssh plugin, although it can impose a higher 
CPU load on the monitoring machine - especially if you are monitoring 
hundreds or thousands of hosts. 

There are two pieces to this addon:

  1) NRPE       - This program runs as a background process on the 
                  remote host and processes command execution requests
	          from the check_nrpe plugin on the Nagios host.
		  Upon receiving a plugin request from an authorized
                  host, it will execute the command line associated
                  with the command name it received and send the
                  program output and return code back to the 
                  check_nrpe plugin

  2) check_nrpe - This is a plugin that is run on the Nagios host
                  and is used to contact the NRPE process on remote
	          hosts.  The plugin requests that a plugin be
                  executed on the remote host and wait for the NRPE
                  process to execute the plugin and return the result.
                  The plugin then uses the output and return code
                  from the plugin execution on the remote host for
                  its own output and return code.

The latest version of Nagios-addons is 2.12 and will be installed as 
SUNWnrpe package. 

This project is targetting a Minor release of Solaris.

Dependencies
============

SUNWnagiosr, SUNWnagiosu, SUNWnagios-plugins


Interfaces
==========

   The SUNWnrper and SUNWnrpeu packages are Uncommitted.
   
   The remaining interfaces are Volatile.
   
Exported Interfaces
-------------------
/usr/bin/nrpe - NRPE Executable
/usr/lib/check_nrpe 
/usr/etc/nrpe.cfg - NRPE Configuaration file
/var/svc/manifest/network/nrpe-tcp.xml - NRPE xml file to start service

Imported Interfaces
-------------------
Nagios -- Uncommitted LSARC 2009/603

Reference Documents
===================
   [1] www.nagios.org
   [2] http://nagios.sourceforge.net/docs/3_0/addons.html
   [3] nrpe.png -- NRPE direct architecture diagram
   [4] indirect-nrpe.png -- NRPE indirect architecture diagram