223 lines
10 KiB
Plaintext
223 lines
10 KiB
Plaintext
|
Nagios Business Process View and Nagios Business Impact Analysis
|
||
|
|
----------------------------------------------------------------
|
||
|
|
|
||
|
|
This document decribes, how to install.
|
||
|
|
If You are new to these AddOns make sure You read README before.
|
||
|
|
|
||
|
|
Requirements
|
||
|
|
------------
|
||
|
|
|
||
|
|
1. You must have Nagios (http://www.nagios.org) or Icinga
|
||
|
|
(http://www.icinga.org) installed and running.
|
||
|
|
|
||
|
|
2. You need to have one of the following possibilities to give
|
||
|
|
this software access to the actual status information Nagios or Icinga
|
||
|
|
provides
|
||
|
|
|
||
|
|
2.1 NDOUTILS
|
||
|
|
(The NDOUTILS - Nagios Data Output Utils - addon allows you to move
|
||
|
|
status and event information from Nagios to a database for later
|
||
|
|
retrieval and processing.)
|
||
|
|
see: http://www.nagios.org/download/addons/
|
||
|
|
|
||
|
|
2.2 IDOUTILS
|
||
|
|
(same for Icinga)
|
||
|
|
see: http://docs.icinga.org/latest/en/quickstart-idoutils.html
|
||
|
|
|
||
|
|
2.3 As an alternative, You may use Merlin. Merlin also requires a separate
|
||
|
|
daemon to run, also requires a MySQL database, but some people like it
|
||
|
|
more then NDOUTILS, because Merlins table structure ist simpler.
|
||
|
|
see: http://www.op5.org/community/projects/merlin
|
||
|
|
|
||
|
|
2.4 If You don't like the overhead of a database, You alternatively can
|
||
|
|
use ndo2fs which writes the same information into the file system.
|
||
|
|
(But keep in mind: ndo2fs uses NDOUTILS as well, You don't save the
|
||
|
|
installation of NDOUTILS, but only the overhead of running a database.)
|
||
|
|
see: http://www.pnp4nagios.org/ndo2fs/start
|
||
|
|
|
||
|
|
2.5 mk_livestatus
|
||
|
|
This backend is very simple. It does not need NDOUTILS, no
|
||
|
|
database and also no other separate storage in filesystem or where
|
||
|
|
ever, because it directly gets information from Nagios' or Icingas
|
||
|
|
internal memory structure.
|
||
|
|
You need at least version 1.1.2 of mk_livestatus.
|
||
|
|
see: http://mathias-kettner.de/checkmk_livestatus.html
|
||
|
|
|
||
|
|
2.6 Icinga-API
|
||
|
|
If You have the new Icinga Web Interface
|
||
|
|
(http://docs.icinga.org/latest/en/icinga-web-scratch.html) up and
|
||
|
|
running, there is the possibility to get status information from the
|
||
|
|
Icinga-API by HTTP/JSON.
|
||
|
|
You need at least Icinga-Web 1.0.3
|
||
|
|
But keep in mind: There are an additional HTTP connection and
|
||
|
|
additional PHP scripts in between. This way is much slower than
|
||
|
|
all the others!!
|
||
|
|
|
||
|
|
3. You need a WebServer installed, we describe configuration for Apache.
|
||
|
|
|
||
|
|
4. Perl > 5.8 is needed.
|
||
|
|
|
||
|
|
5. The Perl-Modul CGI::Simple must be installed
|
||
|
|
If You are not sure, type
|
||
|
|
perl -e "use CGI::Simple" && echo ok
|
||
|
|
this prints out "ok" if the module is installed and included in the
|
||
|
|
default INC path and an error otherwise.
|
||
|
|
Maybe Your linux distribution provides this as a package called
|
||
|
|
libcgi-simple-perl or so.
|
||
|
|
|
||
|
|
6. The Perl-Modul DBI must be installed
|
||
|
|
If You are not sure, type
|
||
|
|
perl -e "use DBI" && echo ok
|
||
|
|
|
||
|
|
7. The Perl-Modul JSON::XS must be installed
|
||
|
|
If You are not sure, type
|
||
|
|
perl -e "use JSON::XS" && echo ok
|
||
|
|
Maybe Your linux distribution provides this as a package called
|
||
|
|
libjson-perl or so.
|
||
|
|
|
||
|
|
8. The Perl-Modul LWP::UserAgent must be installed
|
||
|
|
If You are not sure, type
|
||
|
|
perl -e "use LWP::UserAgent" && echo ok
|
||
|
|
Maybe Your linux distribution provides this as a package called
|
||
|
|
perl-libwww-perl or so.
|
||
|
|
|
||
|
|
|
||
|
|
Install
|
||
|
|
-------
|
||
|
|
|
||
|
|
Be root.
|
||
|
|
Extract the download file
|
||
|
|
tar xvzf nagios-business-process-addon-<VERSION>.tar.gz
|
||
|
|
cd nagios-business-process-addon-<VERSION>
|
||
|
|
|
||
|
|
if using Nagios: For installation in the default path (/usr/local/nagiosbp/)
|
||
|
|
type
|
||
|
|
./configure
|
||
|
|
|
||
|
|
if using Icinga: For installation in the default path (/usr/local/nagiosbp/)
|
||
|
|
type
|
||
|
|
./configure --with-nagcgiurl=/icinga/cgi-bin --with-naghtmurl=/icinga --with-nagetc=/usr/local/icinga/etc/ --with-apache-authname="Icinga Access"
|
||
|
|
|
||
|
|
If You want to install somewhere else or if Your nagios or icinga is not
|
||
|
|
installed in the default path (/usr/local/nagios/ or /usr/local/icinga),
|
||
|
|
you can call configure with different parameters, see
|
||
|
|
./configure --help
|
||
|
|
for details.
|
||
|
|
At the end, all important parameters are listed. If they are ok, type
|
||
|
|
make install
|
||
|
|
to install Nagios Business Process AddOns.
|
||
|
|
|
||
|
|
|
||
|
|
Apache needs to know about the new files. Therefore a file nagiosbp.conf
|
||
|
|
has been put into Your Apache's conf.d directory.
|
||
|
|
The default is, that the given configuration is included in all of
|
||
|
|
Apache's virtual hosts. If this is not what you want, You can copy the
|
||
|
|
content of nagiosbp.conf into the according VirtualHost section of Your
|
||
|
|
httpd.conf and delete nagiosbp.conf afterwards.
|
||
|
|
Another possibility is, to install the file in some other path, by calling
|
||
|
|
configure e. g. with
|
||
|
|
./configure --with-httpd-conf=/usr/local/nagiosbp/etc/apache-conf.d/
|
||
|
|
and afterwards add an include statement into Apache's section for the
|
||
|
|
according VirtualHost:
|
||
|
|
Include /usr/local/nagiosbp/etc/apache-conf.d/nagiosbp.conf
|
||
|
|
|
||
|
|
Concerning the AuthName directives (there are two) in this file:
|
||
|
|
make sure they are exactly the same as in Nagios' or Icingas Apache
|
||
|
|
config file (conf.d/nagios.conf or conf.d/icinga.conf)
|
||
|
|
Otherwise in the web GUI you are prompte twice for Your username and
|
||
|
|
password. Once when accessing a page of Nagios or Icinga and once when
|
||
|
|
accessing a page of the Business Process AddOns.
|
||
|
|
|
||
|
|
You can give the correct AuthName when calling configure by giving the
|
||
|
|
additional parameter --with-apache-authname or by editing the file
|
||
|
|
conf.d/nagiosbp.conf afterwards.
|
||
|
|
|
||
|
|
If You are done with Your Apache configuration, by typing
|
||
|
|
apachectl configtest
|
||
|
|
You can check Your configuration. If it reports no error, reload Your
|
||
|
|
Apache.
|
||
|
|
|
||
|
|
For Nagios Business Impact Analysis, a cron job has been created for You,
|
||
|
|
that throws away old session files. It is normally located in /etc/cron.d
|
||
|
|
|
||
|
|
In Nagios or Icinga You need some links so that You can use the 2 AddOns
|
||
|
|
|
||
|
|
If using Nagios edit /usr/local/nagios/share/side.html
|
||
|
|
e. g. after this section
|
||
|
|
<tr>
|
||
|
|
<td width=13><img src="images/greendot.gif" width="13" height="14" name="statuswrl-dot"></td>
|
||
|
|
<td nowrap><a href="/nagios/cgi-bin/statuswrl.cgi?host=all" target="main" onMouseOver="switchdot('statuswrl-dot',1)" onMouseOut="switchdot('statuswrl-dot',0)" class="NavBarItem">3-D Status Map</a></td>
|
||
|
|
</tr>
|
||
|
|
You insert the following lines:
|
||
|
|
<tr>
|
||
|
|
<td width=13><img src="images/greendot.gif" width="13" height="14" name="statuswrl-dot"></td>
|
||
|
|
<td nowrap><a href="/nagiosbp/cgi-bin/nagios-bp.cgi" target="main" onMouseOver="switchdot('statuswrl-dot',1)" onMouseOut="switchdot('statuswrl-dot',0)" class="NavBarItem">Business Process View</a></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td width=13><img src="images/greendot.gif" width="13" height="14" name="statuswrl-dot"></td>
|
||
|
|
<td nowrap><a href="/nagiosbp/cgi-bin/nagios-bp.cgi?mode=bi" target="main" onMouseOver="switchdot('statuswrl-dot',1)" onMouseOut="switchdot('statuswrl-dot',0)" class="NavBarItem">Business Impact</a></td>
|
||
|
|
</tr>
|
||
|
|
|
||
|
|
If using Icinga with the classic web GUI edit
|
||
|
|
/usr/local/icinga/share/menu.html
|
||
|
|
e. g. after this section
|
||
|
|
<li class="menuli_style1"><a href="/icinga/cgi-bin/extinfo.cgi?&type=7" target="main">Scheduling Queue</a></li>
|
||
|
|
You insert the following lines:
|
||
|
|
<li class="menuli_style2"><a href="/nagiosbp/cgi-bin/nagios-bp.cgi" target="main">Business Process View</a></li>
|
||
|
|
<li class="menuli_style1"><a href="/nagiosbp/cgi-bin/nagios-bp.cgi?mode=bi" target="main">Business Impact</a></li>
|
||
|
|
|
||
|
|
As Nagios Business Process AddOns use the stylesheets of Nagios or Icinga
|
||
|
|
the web GUI has the look and feel of Nagios when installed with Nagios
|
||
|
|
and the look and feel of Icinga when installed with Icinga.
|
||
|
|
In very little details they differ. So when using Icinga with the classic
|
||
|
|
web GUI You might want to insert the following line
|
||
|
|
#nbp_foot_version, #nbp_foot_language, .nbp_text_small, .nbp_text_tiny { font-size:100%; }
|
||
|
|
into share/stylesheets/user.css
|
||
|
|
Otherwise some elements on the web GUI would look very tiny.
|
||
|
|
|
||
|
|
If using Icinga with the new Icinga-Web you need to add the additional
|
||
|
|
cronks there. You find a download link for the Business Process Icinga
|
||
|
|
Cronk at
|
||
|
|
http://nagiosbp.projects.nagiosforge.org/download.shtml
|
||
|
|
Please see the documention there to include them into Your installation.
|
||
|
|
|
||
|
|
Now it's time to set up some config files.
|
||
|
|
|
||
|
|
If You are running with a database (NDO database, IDO database or merlin
|
||
|
|
database) create a user on Your database.
|
||
|
|
The user needs only select privileges.
|
||
|
|
|
||
|
|
If You are running NDO with ndo2fs, You have to make sure, the user Your
|
||
|
|
webserver is running under has read access to the output files of ndo2fs.
|
||
|
|
You might therefor want to append something like
|
||
|
|
-o UMASK=002
|
||
|
|
to the line
|
||
|
|
ndo2fsParam
|
||
|
|
in the init-Script of ndo2fs (normally found under /etc/init.d/ndo2fs)
|
||
|
|
|
||
|
|
If You are running with mk_livestatus, You have to make sure, the user Your
|
||
|
|
webserver is running under has read access to the unix socket which has
|
||
|
|
been created by mk_livestatus (by default: /usr/local/nagios/var/rw/live)
|
||
|
|
|
||
|
|
When using the Icinga-API as backend, please note:
|
||
|
|
The cooperation of Icinga-API and Nagios Business Process AddOns is not
|
||
|
|
yet in use in a large number of setups in production. Also this one is the
|
||
|
|
backend with the most overhead (an additional layer of HTTP and additional
|
||
|
|
PHP scripts are used to get data). Therefor the performance is not as good
|
||
|
|
as with the other backends.
|
||
|
|
|
||
|
|
So if You have a big setup or a need for well tested software, You might want
|
||
|
|
to use it with a NDO database, IDO database or mk_livestatus.
|
||
|
|
|
||
|
|
Now move etc/ndo.cfg-sample to etc/ndo.cfg and edit it
|
||
|
|
change all the parameters there according to Your setup and
|
||
|
|
- if using a database backend - the user You just created
|
||
|
|
all parameters have comments there.
|
||
|
|
If You did install all components with their default path
|
||
|
|
and settings, You probably will not have to change a lot.
|
||
|
|
|
||
|
|
Now You have finished the installation. Go ahead by configuring Your
|
||
|
|
Business Processes as described in README
|
||
|
|
|
||
|
|
Especially do not miss nagios-bp-check-ndo-connection.pl
|