mirror of
https://github.com/Cacti/cacti.git
synced 2026-11-09 05:26:50 +09:00
Tony Roman
32684a123b
git-svn-id: svn+ssh://repo.cacti.net/var/data/svnroot/cacti/branches/BRANCH_0_8_6/cacti@3458 860744bd-22fc-0310-8c96-e9fe5004b5ca
109 lines
4.4 KiB
Plaintext
109 lines
4.4 KiB
Plaintext
Cacti Readme File
|
|
|
|
REQUIREMENTS:
|
|
Cacti should be able to run on any Unix-based operating system with
|
|
the following requirements:
|
|
|
|
PHP 4.1+
|
|
MySQL 3.22+
|
|
|
|
PHP Must also be compiled as a standalone cgi binary. This is required
|
|
for data gathering in crontab. This requirement may go away in the future
|
|
if I decide to replace it with a small C program. If anyone wishes to
|
|
do this, please contact me first; that would be much appreciated.
|
|
|
|
Cacti has been successfully run on the following operating systems:
|
|
|
|
Redhat 9 (Linux 2.4.20-8)
|
|
Redhat 8.0 (Linux 2.4.18-14)
|
|
Redhat 7.3 (Linux 2.4.18-3)
|
|
Redhat 7.2 (Linux 2.4.9-13)
|
|
Redhat 7.1 (Linux 2.4.9-6)
|
|
FreeBSD 4.2
|
|
FreeBSD 4.8
|
|
Windows 2000 Professional/Server
|
|
Windows XP Professional
|
|
Slackware 8.0
|
|
Debian Linux
|
|
SuSE Linux 7.3
|
|
AIX 4.3
|
|
|
|
A Note About RRDtool:
|
|
|
|
RRDTool is available in 2 versions, 1.0.x and 1.2.x, both are supported
|
|
by Cacti. Please remember to confirm your Cacti settings for the RRDtool
|
|
version if you having problem rendering graphs.
|
|
|
|
Also important to note in version Cacti 0.8.6h and above, graph items with
|
|
no color assigned are now properly presented to RRDTool. The upgraded
|
|
will fix graph items that will cause your graphs not to render, but as
|
|
always, please remember to backup before you proceed to upgrade.
|
|
|
|
A Note About Debian:
|
|
|
|
Under Debian Linux, the PHP binary is available as the php4-cgi package.
|
|
This package creates a separate php.ini, so you must edit your
|
|
'php4/cgi/php.ini' file and add line that says 'extension=mysql.so'.
|
|
|
|
If you get cacti running on other operating systems, please contact me, I
|
|
will add the names to the list.
|
|
|
|
A Note About SuSE 7.3:
|
|
|
|
The SNMP support that comes with PHP 4.0.6 does not appear to work correctly
|
|
under SuSE Linux 7.3. It is recommended that you go to http://www.php.net/,
|
|
download the newest source and compile a new PHP-binary with SNMP support.
|
|
|
|
INFORMATION ABOUT CACTI:
|
|
|
|
Cacti is a complete frontend to RRDTool, it stores all of the necessary
|
|
information to create graphs and populate them with data in a MySQL database.
|
|
The frontend is completely PHP driven. Along with being able to maintain
|
|
Graphs, Data Sources, and Round Robin Archives in a database, cacti handles
|
|
the data gathering. There is also SNMP support for those used to creating
|
|
traffic graphs with MRTG.
|
|
|
|
Data Sources
|
|
|
|
To handle data gathering, you can feed cacti the paths to any external
|
|
script/command along with any data that the user will need to "fill in",
|
|
cacti will then gather this data in a cron-job and populate a MySQL
|
|
database/the round robin archives.
|
|
|
|
Data Sources can also be created, which correspond to actual data on the
|
|
graph. For instance, if a user would want to graph the ping times to a host,
|
|
you could create a data source utilizing a script that pings a host and returns
|
|
it's value in milliseconds. After defining options for RRDTool such as how to
|
|
store the data you will be able to define any additional information that the
|
|
data input source requires, such as a host to ping in this case. Once a data
|
|
source is created, it is automatically maintained at 5 minute intervals.
|
|
|
|
Graphs
|
|
|
|
Once one or more data sources are defined, an RRDTool graph can be created
|
|
using the data. Cacti allows you to create almost any imaginable RRDTool graph
|
|
using all of the standard RRDTool graph types and consolidation functions.
|
|
A color selection area and automatic text padding function also aid in the
|
|
creation of graphs to make the process easier.
|
|
|
|
Not only can you create RRDTool based graphs in cacti, but there are many
|
|
ways to display them. Along with a standard "list view" and a "preview mode",
|
|
which resembles the RRDTool frontend 14all, there is a "tree view", which
|
|
allows you to put graphs onto a hierarchical tree for organizational purposes.
|
|
|
|
User Management
|
|
|
|
Due to the many functions of cacti, a user based management tool is built in
|
|
so you can add users and give them rights to certain areas of cacti. This would
|
|
allow someone to create some users that can change graph parameters, while
|
|
others can only view graphs. Each user also maintains their own settings when
|
|
it comes to viewing graphs.
|
|
|
|
Templating
|
|
|
|
Lastly, cacti is able to scale to a large number of data sources and graphs
|
|
through the use of templates. This allows the creation of a single graph or
|
|
data source template which defines any graph or data source associated with it.
|
|
Host templates enable you to define the capabilities of a host so cacti can
|
|
poll it for information upon the addition of a new host.
|