diff options
Diffstat (limited to 'net-mgmt/cacti88/files/pkg-message.in')
-rw-r--r-- | net-mgmt/cacti88/files/pkg-message.in | 87 |
1 files changed, 87 insertions, 0 deletions
diff --git a/net-mgmt/cacti88/files/pkg-message.in b/net-mgmt/cacti88/files/pkg-message.in new file mode 100644 index 000000000000..0a16e3c5fca8 --- /dev/null +++ b/net-mgmt/cacti88/files/pkg-message.in @@ -0,0 +1,87 @@ +======================================================================= +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. + +======================================================================= |