![[tokkee]](http://tokkee.org/images/avatar.png){kind=avatar}
index a9591ec754afaa54282ae923b69d9e61d8ef4ab5..8bca5f753cfc89c8b56c7a4afc27223eb200df7e 100644 (file)
--- a/README
+++ b/README
Nagios Plugins README
---------------------
-* For instructions on installing these plugins for use with Nagios, read
- the INSTALL file.
+* For instructions on installing these plugins for use with Nagios,
+ see below. In addition, generic instructions for the GNU toolchain
+ can be found in the INSTALL file.
-* For information on what chages have been made or plugin have been added,
- read the Changelog file.
+* For major changes between releases, read the CHANGES 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
usually not compiled. Read the REQUIREMENTS file for more information.
* Individual plugins are self documenting. All plugins that comply with
- the basic guidleines for development will provide detailed help when
- invoked with the '-h' option ('--help' also, if long options are enabled).
+ the basic guidelines for development will provide detailed help when
+ invoked with the '-h' or '--help' options.
-* The file command.cfg contains xample configurations for many of the
+* The file command.cfg contains example configurations for many of the
plugins
+* The win32 subdir contains plugins specific to the Win32 platform.
+ These are scripts or binaries.
+
You can check for the latest plugins at:
ftp://download.sourceforge.net/pub/sourceforge/nagiosplug
http://sourceforge.net/projects/nagiosplug/
include the OS type and version that you are using. Also, run the plugin with
the '-v' option and provide the resulting version information. Of course,
there may be additional diagnostic information required as well. Use good
-judgement.
+judgment.
Send mail to nagiosplug-devel@lists.sourceforge.net for developer discussions.
CVS head (development), or to the head of the current stable branch. Also,
please include version information for your OS and the plugin(s) your are
patching/reporting.
-
+
+
+
+
+Nagios Plugins Quick-and-Dirty Installation Instructions
+--------------------------------------------------------
+
+0) If using the CVS tree, you need m4, gettext, automake, and autoconf. To
+ start out, run ./tools/setup
+
+ For development, we generally use the most recent stable tools from
+ the FSF. Currently we use gettext 0.11.5, autoconf 2.58, and
+ automake 1.7.9. You may see warnings or errors with other versions,
+ particularly with autoconf < 2.54.
+
+
+1) Run the configure script to initialize variables and create a Makefile, etc.
+
+ ./configure --prefix=BASEDIRECTORY --with-nagios-user=SOMEUSER --with-nagios-group=SOMEGROUP --with-cgiurl=SOMEURL
+
+ a) Replace BASEDIRECTORY with the path of the directory under which Nagios
+ is installed (default is '/usr/local/nagios')
+ b) Replace SOMEUSER with the name of a user on your system that will be
+ assigned permissions to the installed plugins (default is 'nagios')
+ c) Replace SOMEGRP with the name of a group on your system that will be
+ assigned permissions to the installed plugins (default is 'nagios')
+ d) Replace CGIURL with the path used to access the Nagios CGIs with
+ a web browser (default is '/nagios/cgi-bin')
+
+
+2) Compile the plugins with the following command:
+
+ make
+
+
+3) 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.
+
+
+4) Verify that your host configuration file (hosts.cfg) for Nagios contains
+ the correct paths to the new plugins.
+
+
+
+That's it. If you have any problems or questions, feel free send mail
+to nagios-users@lists.sourceforge.net or nagiosplug-help@lists.sourceforge.net
+
+
+
+
--
Karl DeBisschop (kdebisschop@users.sourceforge.net)