summaryrefslogtreecommitdiffstats
path: root/web/input/doc
diff options
context:
space:
mode:
authorHolger Weiss <holger@zedat.fu-berlin.de>2014-07-14 20:12:06 (GMT)
committerHolger Weiss <holger@zedat.fu-berlin.de>2014-07-14 20:12:06 (GMT)
commitad54725251f8dba95177d5aa481e515dd3c16878 (patch)
tree2aff1ff7e2cfd4f61812f456ca6ed38207c6812c /web/input/doc
parent6695456328ce5b807138db491bb9b3bd0caf9545 (diff)
downloadsite-ad54725251f8dba95177d5aa481e515dd3c16878.tar.gz
Add FAQ item for migration to Monitoring Plugins
Document the migration from the Nagios Plugins to the Monitoring Plugins.
Diffstat (limited to 'web/input/doc')
-rw-r--r--web/input/doc/faq/index.md2
-rw-r--r--web/input/doc/faq/migration.md45
2 files changed, 47 insertions, 0 deletions
diff --git a/web/input/doc/faq/index.md b/web/input/doc/faq/index.md
index bd60afa..c09206a 100644
--- a/web/input/doc/faq/index.md
+++ b/web/input/doc/faq/index.md
@@ -27,6 +27,7 @@ Plugins.
27## Installing 27## Installing
28 28
29* [How do I install the plugins?][installation] 29* [How do I install the plugins?][installation]
30* [How do I migrate to Monitoring Plugins?][migration]
30* [Why aren't the root plugins installed?][root-plugins] 31* [Why aren't the root plugins installed?][root-plugins]
31* [Which user owns the installed plugins?][ownership] 32* [Which user owns the installed plugins?][ownership]
32* [Shouldn't I use a binary package instead?][packages] 33* [Shouldn't I use a binary package instead?][packages]
@@ -56,6 +57,7 @@ Plugins.
56[mixing-compilers]: doc/faq/mixing-compilers.html 57[mixing-compilers]: doc/faq/mixing-compilers.html
57[ps-on-solaris]: doc/faq/ps-on-solaris.html 58[ps-on-solaris]: doc/faq/ps-on-solaris.html
58[installation]: doc/faq/installation.html 59[installation]: doc/faq/installation.html
60[migration]: doc/faq/migration.html
59[root-plugins]: doc/faq/root-plugins.html 61[root-plugins]: doc/faq/root-plugins.html
60[ownership]: doc/faq/ownership.html 62[ownership]: doc/faq/ownership.html
61[packages]: doc/faq/packages.html 63[packages]: doc/faq/packages.html
diff --git a/web/input/doc/faq/migration.md b/web/input/doc/faq/migration.md
new file mode 100644
index 0000000..3dfd566
--- /dev/null
+++ b/web/input/doc/faq/migration.md
@@ -0,0 +1,45 @@
1title: Migrating to Monitoring Plugins
2parent: FAQ
3---
4
5# How do I migrate to Monitoring Plugins?
6
7If you installed the [Nagios Plugins][nagios-plugins] package in the past and
8now plan to migrate to the Monitoring Plugins, you should check whether your
9operating system vendor provides an official package. If no such package
10exists, you might have to [install the Monitoring Plugins from
11source][compiling].
12
13You must then make sure the new plugins are found by your monitoring
14application. While the Nagios Plugins were usually installed into the
15directory `/usr/local/nagios/libexec` when built from the source tarball, the
16Monitoring Plugins are by default installed to `/usr/local/libexec`. You can
17change this by specifying the `--prefix` option when calling the `./configure`
18script. For example, the following commands would install the Monitoring
19Plugins into the old location:
20
21 $ ./configure --prefix=/usr/local/nagios
22 $ make
23 $ su root -c 'make install'
24
25If you prefer the new location (`/usr/local/libexec`), you must adjust your
26monitoring application's configuration instead. The details obviously depend
27on the software you're using. In typical [Nagios][nagios], [Naemon][naemon],
28and [Icinga 1][icinga-1] setups, the path to the plugins can be modified by
29adjusting the `$USER1$` macro in the `resource_file` (often named
30`resource.cfg`). With [Icinga 2][icinga-2], you probably want to set the path
31in in your `constants.conf` file, e.g.:
32
33 const PluginDir = "/usr/local/libexec"
34
35If you run into any trouble, please don't hesitate to [contact us][support]!
36
37[nagios-plugins]: http://www.nagios-plugins.org/ "Nagios Plugins"
38[compiling]: doc/faq/compilation.html "Compiling the Monitoring Plugins"
39[icinga-1]: https://www.icinga.org/icinga-1/ "Icinga 1"
40[icinga-2]: https://www.icinga.org/icinga2/ "Icinga 2"
41[naemon]: http://naemon.github.io/ "Naemon"
42[nagios]: http://www.nagios.org/ "Nagios"
43[support]: support.html "Monitoring Plugins Support"
44
45<!--% # vim:set filetype=markdown textwidth=78 joinspaces expandtab: # %-->