На странице

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

Обзор

В этом разделе приведены шаги, необходимые для успешного обновления с 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

До запуска сервера:

  • Убедитесь, что пользователь базы данных имеет достаточно прав (create table, drop table, create index, drop index).
  • Убедитесь что у вас достаточно свободного дискового пространства.
7 Установка нового веб-интерфейса Zabbix

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

8. Очистка cookies и кэша в веб-браузере

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

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

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

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

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

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

3 Установите новые бинарные файлы прокси

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

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

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

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

6. Запуск нового 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) необходимо выполнить те же действия для сервера/прокси/агента, что и при обновлении между мажорными версиями. Единственное отличие заключается в том, что при обновлении между минорными версиями изменения в базу данных не вносятся.