Categories
Linux Zabbix

Upgrade Zabbix Proxy from 6.0 to 6.2

I was recently going through the process of upgrading one of my Zabbix Proxy nodes following the upgrade documentation from Zabbix and needless to say there were issues. That is why I have decided to document how to Upgrade Zabbix Proxy from 6.0 to 6.2. This process will probably work for 6.0/6.2 to 6.4, but I have not tested it yet.

Let’s step through the process of upgrading and I will show you were the issue is. We will be performing this work on a Debian/Ubuntu based machine.

Upgrade Procedure

Before you begin, you will need to stop the Zabbix Proxy Service

Sudo service zabbix-proxy stop

Once the service has been stopped you will then want to make a backup, just encase things don’t go as planned

sudo mkdir /opt/zabbix-backup/
sudo cp /etc/zabbix/zabbix_proxy.conf /opt/zabbix-backup/
sudo cp -R /usr/share/zabbix-* /opt/zabbix-backup/

Once the backups are complete you will need to update your repository configuration package. You will start by uninstalling your current repository package.

sudo rm -Rf /etc/apt/sources.list.d/zabbix.list

This is where the guide goes off the rails. Even if you uninstall the current package repository, it does not remove it from the sources list. I somehow figured out that you need to run the following or this process will not work.

sudo dpkg --purge zabbix-release

Once you run this command you can proceed as normal. You will need to download the a new repository package and install it. Please note that you will need to make sure that you are using the correct OS and version number. I am using Debian 11 in the below example.

sudo wget https://repo.zabbix.com/zabbix/6.2/debian/pool/main/z/zabbix-release/zabbix-release_6.2-1+debian11_all.deb
sudo dpkg -i zabbix-release_6.2-1+debian11_all.deb

Once you have installed the package you will need to run a apt update to refresh your package list

sudo apt-get update

Here is another part of the Zabbix guide that I have had varing levels of success with. The guide wants you do to the following

sudo apt-get install --only-upgrade zabbix-proxy-mysql zabbix-frontend-php zabbix-agent

However sometimes it will not perform the upgrade if there are dependencies that need to be addressed so you should be able to just get away with

sudo apt-get upgrade

After the upgrade has been compeleted you need to restart the services or the proxy will not work until you reboot.

sudo service zabbix-proxy start

To verify that the the upgrade was successful you should run

sudo zabbix_proxy -V

If it shows the correct version of zabbix then you are good to go.

I hope you found this guide to be helpful and if so please share it with your friends. Also check out our other article on how to upgrade your Zabbix Server 6.0 to 6.2.