Installing MacTrack with Cacti

Here are the basic instructions:

1. Create a directory for mactrack in your cacti plugins directory
2. Download the mactrack plugin. Note that it's a zipfile, not a tarball.
3. Unzip the contents of the plugin into the mactrack directory
4. Back up your database.
5. Load the mactrack.sql file
6. Load the mactrack.sql.0.0.1 file
7. Run the database_upgrade.php script
8. Add it to your config.php

In actuality, there are a couple of caveats which can derail your installation completely.

Errors installing the OUI database

When database_upgrade.php finishes upgrading your database, it downloads a file containing the mapping between MAC prefixes and manufacturers. If you're not looking closely, you might miss a failure in this download:

Importing the Vendor MAC Address Table from the IEEE

Notice: Undefined variable: oui_file in /support/cacti/var/www/localhost/htdocs/cacti/plugins/mactrack/mactrack_import_ouidb.php on line 70
Getting OUI Database from the IEEE

Warning: file(): URL file-access is disabled in the server configuration in /support/cacti/var/www/localhost/htdocs/cacti/plugins/mactrack/lib/mactrack_functions.php on line 1576

Warning: file(http://standards.ieee.org/regauth/oui/oui.txt): failed to open stream: no suitable wrapper could be found in /support/cacti/var/www/localhost/htdocs/cacti/plugins/mactrack/lib/mactrack_functions.php on line 1576
OUI Database Download from IEEE Complete

Warning: Invalid argument supplied for foreach() in /support/cacti/var/www/localhost/htdocs/cacti/plugins/mactrack/lib/mactrack_functions.php on line 1600

There were '0' Entries Added/Updated in the database.
There were '0' Records Removed from the database.

Database Upgrade Complete

The errors in download mean that your database doesn't contain the maps to make MacTrack useful in identifying vendors. You can load this file on your own, though. Retrieve it from here, and save it into your mactrack directory as oui.txt. Run the following command to load it into the database:

% sudo php mactrack_import_ouidb.php -f=oui.txt
Getting OUI Database from the IEEE
OUI Database Download from IEEE Complete
......................................................... (continues)
There were '12439' Entries Added/Updated in the database.
There were '0' Records Removed from the database.

At this point your MacTrack installation is complete. Follow the remainder of the instructions for activating it in your config.php and using it to map your networks.