Debian/Ubuntu

Pārskats

Šajā sadaļā ir sniegti norādījumi, kā veikt jaunināšanu no Zabbix 7.4.x uz jaunāko Zabbix 8.0.x versiju, izmantojot oficiālās Zabbix pakotnes Debian/Ubuntu sistēmām.

Pirms jaunināšanas, lūdzu, pārskatiet attiecīgās jaunināšanas piezīmes un pārliecinieties, ka jūsu sistēma atbilst Zabbix 8.0 prasībām.

Apsveriet iespēju jaunināšanas laikā izmantot divas paralēlas SSH sesijas: vienu jaunināšanas darbību izpildei un otru servera/starpniekservera žurnālu uzraudzībai. Piemēram, otrajā sesijā palaidiet tail -f zabbix_server.log vai tail -f zabbix_proxy.log, lai reāllaikā skatītu jaunākos žurnāla ierakstus un iespējamās kļūdas. Tas var būt kritiski svarīgi produkcijas instancēm.

Norādījumus par jaunināšanu starp Zabbix 8.0.x mazajām versijām (piemēram, no 8.0.1 uz 8.0.3) skatiet sadaļā Jaunināšana starp mazajām versijām.

Jaunināšanas procedūra

1 Apturiet Zabbix procesus

Apturiet Zabbix serveri, lai pārliecinātos, ka datubāzē netiek ievietoti jauni dati:

systemctl stop zabbix-server

Ja jaunināt Zabbix starpniekserveri, aģentu vai aģentu 2, apturiet arī šos komponentus:

systemctl stop zabbix-proxy
systemctl stop zabbix-agent
systemctl stop zabbix-agent2
2 Izveidojiet Zabbix datubāzes dublējumu

Izveidojiet esošās Zabbix datubāzes dublējumu, lai pasargātu sevi no jaunināšanas kļūmēm (piemēram, diska vietas problēmām, elektroapgādes pārtraukuma vai neparedzētām problēmām).

3 Izveidojiet Zabbix konfigurācijas failu, PHP failu un Zabbix bināro failu dublējumkopiju

Izveidojiet esošo Zabbix konfigurācijas failu, PHP failu un Zabbix bināro failu dublējumkopiju.

Konfigurācijas failiem izpildiet:

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

PHP failiem un Zabbix binārajiem failiem izpildiet:

cp -R /usr/share/zabbix/ /opt/zabbix-backup/
cp -R /usr/share/zabbix-* /opt/zabbix-backup/
4 Atjauniniet repozitorija konfigurācijas pakotni

Pirms turpināt jaunināšanu, atinstalējiet pašreizējo Zabbix repozitorija pakotni:

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

Jums var būt nepieciešams arī manuāli noņemt visas vecās Zabbix pakotnes no darba direktorija (piemēram, rm zabbix-release_latest+debian12_all.deb) pirms jaunās pakotnes lejupielādes, lai novērstu to, ka pakotņu pārvaldnieks jaunināšanas procesa laikā atkārtoti izmanto novecojušu versiju.

Pēc tam instalējiet jaunāko repozitorija konfigurācijas pakotni, lai nodrošinātu saderību ar jaunākajām pakotnēm un iekļautu nesenos drošības ielāpus vai kļūdu labojumus.

Uz Debian 12 izpildiet:

wget https://repo.zabbix.com/zabbix/8.0/release/debian/pool/main/z/zabbix-release/zabbix-release_latest+debian12_all.deb
dpkg -i zabbix-release_latest+debian12_all.deb

Vecākām Debian versijām aizstājiet iepriekš norādīto saiti ar pareizo no Zabbix repozitorija. Tomēr ņemiet vērā, ka šo versiju pakotnes var neietvert visus Zabbix komponentus, un, lai šos komponentus jauninātu no pakotnēm, apsveriet iespēju jaunināt savu OS. Iekļauto komponentu sarakstu skatiet sadaļā Zabbix pakotnes.

Uz Ubuntu 24.04 izpildiet:

wget https://repo.zabbix.com/zabbix/8.0/release/ubuntu/pool/main/z/zabbix-release/zabbix-release_latest+ubuntu24.04_all.deb
dpkg -i zabbix-release_latest+ubuntu24.04_all.deb

Uz Ubuntu 22.04 izpildiet:

wget https://repo.zabbix.com/zabbix/8.0/release/ubuntu/pool/main/z/zabbix-release/zabbix-release_latest+ubuntu22.04_all.deb
dpkg -i zabbix-release_latest+ubuntu22.04_all.deb

Vecākām Ubuntu versijām aizstājiet iepriekš norādīto saiti ar pareizo no Zabbix repozitorija. Tomēr ņemiet vērā, ka šo versiju pakotnes var neietvert visus Zabbix komponentus, un, lai šos komponentus jauninātu no pakotnēm, apsveriet iespēju jaunināt savu OS. Iekļauto komponentu sarakstu skatiet sadaļā Zabbix pakotnes.

Jūs varat redzēt uzvedni par Zabbix repozitorija konfigurāciju:

Configuration file '/etc/apt/sources.list.d/zabbix.list'
==> Deleted (by you or by a script) since installation.
==> Package distributor has shipped an updated version.
What would you like to do about it ?  Your options are:
Y or I  : install the package maintainer's version
N or O  : keep your currently-installed version
D       : show the differences between the versions
Z       : start a shell to examine the situation
The default action is to keep your current version.
*** zabbix.list (Y/I/N/O/D/Z) [default=N] ?

Ievadiet Y (vai I), lai instalētu pakotnes uzturētāja Zabbix repozitorija konfigurācijas versiju.

Pēc tam atjauniniet repozitorija informāciju:

apt update
5 Zabbix komponentu jaunināšana

Lai jauninātu Zabbix komponentus, izpildiet:

apt install --only-upgrade zabbix-server-mysql zabbix-frontend-php zabbix-agent
  • Ja izmantojat PostgreSQL, komandā aizstājiet mysql ar pgsql.
  • Ja jaunināt starpniekserveri, komandā aizstājiet server ar proxy.
  • Ja jaunināt Zabbix aģents 2, komandā aizstājiet zabbix-agent ar zabbix-agent2 zabbix-agent2-plugin-*.

Jauninot Zabbix aģents 2 ar komandu apt install zabbix-agent2, var rasties kļūda. Plašāku informāciju skatiet sadaļā Zināmās problēmas.

Jūs varat redzēt uzvedni par Zabbix serveris (vai starpniekserveris) konfigurāciju:

Configuration file '/etc/zabbix/zabbix_server.conf'
==> Modified (by you or by a script) since installation.
==> Package distributor has shipped an updated version.
What would you like to do about it ?  Your options are:
Y or I  : install the package maintainer's version
N or O  : keep your currently-installed version
D       : show the differences between the versions
Z       : start a shell to examine the situation
The default action is to keep your current version.
*** zabbix_server.conf (Y/I/N/O/D/Z) [default=N] ?

Ievadiet opciju, kas vislabāk atbilst jūsu situācijai. Piemēram, ievadiet D, lai salīdzinātu pašreizējo un jauno konfigurāciju, pēc tam izlemiet, vai vēlaties instalēt pakotnes uzturētāja versiju (Y vai I).

Pēc tam, lai jauninātu Zabbix lietotāja saskarne ar Apache un restartētu Apache, izpildiet:

apt install zabbix-apache-conf
systemctl restart apache2
6 Pārskatiet komponentu konfigurācijas parametrus

Pārskatiet atbilstošās jaunināšanas piezīmes, lai pārbaudītu, vai konfigurācijas parametros ir nepieciešamas kādas izmaiņas.

Informāciju par jaunajiem neobligātajiem parametriem skatiet lapā Kas jauns.

7 Palaidiet Zabbix procesus

Palaidiet atjauninātos Zabbix komponentus:

systemctl start zabbix-server
systemctl start zabbix-proxy
systemctl start zabbix-agent
systemctl start zabbix-agent2
8 Notīriet tīmekļa pārlūka sīkfailus un kešatmiņu

Pēc jaunināšanas jums var būt nepieciešams notīrīt tīmekļa pārlūka sīkfailus un tīmekļa pārlūka kešatmiņu, lai Zabbix lietotāja saskarne darbotos pareizi.

Jaunināšana starp mazajām versijām

Ir iespējams jaunināt starp Zabbix 8.0.x mazajām versijām (piemēram, no 8.0.1 uz 8.0.3).

Vispirms atjauniniet repozitorija informāciju:

apt update

Pēc tam, lai jauninātu visus Zabbix komponentus, izpildiet:

apt install --only-upgrade 'zabbix*'
  • Lai jauninātu tikai Zabbix serveri, komandā aizstājiet 'zabbix*' ar 'zabbix-server*'.
  • Lai jauninātu tikai Zabbix starpniekserveri, komandā aizstājiet 'zabbix*' ar 'zabbix-proxy*'.
  • Lai jauninātu tikai Zabbix aģentu, komandā aizstājiet 'zabbix*' ar 'zabbix-agent*'.
  • Lai jauninātu tikai Zabbix aģentu 2, komandā aizstājiet 'zabbix*' ar 'zabbix-agent2*'.