1
0
mirror of https://git.FreeBSD.org/ports.git synced 2024-12-27 05:10:36 +00:00
freebsd-ports/net-mgmt/cacti/files/pkg-message.in
Kai Knoblich 1421d68aca net-mgmt/cacti: Update to 1.2.5
* Remove the SNMPBIN option that was introduced with r490477 and which is no
  longer required since the 1.2.4 release.

  It was used as a workaround to override the internal PHP SNMP calls which
  led to graphs that didn't update within cacti.

  The PHP SNMP extension can now be enabled/disabled by a re-purposed
  variable in the configuration file.

While I'm here:

* Remove superfluous "+=" from PLIST_SUB and SUB_LIST because there are no
  previous definitions of those variables.

* Remove CONFLICTS_INSTALL as net-mgmt/cacti88 is no longer present in the
  Ports tree since the end of 2018.

Changes since 1.2.3:

https://github.com/Cacti/cacti/blob/release/1.2.5/CHANGELOG

PR:		238434
Submitted by:	Michael Muenz <m.muenz@gmail.com>
Reported by:	Matthew Horan <matt@matthoran.com>
Approved by:	maintainer timeout (2+ months)
MFH:		2019Q3
2019-08-19 20:25:28 +00:00

108 lines
3.3 KiB
Plaintext

[
{ type: install
message: <<EOM
Cacti is now installed. If you install 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';
GRANT SELECT ON `mysql`.`time_zone_name` TO 'cacti'@'localhost';
FLUSH PRIVILEGES;
d) Import the default cacti database:
mysql --database=cacti -ucacti -p < %%PREFIX%%/%%CACTIDIR%%/cacti.sql
If you haven't already imported your MySQL timezone data, you need to do this:
mysql_tzinfo_to_sql /usr/share/zoneinfo | mysql -u root -p mysql
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:
(This assumes that you have installed a working PHP Apache install, e.g. with mod_php)
<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 follow the install instructions.
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:
1) Mount linprocfs in /compat/linux/proc will allow most scripts to work.
2) This package does not install a MySQL server in case you wish to use an
external MySQL server. Install a package such as mysql57-server if you
require a local server.
EOM
}
{ type: upgrade
maximum_version: "1.2.4"
message: <<EOM
Starting with version 1.2.4 the option SNMPBIN is no longer required and has
therefore been removed.
Now you can enable PHP integrated support via the "$php_snmp_support" variable
in config.php
EOM
}
]