README 3.0 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990
  1. Nagios Plugins
  2. ==============
  3. * For instructions on installing these plugins for use with Nagios,
  4. see below. In addition, generic instructions for the GNU toolchain can be
  5. found in the `INSTALL` file.
  6. * For major changes between releases, read the `NEWS` file.
  7. * For information on detailed changes that have been made or plugins
  8. that have been added, read the `ChangeLog` file.
  9. * Some plugins require that you have additional programs and/or
  10. libraries installed on your system before they can be used. Plugins that
  11. are dependent on other programs/libraries that are missing are usually not
  12. compiled. Read the `REQUIREMENTS` file for more information.
  13. * Individual plugins are self-documenting. All plugins that comply with
  14. the basic guidelines for development will provide detailed help when
  15. invoked with the `-h` or `--help` options.
  16. You can check for the latest plugins at:
  17. * <https://www.nagios-plugins.org/>
  18. Send an email to <nagiosplug-help@lists.sourceforge.net> for assistance.
  19. Please include the OS type and version that you are using. Also, run the
  20. plugin with the `-vvv` option and provide the resulting version information.
  21. Of course, there may be additional diagnostic information required as well.
  22. Use good judgment.
  23. Send an email to <nagiosplug-devel@lists.sourceforge.net> for developer
  24. discussions.
  25. For patch submissions and bug reports, please use the appropriate resources
  26. at <https://github.com/nagios-plugins/nagios-plugins>.
  27. Installation Instructions
  28. -------------------------
  29. 1. If you are using the Git tree, you will need m4, gettext, automake, and
  30. autoconf. To start out, run:
  31. ./tools/setup
  32. For more detail, see the developer guidelines at
  33. <https://www.nagios-plugins.org/doc/guidelines.html>.
  34. 2. Run the configure script to initialize variables and create a Makefile,
  35. etc.
  36. ./configure --prefix=BASEDIRECTORY --with-cgiurl=SOMEURL
  37. Replace `BASEDIRECTORY` with the path of the directory under which Nagios
  38. is installed (default is `/usr/local/nagios`), and replace `SOMEURL` with
  39. the path used to access the Nagios CGIs with a web browser (default is
  40. `/nagios/cgi-bin`).
  41. 3. Compile the plugins with the following command:
  42. make
  43. 4. Install the compiled plugins and plugin scripts with the following
  44. command:
  45. make install
  46. The installation procedure will attempt to place the plugins in a
  47. `libexec/` subdirectory in the base directory you specified with the
  48. `--prefix` argument to the configure script.
  49. 5. There are some plugins that require setuid. If you run make install as
  50. a non-root user, they will not be installed. To install, switch to root
  51. and run:
  52. make install-root
  53. That's it! If you have any problems or questions, feel free to send an
  54. email to <nagiosplug-help@lists.sourceforge.net>.
  55. License Stuff
  56. -------------
  57. This software is released under the GNU General Public License, Version 3,
  58. with the additional exemption that compiling, linking and/or using OpenSSL
  59. is allowed.
  60. See the `COPYING` file for the complete GPLv3 text.