summaryrefslogtreecommitdiffstats
path: root/README
blob: ae8801cd6cf97b85eb254060bc66080212b41c17 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
Nagios Plugins README
=====================

* For instructions on installing these plugins for use with Nagios,
  see below.  In addition, generic instructions for the GNU toolchain can be
  found in the `INSTALL` file.

* For major changes between releases, read the `NEWS` file.

* For information on detailed changes that have been made or plugins
  that have been added, read the `ChangeLog` file.

* Some plugins require that you have additional programs and/or
  libraries installed on your system before they can be used.  Plugins that
  are dependent on other programs/libraries that are missing are usually not
  compiled.  Read the `REQUIREMENTS` file for more information.

* For a list of outstanding bugs for this release, see the `BUGS` file.

* Individual plugins are self documenting.  All plugins that comply with
  the basic guidelines for development will provide detailed help when
  invoked with the `-h` or `--help` options.

You can check for the latest plugins at:

* <https://sourceforge.net/projects/nagiosplug/>

Send an email to <nagiosplug-help@lists.sourceforge.net> for assistance.
Please include the OS type and version that you are using.  Also, run the
plugin with the `-vvv` option and provide the resulting version information.
Of course, there may be additional diagnostic information required as well.
Use good judgment.

Send an email to <nagiosplug-devel@lists.sourceforge.net> for developer
discussions.

For patch submissions and bug reports, please use the appropriate resources
at <https://github.com/nagios-plugins/nagios-plugins>.


Installation Instructions
-------------------------

1.  If you are using the Git tree, you will need m4, gettext, automake, and
    autoconf.  To start out, run:

	./tools/setup

    For more detail, see the developer guidelines at
    <http://nagiosplug.sourceforge.net/developer-guidelines.html>.

2.  Run the configure script to initialize variables and create a Makefile,
    etc.

	./configure --prefix=BASEDIRECTORY --with-cgiurl=SOMEURL

    * Replace `BASEDIRECTORY` with the path of the directory under which
      Nagios is installed (default is `/usr/local/nagios`).
    * Replace `CGIURL` with the path used to access the Nagios CGIs with a
      web browser (default is `/nagios/cgi-bin`).

3.  Compile the plugins with the following command:

	make

4.  Install the compiled plugins and plugin scripts with the following
    command:

	make install

    The installation procedure will attempt to place the plugins in a
    `libexec/` subdirectory in the base directory you specified with the
    `--prefix` argument to the configure script.

5.  There are some plugins that require setuid.  If you run make install as
    a non-root user, they will not be installed.  To install, switch to root
    and run:

	make install-root

That's it!  If you have any problems or questions, feel free to send an
email to <nagiosplug-help@lists.sourceforge.net>.


License Stuff
-------------

This software is released under the GNU General Public License, Version 3,
with the additional exemption that compiling, linking and/or using OpenSSL
is allowed.

See the `COPYING` file for the complete GPLv3 text.


-- 
Nagios Plugins Development Team