Skip to content

Latest commit

 

History

History
237 lines (164 loc) · 8.27 KB

General-Installing-Instructions.md

File metadata and controls

237 lines (164 loc) · 8.27 KB

General Installing Instructions

Make sure the following packages are installed according to your operating systems requirements. Verify, that httpd/apache and mysqld/mariadb are started at system startup.

Required Packages for Most Operating Systems

Depending on your operating system and php version, certain packages are required for Cacti. The largest variability in these requirements come with regard to php and MySQL/MariaDB.

Installation requirements include the packages below. The installation of these packages will vary by operating system.

Base OS

  • apache, IIS, or nginx
  • net-snmp, net-snmp-utils
  • rrdtool
  • help2man` (for spine)
  • dos2unix (for spine)
  • development packages (gcc, automake, autoconf, libtool, help2man) (for spine)

Database

MySQL versions to 5.7 are supported. MariaDB to 10.2 is also supported.

  • mysql
  • mysql-server
  • libmysqlclient

or

  • mariadb
  • mariadb-server
  • libmariadbclient

PHP Modules

The installation of these modules vary by OS. Use the php -m command to verify that they are installed.

  • posix
  • session
  • sockets
  • PDO
  • pdo_mysql
  • xml
  • ldap
  • mbstring
  • pcre
  • json
  • openssl
  • gd
  • zlib

PHP Optional Modules

The following modules are optional, but preferred to be installed.

  • snmp
  • gmp (for plugin support)
  • com or dotnet (windows only)

Ports for FreeBSD

When installing on FreeBSD and variants, you must consider these packages.

  • www/apache2
  • net/rrdtool
  • net/net-snmp
  • www/php-cgi
  • lang/php (With MySQL and SNMP Support)
  • databases/mysql-server

Configure PHP

Verify that the modules are installed and configured correctly. There are several ways to do so - consult PHP configuration instructions for a complete description.

It is imperative that you set the date.timezone in your /etc/php.ini, or /etc/phpX/apache/php.ini and /etc/phpX/cli/php.ini files. Failure to do so will result in errors after the install is complete.

Most other PHP configuration is done automatically by the base OS, so there is no need to discuss that here.

Configure the Webserver (Apache)

Most Linux/UNIX OS' automatically configure the Web Server to allow PHP content. So there should be no need to provide additional configuration. However, the following section is included below for reference in the case that you are running a UNIX version that does not properly configure the Webserver properly. The documentation below is written specifically for RHEL and variants. So, the instructions may vary.

Find the file /etc/httpd/conf/httpd.conf or its equivalent and make the following changes to it:

# Load config files from the config directory "/etc/httpd/conf.d".
Include conf.d/*.conf

Now, locate the PHP configuration file at /etc/httpd/conf.d/php.conf

# PHP is an HTML-embedded scripting language which attempts to make it
# easy for developers to write dynamically generated webpages.
LoadModule php_module modules/libphp.so
#
# Cause the PHP interpreter to handle files with a .php extension.
AddHandler php-script .php
AddType text/html .php
#
# Add index.php to the list of files that will be served as directory
# indexes.
DirectoryIndex index.php

Configure MySQL/MariaDB

Set a password for the root user, and record this password. If you loose control of this password, you may have to re-install your database server in the case of any system disaster or recovering from a crash.

shell> mysqladmin --user=root password somepassword
shell> mysqladmin --user=root --password reload

You must also load timezone information into the database. This is required for various plugin use. Later, you will be required to grant access to the time_zone_name table during the final installation steps.

shell> mysql_tzinfo_to_sql /usr/share/zoneinfo | mysql -u root mysql

Since Cacti 1.x is supporting internationalization (i18n), it is important that the default character set for MySQL or MariaDB be i18n compatible. The Cacti installer will make specific recommendations on MySQL/MariaDB settings. Follow those as applicable for your OS.

Galera clustering: There are several tables which are set to use the MEMORY storage engine which do not get replicated among nodes which can cause problems. If you configure Cacti to only connect to one node of your cluster and are not load balancing this does not apply to you.

If you are running multiple nodes in a load-balanced environment where you connect to a VIP you should remove all but one node from rotation during Cacti installation or update. After the installation/update login to your MySQL server and execute the following commands to update those tables to use the InnoDB engine:

MariaDB [(none)]> use cacti;
MariaDB [cacti]>> ALTER TABLE `automation_ips` ENGINE=InnoDB;
MariaDB [cacti]>> ALTER TABLE `automation_processes` ENGINE=InnoDB;
MariaDB [cacti]>> ALTER TABLE `data_source_stats_hourly_cache` ENGINE=InnoDB;
MariaDB [cacti]>> ALTER TABLE `data_source_stats_hourly_last` ENGINE=InnoDB;
MariaDB [cacti]>> ALTER TABLE `poller_output` ENGINE=InnoDB;
MariaDB [cacti]>> ALTER TABLE `poller_output_boost_processes` ENGINE=InnoDB;

These changes should replicate to the other nodes in your cluster. Allow Cacti to run at least two or three full polling cycles before placing the other nodes back into rotation.

Install and Configure Cacti

  1. Extract the distribution tarball.
shell> tar xzvf cacti-version.tar.gz
  1. Create the MySQL database:
shell> mysqladmin --user=root create cacti
  1. Import the default cacti database:
shell> mysql cacti < cacti.sql
  1. Optional: Create a MySQL username and password for Cacti.
shell> mysql --user=root mysql
mysql> GRANT ALL ON cacti.* TO cactiuser@localhost IDENTIFIED BY 'somepassword';
mysql> GRANT SELECT ON mysql.time_zone_name TO cactiuser@localhost IDENTIFIED BY 'somepassword';
mysql> flush privileges;
  1. Edit include/config.php and specify the database type, name, host, user and password for your Cacti configuration.
$database_type = "mysql";
$database_default = "cacti";
$database_hostname = "localhost";
$database_username = "cactiuser";
$database_password = "cacti";
  1. Set the appropriate permissions on Cacti's directories for graph/log generation. You should execute these commands from inside Cacti's directory to change the permissions.
shell> chown -R cactiuser rra/ log/ cache/

(Enter a valid username for cactiuser, this user will also be used in the next step for data gathering.)

  1. Create a new file /etc/cron.d/cacti and add to it:
*/5 * * * * cactiuser php <path_cacti>/poller.php > /dev/null 2>&1

Replace cactiuser with the valid user specified in the previous step.

Replace <path_cacti> with your full Cacti path.

  1. During install, you will need to provide write access to the following files and directories:
shell> chown -R resource scripts include/config.php

Once the installation is complete, you may change the permissions to more restrictive settings.

  1. Point your web browser to:

    http://<your-server>/cacti/

    Log in the with a username/password of admin. You will be required to change this password immediately. Make sure to fill in all of the path variables carefully and correctly on the following screen.

(Optional) Install and Configure Spine

Spine is a very fast data collection engine, written in C. It is an optional replacement for cmd.php. If you decide to use it, you will have to install it explicitly. It does not come with cacti itself.

The easiest way is to install Spine using rpm or ports. You will find packages for Spine at the main cacti site or from your distribution.

To compile Spine, download it to any location of your liking. Then, issue from the downloaded directory following commands

shell>./bootstrap

If the boostrap script is successful, you then will follow the instructions it provides to compile and install.

Assuming, you've managed to install spine correctly, you will have to configure it. The configuration file may be placed in the same directory as spine itself or at /etc/spine.conf.

DB_Host  127.0.0.1 or hostname (not localhost)
DB_Database cacti
DB_User     cactiuser
DB_Password cacti
DB_Port     3306

Copyright (c) 2004-2019 The Cacti Group