Monitoring Plugins standards
Find a file
Holger Weiss ae24aaeefb Use FindBin consistently across Perl plugins
Use Perl's FindBin module to locate the path to utils.pm in
check_file_age.pl and check_mssql.pl, just as we do in other Perl
plugins.
2014-06-18 18:45:10 +02:00
build-aux Update bundled libtool files 2013-09-05 00:03:00 +02:00
config_test Ficing C++ style comments 2007-03-08 06:12:36 +00:00
doc Project rename initial commit. 2014-01-19 14:18:47 -05:00
gl Add strcase gnulib module 2014-01-29 03:04:05 -05:00
lib lib/parse_ini.c: Search for INI file in subdirs 2014-06-18 18:39:32 +02:00
m4 Project rename initial commit. 2014-01-19 14:18:47 -05:00
perlmods updated perldod with a renamed pkg 2014-01-20 14:55:18 +01:00
pkg Capitalize "Monitoring Plugins" 2014-01-21 16:19:20 +01:00
plugins plugins/runcmd.c: Remove superfluous newline 2014-06-18 18:40:23 +02:00
plugins-root Capitalize "Monitoring Plugins" 2014-01-21 16:19:20 +01:00
plugins-scripts Use FindBin consistently across Perl plugins 2014-06-18 18:45:10 +02:00
po Capitalize "Monitoring Plugins" 2014-01-21 16:19:20 +01:00
tap Clean up last commit - remove the __STDC_VERSION__ check in tap.h 2009-01-15 01:03:00 -05:00
tools Capitalize "Monitoring Plugins" 2014-01-21 16:19:20 +01:00
.gitignore AUpdate .gitignore for new gnulib module 2014-01-29 03:48:24 -05:00
.travis.yml travis-ci: remove mawk build-deps 2014-02-28 15:35:41 +01:00
ABOUT-NLS Updating gettext files from coreutils-6.9. mkinstalldirs needs to be in 2007-05-12 00:49:26 +00:00
acinclude.m4 Removing CVS/SVN tags and replacing with git-based versioning 2008-11-23 05:38:47 +00:00
ACKNOWLEDGEMENTS Project rename initial commit. 2014-01-19 14:18:47 -05:00
AUTHORS Add Sam Kottler to the list of AUTHORS 2014-04-04 10:28:50 +02:00
autogen.sh Removing CVS/SVN tags and replacing with git-based versioning 2008-11-23 05:38:47 +00:00
CODING Project rename initial commit. 2014-01-19 14:18:47 -05:00
config.rpath make dist failing without config.rpath in top level. File copied 2007-01-30 09:56:47 +00:00
configure.ac configure.ac: Remove unused code 2014-06-12 00:10:07 +02:00
COPYING Update the COPYING file to the GPLv3 2010-07-27 23:06:23 +02:00
FAQ Project rename initial commit. 2014-01-19 14:18:47 -05:00
LEGAL Initial revision 2002-02-28 06:42:51 +00:00
Makefile.am Project rename initial commit. 2014-01-19 14:18:47 -05:00
mkinstalldirs Adding more required files from gettext 2006-05-19 21:30:59 +00:00
monitoring-plugins.spec.in Merge branch 'maint' 2014-01-21 16:07:38 +01:00
NEWS Replace "plugins-scripts/subst.in" foo 2014-02-28 13:28:33 +01:00
NP-VERSION-GEN Prepare for the 1.5 release 2013-10-02 17:21:01 +02:00
NPTest.pm tests: fping checks require being root or setuid root 2014-06-13 15:23:18 +02:00
opttest.pl Initial revision 2002-02-28 06:42:51 +00:00
README README: Minor fixes regarding new project name 2014-01-21 21:56:23 +01:00
README.md Add symlink: README.md -> README 2013-09-20 17:00:40 +02:00
REQUIREMENTS Project rename initial commit. 2014-01-19 14:18:47 -05:00
ROADMAP some minor fixes 2004-12-03 17:48:53 +00:00
SUPPORT Project rename initial commit. 2014-01-19 14:18:47 -05:00
test.pl.in Enable tests in tests/ subdirs 2014-01-31 08:54:44 -05:00
THANKS.in check_nt: add UPTIME to perfdata [sf#3434647] 2014-04-04 12:42:59 +06:00

Monitoring Plugins

  • For instructions on installing these plugins for use with your monitoring system, see below. In addition, generic instructions for the GNU toolchain can be found in the INSTALL file.

  • For major changes between releases, read the NEWS file.

  • For information on detailed changes that have been made or plugins that have been added, read the ChangeLog file.

  • Some plugins require that you have additional programs and/or libraries installed on your system before they can be used. Plugins that are dependent on other programs/libraries that are missing are usually not compiled. Read the REQUIREMENTS file for more information.

  • Individual plugins are self-documenting. All plugins that comply with the basic guidelines for development will provide detailed help when invoked with the -h or --help options.

You can check for the latest plugins at:

Send an email to help@monitoring-plugins.org for assistance. Please include the OS type and version that you are using. Also, run the plugin with the -vvv option and provide the resulting version information. Of course, there may be additional diagnostic information required as well. Use good judgment.

Send an email to devel@monitoring-plugins.org for developer discussions.

For patch submissions and bug reports, please use the appropriate resources at:

Installation Instructions

  1. If you are using the Git tree, you will need m4, gettext, automake, and autoconf. To start out, run:

    ./tools/setup
    

    For more detail, see the developer guidelines at https://www.monitoring-plugins.org/doc/guidelines.html.

  2. Run the configure script to initialize variables and create a Makefile, etc.

    ./configure --prefix=BASEDIRECTORY --with-cgiurl=SOMEURL
    

    Replace BASEDIRECTORY with the path of the directory under which your monitoring system is installed (default is /usr/local), and replace SOMEURL with the path used to access the monitoring system CGIs with a web browser (default is /nagios/cgi-bin).

  3. Compile the plugins with the following command:

    make
    
  4. Install the compiled plugins and plugin scripts with the following command:

    make install
    

    The installation procedure will attempt to place the plugins in a libexec/ subdirectory in the base directory you specified with the --prefix argument to the configure script.

  5. There are some plugins that require setuid. If you run make install as a non-root user, they will not be installed. To install, switch to root and run:

    make install-root
    

That's it! If you have any problems or questions, feel free to send an email to help@monitoring-plugins.org.

License Notice

You can redistribute and/or modify this software under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version; with the additional exemption that compiling, linking, and/or using OpenSSL is allowed.

This software is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

See the COPYING file for the complete text of the GNU General Public License, version 3.