nagios-plugins/contrib

Contrib Plugins README
----------------------

This directory contains plugins which have been contributed by various people, but that
have not yet been incorporated into the core plugins distribution.

If you have questions regarding the use of these plugins, try contacting the author(s)
or post a message to the nagios-users mailing list (nagios-users@onelist.com)
requesting assistance.


Plugin Overview
---------------

berger-ping.tar.gz - Perl script version of the check_ping plugin and a corresponding
CGI (mtr.cgi) that uses mtr to traceroute a path to a host.
(Gary Berger)

bowen-langley_plugins.tar.gz
- Several C plugins including check_inode, check_boot, etc.
(Adam Bown & Thomas Langley)


check_bgpstate.tar.gz - Perl script intended for monitoring BGP sessions on Cisco routers.
Only useful if you are using BGP4 as a routing protocol. For
critical alert the AS (autonomous system) number has to be in the
uplinks hash (see the source code). Requires SNMP read community.
(Christoph Kron)

check_breeze.tar.gz - Perl script to test signal strength on Breezecom wireless
equipment (Jeffrey Blank)

check_dns_random.tar.gz - Perl script to see if dns resolves hosts randomly from a list
using the check_dns plugin (Richard Mayhew)

check_flexlm.tar.gz - Perl script to check a flexlm licensing manager using lmtest
(Ernst-Dieter Martin)

check_hltherm.tar.gz - C program to check the temperature on a Hot Little Therm temperature
probe. The HLT device, along with temperature probes, can be obtained
from Spiderplant at http://www.spiderplant.com
(Ethan Galstad)

check_ifoperstatus.tar.gz
- Perl script that checks the operational interface status (up/down) for
one interface on cisco/ascend routers. Especially useful for monitoring
leased lines. Requires SNMP read community and SNMP interface key.
(Christoph Kron)

check_ifstatus.tar.gz - Perl script that checks operational interface status for every interface
on cisco routers. Requires SNMP read community.
(Christoph Kron)

check_ipxping.tar.gz - C program that it similiar to the check_ping plugin, except that it
send IPX ping packets to Novell servers or other IPX devices. This
requires the ipxping binary for Linux systems. It does NOT by work
without modification with the ipxping binary for SunOS/Solaris.
(Ethan Galstad)

check_maxchannels.tar.gz
- Perl script that can only be used for monitoring Ascend/Lucent Max/TNT
access server. Checks ISDN channels and modem cards. Also shows ISDN and
modem usage. Requires SNMP read community.
(Christoph Kron)

check_maxwanstate.tar.gz
- Perl script that can only be used for monitoring Ascend/Lucent Max/TNT
access server. Checks if every enabled E1/T1 interface is operational
(link active). Requires SNMP read community.
(Christoph Kron)

check_memory.tgz - C program to check available system memory - RAM, swap, buffers,
and cache (Joshua Jackson)

check_nfs.tar.gz - Perl script to test and NFS server using rpcinfo
(Ernst-Dieter Martin)


check_ntp.tar.gz - Perl script to check an NTP time source (Bo Kernsey)


check_ora.tar.gz - Shell script that will check an Oracle database and the TNS listener.
Unlike the check_oracle plugin, this plugin detects when a database is
down and does not create temp files (Jason Hedden)


check_pop3.tar.gz - Perl script that checks to see if POP3 is running and whether or not
authentication can take place (Richard Mayhew)

check_radius.tar.gz - C program to check RADIUS authentication. This is a hacked version of
the Cistron Radiusd program radtest that acts as a plugin for Nagios.
The vast majority of the code was written by someone at Livingston
Enterprises and Cistron. NOTE: Due to the copyright restrictions in
this code, it cannot be distributed under the GPL license, and thus
will not appear in the core plugin distribution!
(Adam Jacob)

check_real.tar.gz - C program to check the status of a REAL media server
(Pedro Leite)


check_rpc.pl.gz - Perl script to check rpc services. Will check to see if the a specified
program is running on the specified server (Chris Kolquist)

check_sap.tar.gz - Shell script to check an SAP message or application server. Requires
that you install the saprfc-devel-45A-1.i386.rpm (or higher) package
on your system. The package can be obtained from the SAP FTP site in
the /general/misc/unsupported/linux directory. (Kavel Salavec)

check_uptime.tar.gz - C program to check system uptime. Must be compiled with the release
1.2.8 or later of the plugins. (Teresa Ramanan)

check_wave.tar.gz - Perl script to test signal strength on Speedlan wireless
equipment (Jeffrey Blank)

hopcroft-plugins.tar.gz - Various example plugin scripts contributed by Stanley Hopcroft.
Includes a plugin to check Internet connectivity by checking various
popular search engines, a plugin to check the availability of login
to a TN/3270 mainframe database using Expect to search for "usual"
screens, and another plugin to test the availability of a database
search via the web.
(Stanley Hopcroft)

maser-oracle.tar.gz - This is a modification to the check_oracle plugin script that returns
the response time in milliseconds. Requires the Oracle tnsping utility.
(Christoph Maser)

radius.tar.gz - Code modifications necessary to make the radexample app
supplied with the radiusclient code work as a RADIUS plugin
for Nagios (Nick Shore)

vincent-check_radius.tar.gz
- C program to check RADIUS authentication. Requires the radiusclient
library available from ftp://ftp.cityline.net/pub/radiusclient/
(Robert August Vincent II)


weipert-mysql.tar.gz - C program to check a connection to a MySQL database server, with an
optional username and password. Requires mysql.h and libmysqlclient
to compile (Time Weipert)

wright-mysql.tar.gz - Perl script to check MySQL database servers. Requires that mysqladmin(1)
be installed on the system (included in the MySQL distribution). This
plugin can accept warning and critical thresholds for the number of threads
in use by the server (Mitch Wright)