Upgrade from sources

Przegląd

Ta sekcja zawiera kroki wymagane do pomyślnego upgrade z Zabbix 7.4.x do Zabbix 8.0.x przy użyciu oficjalnych źródeł Zabbix.

Przed upgrade upewnij się, że przeczytałeś odpowiednie uwagi dotyczące upgrade!

Możesz także chcieć zapoznać się z wymaganiami dla wersji 8.0.

Podczas upgrade przydatne może być uruchomienie dwóch równoległych sesji SSH: w jednej wykonywanie kroków upgrade, a w drugiej monitorowanie logów serwera/proxy. Na przykład uruchom tail -f zabbix_server.log lub tail -f zabbix_proxy.log w drugiej sesji SSH, aby na bieżąco widzieć najnowsze wpisy w pliku logu oraz ewentualne błędy w czasie rzeczywistym. Może to mieć kluczowe znaczenie dla środowisk produkcyjnych.

Proces aktualizacji serwera

1 Zatrzymaj serwer

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

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

To bardzo ważny krok. Upewnij się, że masz kopię zapasową swojej bazy danych. Pomoże ona, jeśli procedura aktualizacji zakończy się niepowodzeniem (brak miejsca na dysku, zanik zasilania, jakikolwiek nieoczekiwany problem).

3 Utwórz kopię zapasową 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 Instalacja 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 uwagami dotyczącymi aktualizacji, aby sprawdzić, czy wymagane są jakiekolwiek zmiany parametrów 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 zobaczyć, czy pliki binarne zostały uruchomione pomyślnie.

serwer Zabbix automatycznie zaktualizuje bazę danych. Podczas uruchamiania serwer Zabbix zgłasza bieżące (obowiązkową i opcjonalną) oraz wymaganą wersję bazy danych. Jeśli bieżąca wersja obowiązkowa jest starsza niż wymagana wersja, serwer Zabbix automatycznie wykona wymagane poprawki aktualizacji bazy danych. Rozpoczęcie i poziom postępu (procentowy) aktualizacji bazy danych są zapisywane w pliku dziennika serwera Zabbix. Po zakończeniu aktualizacji do pliku dziennika zostaje zapisany komunikat „database upgrade fully completed”. Jeśli którakolwiek z poprawek aktualizacji 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 obowiązkowej wersji.

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 (create table, drop table, create index, drop index)
  • Upewnij się, że masz wystarczającą ilość wolnego miejsca na dysku.
7 Instalacja nowego interfejsu webowego Zabbix

Minimalna wymagana wersja PHP to 8.2.0. W razie potrzeby zaktualizuj ją 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 interfejs webowy 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 Instalacja nowych plików binarnych proxy

Użyj tych instrukcji, aby skompilować proxy Zabbix ze źródeł.

4 Przejrzyj parametry konfiguracji proxy

Upewnij się, że zapoznałeś się z uwagami dotyczącymi aktualizacji, aby sprawdzić, czy wymagane są jakiekolwiek zmiany parametrów konfiguracji.

Informacje o nowych opcjonalnych parametrach znajdziesz na stronie Co nowego.

5 Uruchom nowy Zabbix proxy

Uruchom nowy Zabbix proxy. Sprawdź pliki dziennika, aby zobaczyć, czy proxy uruchomił się pomyślnie.

Zabbix proxy automatycznie zaktualizuje bazę danych. Aktualizacja bazy danych przebiega podobnie jak podczas uruchamiania Zabbix server.

Proces aktualizacji agenta

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

Procedura aktualizacji opisana w tej sekcji może być używana do aktualizacji zarówno agenta Zabbix, jak i agenta Zabbix 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 Zainstaluj nowe pliki binarne agenta

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

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

4 Przejrzyj parametry konfiguracji agent

Upewnij się, że zapoznałeś się z uwagami dotyczącymi aktualizacji, aby sprawdzić, czy wymagane są jakiekolwiek zmiany parametrów konfiguracji.

Informacje o nowych opcjonalnych parametrach można znaleźć na stronie Co nowego.

5 Uruchom nowy agent Zabbix

Uruchom nowy agent Zabbix. Sprawdź pliki dziennika, aby zobaczyć, czy agent został uruchomiony pomyślnie.

Aktualizacja między wersjami pobocznymi

Podczas aktualizacji między wersjami pobocznymi 8.0.x (na przykład z 8.0.1 do 8.0.3) wymagane jest wykonanie tych samych działań dla serwer/proxy/agent jak podczas aktualizacji między wersjami głównymi. Jedyna różnica polega na tym, że podczas aktualizacji między wersjami pobocznymi nie są wprowadzane żadne zmiany w bazie danych.