Debian/Ubuntu

Przegląd

W tej sekcji przedstawiono instrukcje dotyczące aktualizacji z Zabbix 8.0.x do najnowszej wersji Zabbix 8.2.x przy użyciu oficjalnych pakietów Zabbix dla systemów Debian/Ubuntu.

Instrukcje dotyczące aktualizacji między wersjami pośrednimi Zabbix 8.2.x (na przykład z 8.2.1 do 8.2.3) znajdziesz w sekcji Aktualizacja między wersjami pośrednimi.

Procedura aktualizacji

1 Zatrzymaj procesy Zabbix

Zatrzymaj serwer Zabbix, aby upewnić się, że do bazy danych nie są wstawiane żadne nowe dane:

systemctl stop zabbix-server

Jeśli aktualizujesz Zabbix proxy, agent lub agent 2, zatrzymaj również te komponenty:

systemctl stop zabbix-proxy
systemctl stop zabbix-agent
systemctl stop zabbix-agent2

2 Utwórz kopię zapasową bazy danych Zabbix

Utwórz kopię zapasową istniejącej bazy danych Zabbix, aby zabezpieczyć się przed niepowodzeniem aktualizacji (na przykład z powodu braku miejsca na dysku, utraty zasilania lub nieoczekiwanych problemów).

3 Utwórz kopię zapasową plików konfiguracyjnych Zabbix, plików PHP i binariów Zabbix

Utwórz kopię zapasową istniejących plików konfiguracyjnych Zabbix, plików PHP i binariów Zabbix.

W przypadku plików konfiguracyjnych uruchom:

mkdir /opt/zabbix-backup/
cp /etc/zabbix/zabbix_server.conf /opt/zabbix-backup/
# Dla Apache:
cp /etc/apache2/conf-enabled/zabbix.conf /opt/zabbix-backup/
# Dla Nginx:
cp /etc/nginx/conf.d/zabbix.conf /opt/zabbix-backup/
cp /etc/zabbix/nginx.conf /opt/zabbix-backup/

W przypadku plików PHP i binariów Zabbix uruchom:

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

4 Aktualizacja pakietu konfiguracji repozytorium

Przed rozpoczęciem aktualizacji odinstaluj bieżący pakiet repozytorium Zabbix:

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

Może być również konieczne ręczne usunięcie starych pakietów Zabbix z katalogu roboczego (np. rm zabbix-release_latest+debian12_all.deb) przed pobraniem nowego pakietu, aby zapobiec ponownemu użyciu nieaktualnej wersji przez menedżera pakietów podczas procesu aktualizacji.

Następnie zainstaluj najnowszy pakiet konfiguracji repozytorium, aby zapewnić zgodność z najnowszymi pakietami oraz uwzględnić najnowsze poprawki bezpieczeństwa i błędów.

W systemie Debian 13 uruchom:

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

W systemie Debian 12 uruchom:

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

W systemie Ubuntu 26.04 uruchom:

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

W systemie Ubuntu 24.04 uruchom:

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

W systemie Ubuntu 22.04 uruchom:

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

Może zostać wyświetlony monit dotyczący konfiguracji repozytorium Zabbix:

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] ?

Wpisz Y (lub I), aby zainstalować wersję konfiguracji repozytorium Zabbix dostarczoną przez opiekuna pakietu.

Następnie zaktualizuj informacje o repozytorium:

apt update

5 Aktualizacja komponentów Zabbix

Aby zaktualizować komponenty Zabbix, uruchom:

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

• Jeśli używasz PostgreSQL, zamień mysql na pgsql w poleceniu.
• Jeśli aktualizujesz proxy, zamień server na proxy w poleceniu.
• Jeśli aktualizujesz agenta Zabbix 2, zamień zabbix-agent na zabbix-agent2 zabbix-agent2-plugin-* w poleceniu.

Może pojawić się monit dotyczący konfiguracji serwera Zabbix (lub proxy):

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] ?

Wprowadź opcję, która najlepiej odpowiada Twojej sytuacji. Na przykład wprowadź D, aby porównać bieżącą i nową konfigurację, a następnie zdecyduj, czy chcesz zainstalować wersję opiekuna pakietu (Y lub I).

Następnie zaktualizuj frontend Zabbix i uruchom ponownie serwer WWW.

W przypadku Apache uruchom:

apt install zabbix-apache-conf
systemctl restart apache2

W przypadku Nginx uruchom:

apt install zabbix-nginx-conf
systemctl restart nginx

W przypadku Nginx może pojawić się monit dotyczący pliku konfiguracyjnego nginx.conf. Wprowadź opcję, która najlepiej odpowiada Twojej sytuacji:

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] ?

Jeśli po aktualizacji musisz zainstalować dodatkowy pakiet Zabbix z tego samego repozytorium, apt może podczas rozwiązywania zależności wybrać aktualizację już zainstalowanych pakietów Zabbix. Aby uniknąć aktualizacji zainstalowanego pakietu serwera Zabbix lub proxy, tymczasowo wstrzymaj ten pakiet przed instalacją, a następnie usuń wstrzymanie:

apt-mark hold zabbix-server-mysql
apt install zabbix-sender
apt-mark unhold zabbix-server-mysql

6 Przejrzyj parametry konfiguracji komponentu

Przejrzyj odpowiednie uwagi dotyczące aktualizacji, aby sprawdzić, czy konieczne są jakiekolwiek zmiany w parametrach konfiguracji.

Informacje o nowych opcjonalnych parametrach znajdują się na stronie Co nowego.

Jeśli jako serwer WWW używasz Nginx, a plik konfiguracyjny /etc/zabbix/nginx.conf został ponownie zainstalowany podczas aktualizacji, przejrzyj ten plik i zaktualizuj dyrektywy listen oraz server_name, aby odpowiadały konfiguracji frontend Zabbixa.

7 Uruchom procesy Zabbix

Uruchom zaktualizowane komponenty Zabbix:

systemctl start zabbix-server
systemctl start zabbix-proxy
systemctl start zabbix-agent
systemctl start zabbix-agent2

8 Wyczyść pliki cookie i pamięć podręczną przeglądarki internetowej

Po aktualizacji może być konieczne wyczyszczenie plików cookie i pamięci podręcznej przeglądarki internetowej, aby interfejs webowy Zabbix działał prawidłowo.

Aktualizacja między wersjami pomniejszymi

Możliwe jest przeprowadzenie aktualizacji między wersjami pomniejszymi Zabbix 8.2.x (na przykład z wersji 8.2.1 do 8.2.3).

Najpierw zaktualizuj informacje o repozytorium:

apt update

Następnie, aby zaktualizować wszystkie komponenty Zabbix, uruchom:

apt install --only-upgrade 'zabbix*'

• Aby zaktualizować tylko serwer Zabbix, zastąp 'zabbix*' ciągiem 'zabbix-server*' w poleceniu.
• Aby zaktualizować tylko proxy Zabbix, zastąp 'zabbix*' ciągiem 'zabbix-proxy*' w poleceniu.
• Aby zaktualizować tylko agent Zabbix, zastąp 'zabbix*' ciągiem 'zabbix-agent*' w poleceniu.
• Aby zaktualizować tylko agent 2 Zabbix, zastąp 'zabbix*' ciągiem 'zabbix-agent2*' w poleceniu.