Прочее Zabbix Linux Ubuntu

Как обновить Zabbix с версии 6.0 до 7.0

Обновление Zabbix 6.0 до 7.0 LTS может потребоваться по разным причинам: переход на новую функциональность, поддержка более современных версий операционных систем и программного обеспечения, исправления ошибок и дальнейшее развитие системы мониторинга. В этой статье покажу на своём примере, как обновить Zabbix Server с версии 6.0 до 7.0 LTS. У меня используется Ubuntu 24.04, MySQL 8 и стандартная установка Zabbix из официального репозитория. Пройдём весь процесс: проверим версии компонентов, сделаем резервную копию, подключим репозиторий Zabbix 7.0, обновим сервер и дождёмся автоматического обновления структуры базы данных.

0 13 мин
Обновление Zabbix Server

Что нужно сделать перед обновлением Zabbix

Обновление основной версии Zabbix лучше начинать не с установки новых пакетов, а с подготовки системы.

Перед началом работ рекомендую:

  • ознакомиться с официальными заметками о выпуске Zabbix 7.0 LTS;
  • изучить заметки по обновлению до Zabbix 7.0;
  • проверить версии операционной системы, базы данных, PHP и Zabbix Server;
  • проверить требования Zabbix 7.0 к используемым компонентам;
  • сделать резервную копию базы данных;
  • сохранить конфигурационные файлы Zabbix и веб-сервера;
  • сохранить собственные скрипты и другие файлы, которые изменялись вручную;
  • подготовить план отката на случай неудачного обновления.

Проверяем версии компонентов

Перед обновлением посмотрим, что сейчас установлено на сервере.

Проверяем PHP

php -v

В моём случае:

PHP 8.3.6 (cli) (built: Dec  2 2024 12:36:18) (NTS)
Copyright (c) The PHP Group
Zend Engine v4.3.6, Copyright (c) Zend Technologies
    with Zend OPcache v8.3.6, Copyright (c), by Zend Technologies

Проверяем MySQL

mysql -V

У меня установлен MySQL 8:

mysql  Ver 8.0.40-0ubuntu0.24.04.1 for Linux on x86_64 ((Ubuntu))

Проверяем Ubuntu

lsb_release -a

Результат:

No LSB modules are available.
Distributor ID: Ubuntu
Description:    Ubuntu 24.04.1 LTS
Release:        24.04
Codename:       noble

Проверяем версию Zabbix Server

zabbix_server --version

До обновления у меня установлена версия Zabbix 6.0.36:

zabbix_server (Zabbix) 6.0.36
Revision 6bcc7a62c0e 19 November 2024, compilation time: Nov 19 2024 09:21:26

Copyright (C) 2024 Zabbix SIA

Эту систему я ранее переносил с Ubuntu 20.04 на Ubuntu 24.04. Сам процесс подробно разбирал в статье Как перенести Zabbix на новый сервер.

Создаём резервную копию конфигурации Zabbix

Перед остановкой сервера сохраним основные конфигурационные файлы.

Конфигурация Zabbix Server

sudo cp /etc/zabbix/zabbix_server.conf ~/zabbix_server.conf.bak

Конфигурация Zabbix Agent

Если используется классический агент:

sudo cp /etc/zabbix/zabbix_agentd.conf ~/zabbix_agentd.conf.bak

Если используется Agent 2:

sudo cp /etc/zabbix/zabbix_agent2.conf ~/zabbix_agent2.conf.bak

Конфигурация Apache

В моей установке используется Apache, поэтому сохраняю и конфигурацию веб-интерфейса:

sudo cp /etc/zabbix/apache.conf ~/apache.conf.bak

Останавливаем Zabbix Server

Перед созданием резервной копии базы остановим Zabbix Server:

sudo systemctl stop zabbix-server

Проверим состояние:

systemctl status zabbix-server --no-pager

Сам веб-интерфейс и база данных при этом могут продолжать работать.

Создаём резервную копию базы данных Zabbix

Для сжатия дампа в моём примере используется bzip2. Если утилита ещё не установлена:

sudo apt install bzip2

Теперь создадим дамп базы данных:

mysqldump -uroot -p zabbix --extended-insert --single-transaction | bzip2 -9 > ~/zabbix_db_backup-$(date "+%Y-%m-%d_%H.%M.%S").sql.bz2

После запуска команды MySQL запросит пароль пользователя root.

Проверим, что файл действительно появился:

ls -lh ~/zabbix_db_backup-*.sql.bz2

Обновляем Ubuntu перед обновлением Zabbix

Перед переходом на Zabbix 7.0 обновим установленные пакеты:

sudo apt update
sudo apt upgrade -y

После этого можно удалить больше не используемые зависимости:

sudo apt autoremove -y

Подключаем репозиторий Zabbix 7.0

Теперь подключим официальный репозиторий ветки Zabbix 7.0 LTS.

Для Ubuntu 24.04 в моём случае:

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

sudo dpkg -i zabbix-release_latest_7.0+ubuntu24.04_all.deb

sudo apt update

После подключения репозитория можно проверить, какую версию Zabbix Server предлагает APT:

apt policy zabbix-server-mysql

В строке Candidate должна отображаться версия из ветки 7.0.

Подготавливаем MySQL к обновлению Zabbix

При использовании MySQL или MariaDB во время обновления базы Zabbix может потребоваться параметр log_bin_trust_function_creators.

Сначала посмотрим его текущее значение:

mysql -u root -p -e "SHOW VARIABLES LIKE 'log_bin_trust_function_creators';"

Также можно проверить состояние бинарного логирования:

mysql -u root -p -e "SHOW VARIABLES LIKE 'log_bin';"

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

mysql -u root -p -e "SET GLOBAL log_bin_trust_function_creators = 1;"

Обновляем пакеты Zabbix до версии 7.0

Перед обновлением полезно посмотреть, какие пакеты Zabbix вообще установлены:

dpkg -l | grep '^ii' | grep zabbix

В типичной установке с MySQL и Apache это могут быть:

  • zabbix-server-mysql;
  • zabbix-frontend-php;
  • zabbix-apache-conf;
  • zabbix-sql-scripts;
  • zabbix-agent или zabbix-agent2.

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

sudo apt install --only-upgrade \
    zabbix-server-mysql \
    zabbix-frontend-php \
    zabbix-apache-conf \
    zabbix-sql-scripts \
    zabbix-agent

Если вместо классического агента используется Agent 2, замените последний пакет на:

zabbix-agent2

Что делать с zabbix_server.conf при обновлении

Если файл /etc/zabbix/zabbix_server.conf изменялся вручную, пакетный менеджер может показать запрос:

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 ?

 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 — установить новую версию конфигурации из пакета;
  • N или O — сохранить текущий файл.

Я обычно выбираю N, чтобы сохранить существующую конфигурацию сервера.

Запускаем Zabbix Server и обновляем базу данных

После установки новых пакетов запускаем сервер:

sudo systemctl start zabbix-server

Рекомендую заранее открыть вторую SSH-сессию и наблюдать за журналом:

sudo tail -f /var/log/zabbix/zabbix_server.log

При первом запуске Zabbix Server 7.0 обнаружит старую структуру базы данных и начнёт её автоматическое обновление.

В журнале это выглядит примерно так:

required mandatory version: 07000000
mandatory patches were found
starting automatic database upgrade
completed 0% of database upgrade
completed 1% of database upgrade
completed 2% of database upgrade
completed 3% of database upgrade
completed 4% of database upgrade
completed 5% of database upgrade

Продолжительность зависит от размера базы данных, количества исторических данных и производительности сервера.

После завершения в журнале появится:

completed 95% of database upgrade
completed 96% of database upgrade
completed 97% of database upgrade
completed 98% of database upgrade
completed 99% of database upgrade
completed 100% of database upgrade
database upgrade fully completed

Это означает, что структура базы данных успешно обновлена до версии, необходимой Zabbix 7.0.

Возвращаем настройку MySQL

Если перед обновлением вы временно включали log_bin_trust_function_creators, после успешного завершения миграции верните прежнее значение:

mysql -u root -p -e "SET GLOBAL log_bin_trust_function_creators = 0;"

Проверить результат:

mysql -u root -p -e "SHOW VARIABLES LIKE 'log_bin_trust_function_creators';"

Проверяем Zabbix после обновления

Сначала посмотрим новую версию:

zabbix_server --version

Затем состояние служб:

systemctl status zabbix-server --no-pager
systemctl status mysql --no-pager

И последние сообщения Zabbix Server:

sudo tail -n 100 /var/log/zabbix/zabbix_server.log

Также обязательно откройте веб-интерфейс и убедитесь, что он загружается без ошибок.

Что проверить в веб-интерфейсе

После обновления я проверяю:

  • поступление свежих данных от хостов;
  • очередь элементов данных;
  • неподдерживаемые элементы данных;
  • триггеры и текущие проблемы;
  • выполнение внешних проверок и пользовательских скриптов;
  • отправку уведомлений;
  • работу Proxy, если они используются.

Что делать с Zabbix Proxy после обновления сервера

После перехода Zabbix Server на 7.0 старый Proxy может продолжить подключаться к серверу, но Zabbix предупредит о несовпадении основных версий.

Предупреждение о старой версии Zabbix Proxy после обновления Zabbix Server до 7.0

В моём случае интерфейс показывал предупреждение о том, что версия Proxy устарела и его возможности при работе с сервером 7.0 ограничены.

Поэтому следующим этапом я обновил и Zabbix Proxy. Весь процесс описан отдельно: Как обновить Zabbix Proxy с версии 6.0 до 7.0.

Нужно ли обновлять шаблоны после перехода на Zabbix 7.0

Обновление Zabbix Server до 7.0 само по себе не означает, что нужно немедленно удалить старые шаблоны и заменить их новыми. Существующие шаблоны могут продолжать использоваться после обновления сервера.

Если вам нужны изменения из новых версий официальных шаблонов, их можно импортировать отдельно.

Перед обновлением шаблона

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

Также стоит проверить:

  • локальные изменения элементов данных и триггеров;
  • макросы;
  • прототипы обнаружения;
  • зависимые элементы;
  • переопределения и пользовательские настройки.

Импортируем новую версию шаблона

Новые официальные шаблоны можно получить из репозитория Zabbix или из соответствующего релиза.

В веб-интерфейсе откройте раздел шаблонов и используйте функцию импорта.

Во время импорта внимательно просмотрите предлагаемые изменения перед их применением, особенно если старый шаблон был изменён вручную.

Финальная проверка после обновления

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

  1. версию Zabbix Server;
  2. состояние zabbix-server и MySQL;
  3. отсутствие ошибок обновления базы данных;
  4. работу веб-интерфейса;
  5. поступление свежих данных от хостов;
  6. очередь мониторинга и неподдерживаемые элементы;
  7. работу триггеров и уведомлений;
  8. подключение Zabbix Proxy;
  9. выполнение внешних скриптов и интеграций.

Если всё работает штатно, переход с Zabbix 6.0 на 7.0 можно считать завершённым.

Часто задаваемые вопросы

Можно ли обновить Zabbix 6.0 напрямую до 7.0?

Да, Zabbix 6.0 LTS можно обновить до Zabbix 7.0 LTS. Перед обновлением необходимо проверить требования новой версии к операционной системе, базе данных, PHP и остальным компонентам.

Нужно ли вручную обновлять структуру базы данных Zabbix?

Нет. После установки новой версии и запуска Zabbix Server необходимые изменения структуры базы выполняются автоматически. Ход процесса можно наблюдать в /var/log/zabbix/zabbix_server.log.

Нужно ли делать резервную копию базы перед обновлением?

Да. Обновление основной версии изменяет структуру базы данных, поэтому рабочая резервная копия перед началом процесса обязательна.

Нужно ли включать log_bin_trust_function_creators?

Не всегда. Это зависит от конфигурации MySQL или MariaDB, состояния бинарного логирования и привилегий пользователя базы данных. Если параметр временно менялся для обновления, после завершения работ верните его в исходное состояние.

Нужно ли сразу обновлять Zabbix Proxy?

После обновления сервера Proxy предыдущей основной версии может временно работать с ограничениями, но его рекомендуется обновить до той же основной версии Zabbix.

Нужно ли обновлять шаблоны сразу после перехода на Zabbix 7.0?

Нет. Сначала лучше убедиться, что сам сервер и существующий мониторинг работают стабильно. Обновление шаблонов можно выполнить отдельным этапом.

Нужно ли отвязывать старый шаблон с очисткой перед импортом нового?

Нет. Для обычного обновления шаблона делать это не следует. Очистка удаляет связанные с шаблоном сущности и может привести к потере истории. Перед импортом новой версии лучше экспортировать текущий шаблон и внимательно проверить изменения.

Заключение

В этой статье мы прошли весь процесс обновления Zabbix Server с версии 6.0 до 7.0 LTS на Ubuntu 24.04 с MySQL: проверили компоненты, сохранили конфигурацию и базу данных, подключили новый репозиторий, обновили пакеты и дождались автоматической миграции базы.

Самый важный этап здесь — подготовка. При наличии проверенной резервной копии, совместимых версий компонентов и возможности отката обновление становится значительно предсказуемее.

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

Следующим этапом можно обновить Proxy по инструкции Как обновить Zabbix Proxy с версии 6.0 до 7.0.

Также рекомендую статью Как мигрировать базу данных Zabbix с MySQL на PostgreSQL.