diff options
Diffstat (limited to 'README')
| -rw-r--r-- | README | 65 |
1 files changed, 60 insertions, 5 deletions
| @@ -1,10 +1,11 @@ | |||
| 1 | Nagios Plugins README | 1 | Nagios Plugins README |
| 2 | --------------------- | 2 | --------------------- |
| 3 | 3 | ||
| 4 | * For instructions on installing these plugins for use with Nagios, read | 4 | * For instructions on installing these plugins for use with Nagios, |
| 5 | the INSTALL file. | 5 | see below. In addition, generic instructions for the GNU toolchain |
| 6 | can be found in the INSTALL file. | ||
| 6 | 7 | ||
| 7 | * For information on what changes have been made or plugin have been added, | 8 | * For information on what changes have been made or plugins have been added, |
| 8 | read the Changelog file. | 9 | read the Changelog file. |
| 9 | 10 | ||
| 10 | * Some plugins require that you have additional programs and/or | 11 | * Some plugins require that you have additional programs and/or |
| @@ -14,7 +15,7 @@ Nagios Plugins README | |||
| 14 | 15 | ||
| 15 | * Individual plugins are self documenting. All plugins that comply with | 16 | * Individual plugins are self documenting. All plugins that comply with |
| 16 | the basic guidelines for development will provide detailed help when | 17 | the basic guidelines for development will provide detailed help when |
| 17 | invoked with the '-h' option ('--help' also, if long options are enabled). | 18 | invoked with the '-h' or '--help' options. |
| 18 | 19 | ||
| 19 | * The file command.cfg contains example configurations for many of the | 20 | * The file command.cfg contains example configurations for many of the |
| 20 | plugins | 21 | plugins |
| @@ -37,6 +38,60 @@ patch tool from the summary page). Patches should be relative to the current | |||
| 37 | CVS head (development), or to the head of the current stable branch. Also, | 38 | CVS head (development), or to the head of the current stable branch. Also, |
| 38 | please include version information for your OS and the plugin(s) your are | 39 | please include version information for your OS and the plugin(s) your are |
| 39 | patching/reporting. | 40 | patching/reporting. |
| 40 | 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 | |||
| 41 | -- | 96 | -- |
| 42 | Karl DeBisschop (kdebisschop@users.sourceforge.net) | 97 | Karl DeBisschop (kdebisschop@users.sourceforge.net) |
