Upgrade from sources

Przegląd

W tej sekcji przedstawiono kroki wymagane do pomyślnej aktualizacji z Zabbix 7.4.x do Zabbix 8.0.x przy użyciu oficjalnych źródeł Zabbix.

Przed aktualizacją należy zapoznać się z odpowiednimi uwagami dotyczącymi aktualizacji!

Warto również zapoznać się z wymaganiami dla wersji 8.0.

Podczas aktualizacji przydatne może być uruchomienie dwóch równoległych sesji SSH: w jednej należy wykonywać kroki aktualizacji, a w drugiej monitorować logi serwera/proxy. Na przykład w drugiej sesji SSH można uruchomić polecenie tail -f zabbix_server.log lub tail -f zabbix_proxy.log, aby wyświetlać najnowsze wpisy w pliku logu i możliwe błędy w czasie rzeczywistym. Może to mieć kluczowe znaczenie w przypadku instancji produkcyjnych.

Proces aktualizacji serwera

1 Zatrzymaj serwer

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

2 Utwórz kopię zapasową istniejącej bazy danych Zabbix

To bardzo ważny krok.
Upewnij się, że masz kopię zapasową bazy danych.
Pomoże ona w przypadku niepowodzenia procedury aktualizacji (brak miejsca na dysku, wyłączenie zasilania lub inny nieoczekiwany problem).

3 Tworzenie kopii zapasowej plików konfiguracyjnych, plików PHP i plików binarnych Zabbix

Utwórz kopię zapasową plików binarnych Zabbix, plików konfiguracyjnych oraz katalogu plików PHP.

4 Instalowanie nowych plików binarnych serwera

Skorzystaj z tych instrukcji, aby skompilować serwer Zabbix ze źródeł.

5 Przejrzyj parametry konfiguracji serwera

Upewnij się, że zapoznałeś się z Uwagi dotyczące aktualizacji, aby sprawdzić, czy wymagane są jakiekolwiek zmiany w parametrach konfiguracji.

Informacje o nowych opcjonalnych parametrach znajdziesz na stronie Co nowego.

6 Uruchom nowe pliki binarne Zabbix

Uruchom nowe pliki binarne.
Sprawdź pliki dziennika, aby upewnić się, że pliki binarne zostały uruchomione pomyślnie.

serwer Zabbix automatycznie zaktualizuje bazę danych.
Podczas uruchamiania serwer Zabbix zgłasza bieżące (obowiązkowe i opcjonalne) oraz wymagane wersje bazy danych.
Jeśli bieżąca wersja obowiązkowa jest starsza niż wymagana wersja, serwer Zabbix automatycznie wykonuje wymagane poprawki aktualizujące bazę danych.
Informacje o rozpoczęciu aktualizacji bazy danych i jej postępie (w procentach) są zapisywane w pliku dziennika serwera Zabbix.
Po zakończeniu aktualizacji w pliku dziennika zapisywany jest komunikat „database upgrade fully completed”.
Jeśli którakolwiek z poprawek aktualizujących zakończy się niepowodzeniem, serwer Zabbix nie uruchomi się.
serwer Zabbix nie uruchomi się również, jeśli bieżąca obowiązkowa wersja bazy danych jest nowsza niż wymagana.
serwer Zabbix uruchomi się tylko wtedy, gdy bieżąca obowiązkowa wersja bazy danych odpowiada wymaganej wersji obowiązkowej.

8673:20161117:104750.259 current database version (mandatory/optional): 03040000/03040000
8673:20161117:104750.259 required mandatory version: 03040000

Przed uruchomieniem serwera:

  • Upewnij się, że użytkownik bazy danych ma wystarczające uprawnienia (tworzenie tabel, usuwanie tabel, tworzenie indeksów, usuwanie indeksów)
  • Upewnij się, że masz wystarczającą ilość wolnego miejsca na dysku.
7 Instalacja nowego frontend Zabbix

Minimalna wymagana wersja PHP to 8.2.0. W razie potrzeby zaktualizuj PHP i postępuj zgodnie z instrukcjami instalacji.

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

Proces aktualizacji proxy

1 Zatrzymaj proxy

Zatrzymaj Zabbix proxy.

2 Utwórz kopię zapasową plików konfiguracyjnych i plików binarnych Zabbix proxy

Utwórz kopię zapasową pliku binarnego Zabbix proxy oraz pliku konfiguracyjnego.

3 Instalowanie nowych plików binarnych proxy

Skorzystaj z tych instrukcji, aby skompilować proxy Zabbix ze źródeł.

4 Przejrzyj parametry konfiguracji proxy

Upewnij się, że przejrzysz Uwagi dotyczące aktualizacji, aby sprawdzić, czy wymagane są jakiekolwiek zmiany w parametrach konfiguracji.

Informacje o nowych opcjonalnych parametrach znajdziesz na stronie Co nowego.

5 Uruchom nowy proxy Zabbix

Uruchom nowy proxy Zabbix.
Sprawdź pliki dziennika, aby upewnić się, że proxy zostało pomyślnie uruchomione.

Proxy Zabbix automatycznie zaktualizuje bazę danych.
Aktualizacja bazy danych przebiega podobnie jak podczas uruchamiania serwera Zabbix.

Proces aktualizacji agent

Aktualizacja agentów nie jest obowiązkowa. Agenty należy aktualizować tylko wtedy, gdy jest to wymagane do uzyskania dostępu do nowych funkcji.

Procedura aktualizacji opisana w tej sekcji może być używana zarówno do aktualizacji Zabbix agent, jak i Zabbix agent 2.

1 Zatrzymaj agent

Zatrzymaj agent Zabbix.

2 Utwórz kopię zapasową plików konfiguracyjnych i plików binarnych agenta Zabbix

Utwórz kopię zapasową pliku binarnego agenta Zabbix oraz pliku konfiguracyjnego.

3 Instalowanie nowych plików binarnych agentów

Skorzystaj z tych instrukcji, aby skompilować agenta Zabbix ze źródeł.

Alternatywnie możesz pobrać wstępnie skompilowane agenty Zabbix ze strony pobierania Zabbix.

4 Przejrzyj parametry konfiguracji agenta

Upewnij się, że zapoznałeś się z Uwagi dotyczące aktualizacji, aby sprawdzić, czy wymagane są jakiekolwiek zmiany w parametrach konfiguracji.

Informacje o nowych opcjonalnych parametrach znajdziesz na stronie Co nowego.

5 Uruchom nowy agent Zabbix

Uruchom nowy agent Zabbix. Sprawdź pliki dziennika, aby upewnić się, że agent został pomyślnie uruchomiony.

Aktualizacja między wersjami pomniejszymi

Podczas aktualizacji między wersjami pomniejszymi 8.0.x (na przykład z 8.0.1 do 8.0.3) należy wykonać te same czynności dla serwera/proxy/agenta co podczas aktualizacji między wersjami głównymi. Jedyna różnica polega na tym, że podczas aktualizacji między wersjami pomniejszymi nie są wprowadzane żadne zmiany w bazie danych.