Virtual AppliancesTM HOME PRODUCTS DOWNLOADS PARTNERS SUPPORT CONTACT

README for Virtual Appliances Cacti 1.0.180

Updated: October 14 2007

Updates available at virtualappliances.net


What is Cacti?

Cacti is a complete network graphing solution designed to harness the power of RRDTool's data storage and graphing functionality. Cacti provides a fast poller, advanced graph templating, multiple data acquisition methods, and user management features out of the box. All of this is wrapped in an intuitive, easy to use interface that makes sense for LAN-sized installations up to complex networks with hundreds of devices.

Cacti information (including full documentation, screenshots, support forum, and additional scripts) can be found at: cacti.net

Changelog

Build 110

PHP binary now has SNMP support (#146)
Required by certain Cacti plugins
Added missing Cracklib package (req'd for passwd) (#145)
User feedback from forums
Added missing /usr/bin/php (#144)
User feedback from forums; some PEAR applications depend on /usr/bin/php for installation.

Build 97

Now supports user-installable Cacti extensions/plugins
Cacti pseudo-filesystem exported which contains "scripts" and "resource" directories.
Improved network configuration
Easier to use, allow configuration of static network routes.
Shell access now enabled!
For the first time ever, shell access has been enabled via console logins and SSH (via Dropbear SSH server).
Out-of-the-box dual disk configuration
The first disk contains the operating system, the second contains the MySQL database and Cacti data. It's now easy to expand a Cacti VA simply by creating a new second disk. Data from an existing installation can be migrated to the new disk simply by attaching the old disk and copying data across.
Virtual Appliances Management Console improvements
Improvements to the web administration interface.

Running the Cacti VA for the first time

During the first run, a simple wizard is displayed for configuring Cacti. It should be noted that none of these settings need to be changed from the defaults.

It is safe to click Next, Next, Next, and Done.

During the first login to Cacti server (not to be confused with the Virtual Appliances web administration interface), you will be prompted to change your password.

NOTE: the default user name/password for Cacti is admin/admin.

Cacti Extensions/Plugins

A pseudo-filesystem exporting the Cacti scripts and resource directory is shared as "cacti" using the standard SMB/CIFS protocol. This will allow installing Cacti extensions and plugins without having to manually copy files into the VA.

The default SMB/CIFS user name/password is "admin/admin".

The cacti share can be accessed by any capable Windows or SMB client using the following UNC path:

\\<IP address or host name of VA>\cacti

This share can be disabled using the VA webadmin console (under "Configure Samba").

For security purposes, it is strongly recommended to disable the Samba server once completed importing files into the web server.

Shell Access

The Username/password is 'root/root'. Please change this password if using the Cacti VA in a production environment.

As there is currently no Virtual Appliances Management Console interface for the SSH server, it is up to the user to manually disable the SSH daemon if necessary.

Enabling Client-side Multicast DNS (mDNS)

All Virtual Appliances are mDNS aware. In order to make Windows & Linux clients mDNS aware, it is necessary to configure and/or enable the functionality.

Multicast DNS allows the Cacti VA to be referenced by the host name "cacti.local."

Windows

Install the freely downloadable Bonjour for Windows package.

Linux

nss-mdns needs to be installed and configured.

MySQL Security -- PLEASE READ

It is *STRONGLY* recommended that MySQL user privileges be reviewed prior to making a MySQL server publicly accessible. In particular, it is essential that a password be applied to the 'root' user.

The default MySQL superuser name is 'root' without a password.

For more information, see General Security Issues in the MySQL 5.0 manual.

phpMyAdmin

phpMyAdmin is a comprehensive management/administration tool for MySQL. It provides all the functionality required to manage users, and databases through an SSL web interface and comes pre-installed.

phpMyAdmin is accessible at HTTPS on the VA host

Storage Space

The Cacti VA is configured with two virtual hard disks. The first disk contains the base operating system and a master 'image' of Cacti. The second disk is the data disk. It can be safely replaced with a larger virtual disk. The Cacti VA will automatically migrate necessary files to the new virtual hard disk.

The default installation includes a 2GB data virtual hard disk, which will contain Cacti data and the MySQL database used by Cacti.

NOTE: The Cacti VA cannot run without a second data virtual hard disk.

Migrating from an existing Cacti VA

This procedure involves manually adding the old Cacti VMDK to the current Cacti VA, copying data, and removing the old Cacti VMDK.

The Cacti data is stored in the following subdirectories within the Cacti VA:

It is also necessary to migrate the MySQL database (found in /data/mysql) in order to retain Cacti information. This can be done by copying the entire datastore from /var/lib/mysql or by exporting data using phpMyAdmin and re-importing into the new Cacti MySQL instance.

Once the data has been successfully migrated to the new location, it is necessary to adjust some Cacti settings.

Cacti log location

  1. Click "Console" to display the Cacti admin console
  2. Click "Settings" (under Configuration) to display "Cacti Settings"
  3. Click "Paths" tab
  4. Adjust the setting of "Cacti Log File Path" to be /webapps/cacti

Rebuild poller cache

  1. Click "System Utilities" (under "Utilities" on the left toolbar)
  2. Click "Rebuild Poller Cache"

Backups

Use phpMyAdmin or other remote MySQL administration tool to create/manage database backups.

Please note, there is no direct access to the MySQL command-line utilities from within the VA.

Advanced Network Settings

Static Network Routes

The Cacti Virtual Appliance now supports end-user configured static network routes. These can be configured from within the Networking section of the Virtual Appliances Management Console.

Firewall

Not currently implemented

Adjusting memory in virtual machine

The default memory allocation for the Cacti VA is 256MB. Please adjust accordingly depending on system load, database size(s), and the number of hosts being monitored.


Copyright © 2006-2007 Virtual Appliances. All Rights Reserved.