2 Debian/Ubuntu

Przegląd

Ta sekcja zawiera instrukcje dotyczące aktualizacji z Zabbix 7.2.x do najnowszej wersji Zabbix 7.4.x przy użyciu oficjalnych pakietów Zabbix dla Debian/Ubuntu.

Przed aktualizacją zapoznaj się z odpowiednimi uwagami dotyczącymi aktualizacji i upewnij się, że Twój system spełnia wymagania dla Zabbix 7.4.

Rozważ uruchomienie dwóch równoległych sesji SSH podczas aktualizacji: jednej do wykonywania kroków aktualizacji, a drugiej do monitorowania logów serwera/proxy. Na przykład uruchom tail -f zabbix_server.log lub tail -f zabbix_proxy.log w drugiej sesji, aby na bieżąco wyświetlać najnowsze wpisy w logach i możliwe błędy. Może to mieć kluczowe znaczenie w przypadku środowisk produkcyjnych.

Instrukcje dotyczące aktualizacji między wersjami podrzędnymi Zabbix 7.4.x (na przykład z 7.4.1 do 7.4.3) znajdziesz w sekcji Aktualizacja między wersjami podrzędnymi.

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 plików binarnych Zabbix

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

W przypadku plików konfiguracyjnych uruchom:

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

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

cp -R /usr/share/zabbix/ /opt/zabbix-backup/
cp -R /usr/share/zabbix-* /opt/zabbix-backup/
4 Zaktualizuj pakiet konfiguracji repozytorium

Przed kontynuowaniem 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, aby zapobiec ponownemu użyciu przez menedżera pakietów nieaktualnej wersji podczas procesu aktualizacji.

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

W przypadku Debian 12 uruchom:

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

W przypadku starszych wersji Debian zastąp powyższy link prawidłowym linkiem z repozytorium Zabbix. Należy jednak pamiętać, że pakiety dla tych wersji mogą nie zawierać wszystkich komponentów Zabbix, a aby zaktualizować te komponenty z pakietów, rozważ aktualizację systemu operacyjnego. Listę zawartych komponentów znajdziesz w sekcji Pakiety Zabbix.

W przypadku Ubuntu 24.04 uruchom:

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

W przypadku Ubuntu 22.04 uruchom:

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

W przypadku starszych wersji Ubuntu zastąp powyższy link prawidłowym linkiem z repozytorium Zabbix. Należy jednak pamiętać, że pakiety dla tych wersji mogą nie zawierać wszystkich komponentów Zabbix, a aby zaktualizować te komponenty z pakietów, rozważ aktualizację systemu operacyjnego. Listę zawartych komponentów znajdziesz w sekcji Pakiety Zabbix.

Może pojawić się 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ę pliku konfiguracyjnego 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, zastąp mysql przez pgsql w poleceniu.
  • Jeśli aktualizujesz proxy, zastąp server przez proxy w poleceniu.
  • Jeśli aktualizujesz Zabbix agent 2, zastąp zabbix-agent przez zabbix-agent2 zabbix-agent2-plugin-* w poleceniu.

Aktualizacja Zabbix agent 2 za pomocą polecenia apt install zabbix-agent2 może prowadzić do błędu. Aby uzyskać więcej informacji, zobacz Znane problemy.

Może zostać wyświetlony 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] ?

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

Następnie, aby zaktualizować frontend Zabbix z Apache i ponownie uruchomić Apache, wykonaj:

apt install zabbix-apache-conf
systemctl restart apache2
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 znajdziesz na stronie Co nowego.

7 Uruchom procesy Zabbix

Uruchom zaktualizowane komponenty Zabbix:

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

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 minor

Możliwe jest przeprowadzenie aktualizacji między wersjami minor Zabbix 7.4.x (na przykład z 7.4.1 do 7.4.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*' w poleceniu przez 'zabbix-server*'.
  • Aby zaktualizować tylko proxy Zabbix, zastąp 'zabbix*' w poleceniu przez 'zabbix-proxy*'.
  • Aby zaktualizować tylko agent Zabbix, zastąp 'zabbix*' w poleceniu przez 'zabbix-agent*'.
  • Aby zaktualizować tylko agent Zabbix 2, zastąp 'zabbix*' w poleceniu przez 'zabbix-agent2*'.