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) installed and running.

2.  You need to have one of the following possibilities to give
    this software access to the actual status information Nagios 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 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.3 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.4 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' internal
    memory structure.
    You need at least version 1.1.2 of mk_livestatus.
    see: http://mathias-kettner.de/checkmk_livestatus.html

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.

5.  The Perl-Modul DBI must be installed
    If You are not sure, type
    perl -e "use DBI" && echo ok


Install
-------

Be root.
Extract the download file
		tar xvzf nagios-business-process-addon-<VERSION>.tar.gz
		cd nagios-business-process-addon-<VERSION>
For installation in the default path (/usr/local/nagiosbp/) type
		./configure
If You want to install somewhere else or if Your nagios is not installed in
the default path (/usr/local/nagios/), 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

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 You need some links so that You can use the 2 AddOns
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>

Now it's time to set up some config files.

If You are running with NDO 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 mk_livestatus, please note: 
The cooperation of mk_livestatus and Nagios Business Process AddOns is not 
yet in use in a large number of setups in production. 
Also setup with merlin database or ndo2fs is not so wide used and not so 
well tested at the moment.
So if You have a big setup or a need for very well tested software, You
might want to use it with a NDO database.

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 NDO or merlin database - 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