PHP Network Weathermap
PHP Network Weathermap is a Cacti plugin for creating network maps that show
traffic utilisation and other monitored data. This Cacti-maintained fork builds
on the original PHP Network Weathermap by Howard Jones (howie@thingy.com), based
on his 0.98 series framework.
The editor supports interface assignment, editable notes, curved link comments,
traffic colour presets, icon/background libraries, hover graphs and saved-edit
Undo/Redo. The 2.1 release adds stricter map management and output handling,
more resilient rendering, schedule fixes and theme-aware editor controls.
See the bundled manual for installation, upgrades, editor workflows,
image libraries, troubleshooting and the configuration/data-source reference.
The editor workflow guide links to the detailed manual.
See CHANGELOG.md for updates listed by version, and
COPYING for the license.
Versions and compatibility
This README describes the develop source branch.
Use the published release’s assets and tagged documentation when installing that
package. Branch code can include later changes, even when its version number
matches the release. Cacti’s own PHP and database requirements also apply.
Install this plugin in <cacti-root>/plugins/weathermap, using the directory
name weathermap rather than plugin_weathermap.
See CHANGELOG.md for the version history.
Bundled node icons
The node icon library in images/objects/ includes modern corporate building,
branch office, hospital, clinic, data centre, warehouse and wireless access-point
(AP.png) icons, plus NAS (NAS.png), server (Server.png), printer
(Printer.png), CCTV recorder (CCTV-NVR.png), UPS (UPS.png) and CCTV camera
(CCTV-Camera.png) icons. These transparent PNGs are 96 × 96 pixels and can be selected from the editor's node
icon picker without uploading additional files.
Compatibility
The plugin requires Cacti 1.2.29 or later, as specified in INFO, and uses
Cacti's authentication and permissions. The editor includes theme handling for
Cacti 1.2.x and the developing 1.3.x series.
Contribute
Check out the main Cacti web site for downloads, change
logs, release notes and more!
Community forums
Given the large scope of Cacti, the forums tend to generate a respectable amount
of traffic. Doing your part in answering basic questions goes a long way since
we cannot be everywhere at once. Contribute to the Cacti community by
participating on the Cacti Community Forums.
For Network Weathermap's core support, there is much more information along with
tutorials and updates available at Howard Jones's site:
http://www.network-weathermap.com/
Important Notes
Back up the plugin and your map configurations before upgrading.
Backgrounds and node icons use separate directories: images/backgrounds/ and
images/objects/. When upgrading from older versions, the upgrade script
attempts to move images and update their configuration paths. Check customised
image locations after upgrading, and ensure the poller account has permission
to move the relevant files and update map configurations.
The old cacti-resources and editor-resources directories have been replaced
by js and css. They are no longer used. The Overlib library dependency has
also been removed.
Editor access depends on Cacti's authentication and permissions. Review those
permissions when upgrading from older installations.
Permissions
The plugin registers three realms: View Weathermaps, Manage Weathermap
(the management pages and check.php) and Edit Weathermaps (the map
editor).
Command line tools
The cli/ directory holds helper scripts for map configuration files. Run each
with --help for its options:
cacti-integrate.php - populate TARGET, INFOURL, OVERLIBGRAPH and BANDWIDTH
from Cacti data (--input, --output, --target-rrdtool,
--target-dsstats).
convert-to-dsstats.php - convert RRDtool targets to DSStats targets, or back
with --reverse (--input, --output).
map-tidyup.php - tidy a map configuration (--input, --output).
upgrade_configs.php - upgrade map configurations (--debug).
cacti-mapper.php, bristle.php and auto-overlib.pl are described in
cli/README.
GitHub Documentation
Get involved in creating and editing Cacti Documentation! Fork, change and
submit a pull request to help improve the documentation on
GitHub.
GitHub Development
Get involved in development of Cacti! Join the developers and community on
GitHub!
Original Weathermap Plugin
Howard Jones's original work can still be found on GitHub at the following location.
https://github.com/howardjones/network-weathermap
This fork is maintained separately from that upstream project.
Included 3rd Party Component Software
Copyright (c) 2004-2026 - The Cacti Group, Inc.