Version 0.2.1

Installation
------------

1)
Install mod_python with apache if you don't have it already.
(http://www.modpython.org)

2)
Install configobj for python by typing this in your shell:
	easy_install configobj

If you don't have easy_install then you're missing setuptools for python. If you
are running Debian, you can install it with:

	apt-get install python-setuptools

Or you can download it from cheeseshop.python.org/pypi/setuptools.

3)
On a standalone Nagios installation, edit side.html in your Nagios directory and
just above 'Tactical Overview' add this:

<tr>
 <td width=13><img src="images/greendot.gif" width="13" height="14" name="dashboard"></td>
 <td nowrap width=134><a href="/cgi-bin/nagios2/dashboard.py" target="main" onMouseOver="switchdot('dashboard',1)" 
  onMouseOut="switchdot('dashboard',0)" class="NavBarItem">DashBoard</a></td>
</tr>


And the following just above the "View Dashboard" line.

<tr>
 <td width=13><img src="images/greendot.gif" width="13" height="14" name="dashboard_admin"></td>
 <td nowrap width=134><a href="/cgi-bin/nagios2/dashboard_edit.py" target="main" onMouseOver="switchdot('dashboard_admin',1)" 
  onMouseOut="switchdot('dashboard_admin',0)" class="NavBarItem">DashBoard Admin</a></td>
</tr>
<tr>
 <td width=13><img src="images/greendot.gif" width="13" height="14" name="dashboard_display"></td>
 <td nowrap width=134><a href="/cgi-bin/nagios2/dashboard_display.py" target="main" onMouseOver="switchdot('dashboard_display',1)" 
  onMouseOut="switchdot('dashboard'_display,0)" class="NavBarItem">DashBoard View</a></td>
</tr>

4)
Copy dashboard*.py files in your Nagios cgi-bin directory with rest of cgi files
(avail.cgi, cmd.cgi, tac.cgi, extinfo.cgi ...). For Standalone Nagios this is
typically /usr/local/nagios/bin. Under Groundwork this is typically
(5.2.1) /usr/local/groundwork/apache2/cgi-bin/nagios or
(5.3.*) /usr/local/groundwork/nagios/sbin. Change the ownership and group of
the files copied to be the same as that the Nagios installation is running as.

Copy dashboard.css in your Nagios stylesheets directory with rest of css files!
For a standalone Nagios this is typically /usr/local/nagios/share/stylesheets.
For Groundwork it is typically /usr/local/groundwork/nagios/share/stylesheets.
Change the ownership and group of the file copied to be the same as that the
Nagios installation is running as.

Create a DashBoard directory inside Nagios directory named Dashboard which will
hold user's configuration files for Dashboard. Change the ownership and group of
the directory created to be the same as that the Nagios installation is running
as. Change the permission to allow write for owner and group.

Edit the dashboard_inc.py and change the datfile and cfgfile PATHs. you can
also set the default logo to use as well as the  number of blocks per line and
items per line inside each block.


5)
For standalond Nagios installations, simply clear your cache in browser and
reload Nagios web page. Now you should see the DashBoard, Dashboard Admin, and
Dashboard View links in your left-side menu.

Create your own configuration and start monitoring! :)

For Groundwork you have several more steps to go:

5)
Under Administration/Wrappit create 2 new packages with the following
parameters:

Package 1: 
General Tab
Name of Application: Nagios Dashboard
Description of Application: Nagios Dashboard
Base URL: /nagios/cgi-bin
Welcome URL: /dashboard.py

Menu Tab
Name of Menu Item:	Dashboard
URL of Menu Item:	/dashboard.py
click "Create Menu Item"

Single Sign-On Tab
Check "Enable Single Sign-On" checkbox

Export Tab
Click "Install Package"


Package 2: 
General Tab
Name of Application: Nagios Dashboard Admin
Description of Application: Nagios Dashboard Administration
Base URL: /nagios/cgi-bin
Welcome URL: /dashboard_edit.py

Menu Tab
Add both of these items

Name of Menu Item:	Create/Edit
URL of Menu Item:	/dashboard_edit.py
click "Create Menu Item"

Name of Menu Item:	View
URL of Menu Item:	/dashboard_display.py
click "Create Menu Item"

Single Sign-On Tab
Check "Enable Single Sign-On" checkbox

Export Tab
Click "Install Package"

6) 
Replace this line:
$guava->SSO_createAuthTicket("nagios_auth_tkt", "/nagios/", 'nagiosadmin'); 

With the following line:
$guava->SSO_createAuthTicket("nagios_auth_tkt", "/nagios/", $_SESSION['username']); 

in the following files 

/usr/local/groundwork/guava/packages/nagios/views/nagios.inc.php 
/usr/local/groundwork/guava/packages/nagiosmap/views/nagiosmap.inc.php 
/usr/local/groundwork/guava/packages/nagiosreports/views/nagiosreports.inc.php 

For Groundwork 5.3*
/usr/local/groundwork/core/guava/htdocs/guava/packages/nagiosdashboard/views/nagiosdashboard.inc.php

For Groundwork 5.2.1
/usr/local/groundwork/guava/packages/nagiosdashboard/views/nagiosdashboard.inc.php

Considering groundwork is installed in /usr/local/groundwork

Until this is done, the ONLY dashboard the system will see is the one for
nagiosadmin



Notice:
See ReadMe.txt file for config file syntax definition and sample