summaryrefslogtreecommitdiffstats
path: root/FAQ
diff options
context:
space:
mode:
Diffstat (limited to 'FAQ')
-rw-r--r--FAQ81
1 files changed, 81 insertions, 0 deletions
diff --git a/FAQ b/FAQ
new file mode 100644
index 0000000..5d59a41
--- /dev/null
+++ b/FAQ
@@ -0,0 +1,81 @@
1Frequently Asked Questions
2**************************
3
41. Q: Where can I find documentation for <insert name> plugin?
5
6 A: All plugins that comply with minimal development guideline for
7 this project include internal documentation. The documentation
8 can be read executing plugin with the '-h' option ('--help' if
9 long options are enabled). If the '-h' option does not work, that
10 is a bug.
11
122. Q: What version of <insert name> plugin am I running?
13
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:
17
18 check_radius (nagios-plugins 1.3.0-alpha1) 1.11
19
20 Note that this string include both the assigned package release
21 name and the CVS-generated revision for the individual plugin.
22 Authors hould strictly adhere to this format. All bug reports
23 and help requests should reference this information.
24
253. Q: What information do I need to include when asking for help or
26 submitting a bug report?
27
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
324. Q: I'm using Redhat Linux (or some other RPM-based distribution).
33 Which packages should I install?
34
35 A: The package nagios-plugins-<version>.<arch>.rpm contains only
36 those plugins that should work on any POSIX compliant system. In
37 other words, you should be able to install this package on your
38 system, no matter what else is or in not installed.
39
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
485. Q: My sysem uses the .deb package format. What pacakges should I
49 install?
50
51 A: We strive for cooperation between all packagers and developers.
52 The answers for .deb are the same as for RPM, afetr changing the
53 package name suffixes accordingly.
54
556. Q: I prefer to build my own RPMs. Do I need to install all of the
56 various dependencies?
57
58 A: Beginning with the 1.2.9-1 release, you may run
59
60 rpm --define 'custom 1' -ta nagios-plugins-<release>.tar.gz
61
62 In prior releases, you must unpack the tarball and build the
63 RPM using nagios-custom.spec with 'rpm -ba'.
64
657. Q: I get an error like
66
67 Warning: Return code of 127 for check of service 'PING' on host 'anyhost' was out of bounds.
68
69 when I run Nagios. (Often check_ping runs just fine on the
70 command line).
71
72 A: Commonly, system adminitartors will make security as tight as
73 possible on the monitoring system. Sometimes this includes OS
74 options or hardening scripts that prevent unpriveleged users from
75 running the ping command. Nagios runs with no more priveleges
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
81