Cacti v0.8.7e for Linux/Unix

The Cacti Manual Ian Berry Tony Roman Larry Adams J.P. Pasnak Jimmy Conner Reinhard Scheck Copyright © 2008 The Cacti Group This project is licensed under the terms of the GPL. This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. All product names are property of their respective owners. Such names are used for identification purposes only and are not indicative of endorsement by or of any company, organization, product, or platform. -------------------------------------------------------------------------- Table of Contents I. [1]Installation [2]Requirements [3]Installing Under Unix [4]Required Packages for RPM-based Operating Systems [5]Ports for FreeBSD [6]Configure PHP [7]Configure the Webserver (Apache) [8]Configure MySQL [9]Install and Configure Cacti [10](Optional) Install and Configure Spine [11]Apply Patches [12]Installing Under Windows [13]Upgrading Cacti II. [14]Basics [15]Principles of Operation [16]Data Retrieval [17]Data Storage [18]Data Presentation [19]Graph Overview [20]How to Graph Your Network [21]Creating a Device [22]Creating the Graphs [23]Viewing Graphs [24]Graph Trees [25]User Management [26]Editing an existing User [27]Creating a New User [28]Copying a user [29]Enable/Disable Users [30]Batch Copy Users [31]Delete Users [32]Guest (Anonymous) Access III. [33]Advanced Topics [34]Graph a Single SNMP OID [35]Data Input Methods [36]Creating a Data Input Method [37]Making Your Scripts Work With Cacti [38]Data Queries [39]Creating a Data Query [40]SNMP Query XML Syntax [41]Script Query XML Syntax [42]Templates [43]Data Templates [44]Graph Templates [45]Host Templates [46]Import Templates [47]Export Templates [48]PHP Script Server [49]Using the Script Server [50]Upgrade Steps for the Example HostMib Data Queries [51]Migration of Existing PHP Scripts to Script Server [52]Testing Your Script in the Script Server [53]Spine IV. [54]Help [55]How To [56]Simplest Method of Going from Script to Graph (Walkthrough) [57]Frequently Asked Questions V. [58]Reference [59]Variables [60]Graph Variables [61]Host Variables [62]RRDTool Specific Features [63]GPRINT Presets [64]CDEFs [65]Command Line Scripts [66]Rebuild Poller Cache [67]Re-Index Hosts [68]Empty Poller Output Table [69]Reapply Suggested Names to Graphs [70]Copy Local Cacti Users [71]Add a New Device [72]Associate a Data Query to an existing Host [73]Associate a Graph Template to an existing Host [74]Add a New Graph [75]Add Items to a Tree [76]Add Graph Permissions [77]Debugging [78]Check Cacti Log File [79]Check Basic Data Gathering [80]Check cacti's poller [81]Check MySQL updating [82]Check rrd file updating [83]Check rrd file ownership [84]Check rrd file numbers [85]Check rrdtool graph statement [86]Miscellaneous [87]RPM Installation? [88]Not NaN, but 0 (zero) values? I. Installation Table of Contents [89]Requirements [90]Installing Under Unix [91]Installing Under Windows [92]Upgrading Cacti -------------------------------------------------------------------------- Requirements Cacti requires that the following software is installed on your system. * RRDTool 1.0.49 or 1.2.x or greater * MySQL 4.1.x or 5.x or greater * PHP 4.3.6 or greater, 5.x greater highly recommended for advanced features * A Web Server e.g. Apache or IIS -------------------------------------------------------------------------- Installing Under Unix Please make sure, the following packages are installed according to your operating systems requirements. Verify, that httpd and mysqld are started at system startup. -------------------------------------------------------------------------- Required Packages for RPM-based Operating Systems * httpd * php * php-mysql * php-snmp * mysql * mysql-server * net-snmp -------------------------------------------------------------------------- Ports for FreeBSD * www/apache2 * net/rrdtool * net/net-snmp * www/php4-cgi * lang/php4 (With MySQL and SNMP Support) * databases/mysql323-server -------------------------------------------------------------------------- Configure PHP Please ensure, that PHP support is either builtin or installed for the following PHP extension modules: * mysql (For configuration, see note below) * SNMP (For configuration, see note below) * XML * Session * Sockets * LDAP (Required only when using LDAP authentication) * GD (Required only for some Plugins) You may run the following command to get the list of all available PHP modules php -m Please verify, that the modules are installed and configured correctly. There are several ways to do so, please consult [93]PHP configuration instructions for a complete description. We will continue using the most recommended way of configuring php ex