This is a translation of the original English documentation page. Help us make it better.

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.

Lees voordat je de upgrade uitvoert de relevante upgrade-aantekeningen!

De volgende upgrade-aantekeningen zijn beschikbaar:

Upgrade vanaf Lees de volledige upgrade-aantekeningen Belangrijkste wijzigingen tussen versies
5.4.x Voor:
Zabbix 6.0
Minimum vereiste databaseversies verhoogd;
Server/proxy start niet als de database verouderd is;
Auditloggegevens verloren gegaan vanwege de wijziging in de databasestructuur.
5.2.x Voor:
Zabbix 5.4
Zabbix 6.0
Minimum vereiste databaseversies verhoogd;
Samengevoegde items verwijderd als apart type.
5.0.x LTS Voor:
Zabbix 5.2
Zabbix 5.4
Zabbix 6.0
Minimum vereiste PHP-versie verhoogd van 7.2.0 naar 7.2.5.
4.4.x Voor:
Zabbix 5.0
Zabbix 5.2
Zabbix 5.4
Zabbix 6.0
Ondersteuning voor IBM DB2 verwijderd;
Minimum vereiste PHP-versie verhoogd van 5.4.0 naar 7.2.0;
Minimum vereiste databaseversies verhoogd;
Gewijzigde Zabbix PHP-bestandsdirectory.
4.2.x Voor:
Zabbix 4.4
Zabbix 5.0
Zabbix 5.2
Zabbix 5.4
Zabbix 6.0
Mediatypen Jabber en Ez Texting verwijderd.
4.0.x LTS Voor:
Zabbix 4.2
Zabbix 4.4
Zabbix 5.0
Zabbix 5.2
Zabbix 5.4
Zabbix 6.0
Oudere proxies kunnen geen gegevens meer rapporteren aan een geüpgradede server;
Nieuwere agents kunnen niet meer samenwerken met een oudere Zabbix-server.
3.4.x Voor:
Zabbix 4.0
Zabbix 4.2
Zabbix 4.4
Zabbix 5.0
Zabbix 5.2
Zabbix 5.4
Zabbix 6.0
Verplichte bibliotheken 'libpthread' en 'zlib';
Ondersteuning voor platte tekstprotocol verwijderd en koptekst is verplicht;
Ondersteuning voor oudere Zabbix-agentversies vóór 1.4 is verwijderd;
Het 'Server'-parameter in de configuratie van passieve proxy is nu verplicht.
3.2.x Voor:
Zabbix 3.4
Zabbix 4.0
Zabbix 4.2
Zabbix 4.4
Zabbix 5.0
Zabbix 5.2
Zabbix 5.4
Zabbix 6.0
Ondersteuning voor SQLite als backend-database verwijderd voor Zabbix-server/frontend;
Perl Compatible Regular Expressions (PCRE) wordt nu ondersteund in plaats van POSIX-uitgebreid;
'libpcre' en 'libevent' zijn verplicht voor de Zabbix-server;
Exit code-controles toegevoegd voor gebruikersparameters, externe opdrachten en system.run[]-items zonder de 'nowait'-vlag, evenals voor uitgevoerde scripts van Zabbix-server;
Zabbix Java-gateway moet worden geüpgraded om nieuwe functionaliteit te ondersteunen.
3.0.x LTS Voor:
Zabbix 3.2
Zabbix 3.4
Zabbix 4.0
Zabbix 4.2
Zabbix 4.4
Zabbix 5.0
Zabbix 5.2
Zabbix 5.4
Zabbix 6.0
Het upgraden van de database kan lang duren, afhankelijk van de grootte van de geschiedenistabel.
2.4.x Voor:
Zabbix 3.0
Zabbix 3.2
Zabbix 3.4
Zabbix 4.0
Zabbix 4.2
Zabbix 4.4
Zabbix 5.0
Zabbix 5.2
Zabbix 5.4
Zabbix 6.0
Minimum vereiste PHP-versie verhoogd van 5.3.0 naar 5.4.0;
LogFile agentparameter moet worden gespecificeerd.
2.2.x LTS Voor:
Zabbix 2.4
Zabbix 3.0
Zabbix 3.2
Zabbix 3.4
Zabbix 4.0
Zabbix 4.2
Zabbix 4.4
Zabbix 5.0
Zabbix 5.2
Zabbix 5.4
Zabbix 6.0
Distributie van bewaking op basis van nodes verwijderd
2.0.x Voor:
Zabbix 2.2
Zabbix 2.4
Zabbix 3.0
Zabbix 3.2
Zabbix 3.4
Zabbix 4.0
Zabbix 4.2
Zabbix 4.4
Zabbix 5.0
Zabbix 5.2
Zabbix 5.4
Zabbix 6.0
Minimum vereiste PHP-versie verhoogd van 5.1.6 naar 5.3.0;
Agentparameter LogFile moet worden gespecificeerd.
2.2.x LTS Voor:
Zabbix 2.4
Zabbix 3.0
Zabbix 3.2
Zabbix 3.4
Zabbix 4.0
Zabbix 4.2
Zabbix 4.4
Zabbix 5.0
Zabbix 5.2
Zabbix 5.4
Zabbix 6.0
Minimum vereiste PHP-versie verhoogd van 5.1.6 naar 5.3.0;
Agentparameter LogFile moet worden gespecificeerd.
2.2.x LTS Voor:
Zabbix 2.4
Zabbix 3.0
Zabbix 3.2
Zabbix 3.4
Zabbix 4.0
Zabbix 4.2
Zabbix 4.4
Zabbix 5.0
Zabbix 5.2
Zabbix 5.4
Zabbix 6.0
Minimum vereiste PHP-versie verhoogd van 5.1.6 naar 5.3.0;
Agentparameter LogFile moet worden gespecificeerd.
2.2.x LTS Voor:
Zabbix 2.4
Zabbix 3.0
Zabbix 3.2
Zabbix 3.4
Zabbix 4.0
Zabbix 4.2
Zabbix 4.4
Zabbix 5.0
Zabbix 5.2
Zabbix 5.4
Zabbix 6.0
Minimum vereiste PHP-versie verhoogd van 5.1.6 naar 5.3.0;
Agentparameter LogFile moet worden gespecificeerd.
2.2.x LTS Voor:
Zabbix 2.4
Zabbix 3.0
Zabbix 3.2
Zabbix 3.4
Zabbix 4.0
Zabbix 4.2
Zabbix 4.4
Zabbix 5.0
Zabbix 5.2
Zabbix 5.4
Zabbix 6.0
Minimum vereiste PHP-versie verhoogd van 5.1.6 naar 5.3.0;
Agentparameter LogFile moet worden gespecificeerd.
2.2.x LTS Voor:
Zabbix 2.4
Zabbix 3.0
Zabbix 3.2
Zabbix 3.4
Zabbix 4.0
Zabbix 4.2
Zabbix 4.4
Zabbix 5.0
Zabbix 5.2
Zabbix 5.4
Zabbix 6.0
Minimum vereiste PHP-versie verhoogd van 5.1.6 naar 5.3.0;
Agentparameter LogFile moet worden gespecificeerd.
2.0.x Voor:
Zabbix 2.2
Zabbix 2.4
Zabbix 3.0
Zabbix 3.2
Zabbix 3.4
Zabbix 4.0
Zabbix 4.2
Zabbix 4.4
Zabbix 5.0
Zabbix 5.2
Zabbix 5.4
Zabbix 6.0
Minimum vereiste PHP-versie verhoogd van 5.1.6 naar 5.3.0;
Agentparameter LogFile moet worden gespecificeerd.

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.

Het upgraden van Zabbix agent 2 met het commando apt install zabbix-agent2 kan leiden tot een fout. Voor meer informatie, zie Bekende problemen (Engels).

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.*'