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
------------

You must have Nagios (http://www.nagios.org) installed and running.

NDOUTILS must be installed and working.
(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/

If You don't like the overhead of a database, You alternatively can
use ndo2fs (http://www.pnp4nagios.org/ndo2fs/start) 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.)

As a third alternative, You may use Merlin instead of NDOUTILS. 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.

You need a WebServer installed, we describe configuration for Apache.

Perl > 5.8 is needed.
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.


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)

When using ndo2fs, please note: 
The cooperation of ndo2fs and Nagios Business Process AddOns is not yet in
use in a large number of setups in production. It is known to work well and
without performace problems in a medium size setup (200 hosts, 1600 services).
Also setup with merlin database 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

