Unified Trees! 0.8

[ericdives]

Hullo all! Plugin #2 from yours truly is officially released.

Unified Trees provides a way for multiple Cacti instances to share tree information between them and display a single tree to a user. With fully meshed connectivity between Cacti instances and a single sign-on service (or unauthenticated access to your graphs), Unified Trees provides you a way to navigate between Cacti servers without having to wonder what server a particular monitored host is off of.

For more information, see the Unified Trees post on my blog site or the Cacti documentation for Unified Trees.

You are strongly advised to read all of the documentation before proceeding with the installation.

But, in case you want to do something brave/stupid, you can download the plugin here.

Have an issue? Let's try using the github listing for the project.

20131209: 0.1 release. I've been pounding away at it for a while when I haven't encountered a bug in DPDiscover. Since I cut my teeth in DPDiscover, this should be a tad more feature rich than the 0.1 release of that was, and be a little less buggy as well. However, since I'm the only one that's been using it, I'm sure someone's going to find something I haven't ...

20140108: 0.5 Provides a "client/server" structure where trees are prebuilt and stored in a memory based table on the "server". "Clients", instead of having to pull data from all servers, only need to pull the information from a single server.

20140110: 0.6 Fixed a major operational bug involving the failure of making a given entry's ID on the tree unique. However, this involves "unpatching" lib/html_tree.php and repatching it.

20140805: I never updated this post for versions between 0.6 and 0.8 -
For 0.8:

The idea where the plugin was developed is that switches are to be polled by the server in the node the switch eventually connects through. Thing is, determining this is not faultless, and errors creep in once in a while. So, sometimes it’s important to move a device to a different server. In order to avoid losing the data from the original host:
You can mark a host as disabled, and the build tree function should be able to detect that it is disabled and add a “(D)” to the host name, separating it from the “active” machine and listing them both in the tree.
There is still a possibility of collisions between Cacti hosts with the same target if it is disabled on both or active on both.
Best option? Change your tree location for disabled hosts.

For 0.71:

0.7 (unreleased outside of GitHub) introduced the idea of the “Other” tree. If you have a tree in your list of trees that you need displayed at the end of all of the others, put the tree name in the settings box and it will do so.
As I was deploying my own collection of Cacti servers, it became apparent that hourly rebuilds of the server provided tree might not be frequent enough, so 0.71 introduced the options for every 15 minutes and every 30 minutes.

[ericdives]

Just bumping it in case there are any subscribers; version 0.5 is released and contains new functionality.

[ericdives]

I don't know how many of you may be using this ... but I found a major bug in it today.

It has to do with an "ID" that needs to be unique for every entry on the built tree. However, the current code doesn't do that, and collisions of IDs are ugly.

I should have a fix out by 1:30pm Eastern US. However, upgrading will involve a new patch to html_tree.php - you'll have to undo the previous patch (which, if you followed the instructions appropriately, will just involve moving the backup file over to the patched file) and then run a new patch. Instructions will be available on the blog post and Cacti docs for the plugin.

Sorry guys - as I deploy my 9 or so installs, I'm tripping all over gotchas.

[ericdives]

The docs page is currently locked. See the blog post linked above for information.

0.6 fixes an ID collision bug that didn't rear its ugly head for me until today. Be aware: you'll need to "unpatch" html_tree.php and repatch it:

If you followed the instructions appropriately while installing Unified Trees, you should just be able to overwrite all the existing files, and:

1. From your Cacti base directory: mv lib/html_tree.php.orig lib/html_tree.php
2. Then: patch -b -p0 < plugins/unifiedtrees/patch-0.8.8b/html_tree.diff

[jimcjulsonjr]

The docs page is currently locked. See the blog post linked above for information.

0.6 fixes an ID collision bug that didn't rear its ugly head for me until today. Be aware: you'll need to "unpatch" html_tree.php and repatch it:

If you followed the instructions appropriately while installing Unified Trees, you should just be able to overwrite all the existing files, and:

1. From your Cacti base directory: mv lib/html_tree.php.orig lib/html_tree.php
2. Then: patch -b -p0 < plugins/unifiedtrees/patch-0.8.8b/html_tree.diff

Are you still actively working on this project? I can't believe I never saw this until now! We are in the process of deploying roughly 11 instance of Cacti, and this is an AMAZING plugin (if it still works of course )