Changes For This Version (0.95b to 0.96)



New Features

Changes For This Version (0.941 to 0.95)

This release has a lot of changes - most of them are small 'polishing' tweaks, but there are a few interesting bigger ones too. Happily, although there are a quite a few more features, this release actually has less lines of code than 0.941, due to some internal cleaning up.

Known Issues



New Features

Changes For This Version (0.94 to 0.941)


Changes For This Version (0.93 to 0.94)

0.94 was released early, to fix the one small issue caused by files moving around in the recent Cacti 0.8.7 release. However, there are some nice new features even so - INBWFORMAT has been requested for quite a while, and so has poller_output support.


New Features


Changes For This Version (0.92 to 0.93)


New Features


Changes For This Version (0.91 to 0.92)

New Features


Changes For This Version (0.9 to 0.91)

After all the big changes (below for 0.9), there are a whole bunch of bugs that no-one spotted in the testing, so this release is mostly a clean-up of those. There are a couple of small changes for new features, and a bit more diagnostic stuff for installation problems.

New Features


Changes For This Version (0.82 to 0.9)

I've divided the changes up into chunks. Most of the serious work was done in the Structural Changes section, but there are plenty of things for everyone. These are brief descriptions - see the Config Reference for the full detail. I've mentioned the appropriate configuration keywords if there are any.

Graphical Changes

These tend to be smaller things, but together they make a lot of useful additions.

Link comments

You can add a comment string which runs down the side of link arrows. This is intended for use for circuit references, or interface names. There are 4 new directives to make this happen: INCOMMENT, OUTCOMMENT, COMMENTFONT and COMMENTFONTCOLOR. You must use a TrueType COMMENTFONT to use this feature, as none of the other font types allow for rotation of text.

Bandwidth Label Positioning

You can now move the bandwidth labels (those little boxes) up and down the link arrow. You set a percentage position with BWLABELPOS.


You can make links end at arbitrary positions relative to a node now. Previously you could use compass-points, now you can also use pixels for the offsets in a NODES line

JPEG & GIF Support

If your GD library supports it, then Weathermap now understands JPEG and GIF files for BACKGROUND, ICON and IMAGEOUTPUTFILE.


You can specify a caption string for the 'popup' overlib window now, per-node/link. You can also have HTML-formatted text in that window, with or without the graph. See NOTES and OVERLIBCAPTION.

New Legend Styles

The new KEYSTYLE directive allows you to choose between 'classic' and two new styles of Legend. The new styles are neater for showing gradient scales, or when you have a lot of different bands.

Relative Positioning

You can position a node relative to another node. This is handy for maintaining big rows of nodes, where only one needs to be fixed in position now.

Use it with String Tokens to make captions for your nodes, with additional information.

Structural Changes

The internal structure of Weathermap has changed quite a lot in this version. It started as a few small changes, but each one showed that another was required.

Datasource Plugins

All the data-reading parts of Weathermap are now in plugins. This is to allow users to add their own external data sources more easily, without having to change the Weathermap code. All the previous TARGET strings will work as before, and I've added a few new ones for 0.9:

The RRD plugin also has some improvements in dealing with error conditions in this release.

There are planned plugins for Cacti (reading directly from the Cact database), Nagios Host Status, SNMP directly and others.

NODE Targets

NODEs can have data now. This means you can have them change colour according to a SCALE, just like a LINK does. Since a NODE only has one value, you can choose which one to use (of the two that a TARGET provides), with USEVALUE.

Multiple SCALEs

Because you probably don't want your nodes to change colour with the same values as your links, you can now have multiple SCALE sets too. The default one is DEFAULT, but you can define others and use them with USESCALE in a NODE or LINK section.

String Tokens

You can embed information from Weathermap, and from your own data, in almost any string in Weathermap. This allows you to do things like:

Arbitrary Parameters

The new SET directive lets you define new 'variables' per-NODE, per-LINK or for the whole map. These can be used to give fine-tuning parameters to the data source plugins, and also as additional data in String Tokens.

>Cacti Plugin

Most of the Cacti Plugin changes are bugfixes or for more advanced users.

Non-Standard Poller Cycle Times

If you are using the "<5 minute poller" patch from TheWitness, then you may not want the time-consuming Weathermap process to run every poller cycle. There is now an option to choose how often Weathermap redraws it's maps, including 'Never'.

Async Map Generation

If you choose 'Never' above, then you need some way to redraw. The new weathermap-cacti-rebuild.php script allows you to run a separate cron job for Weathermap, but in the environment it would have inside the poller process.

Recalculate Now

If you have your permissions set up correctly, then you can force the redraw of all maps from within the Cacti UI, instead of waiting for a poller cycle.


There are no new features in the Editor for 0.9, although a few annoying bugs have been squashed. I have big plans for the editor, but they are a whole project by themselves, so I've put it to one side. Otherwise 0.9 would never have appeared :-) Now this version is released, the Editor is one the main focus areas for the next release.


There were a lot of bugs fixed along the way. Most were new ones, but a few are things that existed in 0.82 too: