2 Debian/Ubuntu

Pārskats

Šajā sadaļā ir sniegti norādījumi par Zabbix 7.2.x atjaunināšanu uz jaunāko Zabbix 7.4.x versiju, izmantojot oficiālās Zabbix pakotnes Debian/Ubuntu vidēm.

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

Atjaunināšanas laikā ieteicams izmantot divas paralēlas SSH sesijas: vienu atjaunināšanas darbību veikšanai 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 ražošanas vidēs.

Norādījumus par atjaunināšanu starp Zabbix 7.4.x mazajām versijām (piemēram, no 7.4.1 uz 7.4.3) skatiet sadaļā Atjaunināš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 Dublējiet Zabbix konfigurācijas failus, PHP failus un Zabbix bināros failus

Dublējiet esošos Zabbix konfigurācijas failus, PHP failus un Zabbix bināros failus.

Konfigurācijas failiem izpildiet:

mkdir /opt/zabbix-backup/
cp /etc/zabbix/zabbix_server.conf /opt/zabbix-backup/
# Apache gadījumā:
cp /etc/apache2/conf-enabled/zabbix.conf /opt/zabbix-backup/
# Nginx gadījumā:
cp /etc/nginx/conf.d/zabbix.conf /opt/zabbix-backup/
cp /etc/zabbix/nginx.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

Iespējams, jums arī manuāli jānoņem jebkuras vecās Zabbix pakotnes no darba direktorijas (piem., rm zabbix-release_latest+debian12_all.deb) pirms jaunās lejupielādes, lai pakotņu pārvaldnieks jaunināšanas procesa laikā neizmantotu 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 nesenus drošības ielāpus vai kļūdu labojumus.

Uz Debian 13 izpildiet:

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

Uz Debian 12 izpildiet:

wget https://repo.zabbix.com/zabbix/7.4/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 saiti no Zabbix repozitorija. Tomēr ņemiet vērā, ka šo versiju pakotnes var neietvert visus Zabbix komponentus, un, lai jauninātu šos komponentus no pakotnēm, apsveriet operētājsistēmas jaunināšanu. Komplektā iekļauto komponentu sarakstu skatiet sadaļā Zabbix pakotnes.

Uz Ubuntu 26.04 izpildiet:

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

Uz Ubuntu 24.04 izpildiet:

wget https://repo.zabbix.com/zabbix/7.4/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/7.4/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 saiti no Zabbix repozitorija. Tomēr ņemiet vērā, ka šo versiju pakotnes var neietvert visus Zabbix komponentus, un, lai jauninātu šos komponentus no pakotnēm, apsveriet operētājsistēmas jaunināšanu. Komplektā iekļauto komponentu sarakstu skatiet sadaļā Zabbix pakotnes.

Var tikt parādīts uzvednis 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ā mysql aizstājiet ar pgsql.
  • Ja jaunināt starpniekserveri, komandā server aizstājiet ar proxy.
  • Ja jaunināt Zabbix aģentu 2, komandā zabbix-agent aizstājiet ar zabbix-agent2 zabbix-agent2-plugin-*.

Zabbix aģenta 2 jaunināšana ar komandu apt install zabbix-agent2 var izraisīt kļūdu. Papildinformāciju skatiet Known issues.

Var tikt parādīts uzvedne par Zabbix servera (vai starpniekservera) 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, un pēc tam izlemiet, vai vēlaties instalēt pakotnes uzturētāja versiju (Y vai I).

Pēc tam jauniniet Zabbix lietotāja saskarni un restartējiet tīmekļa serveri.

Apache gadījumā izpildiet:

apt install zabbix-apache-conf
systemctl restart apache2

Nginx gadījumā izpildiet:

apt install zabbix-nginx-conf
systemctl restart nginx

Nginx gadījumā var tikt parādīta uzvedne par nginx.conf konfigurācijas failu. Ievadiet opciju, kas vislabāk atbilst jūsu situācijai:

Configuration file '/etc/zabbix/nginx.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.
*** nginx.conf (Y/I/N/O/D/Z) [default=N] ?
6 Pārskatiet komponenta konfigurācijas parametrus

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

Par jauniem izvēles parametriem skatiet lapu Kas jauns.

Ja kā tīmekļa serveri izmantojat Nginx un ja jaunināšanas laikā tika atkārtoti instalēts konfigurācijas fails /etc/zabbix/nginx.conf, pārskatiet šo failu un atjauniniet direktīvas listen un server_name, lai tās atbilstu jūsu Zabbix lietotāja saskarnes konfigurācijai.

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 veikt jaunināšanu starp Zabbix 7.4.x mazajām versijām (piemēram, no 7.4.1 uz 7.4.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 serveris, komandā aizstājiet 'zabbix*' ar 'zabbix-server*'.
  • Lai jauninātu tikai Zabbix starpniekserveris, komandā aizstājiet 'zabbix*' ar 'zabbix-proxy*'.
  • Lai jauninātu tikai Zabbix aģents, komandā aizstājiet 'zabbix*' ar 'zabbix-agent*'.
  • Lai jauninātu tikai Zabbix aģents 2, komandā aizstājiet 'zabbix*' ar 'zabbix-agent2*'.