diff options
| -rw-r--r-- | FAQ | 128 | ||||
| -rw-r--r-- | INSTALLING | 52 | ||||
| -rw-r--r-- | NEWS | 1 | ||||
| -rw-r--r-- | README | 8 | ||||
| -rw-r--r-- | plugins-root/Makefile.am | 2 | 
5 files changed, 71 insertions, 120 deletions
| @@ -1,87 +1,93 @@ | |||
| 1 | Frequently Asked Questions | 1 | Frequently Asked Questions | 
| 2 | ************************** | 2 | ************************** | 
| 3 | 3 | ||
| 4 | 1. Q: Where can I find documentation for <insert name> plugin? | 4 | Q: Where can I find documentation for <insert name> plugin? | 
| 5 | 5 | ||
| 6 | A: All plugins that comply with minimal development guideline for | 6 | A: All plugins that comply with minimal development guideline for | 
| 7 | this project include internal documentation. The documentation | 7 | this project include internal documentation. The documentation | 
| 8 | can be read executing plugin with the '-h' option ('--help' if | 8 | can be read executing plugin with the -h or --help option. If | 
| 9 | long options are enabled). If the '-h' option does not work, that | 9 | the '-h' option does not work, that is a bug. | 
| 10 | is a bug. | ||
| 11 | 10 | ||
| 12 | 2. Q: What version of <insert name> plugin am I running? | ||
| 13 | 11 | ||
| 14 | A: All plugins that comply with minimal development guideline for | 12 | Q: What version of <insert name> plugin am I running? | 
| 15 | this project include detailed version information. When executed | ||
| 16 | with the '-V' option, a version string will be printed: | ||
| 17 | 13 | ||
| 18 | check_radius (nagios-plugins 1.3.0-alpha1) 1.11 | 14 | A: All plugins that comply with minimal development guideline for | 
| 15 | this project include detailed version information. When executed | ||
| 16 | with the '-V' option, a version string will be printed: | ||
| 19 | 17 | ||
| 20 | Note that this string include both the assigned package release | 18 | check_radius (nagios-plugins 1.3.0-alpha1) 1.11 | 
| 21 | name and the CVS-generated revision for the individual plugin. | ||
| 22 | Authors should strictly adhere to this format. All bug reports | ||
| 23 | and help requests should reference this information. | ||
| 24 | 19 | ||
| 25 | 3. Q: What information do I need to include when asking for help or | 20 | Note that this string include both the assigned package release | 
| 26 | submitting a bug report? | 21 | name and the CVS-generated revision for the individual plugin. | 
| 22 | Authors should strictly adhere to this format. All bug reports | ||
| 23 | and help requests should reference this information. | ||
| 27 | 24 | ||
| 28 | A: At a minimum, the output from 'uname -a' and the version string | ||
| 29 | from '<plugin_name> -V' and, of course, a description of the | ||
| 30 | problem and any solution/patch. | ||
| 31 | 25 | ||
| 32 | 4. Q: I'm using Redhat Linux (or some other RPM-based distribution). | 26 | Q: What information do I need to include when asking for help or | 
| 33 | Which packages should I install? | 27 | submitting a bug report? | 
| 34 | 28 | ||
| 35 | A: The package nagios-plugins-<version>.<arch>.rpm contains only | 29 | A: At a minimum, the output from 'uname -a' and the version string | 
| 36 | those plugins that should work on any POSIX compliant system. In | 30 | from '<plugin_name> -V' and, of course, a description of the | 
| 37 | other words, you should be able to install this package on your | 31 | problem and any solution/patch. | 
| 38 | system, no matter what else is or in not installed. | ||
| 39 | 32 | ||
| 40 | However, most of us have more complex systems than barebones | ||
| 41 | POSIX. We tried creating a variety of separate packages so | ||
| 42 | each dependency could be installed cleanly, but many people | ||
| 43 | found that this resulted in too many packages. So in the end, | ||
| 44 | all the non-POSIX plugins were folded into one RPM | ||
| 45 | (nagios-plugins-<version>.<arch>.rpm). Most people will need to | ||
| 46 | use RPM's '--nodeps' option to install this package. | ||
| 47 | 33 | ||
| 48 | 5. Q: My system uses the .deb package format. What packages should I | 34 | Q: I'm using Redhat Linux (or some other RPM-based distribution). | 
| 49 | install? | 35 | Which packages should I install? | 
| 50 | 36 | ||
| 51 | A: We strive for cooperation between all packagers and developers. | 37 | A: The package nagios-plugins-<version>.<arch>.rpm contains only | 
| 52 | The answers for .deb are the same as for RPM, after changing the | 38 | those plugins that should work on any POSIX compliant system. In | 
| 53 | package name suffixes accordingly. | 39 | other words, you should be able to install this package on your | 
| 40 | system, no matter what else is or in not installed. | ||
| 54 | 41 | ||
| 55 | 6. Q: I prefer to build my own RPMs. Do I need to install all of the | 42 | However, most of us have more complex systems than barebones | 
| 56 | various dependencies? | 43 | POSIX. We tried creating a variety of separate packages so | 
| 44 | each dependency could be installed cleanly, but many people | ||
| 45 | found that this resulted in too many packages. So in the end, | ||
| 46 | all the non-POSIX plugins were folded into one RPM | ||
| 47 | (nagios-plugins-<version>.<arch>.rpm). Most people will need to | ||
| 48 | use RPM's '--nodeps' option to install this package. | ||
| 57 | 49 | ||
| 58 | A: Beginning with the 1.2.9-1 release, you may run | ||
| 59 | 50 | ||
| 60 | rpm --define 'custom 1' -ta nagios-plugins-<release>.tar.gz | 51 | Q: My system uses the .deb package format. What packages should I | 
| 52 | install? | ||
| 61 | 53 | ||
| 62 | In prior releases, you must unpack the tarball and build the | 54 | A: We strive for cooperation between all packagers and developers. | 
| 63 | RPM using nagios-custom.spec with 'rpm -ba'. | 55 | The answers for .deb are the same as for RPM, after changing the | 
| 56 | package name suffixes accordingly. | ||
| 64 | 57 | ||
| 65 | 7. Q: I get an error like | ||
| 66 | 58 | ||
| 67 | Warning: Return code of 127 for check of service 'PING' on host 'anyhost' was out of bounds. | 59 | Q: I prefer to build my own RPMs. Do I need to install all of the | 
| 60 | various dependencies? | ||
| 68 | 61 | ||
| 69 | when I run Nagios. (Often check_ping runs just fine on the | 62 | A: Beginning with the 1.2.9-1 release, you may run | 
| 70 | command line). | ||
| 71 | 63 | ||
| 72 | A: Commonly, system administrators will make security as tight as | 64 | rpm --define 'custom 1' -ta nagios-plugins-<release>.tar.gz | 
| 73 | possible on the monitoring system. Sometimes this includes OS | ||
| 74 | options or hardening scripts that prevent unprivileged users from | ||
| 75 | running the ping command. Nagios runs with no more privileges | ||
| 76 | than 'nobody' -- check to be sure that the nagios user can | ||
| 77 | actually run check ping. (This can also happen with other binaries | ||
| 78 | executed by nagios, but ping seems to be far and away the biggest | ||
| 79 | offender.) | ||
| 80 | 65 | ||
| 81 | 8. Q: I have a plugin to offer. What do I do to get it accepted? | 66 | In prior releases, you must unpack the tarball and build the | 
| 67 | RPM using nagios-custom.spec with 'rpm -ba'. | ||
| 82 | 68 | ||
| 83 | A: Send it to nagiosplug-devel@lists.sourceforge.net. Usually, we | ||
| 84 | just drop it into contrib until we have a chance to check if the | ||
| 85 | standard options are used, etc. | ||
| 86 | 69 | ||
| 87 | You can also get feedback on improving the plugin via the mailing list. | 70 | Q: I get an error like | 
| 71 | |||
| 72 | Warning: Return code of 127 for check of service 'PING' on host 'anyhost' was out of bounds. | ||
| 73 | |||
| 74 | when I run Nagios. (Often check_ping runs just fine on the | ||
| 75 | command line). | ||
| 76 | |||
| 77 | A: Commonly, system administrators will make security as tight as | ||
| 78 | possible on the monitoring system. Sometimes this includes OS | ||
| 79 | options or hardening scripts that prevent unprivileged users from | ||
| 80 | running the ping command. Nagios runs with no more privileges | ||
| 81 | than 'nobody' -- check to be sure that the nagios user can | ||
| 82 | actually run check ping. (This can also happen with other binaries | ||
| 83 | executed by nagios, but ping seems to be far and away the biggest | ||
| 84 | offender.) | ||
| 85 | |||
| 86 | |||
| 87 | Q: I have a plugin to offer. What can I do? | ||
| 88 | |||
| 89 | A: You can make it available on NagiosExchange (http://nagiosexchange.org) | ||
| 90 | where other people can find it for use. | ||
| 91 | |||
| 92 | You can also get feedback on improving the plugin via the | ||
| 93 | nagiosplug-devel@lists.sourceforge.net mailing list. | ||
| diff --git a/INSTALLING b/INSTALLING deleted file mode 100644 index 019feb4c..00000000 --- a/INSTALLING +++ /dev/null | |||
| @@ -1,52 +0,0 @@ | |||
| 1 | Nagios Plugins Quick-and-Dirty Installation Instructions | ||
| 2 | -------------------------------------------------------- | ||
| 3 | |||
| 4 | 0) If using the CVS tree, you need: | ||
| 5 | gnu make 3.79 | ||
| 6 | automake 1.9.2 | ||
| 7 | autoconf 2.58 | ||
| 8 | |||
| 9 | To start out, run: | ||
| 10 | tools/setup | ||
| 11 | |||
| 12 | 1) Run the configure script to initialize variables and create a Makefile, etc. | ||
| 13 | ./configure --prefix=BASEDIRECTORY --with-cgiurl=SOMEURL | ||
| 14 | |||
| 15 | a) Replace BASEDIRECTORY with the path of the directory under which Nagios | ||
| 16 | is installed (default is '/usr/local/nagios') | ||
| 17 | b) Replace CGIURL with the path used to access the Nagios CGIs with | ||
| 18 | a web browser (default is '/nagios/cgi-bin') | ||
| 19 | |||
| 20 | |||
| 21 | 2) Compile the plugins with the following command: | ||
| 22 | make all | ||
| 23 | |||
| 24 | |||
| 25 | 3) Test the plugins: | ||
| 26 | make test | ||
| 27 | |||
| 28 | You will need to answer questions on servers that can be used for testing. If | ||
| 29 | you need to edit any values, edit the file /var/tmp/NPTest.cache | ||
| 30 | |||
| 31 | |||
| 32 | 4) Install the compiled plugins and plugin scripts with the following command: | ||
| 33 | make install | ||
| 34 | |||
| 35 | NOTE: | ||
| 36 | The installation procedure will attempt to place the plugins in a | ||
| 37 | 'libexec/' subdirectory in the base directory you specified with | ||
| 38 | the --prefix argument to the configure script. | ||
| 39 | |||
| 40 | |||
| 41 | 5) Verify that your host configuration file (hosts.cfg) for Nagios contains | ||
| 42 | the correct paths to the new plugins. | ||
| 43 | |||
| 44 | |||
| 45 | |||
| 46 | That's it. If you have any problems or questions, feel free send mail | ||
| 47 | to nagios-users@lists.sourceforge.net or nagiosplug-help@lists.sourceforge.net | ||
| 48 | |||
| 49 | Please send patches and bugs to nagiosplug-devel@lists.sourceforge.net and | ||
| 50 | post them on http://sourceforge.net/projects/nagiosplug. | ||
| 51 | |||
| 52 | |||
| @@ -2,6 +2,7 @@ This file documents the major additions and syntax changes between releases. | |||
| 2 | 2 | ||
| 3 | ?? ?? | 3 | ?? ?? | 
| 4 | Fixed MKINSTALLDIRS problem in po/ | 4 | Fixed MKINSTALLDIRS problem in po/ | 
| 5 | Root plugins installed with world executable | ||
| 5 | check_sybase from contrib now maintained in NagiosExchange | 6 | check_sybase from contrib now maintained in NagiosExchange | 
| 6 | 7 | ||
| 7 | 1.4.6 5th February 2007 | 8 | 1.4.6 5th February 2007 | 
| @@ -60,15 +60,11 @@ Nagios Plugins Quick-and-Dirty Installation Instructions | |||
| 60 | 60 | ||
| 61 | 1) Run the configure script to initialize variables and create a Makefile, etc. | 61 | 1) Run the configure script to initialize variables and create a Makefile, etc. | 
| 62 | 62 | ||
| 63 | ./configure --prefix=BASEDIRECTORY --with-nagios-user=SOMEUSER --with-nagios-group=SOMEGROUP --with-cgiurl=SOMEURL | 63 | ./configure --prefix=BASEDIRECTORY --with-cgiurl=SOMEURL | 
| 64 | 64 | ||
| 65 | a) Replace BASEDIRECTORY with the path of the directory under which Nagios | 65 | a) Replace BASEDIRECTORY with the path of the directory under which Nagios | 
| 66 | is installed (default is '/usr/local/nagios') | 66 | is installed (default is '/usr/local/nagios') | 
| 67 | b) Replace SOMEUSER with the name of a user on your system that will be | 67 | b) Replace CGIURL with the path used to access the Nagios CGIs with | 
| 68 | assigned permissions to the installed plugins (default is 'nagios') | ||
| 69 | c) Replace SOMEGRP with the name of a group on your system that will be | ||
| 70 | assigned permissions to the installed plugins (default is 'nagios') | ||
| 71 | d) Replace CGIURL with the path used to access the Nagios CGIs with | ||
| 72 | a web browser (default is '/nagios/cgi-bin') | 68 | a web browser (default is '/nagios/cgi-bin') | 
| 73 | 69 | ||
| 74 | 70 | ||
| diff --git a/plugins-root/Makefile.am b/plugins-root/Makefile.am index d2e4e8bd..a36e120a 100644 --- a/plugins-root/Makefile.am +++ b/plugins-root/Makefile.am | |||
| @@ -26,7 +26,7 @@ TESTS = @PLUGIN_TEST@ | |||
| 26 | test: | 26 | test: | 
| 27 | perl -I $(top_builddir) -I $(top_srcdir) ../test.pl | 27 | perl -I $(top_builddir) -I $(top_srcdir) ../test.pl | 
| 28 | 28 | ||
| 29 | setuid_root_mode = 4550 | 29 | setuid_root_mode = a=rx,u+s | 
| 30 | 30 | ||
| 31 | # /* Author Coreutils team - see ACKNOWLEDGEMENTS */ | 31 | # /* Author Coreutils team - see ACKNOWLEDGEMENTS */ | 
| 32 | 32 | ||
