summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--FAQ128
-rw-r--r--INSTALLING52
-rw-r--r--NEWS1
-rw-r--r--README8
-rw-r--r--plugins-root/Makefile.am2
5 files changed, 71 insertions, 120 deletions
diff --git a/FAQ b/FAQ
index 370ac99..5ba948f 100644
--- a/FAQ
+++ b/FAQ
@@ -1,87 +1,93 @@
1Frequently Asked Questions 1Frequently Asked Questions
2************************** 2**************************
3 3
41. Q: Where can I find documentation for <insert name> plugin? 4Q: Where can I find documentation for <insert name> plugin?
5 5
6 A: All plugins that comply with minimal development guideline for 6A: 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
122. Q: What version of <insert name> plugin am I running?
13 11
14 A: All plugins that comply with minimal development guideline for 12Q: 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 14A: 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
253. 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
324. Q: I'm using Redhat Linux (or some other RPM-based distribution). 26Q: 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 29A: 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
485. Q: My system uses the .deb package format. What packages should I 34Q: 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. 37A: 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
556. 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 51Q: 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 54A: 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
657. 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. 59Q: 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 62A: 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
818. 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. 70Q: 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
77A: 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
87Q: I have a plugin to offer. What can I do?
88
89A: 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 019feb4..0000000
--- a/INSTALLING
+++ /dev/null
@@ -1,52 +0,0 @@
1Nagios Plugins Quick-and-Dirty Installation Instructions
2--------------------------------------------------------
3
40) 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
121) 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
212) Compile the plugins with the following command:
22 make all
23
24
253) 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
324) 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
415) Verify that your host configuration file (hosts.cfg) for Nagios contains
42 the correct paths to the new plugins.
43
44
45
46That's it. If you have any problems or questions, feel free send mail
47to nagios-users@lists.sourceforge.net or nagiosplug-help@lists.sourceforge.net
48
49Please send patches and bugs to nagiosplug-devel@lists.sourceforge.net and
50post them on http://sourceforge.net/projects/nagiosplug.
51
52
diff --git a/NEWS b/NEWS
index dafdaee..67b6877 100644
--- a/NEWS
+++ b/NEWS
@@ -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
71.4.6 5th February 2007 81.4.6 5th February 2007
diff --git a/README b/README
index 13b46a2..b06d5b5 100644
--- a/README
+++ b/README
@@ -60,15 +60,11 @@ Nagios Plugins Quick-and-Dirty Installation Instructions
60 60
611) Run the configure script to initialize variables and create a Makefile, etc. 611) 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 d2e4e8b..a36e120 100644
--- a/plugins-root/Makefile.am
+++ b/plugins-root/Makefile.am
@@ -26,7 +26,7 @@ TESTS = @PLUGIN_TEST@
26test: 26test:
27 perl -I $(top_builddir) -I $(top_srcdir) ../test.pl 27 perl -I $(top_builddir) -I $(top_srcdir) ../test.pl
28 28
29setuid_root_mode = 4550 29setuid_root_mode = a=rx,u+s
30 30
31# /* Author Coreutils team - see ACKNOWLEDGEMENTS */ 31# /* Author Coreutils team - see ACKNOWLEDGEMENTS */
32 32