Documentation
Table of Contents
7 Upgrade procedure
Overzicht
Deze sectie biedt upgrade-informatie voor Zabbix 6.4:
- met behulp van pakketten:
- voor Red Hat Enterprise Linux
- voor Debian/Ubuntu
- met behulp van bronnen
Zie ook upgrade-instructies voor servers in een high-availability (HA) cluster.
Het upgraden van Zabbix agents wordt aanbevolen maar is niet verplicht.
Het sterk aanbevolen om Zabbix proxies te upgraden. Zabbix server ondersteunt volledig proxies van dezelfde hoofdversie als de server. Zabbix server ondersteunt ook proxies die niet ouder zijn dan de vorige LTS-releaseversie van Zabbix server, maar met beperkte functionaliteit (gegevensverzameling, uitvoering van externe commando's, onmiddellijke itemwaardecontroles). Configuratie-updates zijn ook uitgeschakeld, en verouderde proxies zullen alleen werken met oude configuraties.
Proxies die ouder zijn dan de vorige LTS-releaseversie van Zabbix server of nieuwer dan de hoofdversie van Zabbix server worden niet ondersteund. Zabbix server zal gegevens van niet-ondersteunde proxies negeren en alle communicatie met Zabbix server zal mislukken met een waarschuwing. Voor meer informatie, zie Versiecompatibiliteit.
Om de downtime en gegevensverlies tijdens de upgrade te minimaliseren, wordt aanbevolen om Zabbix server te stoppen, upgraden en starten en vervolgens de Zabbix proxies één voor één te stoppen, upgraden en starten. Tijdens de downtime van de server zullen actieve proxies doorgaan met het verzamelen van gegevens. Zodra de server operationeel is, zullen verouderde proxies de gegevens naar de nieuwere server sturen (de proxyconfiguratie wordt echter niet bijgewerkt) en zullen ze gedeeltelijk blijven functioneren. Eventuele meldingen van problemen tijdens de downtime van Zabbix server worden pas gegenereerd nadat de geüpgradede server is gestart.
Als Zabbix-proxy voor de eerste keer wordt gestart en het SQLite-databasebestand ontbreekt, maakt de proxy het automatisch aan. Let op dat vanaf Zabbix 6.4.0, als Zabbix-proxy SQLite3 gebruikt en bij het opstarten detecteert dat de huidige databasebestandsversie ouder is dan vereist, deze automatisch het databasebestand zal verwijderen en een nieuw zal aanmaken. Daarom gaan de historische gegevens die zijn opgeslagen in het SQLite-databasebestand verloren. Als de versie van de Zabbix-proxy ouder is dan de versie van het databasebestand, zal Zabbix een foutmelding registreren en afsluiten.
Afhankelijk van de databasesize kan de database-upgrade naar versie 6.4 geruime tijd in beslag nemen.
Directe upgrade naar Zabbix 6.4.x is mogelijk vanaf Zabbix 6.2.x, 6.0.x, 5.4.x, 5.2.x, 5.0.x, 4.4.x, 4.2.x, 4.0.x, 3.4.x, 3.2.x, 3.0.x, 2.4.x, 2.2.x en 2.0.x. Voor het upgraden van eerdere versies raadpleegt u de Zabbix-documentatie voor versie 2.0 en eerder.
Houd er rekening mee dat na de upgrade sommige integraties met software van derden in Zabbix mogelijk worden beïnvloed als de externe software niet compatibel is met de geüpgradede Zabbix-versie.
De volgende upgrade-opmerkingen zijn beschikbaar:
| Upgrade van | Lees volledige upgrade-opmerkingen | Belangrijkste wijzigingen tussen versies |
|---|---|---|
| 6.2.x | Voor: Zabbix 6.4 |
Minimaal vereiste MySQL-versie verhoogd van 8.0.0 naar 8.0.30. De 'libevent_pthreads'-bibliotheek is vereist voor de Zabbix-server/proxy. Bij de eerste start na een upgrade laat de Zabbix-proxy met SQLite3 automatisch de oude versie van de database vallen (met alle geschiedenis) en maakt een nieuwe aan. |
| 6.0.x LTS | Voor: Zabbix 6.2 Zabbix 6.4 |
Minimaal vereiste PHP-versie verhoogd van 7.2.5 naar 7.4.0. Deterministische triggers moeten tijdens de upgrade worden aangemaakt. Als binair loggen is ingeschakeld voor MySQL/MariaDB, vereist dit supergebruikersrechten of het instellen van de variabele/configuratieparameter log_bin_trust_function_creators = 1. Zie Databasecreatie-scripts voor instructies over hoe de variabele in te stellen. |
| 5.4.x | Voor: Zabbix 6.0 Zabbix 6.2 Zabbix 6.4 |
Minimaal vereiste databaseversies verhoogd. Server/proxy start niet als de database verouderd is. Auditlogboekrecords verloren gegaan vanwege wijziging van de databasestructuur. |
| 5.2.x | Voor: Zabbix 5.4 Zabbix 6.0 Zabbix 6.2 Zabbix 6.4 |
Minimaal vereiste databaseversies verhoogd. Aggregate items verwijderd als een afzonderlijk type. |
| 5.0.x LTS | Voor: Zabbix 5.2 Zabbix 5.4 Zabbix 6.0 Zabbix 6.2 Zabbix 6.4 |
Minimaal vereiste PHP-versie verhoogd van 7.2.0 naar 7.2.5. Wachtwoordhashingalgoritme gewijzigd van MD5 naar bcrypt. |
| 4.4.x | Voor: Zabbix 5.0 Zabbix 5.2 Zabbix 5.4 Zabbix 6.0 Zabbix 6.2 Zabbix 6.4 |
Ondersteuning voor IBM DB2 stopgezet. Minimaal vereiste PHP-versie verhoogd van 5.4.0 naar 7.2.0. Minimaal 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 Zabbix 6.2 Zabbix 6.4 |
Jabber, Ez Texting media types verwijderd. |
| 4.0.x LTS | Voor: Zabbix 4.2 Zabbix 4.4 Zabbix 5.0 Zabbix 5.2 Zabbix 5.4 Zabbix 6.0 Zabbix 6.2 Zabbix 6.4 |
Oudere proxies kunnen geen gegevens meer rapporteren aan een geüpgrade server. Nieuwere agents kunnen niet langer werken 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 Zabbix 6.2 Zabbix 6.4 |
'libpthread'- en 'zlib'-bibliotheken nu verplicht. Ondersteuning voor tekstprotocol zonder opmaak stopgezet en kop is verplicht. Ondersteuning voor Zabbix-agents van vóór versie 1.4 is niet langer beschikbaar. De parameter 'Server' 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 Zabbix 6.2 Zabbix 6.4 |
Ondersteuning voor SQLite als backend-database is niet langer beschikbaar voor Zabbix server/frontend. Perl Compatible Regular Expressions (PCRE) wordt ondersteund in plaats van POSIX-uitgebreid. 'libpcre'- en 'libevent'-bibliotheken zijn verplicht voor Zabbix server. Exit-codes zijn toegevoegd voor gebruikersparameters, externe opdrachten en systeem.run[] items zonder de 'nowait'-vlag, evenals voor scripts uitgevoerd door de Zabbix server. De 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 Zabbix 6.2 Zabbix 6.4 |
Database-upgrade kan traag zijn, afhankelijk van de grootte van de history-tabel. |
| 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 Zabbix 6.2 Zabbix 6.4 |
Minimaal 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 Zabbix 6.2 Zabbix 6.4 |
Node-gebaseerde gedistribueerde monitoring 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 Zabbix 6.2 Zabbix 6.4 |
Minimaal vereiste PHP-versie verhoogd van 5.1.6 naar 5.3.0. Hoofdlettergevoelige MySQL-database vereist voor correcte werking van de server; tekenreeks utf8 en collatie utf8_bin zijn vereist voor de juiste werking van de Zabbix-server met de MySQL-database. Zie databasecreatie-scripts. 'mysqli'-PHP-extensie vereist in plaats van 'mysql'. |