[comment]: # ({a25b2d94-91aab3e5})
# Debian/Ubuntu

[comment]: # ({/a25b2d94-91aab3e5})

[comment]: # ({545ec22f-d02acea9})
#### 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.

::: notewarning
Przed aktualizacją zapoznaj się z odpowiednimi [uwagami dotyczącymi aktualizacji](/manual/installation/upgrade) i upewnij się, że Twój system spełnia [wymagania](/manual/installation/requirements) dla Zabbix 8.0.
:::

::: noteclassic
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 w drugiej sesji uruchom `tail -f zabbix_server.log` lub `tail -f zabbix_proxy.log`, aby wyświetlać najnowsze wpisy logów i możliwe błędy w czasie rzeczywistym.
Może to mieć kluczowe znaczenie w środowiskach produkcyjnych.
:::

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](#upgrade-between-minor-versions).

[comment]: # ({/545ec22f-d02acea9})

[comment]: # ({93ff8b03-93ff8b03})
#### Procedura aktualizacji

[comment]: # ({/93ff8b03-93ff8b03})

[comment]: # ({b7813e36-f8102233})
##### 1 Zatrzymaj procesy Zabbix

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

```bash
systemctl stop zabbix-server
```

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

```bash
systemctl stop zabbix-proxy
systemctl stop zabbix-agent
systemctl stop zabbix-agent2
```

[comment]: # ({/b7813e36-f8102233})

[comment]: # ({906e7b99-ab13a6a4})
##### 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).

[comment]: # ({/906e7b99-ab13a6a4})

[comment]: # ({9978590c-6c141723})
##### 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:

```bash
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:

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

[comment]: # ({/9978590c-6c141723})

[comment]: # ({73d08cd4-31c75b55})
##### 4 Zaktualizuj pakiet konfiguracji repozytorium

Przed przystąpieniem do aktualizacji odinstaluj bieżący pakiet repozytorium Zabbix:

```bash
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 błędów.

W systemie **Debian 12** uruchom:

```bash
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
```

::: noteclassic
W przypadku starszych wersji Debiana zastąp powyższy link właściwym linkiem z [repozytorium Zabbix](https://repo.zabbix.com/zabbix/8.0/release/debian/pool/main/z/zabbix-release/).
Pamiętaj jednak, że pakiety dla tych wersji mogą nie zawierać wszystkich komponentów Zabbix, a jeśli chcesz zaktualizować te komponenty z pakietów, rozważ aktualizację systemu operacyjnego.
Listę uwzględnionych komponentów znajdziesz w sekcji [Pakiety Zabbix](https://www.zabbix.com/download?zabbix=8.0&os_distribution=debian&os_version=11&components=agent&db=&ws=).
:::

W systemie **Ubuntu 24.04** uruchom:

```bash
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:

```bash
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
```

::: noteclassic
W przypadku starszych wersji Ubuntu zastąp powyższy link właściwym linkiem z [repozytorium Zabbix](https://repo.zabbix.com/zabbix/8.0/release/ubuntu/pool/main/z/zabbix-release/).
Pamiętaj jednak, że pakiety dla tych wersji mogą nie zawierać wszystkich komponentów Zabbix, a jeśli chcesz zaktualizować te komponenty z pakietów, rozważ aktualizację systemu operacyjnego.
Listę uwzględnionych komponentów znajdziesz w sekcji [Pakiety Zabbix](https://www.zabbix.com/download?zabbix=8.0&os_distribution=ubuntu&os_version=20.04&components=agent&db=&ws=).
:::

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

```bash
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:

```bash
apt update
```

[comment]: # ({/73d08cd4-31c75b55})

[comment]: # ({a78e76d3-08c7383c})
##### 5 Aktualizacja komponentów Zabbix

Aby zaktualizować komponenty Zabbix, uruchom:

```bash
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.

::: noteimportant
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*](/manual/installation/known_issues#upgrading-zabbix-agent-2-6.0.5-or-older).
:::

Może zostać wyświetlony monit dotyczący konfiguracji serwera Zabbix (lub proxy):

```bash
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:

```bash
apt install zabbix-apache-conf
systemctl restart apache2
```

[comment]: # ({/a78e76d3-08c7383c})

[comment]: # ({06ed5d87-455f4e97})
##### 6 Przejrzyj parametry konfiguracji komponentu

Przejrzyj odpowiednie [uwagi dotyczące aktualizacji](/manual/installation/upgrade_notes), aby sprawdzić, czy konieczne są jakiekolwiek zmiany parametrów konfiguracji.

Informacje o nowych opcjonalnych parametrach można znaleźć na stronie [Co nowego](/manual/whatsnew).

[comment]: # ({/06ed5d87-455f4e97})

[comment]: # ({e83479d6-624a8fc7})
##### 7 Uruchom procesy Zabbix

Uruchom zaktualizowane komponenty Zabbix:

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

[comment]: # ({/e83479d6-624a8fc7})

[comment]: # ({0d20ecac-49e4f43e})
##### 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.

[comment]: # ({/0d20ecac-49e4f43e})

[comment]: # ({d6c45268-9bab02f2})
#### 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:

```bash
apt update
```

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

```bash
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*'`.

[comment]: # ({/d6c45268-9bab02f2})
