В этом разделе приведены шаги, необходимые для успешного обновления с Zabbix 7.4.x до Zabbix 8.0.x с использованием официальных источников Zabbix.

Перед обновлением обязательно ознакомьтесь с соответствующими примечаниями к обновлению!

Также рекомендуется ознакомиться с требованиями для версии 8.0.

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

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

1 Остановите сервер

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

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

Это очень важный шаг. Убедитесь, что у вас есть резервная копия базы данных. Она поможет восстановить данные, если процедура обновления завершится с ошибкой (из-за нехватки места на диске, отключения питания или любой другой непредвиденной проблемы).

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

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

4 Установка новых двоичных файлов сервера

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

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

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

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

6 Запуск новых двоичных файлов Zabbix

Запустите новые двоичные файлы.
Проверьте файлы журналов, чтобы убедиться, что двоичные файлы успешно запустились.

Сервер Zabbix автоматически обновит базу данных.
При запуске сервер Zabbix сообщает текущую (обязательную и необязательную) и требуемую версии базы данных.
Если текущая обязательная версия старше требуемой, сервер Zabbix автоматически выполняет необходимые исправления для обновления базы данных.
Информация о начале обновления базы данных и его ходе (в процентах) записывается в файл журнала сервера Zabbix.
После завершения обновления в файл журнала записывается сообщение "database upgrade fully completed".
Если какое-либо исправление для обновления завершится ошибкой, сервер Zabbix не запустится.
Сервер Zabbix также не запустится, если текущая обязательная версия базы данных новее требуемой.
Сервер Zabbix запустится только в том случае, если текущая обязательная версия базы данных соответствует требуемой обязательной версии.

8673:20161117:104750.259 current database version (mandatory/optional): 03040000/03040000
8673:20161117:104750.259 required mandatory version: 03040000

Перед запуском сервера:

Убедитесь, что у пользователя базы данных достаточно прав (создание таблиц, удаление таблиц, создание индексов, удаление индексов)
Убедитесь, что у вас достаточно свободного места на диске.

7 Установите новый веб-интерфейс Zabbix

Минимально необходимая версия PHP — 8.2.0. При необходимости обновите PHP и следуйте инструкциям по установке.

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

Процесс обновления прокси

1. Останов прокси

Остановите Zabbix прокси.

2. Резервное копирование файлов конфигурации и бинарного файла Zabbix прокси

Выполните резервное копирование бинарного файла и файла конфигурации Zabbix прокси.

3 Установка новых двоичных файлов прокси

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

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

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

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

5 Запуск нового прокси Zabbix

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

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

Процесс обновления агента

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

Процедура обновления, описанная в этом разделе, может использоваться для обновления как агента Zabbix, так и агента Zabbix 2.

1. Останов агента

Остановите Zabbix агент.

2. Резервное копирование файлов конфигурации и бинарных файлов Zabbix агента

Выполните резервное копирование бинарного файла и файла конфигурации Zabbix агента.

3 Установите новые двоичные файлы агента

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

Также можно скачать предварительно скомпилированные агенты Zabbix со страницы загрузки Zabbix.

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

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

5 Запуск нового агента Zabbix

Запустите новый агент Zabbix. Проверьте файлы журнала, чтобы убедиться, что агент успешно запущен.

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

При обновлении между минорными версиями 8.0.x (например, с 8.0.1 до 8.0.3) необходимо выполнить те же действия для сервера/прокси/агента, что и при обновлении между основными версиями. Единственное отличие заключается в том, что при обновлении между минорными версиями изменения в базе данных не вносятся.

Что дальше?

Обновление из контейнеров

Docs

Обновление из исходных кодов

Обзор