Debian/Ubuntu

Przegląd

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

Instrukcje dotyczące aktualizacji między wersjami podrzędnymi Zabbix 8.0.x (na przykład z 8.0.1 do 8.0.3) znajdują się 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 Aktualizacja pakietu konfiguracji repozytorium

Przed przystąpieniem do 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 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ć ostatnie poprawki bezpieczeństwa i poprawki błędów.

W systemie Debian 12 uruchom:

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

W systemie Ubuntu 24.04 uruchom:

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

W systemie Ubuntu 22.04 uruchom:

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

Możesz zobaczyć 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] ?

Wprowadź 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, 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.

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 parametrów konfiguracji.

Informacje o nowych opcjonalnych parametrach można znaleźć 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

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 minor

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