2. Debian/Ubuntu

Обзор

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

Перед выполнением обновления ознакомьтесь с соответствующими заметки по обновлению и убедитесь, что ваша система соответствует требованиям для Zabbix 7.0.

Рассмотрите возможность запуска двух параллельных сессий SSH во время обновления: одна — для выполнения шагов обновления, и другая — для наблюдения за журналами сервера/прокси. Например, запустите tail -f zabbix_server.log или tail -f zabbix_proxy.log во второй сессии, чтобы в реальном времени просматривать последние записи журнала и возможные ошибки. Это может быть критически важно для промышленных инсталляций.

Инструкции по обновлению между минорными версиями 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/
       cp /etc/apache2/conf-enabled/zabbix.conf /opt/zabbix-backup/

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

cp -R /usr/share/zabbix/ /opt/zabbix-backup/
       cp -R /usr/share/zabbix-* /opt/zabbix-backup/
4. Обновите пакет конфигурации репозитория

Прежде чем приступить к обновлению, необходимо удалить текущий пакет репозитория:

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

Возможно, вам также придётся вручную удалить все старые пакеты Zabbix из вашего рабочего каталога (например, rm zabbix-release_latest+debian12_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

Для более старых версий Debian замените ссылку выше на правильную из репозитория Zabbix. Однако, обратите внимание, что пакеты для этих версий могут не включать все компоненты Zabbix, и для обновления этих компонентов из пакетов рассмотрите возможность обновления вашей операционной системы. Список включённых компонентов смотрите в репозитории Zabbix.

На 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

Для более старых версий Ubuntu замените ссылку выше на правильную из репозитория Zabbix. Однако, обратите внимание, что пакеты для этих версий могут не включать все компоненты Zabbix, и для обновления этих компонентов из пакетов рассмотрите возможность обновления вашей операционной системы.. Список включённых компонентов смотрите пакеты Zabbix.

Вы можете увидеть запрос о конфигурации репозитория 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 агента 2 при помощи команды apt install zabbix-agent2 может привести к ошибке. Для получения дополнительной информации смотрите Известные проблемы.

Вы можете увидеть запрос о конфигурации 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 и перезапустить Apache, выполните:

apt install zabbix-apache-conf
       systemctl restart apache2
6. Проверьте параметры конфигурации компонентов

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

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

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