2. Debian/Ubuntu

Обзор

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

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

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

Инструкции по обновлению между минорными версиями Zabbix 7.4.x (например, с 7.4.1 до 7.4.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 Обновление пакета конфигурации репозитория

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

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.4/release/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.4/release/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.4/release/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 agent 2, замените zabbix-agent на zabbix-agent2 zabbix-agent2-plugin-* в команде.

Обновление Zabbix agent 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 работал должным образом.

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

Возможно обновление между минорными версиями Zabbix 7.4.x (например, с 7.4.1 до 7.4.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*' в команде.