DashBoard
---------
Author: Franjo Stipanovic - fritz [fritzfs@gmail.com]
Updated by: Mark Holm - markh/oneobserver [markh@infoarch.com]

DashBoard enables you to create custom page (create & edit on-the-fly) with
service and host status for monitoring. You can create groups and subgroups so
you can view all necessary information in just one page. DashBoard supports
configuration files for every user separately.

Nagios is great tool, but when it comes to display options (i.e. two service
and one host in same page without grouping them in nagios) - it is little bit
complicated. DashBoard gives you enough freedom to display all kinds of
combinations on same page without restarting Nagios and changing it's
configuration files.

0.2 Update (markh)
-----------------

Fritz did a great job with the basic package, but it needed some streamlining
in order to make it also work with the Groundwork  package as well. To
accomplish this I broke it into three effective modules and pulled all the
default configuration parameters into a single include module to make
configuration easier. See installation file for setup for Nagios and Groundwork.

0.2.1 Update (markh)
-----------------

Found a couple of problems with the tar package and also fixed the include
syntax on the two files taht displayed the dashboards so they were properly
imported within scope. Also tested and updated the installation documentation
to explicitly tell you how to turn on single sign-on properly for both Nagios
and the Nagios Dashboard.


Config file Syntax
------------------

For version 0.2 I added a little bit more formatting to the configuration file
so you can label sections, force breaks in the layout and change the number of
items per line and items per row in each block. You can also change the Nagios
logo out in the corner for a logo of your own choosing.

Sections:

[config LabelText]	Change logo, columnsperline, and columnsperblock
			dynamically. LabelText is optional if there is only
			one config block and required if there is more than one.

Options -		One or more of the following:

logo=PathToFile		Not Required. Only works if defined in the first config
			section in the file. All others ignored.

columnsperline=#	Not Required. Changes number of columns used in current
			grouping of blocks per line. When defined it will ALWAYS
			start a new group of blocks.

columnsperblock=#	Not Required. Changes the number of items per line
			inside the next block of items defined and those
			following.

[linebreak LabelText]	Starts a new line of group blocks. It will left justify
			the new line blocks. LabelText is optional if there is
			only one config block and required if there is more than			one.

Options -		None.

[header LabelText]	Starts a new grouping of group blocks and centers the 
			headervalue text in bold over the block. LabelText is
			optional if there is only one config block and required
			if there is more than one.

Options -		One of the following required in the section:

headervalue=HeaderText	Text to be used in the centered label

[LabelText]		Starts a new block of items being monitored.

Options -		One of the following required in the section:

members=host|host:svc,[host|host:svc,...]
			host is a hostname defined in Nagios, svc is a service
			check defined for that host. Members can be a mix of 
			host and host:svc definitions. Each item member must be 
			terminated with a ','

[[LabelText]]		Creates a subgroup in a block that has a single label
			for all the members of the member item

Options -		Both of the following required in the section:

group=HostGroup		HostGroup is a Nagios defined Host Group that contains 
			all hosts listed in members

members=host|host:svc,[host|host:svc,...]
			host is a hostname defined in Nagios, svc is a service
			check defined for that host. Members can be a mix of 
			host and host:svc definitions. Each item member must be 
			terminated with a ','


Sample Config File
------------------
[config1]
columnsperline=1
columnsperblock=3
logo=/nagios/images/FooBarLogo.gif

[header1]
headervalue=All Servers

[FooBar Servers]
members=FooBar-SBS,FooBar-SQL 

[[FooBar Servers Nagios Detail]]
group=FooBar-Group
members=FooBar-SBS,FooBar-SQL,FooBar-SBS:DNS,FooBar-SBS:NT_CPU_PA,FooBar-SBS:NT_MEM_PA,FooBar-SBS:NT_Disk_PA-C,FooBar-SQL:NT_CPU_PA,FooBar-SQL:NT_MEM_PA,FooBar-SQL:NT_Disk_PA-C,FooBar-SQL:NT_SVC_PA-MSSQL,FooBar-SQL:NT_SVC_PA-SQLAgent

[config2]
columnsperline=2
columnsperblock=3

[header2]
headervalue=All Services


[FooBar SBS Services]
members=FooBar-SBS:DNS,FooBar-SBS:NT_CPU_PA,FooBar-SBS:NT_MEM_PA,FooBar-SBS:NT_Disk_PA-C,FooBar-SBS:NT_Disk_PA-C

#[linebreak]

[config3]
columnsperblock=4

[FooBar SQL Server Services]
members=FooBar-SQL:NT_CPU_PA,FooBar-SQL:NT_MEM_PA,FooBar-SQL:NT_Disk_PA-C,FooBar-SQL:NT_SVC_PA-MSSQL,FooBar-SQL:NT_SVC_PA-SQLAgent

[header3]
headervalue=Test Items

[InfoArch Test Items]
members=Markh-GPX2000:icmp_ping_alive,