diff options
Diffstat (limited to 'README')
-rw-r--r-- | README | 65 |
1 files changed, 60 insertions, 5 deletions
@@ -1,10 +1,11 @@ | |||
1 | Nagios Plugins README | 1 | Nagios Plugins README |
2 | --------------------- | 2 | --------------------- |
3 | 3 | ||
4 | * For instructions on installing these plugins for use with Nagios, read | 4 | * For instructions on installing these plugins for use with Nagios, |
5 | the INSTALL file. | 5 | see below. In addition, generic instructions for the GNU toolchain |
6 | can be found in the INSTALL file. | ||
6 | 7 | ||
7 | * For information on what changes have been made or plugin have been added, | 8 | * For information on what changes have been made or plugins have been added, |
8 | read the Changelog file. | 9 | read the Changelog file. |
9 | 10 | ||
10 | * Some plugins require that you have additional programs and/or | 11 | * Some plugins require that you have additional programs and/or |
@@ -14,7 +15,7 @@ Nagios Plugins README | |||
14 | 15 | ||
15 | * Individual plugins are self documenting. All plugins that comply with | 16 | * Individual plugins are self documenting. All plugins that comply with |
16 | the basic guidelines for development will provide detailed help when | 17 | the basic guidelines for development will provide detailed help when |
17 | invoked with the '-h' option ('--help' also, if long options are enabled). | 18 | invoked with the '-h' or '--help' options. |
18 | 19 | ||
19 | * The file command.cfg contains example configurations for many of the | 20 | * The file command.cfg contains example configurations for many of the |
20 | plugins | 21 | plugins |
@@ -37,6 +38,60 @@ patch tool from the summary page). Patches should be relative to the current | |||
37 | CVS head (development), or to the head of the current stable branch. Also, | 38 | CVS head (development), or to the head of the current stable branch. Also, |
38 | please include version information for your OS and the plugin(s) your are | 39 | please include version information for your OS and the plugin(s) your are |
39 | patching/reporting. | 40 | patching/reporting. |
40 | 41 | ||
42 | |||
43 | |||
44 | |||
45 | Nagios Plugins Quick-and-Dirty Installation Instructions | ||
46 | -------------------------------------------------------- | ||
47 | |||
48 | 0) If using the CVS tree, you need m4, gettext, automake, and autoconf. To | ||
49 | start out, run ./tools/setup | ||
50 | |||
51 | For development, we generally use the most recent stable tools from | ||
52 | the FSF. Currently we use gettext 0.11.5, autoconf 2.57, and | ||
53 | automake 1.76. No other versions are tested, and you may see | ||
54 | warnings or errors with other versions. | ||
55 | |||
56 | |||
57 | 1) Run the configure script to initialize variables and create a Makefile, etc. | ||
58 | |||
59 | ./configure --prefix=BASEDIRECTORY --with-nagios-user=SOMEUSER --with-nagios-group=SOMEGROUP --with-cgiurl=SOMEURL | ||
60 | |||
61 | a) Replace BASEDIRECTORY with the path of the directory under which Nagios | ||
62 | is installed (default is '/usr/local/nagios') | ||
63 | b) Replace SOMEUSER with the name of a user on your system that will be | ||
64 | assigned permissions to the installed plugins (default is 'nagios') | ||
65 | c) Replace SOMEGRP with the name of a group on your system that will be | ||
66 | assigned permissions to the installed plugins (default is 'nagios') | ||
67 | d) Replace CGIURL with the path used to access the Nagios CGIs with | ||
68 | a web browser (default is '/nagios/cgi-bin') | ||
69 | |||
70 | |||
71 | 2) Compile the plugins with the following command: | ||
72 | |||
73 | make | ||
74 | |||
75 | |||
76 | 3) Install the compiled plugins and plugin scripts with the following command: | ||
77 | |||
78 | make install | ||
79 | |||
80 | The installation procedure will attempt to place the plugins in a | ||
81 | 'libexec/' subdirectory in the base directory you specified with | ||
82 | the --prefix argument to the configure script. | ||
83 | |||
84 | |||
85 | 4) Verify that your host configuration file (hosts.cfg) for Nagios contains | ||
86 | the correct paths to the new plugins. | ||
87 | |||
88 | |||
89 | |||
90 | That's it. If you have any problems or questions, feel free send mail | ||
91 | to nagios-users@lists.sourceforge.net or nagiosplug-help@lists.sourceforge.net | ||
92 | |||
93 | |||
94 | |||
95 | |||
41 | -- | 96 | -- |
42 | Karl DeBisschop (kdebisschop@users.sourceforge.net) | 97 | Karl DeBisschop (kdebisschop@users.sourceforge.net) |