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.