SOURCE: http://blog.best-practice.se/2014/07/using-php-weathermap-with-observium.html?m=1

1. Download the modified version of PHP Weathermap done by Neil Lathwood (neil@lathwood.co.uk) from his github: https://github.com/laf/weathermap and put it in your observium/html-directory.
The easiest way to do this is using git:

    cd /opt/observium/html/

    git clone https://github.com/laf/Weathermap-for-Observium.git weathermap
	
Correction ----
used this search to accomplish this step: https://github.com/search?utf8=%E2%9C%93&q=observium+weathermap&type=Repositories&ref=searchresults
used git clone https://github.com/tobzsc/weathermap-for-observium.git weathermap

2. If you have used different paths for observium or the weathermap-plugin you will need to edit the variables in data-pick.php and map-poller.php, if you are following the installation guide then the default variables will work.

Correction ----
Verify that defaults in data-pick and map-poller.php including the paths are correct
	
7. Create a new map by writing a name and click create map. Note that the map name *must* end with .conf (i.e. networkmap.conf)
Edit your map, create nodes and draw links and then pick graphs from Observium to use with the links.
*NOTE* Under Map Properties, make sure to define Output HTML Filename to maps/<mapname>.html and Output Image Filename to <mapname>.png

Correction ----
Html filename and the image filename should be maps/<mapname>.(html/png)

8. Make the file map-poller.php executable for your system by doing:

    chmod +x map-poller.php
	
8a. Run map-poller from the cli to work through any issues

	cd /opt/observium/html/
	
	./opt/observium/html/weathermap/map-poller.php
	
	8a1. IF this Error:
	
		PHP Fatal error:  require_once(): Failed opening required '/includes/db.inc.php' (include_path='.:/usr/share/pear:/usr/share/php') in /opt/observium/includes/definitions.inc.php on line 478

		THEN: comment out this offending line in map-poller.php
		
		include("../../includes/definitions.inc.php");

8b. If successful a new file in the maps directory like this should be created to verify

	ls /opt/observium/html/weathermap/maps/
	
10. Move the file navbar-custom.inc.php in the observium/html/includes/-directory. This file does not exist by default in Observium but Observium looks for this file and include the code from it if it exists, this makes it possible to add custom menus that does not break when you upgrade you Observium installation.

    mv navbar-custom.inc.php /opt/observium/html/includes/navbar-custom.inc.php
	
10a. If different directory then change those in the navbar-custom.inc.php (3 different places)

10b. To show icon change the navbar-custom.inc.php to this (3 different places)

	'icon' => $config['icon']['netmap']
	
11. Now that's it!
All .html-files in the maps/-directory will be linked in a sub menu in the Observium GUI.  
Clicking on one of them will take you to the rendered weathermap where you will get a nice overview of your networks load.


12. Hovering the mouse over a link will show the Observium graph for that link
The Mouse over is broken 

FIX --

overlib.js needs to be moved to web root ie. /opt/observium/html/