README

   1 Nagios Plugins README
   2 ---------------------
   3
   4 * For instructions on installing these plugins for use with Nagios,
   5   see below. In addition, generic instructions for the GNU toolchain
   6   can be found in the INSTALL file.
   7
   8 * For information on what changes have been made or plugins have been added,
   9   read the Changelog file.
  10
  11 * Some plugins require that you have additional programs and/or
  12   libraries installed on your system before they can be used.  Plugins
  13   that are dependent on other programs/libraries that are missing are
  14   usually not compiled. Read the REQUIREMENTS file for more information.
  15
  16 * Individual plugins are self documenting.  All plugins that comply with
  17   the basic guidelines for development will provide detailed help when
  18   invoked with the '-h' or '--help' options.
  19
  20 * The file command.cfg contains example configurations for many of the
  21   plugins
  22
  23 You can check for the latest plugins at:
  24   ftp://download.sourceforge.net/pub/sourceforge/nagiosplug
  25   http://sourceforge.net/projects/nagiosplug/
  26
  27 Send mail to nagiosplug-help@lists.sourceforge.net for assistance.  Please
  28 include the OS type and version that you are using.  Also, run the plugin with
  29 the '-v' option and provide the resulting version information.  Of course,
  30 there may be additional diagnostic information required as well.  Use good
  31 judgment.
  32
  33 Send mail to nagiosplug-devel@lists.sourceforge.net for developer discussions.
  34
  35 For patch submissions and bug reports, please use the appropriate resources at
  36 http://sourceforge.net/projects/nagiosplug/ (navigate to the bug tool and/or
  37 patch tool from the summary page).  Patches should be relative to the current
  38 CVS head (development), or to the head of the current stable branch. Also,
  39 please include version information for your OS and the plugin(s) your are
  40 patching/reporting.
  41
  42
  43
  44
  45 Nagios Plugins Quick-and-Dirty Installation Instructions
  46 --------------------------------------------------------
  47
  48 0) If using the CVS tree, you need m4, gettext, automake, and autoconf. To
  49    start out, run ./tools/setup
  50
  51    For development, we generally use the most recent stable tools from
  52    the FSF. Currently we use gettext 0.11.5, autoconf 2.57, and
  53    automake 1.76. No other versions are tested, and you may see
  54    warnings or errors with other versions.
  55
  56
  57 1) Run the configure script to initialize variables and create a Makefile, etc.
  58
  59         ./configure --prefix=BASEDIRECTORY --with-nagios-user=SOMEUSER --with-nagios-group=SOMEGROUP --with-cgiurl=SOMEURL
  60
  61    a) Replace BASEDIRECTORY with the path of the directory under which Nagios
  62       is installed (default is '/usr/local/nagios')
  63    b) Replace SOMEUSER with the name of a user on your system that will be
  64       assigned permissions to the installed plugins (default is 'nagios')
  65    c) Replace SOMEGRP with the name of a group on your system that will be
  66       assigned permissions to the installed plugins (default is 'nagios')
  67    d) Replace CGIURL with the path used to access the Nagios CGIs with
  68       a web browser (default is '/nagios/cgi-bin')
  69
  70
  71 2) Compile the plugins with the following command:
  72
  73         make
  74
  75
  76 3) Install the compiled plugins and plugin scripts with the following command:
  77
  78         make install
  79
  80    The installation procedure will attempt to place the plugins in a
  81    'libexec/' subdirectory in the base directory you specified with
  82    the --prefix argument to the configure script.
  83
  84
  85 4) Verify that your host configuration file (hosts.cfg) for Nagios contains
  86    the correct paths to the new plugins.
  87
  88
  89
  90 That's it.  If you have any problems or questions, feel free send mail
  91 to nagios-users@lists.sourceforge.net or nagiosplug-help@lists.sourceforge.net
  92
  93
  94
  95
  96 --
  97 Karl DeBisschop (kdebisschop@users.sourceforge.net)