summaryrefslogtreecommitdiffstats
path: root/web/input/doc/faq/migration.md
blob: 3dfd56666a5b057c4c3d2993790d144aec6e66c8 (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
title: Migrating to Monitoring Plugins
parent: FAQ
---

# How do I migrate to Monitoring Plugins?

If you installed the [Nagios Plugins][nagios-plugins] package in the past and
now plan to migrate to the Monitoring Plugins, you should check whether your
operating system vendor provides an official package.  If no such package
exists, you might have to [install the Monitoring Plugins from
source][compiling].

You must then make sure the new plugins are found by your monitoring
application.  While the Nagios Plugins were usually installed into the
directory `/usr/local/nagios/libexec` when built from the source tarball, the
Monitoring Plugins are by default installed to `/usr/local/libexec`.  You can
change this by specifying the `--prefix` option when calling the `./configure`
script.  For example, the following commands would install the Monitoring
Plugins into the old location:

    $ ./configure --prefix=/usr/local/nagios
    $ make
    $ su root -c 'make install'

If you prefer the new location (`/usr/local/libexec`), you must adjust your
monitoring application's configuration instead.  The details obviously depend
on the software you're using.  In typical [Nagios][nagios], [Naemon][naemon],
and [Icinga 1][icinga-1] setups, the path to the plugins can be modified by
adjusting the `$USER1$` macro in the `resource_file` (often named
`resource.cfg`).  With [Icinga 2][icinga-2], you probably want to set the path
in in your `constants.conf` file, e.g.:

    const PluginDir = "/usr/local/libexec"

If you run into any trouble, please don't hesitate to [contact us][support]!

[nagios-plugins]: http://www.nagios-plugins.org/ "Nagios Plugins"
[compiling]: doc/faq/compilation.html "Compiling the Monitoring Plugins"
[icinga-1]: https://www.icinga.org/icinga-1/ "Icinga 1"
[icinga-2]: https://www.icinga.org/icinga2/ "Icinga 2"
[naemon]: http://naemon.github.io/ "Naemon"
[nagios]: http://www.nagios.org/ "Nagios"
[support]: support.html "Monitoring Plugins Support"

<!--% # vim:set filetype=markdown textwidth=78 joinspaces expandtab: # %-->