aboutsummaryrefslogtreecommitdiff
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 00000000..5d59a412
--- /dev/null
+++ b/FAQ
@@ -0,0 +1,81 @@
+Frequently Asked Questions
+**************************
+
+1. Q: Where can I find documentation for <insert name> plugin?
+
+ A: All plugins that comply with minimal development guideline for
+ this project include internal documentation. The documentation
+ can be read executing plugin with the '-h' option ('--help' if
+ long options are enabled). If the '-h' option does not work, that
+ is a bug.
+
+2. Q: What version of <insert name> plugin am I running?
+
+ A: All plugins that comply with minimal development guideline for
+ this project include detailed version information. When executed
+ with the '-V' option, a version string will be printed:
+
+ check_radius (nagios-plugins 1.3.0-alpha1) 1.11
+
+ Note that this string include both the assigned package release
+ name and the CVS-generated revision for the individual plugin.
+ Authors hould strictly adhere to this format. All bug reports
+ and help requests should reference this information.
+
+3. Q: What information do I need to include when asking for help or
+ submitting a bug report?
+
+ A: At a minimum, the output from 'uname -a' and the version string
+ from '<plugin_name> -V' and, of course, a description of the
+ problem and any solution/patch.
+
+4. Q: I'm using Redhat Linux (or some other RPM-based distribution).
+ Which packages should I install?
+
+ A: The package nagios-plugins-<version>.<arch>.rpm contains only
+ those plugins that should work on any POSIX compliant system. In
+ other words, you should be able to install this package on your
+ system, no matter what else is or in not installed.
+
+ However, most of us have more complex systems than barebones
+ POSIX. We tried creating a variety of separate packages so
+ each dependency could be installed cleanly, but many people
+ found that this resulted in too many packages. So in the end,
+ all the non-POSIX plugins were folded into one RPM
+ (nagios-plugins-<version>.<arch>.rpm). Most people will need to
+ use RPM's '--nodeps' option to install this package.
+
+5. Q: My sysem uses the .deb package format. What pacakges should I
+ install?
+
+ A: We strive for cooperation between all packagers and developers.
+ The answers for .deb are the same as for RPM, afetr changing the
+ package name suffixes accordingly.
+
+6. Q: I prefer to build my own RPMs. Do I need to install all of the
+ various dependencies?
+
+ A: Beginning with the 1.2.9-1 release, you may run
+
+ rpm --define 'custom 1' -ta nagios-plugins-<release>.tar.gz
+
+ In prior releases, you must unpack the tarball and build the
+ RPM using nagios-custom.spec with 'rpm -ba'.
+
+7. Q: I get an error like
+
+ Warning: Return code of 127 for check of service 'PING' on host 'anyhost' was out of bounds.
+
+ when I run Nagios. (Often check_ping runs just fine on the
+ command line).
+
+ A: Commonly, system adminitartors will make security as tight as
+ possible on the monitoring system. Sometimes this includes OS
+ options or hardening scripts that prevent unpriveleged users from
+ running the ping command. Nagios runs with no more priveleges
+ than 'nobody' -- check to be sure that the nagios user can
+ actually run check ping. (This can also happen with other binaries
+ executed by nagios, but ping seems to be far and away the biggest
+ offender.)
+
+