Cacti System upgrade procedure

Updating Cacti can be easy or tricky depending on your system size and design.
In general, there are a few steps for a safe upgrade follow the below steps to properly and safely upgrade your cacti server

In this scenario, I am upgrading from Cacti 1.2.2 to 1.2.4 which is the latest release version at the time of this writing.



Step 1.) Stopping the poller cronjob this is important for consistency purposes we don’t want cron to run the polls while we are upgrading the system

add a # in front of the cron entry

#*/5 * * * * www-data php /var/www/html/cacti/poller.php > /dev/null 2>&1

Step 2.) Backup the cacti database

We use the mysqldump command to dump the database named cacti to cacti-backup.sql this is a very important step as the database contains all system settings such as user accounts and devices we are monitoring without the database your cacti instance will be back to scratch so again its important that we keep this backed up.

root@localhost:~# mysqldump -u root -p cacti > cacti-backup.sql
Enter password:
root@localhost:~# ls

Step 3.) Backup the existing cacti directory

In this case I am moving the cacti directory to the /tmp directory the cacti folder contains all of the files needed for cacti along with the graphs which are located in the RRA folder import notice if you have a large installation with many devices you might want to move this folder to a network share or something with a lot of space.

root@localhost:/var/www/html# cp -R cacti/ /tmp

Step 4.) Download the new version of cacti

I will be downloading the latest 1.2.4 release from the Cacti projects GitHub page wget
HTTP request sent, awaiting response… 200 OK
Length: unspecified [application/zip]
Saving to: ‘’ [ <=> ] 11.28M 6.26MB/s in 1.8s
2019-07-13 19:13:45 (6.26 MB/s) – ‘’ saved [11831094]


Step 5.) rename the current cacti directory in /var/www/html  to cacti-back

root@localhost:/var/www/html# mv cacti/ cacti-back


step 6.) copy the new cacti directory to /var/www/html

Moving the files in place of where the old files are essentially completes the upgrade we will need to apply the proper permissions as well

root@localhost:~# mv cacti/ /var/www/html/
root@localhost:~# chown -R www-data:www-data /var/www/html/cacti


Step 7.) copy the RRA and config file

this will copy your graphs along with your config file needed for cacti to access the database and other settings

root@localhost:~# cp /var/www/html/cacti-back/include/config.php /var/www/html/cacti/include/
root@localhost:~# cp -R /var/www/html/cacti-back/rra/* /var/www/html/cacti/rra/


Step 8.) Browse to the cacti page which should now bring you the web installer to complete the upgrade



See my below video tutorial on this procedure!


6 thoughts on “Cacti System upgrade procedure

  1. Hi Sean,
    There’s no directory called ‘Cacti’ in /var/www/html
    I’m running 1.2.2 on
    root@Cygnus:/etc/cacti# uname -a
    Linux Cygnus 4.19.0-13-amd64 #1 SMP Debian 4.19.160-2 (2020-11-28) x86_64 GNU/Linux

    ..and installed cacti with apt-get right after installing Debian on this pc I dedicated to running cacti.
    So I came screeching to a halt at step 3. Now I could go galavanting around the internet and figure this one out, but I’m afraid of breaking things.
    Could you nudge me in the right direction, please?


  2. Hi,
    I have upgraded cacti 0.0.8h in Centos 6.8 to cacti 1.2.17 but when I access obtain error:

    Parse error: syntax error, unexpected ‘[‘ in /var/www/html/cacti-1.2.17/lib/functions.php on line 5722

    But I can’t find where the error may be. Any help?

    5715 function get_running_user() {
    5716 global $config;
    5718 static $tmp_user = ”;
    5720 if (empty($tmp_user)) {
    5721 if (function_exists(‘posix_geteuid’)) {
    5722 $tmp_user = posix_getpwuid(posix_geteuid())[‘name’];
    5723 }
    5724 }

  3. Sean,
    I too have this issue, originally installed via apt-get, and currently on 1.2.10, I need to upgrade ubuntu distros. which removes cacti. once the OS is upgraded. apt-get currently only has 1.2.19 which has a small bug. so I would like to upgrade to rev 1.2.23 after the distro upgrade. any help you could extend my way?

  4. Hey Scott

    Honestly the best way around this is to download the Cacti source code and and manually install
    I find I have much better control over the install rather than installing via a package manager
    Also when there is a new version you can get it as soon as its available and not have to wait for the package maintainer to release the package

Leave a Reply

Your email address will not be published. Required fields are marked *

This site uses Akismet to reduce spam. Learn how your comment data is processed.