Инструкция по обновлению Zabbix 7.2.x до последней версии Zabbix 7.4.x

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

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

Остановите сервер Zabbix, чтобы убедиться, что в базу данных не добавляются новые данные:

systemctl stop zabbix-server

При обновлении прокси-сервера, агента или агента 2 Zabbix также остановите эти компоненты:

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

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

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

# Резервная копия базы данных
sudo -u postgres pg_dump zabbix > /tmp/zabbix_backup_$(date +%Y%m%d).sql


# Проверьте размер бекапа
ls -lh /tmp/zabbix_backup_*

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

Сделайте резервную копию существующих файлов конфигурации 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

В 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

Вы можете увидеть сообщение о конфигурации репозитория 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). В моем случае из важных замечаний был данные для подключения к БД , я нажал Y и после сменил их через nano /etc/zabbix/zabbix_server.conf

Либо чтобы обновить интерфейс 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 Очистить файлы cookie и кэш веб-браузера

После обновления вам может потребоваться очистить файлы cookie и кэш веб-браузера, чтобы веб-интерфейс 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*' в команде.

Итог:

На первых этапах выявил что шаблоны не обновляются автоматически.

В ходе получилось выяснить что в Zabbix действует принцип: Шаблоны — это часть конфигурации, а не бинарной установки

При обновлении:

• обновляются server / frontend / proxy / DB schema

• конфигурация (templates, hosts, triggers) не трогается

• Zabbix умышленно не перезаписывает шаблоны, чтобы не:

  • сломать кастомные правки

  • изменить логику триггеров

  • нарушить SLA и алерты

Поэтому:

• шаблоны 7.2 остаются 7.2

• новые шаблоны в новой версии не подтягиваются автоматически

Что можно сделать в данной ситуации ? 

Вариант 1 (правильный): обновить шаблоны вручную

1. Перейти в
   Сбор данных → Шаблоны

2. Скачать официальные шаблоны Zabbix на этапе обновления  7.4 :

   • с GitHub Zabbix

   • Страницы сайта 

3. Импортировать шаблоны:

   • Сбор данных → Шаблоны → Иморт

4. При импорте:

   • система сравнит код старого и нового шаблона 

Так вы получите обновлённую логику без разрушения текущей конфигурации.

Вариант 2 (безопасный): новые шаблоны — новым хостам

Если система стабильна:

• старые хосты → остаются на шаблонах 7.2

• новые хосты → используют шаблоны 7.4

• постепенная миграция без риска

Это часто используется в  проде.