2. Debian/Ubuntu

Обзор

В этом разделе приведены инструкции по обновлению с Zabbix 6.4.x на последнюю версию Zabbix 7.0.x с использованием официальных пакетов Zabbix для Debian/Ubuntu.

Инструкции по обновлению между минорными версиями Zabbix 7.0.x (например, с 7.0.1 до 7.0.3) смотрите в разделе Обновление между минорными версиями.

Процедура обновления

1. Остановите процессы Zabbix

Остановите Zabbix сервер, чтобы быть уверенным, что в базу данных не будет происходить запись новых данных.

systemctl stop zabbix-server

Если обновляете Zabbix прокси, агента или агента 2, то остановите и эти компоненты тоже.

systemctl stop zabbix-proxy
systemctl stop zabbix-agent
systemctl stop zabbix-agent2

2. Сделайте резервную копию базы данных Zabbix

Сделайте резервную копию вашей существующей базы данных Zabbix, чтобы подстраховаться от возможных сбоев при обновлении (например, проблем с дисковым пространством, отключения электричества или непредвиденных проблем).

3. Сделайте резервную копию файлов конфигурации, PHP и бинарных файлов Zabbix

Сделайте резервную копию существующих файлов конфигурации, файлов PHP и бинарных файлов Zabbix.

Для файлов конфигурации выполните:

mkdir /opt/zabbix-backup/
cp /etc/zabbix/zabbix_server.conf /opt/zabbix-backup/
# Для Apache:
cp /etc/apache2/conf-enabled/zabbix.conf /opt/zabbix-backup/
# Для Nginx:
cp /etc/nginx/conf.d/zabbix.conf /opt/zabbix-backup/
cp /etc/zabbix/nginx.conf /opt/zabbix-backup/

Для файлов PHP и двоичных файлов Zabbix выполните:

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

4 Обновление пакета конфигурации репозитория

Перед началом обновления удалите текущий пакет репозитория Zabbix:

rm -Rf /etc/apt/sources.list.d/zabbix.list

Также может потребоваться вручную удалить все старые пакеты Zabbix из рабочего каталога (например, rm zabbix-release_latest+debian12_all.deb), прежде чем загружать новый пакет, чтобы менеджер пакетов не использовал устаревшую версию в процессе обновления.

Затем установите последнюю версию пакета конфигурации репозитория, чтобы обеспечить совместимость с новейшими пакетами и получить последние исправления безопасности и ошибок.

В Debian 13 выполните:

wget https://repo.zabbix.com/zabbix/7.0/release/debian/pool/main/z/zabbix-release/zabbix-release_latest+debian13_all.deb
dpkg -i zabbix-release_latest+debian13_all.deb

В Debian 12 выполните:

wget https://repo.zabbix.com/zabbix/7.0/debian/pool/main/z/zabbix-release/zabbix-release_latest+debian12_all.deb
dpkg -i zabbix-release_latest+debian12_all.deb

В Ubuntu 26.04 выполните:

wget https://repo.zabbix.com/zabbix/7.0/release/ubuntu/pool/main/z/zabbix-release/zabbix-release_latest+ubuntu26.04_all.deb
dpkg -i zabbix-release_latest+ubuntu26.04_all.deb

В Ubuntu 24.04 выполните:

wget https://repo.zabbix.com/zabbix/7.0/ubuntu/pool/main/z/zabbix-release/zabbix-release_latest+ubuntu24.04_all.deb
dpkg -i zabbix-release_latest+ubuntu24.04_all.deb

В Ubuntu 22.04 выполните:

wget https://repo.zabbix.com/zabbix/7.0/ubuntu/pool/main/z/zabbix-release/zabbix-release_latest+ubuntu22.04_all.deb
dpkg -i zabbix-release_latest+ubuntu22.04_all.deb

Может появиться запрос о конфигурации репозитория 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] ?

Введите Y (или I), чтобы установить версию конфигурации репозитория Zabbix от сопровождающего пакета.

Затем обновите информацию о репозитории:

apt update

5 Обновление компонентов Zabbix

Для обновления компонентов Zabbix выполните:

apt install --only-upgrade zabbix-server-mysql zabbix-frontend-php zabbix-agent

• При использовании PostgreSQL замените mysql на pgsql в команде.
• При обновлении прокси замените server на proxy в команде.
• При обновлении агента Zabbix 2 замените zabbix-agent на zabbix-agent2 zabbix-agent2-plugin-* в команде.

Может появиться запрос о конфигурации сервера Zabbix (или прокси):

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] ?

Введите вариант, который лучше всего соответствует вашей ситуации. Например, введите D, чтобы сравнить текущую и новую конфигурации, а затем решите, хотите ли вы установить версию, предоставленную сопровождающим пакета (Y или I).

Затем обновите веб-интерфейс Zabbix и перезапустите веб-сервер.

Для Apache выполните:

apt install zabbix-apache-conf
systemctl restart apache2

Для Nginx выполните:

apt install zabbix-nginx-conf
systemctl restart nginx

Для Nginx может появиться запрос о конфигурационном файле nginx.conf. Введите вариант, который лучше всего соответствует вашей ситуации:

Configuration file '/etc/zabbix/nginx.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.
*** nginx.conf (Y/I/N/O/D/Z) [default=N] ?

6. Проверьте параметры конфигурации компонентов

Ознакомьтесь с Заметками по обновлению, чтобы проверить, не требуются ли какие-то изменения в параметрах конфигурации.

Новые необязательные параметры можно найти на странице Что нового.

Если в качестве веб-сервера используется Nginx и файл конфигурации /etc/zabbix/nginx.conf был переустановлен во время обновления, просмотрите этот файл и обновите директивы listen и server_name, чтобы они соответствовали конфигурации вашего веб-интерфейса Zabbix.

7. Запустите процессы Zabbix

Запустите обновлённые компоненты Zabbix:

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

8. Очистите cookies и кэш в веб-браузере

После обновления вам, возможно, потребуется очистить cookies веб-браузера и кэш веб-браузера, чтобы веб-интерфейс Zabbix работал должным образом.

Обновление между минорными версиями

Возможно обновление между минорными версиями 7.0.х (например, с 7.0.1 до 7.0.3).

Сначала обновите информацию о репозитории:

apt update

Затем, чтобы обновить все компоненты Zabbix, выполните:

apt install --only-upgrade 'zabbix*'

• Чтобы обновить только сервер Zabbix, замените в команде 'zabbix*' на 'zabbix-server*'.
• Чтобы обновить только прокси Zabbix, замените в команде 'zabbix*' на 'zabbix-proxy*'.
• Чтобы обновить только агент Zabbix, замените в команде 'zabbix*' на 'zabbix-agent*'.
• Чтобы обновить только Zabbix агент 2, замените в команде 'zabbix*' на 'zabbix-agent2*'.