2 Debian/Ubuntu

Overzicht

Deze sectie biedt de stappen die nodig zijn voor een succesvolle upgrade van Zabbix 5.4.x naar Zabbix 6.0.x met behulp van de officiële Zabbix-pakketten voor Debian/Ubuntu.

Hoewel het upgraden van Zabbix-agenten niet verplicht is (maar wel aanbevolen), moeten de Zabbix-server en proxies van dezelfde belangrijke versie zijn. Daarom moeten bij een server-proxy configuratie zowel de Zabbix-server als alle proxies worden gestopt en geüpgraded. Het draaien van proxies tijdens het upgraden van de server levert geen voordeel meer op, aangezien bij de upgrade van de proxy hun oude gegevens worden verwijderd en er geen nieuwe gegevens worden verzameld totdat de proxyconfiguratie is gesynchroniseerd met de server.

Houd er rekening mee dat bij gebruik van een SQLite-database op proxies de historische gegevens van vóór de upgrade verloren zullen gaan, omdat de upgrade van een SQLite-database niet wordt ondersteund en het SQLite-databasebestand handmatig moet worden verwijderd. Wanneer de proxy voor de eerste keer wordt gestart en het SQLite-databasebestand ontbreekt, maakt de proxy het automatisch aan.

Afhankelijk van de grootte van de database kan het upgraden van de database naar versie 6.0 lang duren.

De volgende upgrade-aantekeningen zijn beschikbaar:

Houd er rekening mee dat bij het upgraden van Zabbix de databaseversies en de PHP-versie ook belangrijk zijn, dus zorg ervoor dat deze aan de minimale vereisten voldoen zoals vermeld in de upgrade-aantekeningen.

Zorg ervoor dat je een goede back-up maakt van je Zabbix-configuratie en database voordat je begint met de upgrade. Volg de instructies in de officiële Zabbix-documentatie voor een soepele upgrade van Zabbix naar versie 6.0. Veel succes!

Upgrade procedure

1 Stoppen van Zabbix-processen

Stop de Zabbix-server om ervoor te zorgen dat er geen nieuwe gegevens in de database worden ingevoegd.

service zabbix-server stop

Als je Zabbix-proxy aan het upgraden bent, stop dan ook de proxy.

service zabbix-proxy stop

2 Maak een back-up van de bestaande Zabbix-database

Dit is een zeer belangrijke stap. Zorg ervoor dat je een back-up hebt van je database. Dit zal van pas komen als de upgradeprocedure mislukt (gebrek aan schijfruimte, stroomuitval, elk onverwacht probleem).

3 Back-up configuratiebestanden, PHP-bestanden en Zabbix-binaries

Maak een back-up van Zabbix-binaries, configuratiebestanden en de map met PHP-bestanden.

Configuratiebestanden:

mkdir /opt/zabbix-backup/
       cp /etc/zabbix/zabbix_server.conf /opt/zabbix-backup/
       cp /etc/apache2/conf-enabled/zabbix.conf /opt/zabbix-backup/

PHP-bestanden en Zabbix-binaries:

cp -R /usr/share/zabbix/ /opt/zabbix-backup/
       cp -R /usr/share/zabbix-* /opt/zabbix-backup/

4 Bijwerken van de repository configuratiepakket

Om door te gaan met de update moet je huidige repositorypakket worden verwijderd.

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

Installeer vervolgens het nieuwe repository configuratiepakket.

Op Debian 12 voer uit:

wget https://repo.zabbix.com/zabbix/6.0/debian/pool/main/z/zabbix-release/zabbix-release_6.0-5+debian12_all.deb
       dpkg -i zabbix-release_6.0-5+debian12_all.deb

Op Debian 11 voer uit:

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

Op Debian 10 voer uit:

wget https://repo.zabbix.com/zabbix/6.0/debian/pool/main/z/zabbix-release/zabbix-release_6.0-1+debian10_all.deb
       dpkg -i zabbix-release_6.0-1+debian10_all.deb

Op Debian 9 voer uit:

wget https://repo.zabbix.com/zabbix/6.0/debian/pool/main/z/zabbix-release/zabbix-release_6.0-1+debian9_all.deb
       dpkg -i zabbix-release_6.0-1+debian9_all.deb

Op Ubuntu 20.04 voer uit:

wget https://repo.zabbix.com/zabbix/6.0/ubuntu/pool/main/z/zabbix-release/zabbix-release_6.0-1+ubuntu20.04_all.deb
       dpkg -i zabbix-release_6.0-1+ubuntu20.04_all.deb

Op Ubuntu 18.04 voer uit:

wget https://repo.zabbix.com/zabbix/6.0/ubuntu/pool/main/z/zabbix-release/zabbix-release_6.0-1+ubuntu18.04_all.deb
       dpkg -i zabbix-release_6.0-1+ubuntu18.04_all.deb

Op Ubuntu 16.04 voer uit:

wget https://repo.zabbix.com/zabbix/6.0/ubuntu/pool/main/z/zabbix-release/zabbix-release_6.0-1+ubuntu16.04_all.deb
       dpkg -i zabbix-release_6.0-1+ubuntu16.04_all.deb

Op Ubuntu 14.04 voer uit:

wget https://repo.zabbix.com/zabbix/6.0/ubuntu/pool/main/z/zabbix-release/zabbix-release_6.0-1+ubuntu14.04_all.deb
       dpkg -i zabbix-release_6.0-1+ubuntu14.04_all.deb

Werk de repository-informatie bij.

apt-get update

5 Upgrade Zabbix-componenten

Om Zabbix-componenten bij te werken, kun je iets dergelijks uitvoeren:

apt-get install --only-upgrade zabbix-server-mysql zabbix-frontend-php zabbix-agent

Als je PostgreSQL gebruikt, vervang dan mysql door pgsql in het commando. Als je de proxy aan het upgraden bent, vervang dan server door proxy in het commando. Als je de Zabbix agent 2 aan het upgraden bent, vervang dan zabbix-agent door zabbix-agent2 in het commando.

Daarna, om het webfrontend correct te upgraden met Apache, voer ook het volgende uit:

apt-get install zabbix-apache-conf

Distributies voorafgaand aan Debian 10 (buster) / Ubuntu 18.04 (bionic) / Raspbian 10 (buster) bieden geen PHP 7.2 of nieuwer, wat vereist is voor Zabbix frontend 6.0. Zie informatie over het installeren van Zabbix frontend op oudere distributies.

6 Bekijk configuratieparameters van componenten

Zorg ervoor dat je de Upgrade notities bekijkt om te controleren of er wijzigingen in de configuratieparameters vereist zijn.

7 Start Zabbix-processen

Start de bijgewerkte Zabbix-componenten.

service zabbix-server start
       service zabbix-proxy start
       service zabbix-agent start
       service zabbix-agent2 start

8 Wis cookies en cache van de webbrowser

Na de upgrade moet je mogelijk cookies en cache van de webbrowser wissen voor de Zabbix-webinterface om correct te werken.

Upgraden tussen kleine versies

Het is mogelijk om kleine versies van 6.0.x bij te werken (bijvoorbeeld van 6.0.1 naar 6.0.3). Het is eenvoudig.

Om een kleine versie van Zabbix te upgraden, voer het volgende uit:

sudo apt install --only-upgrade 'zabbix.*'

Om een kleine versie van Zabbix server te upgraden, voer het volgende uit:

sudo apt install --only-upgrade 'zabbix-server.*'

Om een kleine versie van Zabbix agent te upgraden, voer het volgende uit:

sudo apt install --only-upgrade 'zabbix-agent.*'

of, voor Zabbix agent 2:

sudo apt install --only-upgrade 'zabbix-agent2.*'