+------------------------------------------------------------------------------+
| NAGIOS LOOKING GLASS - UPGRADING                                             |
|------------------------------------------------------------------------------|
| Author:           Andy Shellam <andy.shellam@mailnetwork.co.uk>              |
| Last Updated:     3rd June 2007                                              |
+------------------------------------------------------------------------------+

+------------------------------------------------------------------------------+
| Upgrading from 1.0.5 to 1.0.6                                                |
+------------------------------------------------------------------------------+

There have been no config file changes between 1.0.5 and 1.0.6.

However, the filter model has changed, so any custom filters will need 
converting to the new format, or NLG will throw PHP parse errors.

+------------------------------------------------------------------------------+
| Upgrading from 1.0.4 to 1.0.5                                                |
+------------------------------------------------------------------------------+

There have been no config file changes between 1.0.4 and 1.0.5.

+------------------------------------------------------------------------------+
| Upgrading from 1.0.3 to 1.0.4                                                |
+------------------------------------------------------------------------------+

To enable NLG to work with non-standard Nagios data filenames* (e.g. status.log
instead of status.dat) the $ServerNagiosFiles variable MUST now look like this:

	$ServerNagiosFiles = Array(
		"comments" => "comments.dat", 
		"downtime" => "downtime.dat", 
		"obj_cache" => "objects.cache", 
		"status" => "status.dat"
	);

Otherwise you may find NLG complains that Nagios isn't running, even though it 
is.

* Some config GUI tools for Nagios, such as Groundwork, generate different data
filenames to the standard.

+------------------------------------------------------------------------------+
| Upgrading from 1.0.2 to 1.0.3                                                |
+------------------------------------------------------------------------------+

There has been a new variable added into the configuration file which used to be
present, then was removed, but now realised it is required so added it back in!

In server/sync-files/s3_config.inc.php:

	On Unix/Linux platforms:
	+ $NLG_LineEnding = "/";

	On Windows platforms:
	+ $NLG_LineEnding = "\\";

+------------------------------------------------------------------------------+
| Upgrading from 1.0.2#BETA to 1.0.2                                           |
+------------------------------------------------------------------------------+

There have been no code changes between 1.0.2#BETA and 1.0.2.

+------------------------------------------------------------------------------+
| Upgrading from 1.0.1 to 1.0.2#BETA                                           |
+------------------------------------------------------------------------------+

There has been a revamp of the way the poller script gathers it's data from the
Nagios server, so NLG now handles upwards of 500 servers/6000 services happily.

There have been 2 new variables added into the configuration file to facilitate
the displaying of a custom network health comment.

In server/sync-files/s3_config.inc.php:

	+ $ClientHealth_NetworkOKThreshold = 100;
	+ $ClientHealth_NetworkWarnThreshold = 50;

+------------------------------------------------------------------------------+
| Upgrading from 1.0.0 to 1.0.1                                                |
+------------------------------------------------------------------------------+

There have been no changes to the configuration from 1.0.0.
In fact, the only file you need to replace for this upgrade is:
 client/s3_client.php.

+------------------------------------------------------------------------------+
| Upgrading from 1.0.0#PRE to 1.0.0                                            |
+------------------------------------------------------------------------------+

The first stable release of the 1.0 series is mainly a revamp of the UI, 
however a few configuration items have been changed.  Please find below a list
of variables to add (+) or remove (-) from your 1.0.0#PRE configuration file.
Changes to existing default variables are marked >.

If you want a no-hassle install, simply re-key your installation's details into
the distribution config files as for a clean install, otherwise make the changes
detailed below.  (I can also send you a diff if required.)

In server/sync-files/s3_config.inc.php:

	> $ClientSiteName = "Nagios Looking Glass";
	> $ClientCacheTTL = 60;
	+ $ClientTrimServerNames = 0;
	+ $ClientTrimMetricNames = 0;
	+ $ClientRefreshTime = 60;
	- $ClientHealth_OKColour
	- $ClientHealth_WarnColour
	- $ClientHealth_BadColour
	> $Update_DownloadLink = "http://www.nagioslookingglass.co.uk/download.phpx";
	> $Update_DNSRecordToCheck = "version.nagioslookingglass.co.uk";
	> ini_set("display_errors", "off");
	
In client/s3_config_stub.inc.php:

	+ $Stub_ClientEnableDebugging = 0;
	> ini_set("display_errors", "off");

+------------------------------------------------------------------------------+
| Upgrading from 0.2.x to 1.0.0#PRE                                            |
+------------------------------------------------------------------------------+

Nagios Looking Glass changed significantly after 0.2.5, and the 0.2.x config
files are not compatible with 1.0.0#PRE or above.

Therefore if you are upgrading from 0.2.x, please treat 1.0.0#PRE or above as a
clean installation.