Web-driven graphing interface for RRDTool (Old version of net-mgmt/cacti) New releases of Cacti are still unable to work with useful plugins like "GPS Map" and "Network Weathermap". While here, minor fixes and get improvements from the current port. PR: 219685 Submitted by: Vinicius Zavam <egypcio@googlemail.com> Approved by: garga (mentor) Differential Revision: https://reviews.freebsd.org/D11023
87 lines
2.7 KiB
Text
87 lines
2.7 KiB
Text
=======================================================================
|
|
Cacti is now installed. If you intall it for the first time,
|
|
you may have to follow this steps to make it work correctly:
|
|
|
|
1. Create the MySQL database, a cacti user, and initialize:
|
|
a) CREATE DATABASE cacti;
|
|
b) Create a mysql user/password for cacti:
|
|
CREATE USER 'cacti'@'localhost' IDENTIFIED BY 'password';
|
|
FLUSH PRIVILEGES;
|
|
c) Add GRANTS:
|
|
GRANT ALL ON cacti.* TO 'cacti'@'localhost';
|
|
FLUSH PRIVILEGES;
|
|
d) Import the default cacti database:
|
|
mysql --database=cacti -ucacti -p < %%PREFIX%%/%%CACTIDIR%%/cacti.sql
|
|
|
|
NOTE:
|
|
* Cacti does not LOCK TABLES.
|
|
|
|
2. Edit %%PREFIX%%/%%CACTIDIR%%/include/config.php from the template
|
|
config.php.orig.
|
|
|
|
PHP requires the time zone to be explicitly set rather that rely on
|
|
the system time zone, otherwise poller complains. I added the
|
|
following line to my config.php:
|
|
|
|
date_default_timezone_set('America/Los_Angeles');
|
|
|
|
3. Add the following line to cron for %%CACTIUSER%%:
|
|
*/5 * * * * %%LOCALBASE%%/bin/php %%PREFIX%%/%%CACTIDIR%%/poller.php > /dev/null 2>&1
|
|
|
|
4. Example Apache 2.4 configuration:
|
|
|
|
LoadModule php5_module libexec/apache22/libphp5.so
|
|
|
|
<FilesMatch "\.php$">
|
|
SetHandler application/x-httpd-php
|
|
</FilesMatch>
|
|
<FilesMatch "\.phps$">
|
|
SetHandler application/x-httpd-php-source
|
|
</FilesMatch>
|
|
|
|
DirectoryIndex index.php
|
|
|
|
DocumentRoot "/usr/local/share/cacti"
|
|
|
|
Alias /cacti "/usr/local/share/cacti/"
|
|
Alias /Cacti "/usr/local/share/cacti/"
|
|
|
|
<Directory "/usr/local/share/cacti">
|
|
Require all granted
|
|
AllowOverride None
|
|
Order Allow,deny
|
|
Allow from all
|
|
</Directory>
|
|
|
|
5. Open a Cacti login page in your web browser and login with
|
|
admin/admin.
|
|
|
|
If you update cacti, open a login page and an updating process will
|
|
start automatically.
|
|
|
|
NOTEs as of 10Aug2014:
|
|
|
|
1) Cacti now better supports hier(7)
|
|
|
|
a) Cacti log files are now found under /var/log/cacti where you can
|
|
manage them using newsyslog.
|
|
b) Cacti RRD files are now found under /var/db/cacti/rra.
|
|
|
|
If you have an existing Cacti installation these paths are also
|
|
found in Cacti's SQL database and MUST be updated. These two SQL
|
|
commands should do the trick:
|
|
|
|
UPDATE settings SET value='/var/log/cacti/log' \
|
|
WHERE name='path_cactilog';
|
|
|
|
UPDATE poller_item SET rrd_path=\
|
|
REPLACE(rrd_path,'/usr/local/share/cacti/rra','/var/db/cacti/rra') \
|
|
WHERE rrd_path REGEXP '^/usr/local/share/cacti/rra';
|
|
|
|
2) The PERL paths in the Cacti PERL scripts have been updated to
|
|
/usr/local/bin.
|
|
|
|
Other Erratas:
|
|
Mount linprocfs in /compat/linux/proc will alow most scripts to work.
|
|
|
|
=======================================================================
|