Table of Contents

6 Процедура обновления с использованием исходных кодов

6 Процедура обновления с использованием исходных кодов

Обзор

Этот раздел описывает требуемые шаги для успешного обновления до Zabbix 3.0.

Обновление напрямую до Zabbix 3.0 возможно с Zabbix 2.4.x, 2.2.x и 2.0.x. При обновлении с более ранних версий обратитесь к документации Zabbix по 2.0 и более ранним версиям.

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

Чтобы минимизировать время простоя и потери данных в процессе обновления, рекомендуется остановить и обновить Zabbix сервер и один за другим затем остановить, обновить и запустить Zabbix прокси. Когда все прокси будут обновлены, запустите Zabbix сервер. Пока Zabbix сервер будет остановлен, запущенные прокси будут продолжать сбор и хранение данных и отправят эти данные на Zabbix сервер, когда сервер запустится и заработает. Любые оповещения о проблемах в процессе простоя Zabbix сервера будут сгенерированы только после того как обновленный сервер запустится.

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

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

До обновления с 2.4.x до 3.0:

прочитайте заметки по обновлению для 3.0
проверьте требования для 3.0

При обновлении с предыдущих версий, также читайте заметки по обновлению для 2.0 → 2.2 и 2.2 → 2.4.

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

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

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

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

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

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

3 Сделайте копию файлов конфигурации, PHP файлов и приложений Zabbix

Сделайте резервные копии приложений Zabbix, файлов конфигурации и папки с файлами PHP.

4 Установите новые исполняемые файлы сервера

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

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

Параметр HistoryTextCacheSize заменён новым параметром HistoryIndexCacheSize сервера, который должен присутствовать при запуске сервера.

Для ознакомления с остальными рекомендуемыми изменениями и новыми необязательными параметрами, пожалуйста, смотрите раздел Что нового.

6 Запустите новые бинарные файлы Zabbix

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

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

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

До начала запуска процесса сервера:

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

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

Минимально требуемая версия PHP повышена с 5.3.0 до 5.4.0.

Обновите, если требуется, и следуйте инструкции по установке.

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

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

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

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

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

2 Сделайте копию файлов конфигурации и бинарного файла Zabbix прокси

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

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

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

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

Параметр HistoryTextCacheSize заменён новым параметром HistoryIndexCacheSize прокси, который должен присутствовать при запуске прокси.

Для ознакомления с остальными рекомендуемыми изменениями и новыми необязательными параметрами, пожалуйста, смотрите раздел Что нового.

5 Запустите новый Zabbix прокси

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

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

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

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

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

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

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

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

3 Установите новые исполняемые файлы агента

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

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

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

В этой версии обязательные изменения в параметрах агента отсутствуют. Для ознакомления с рекомендуемыми изменениями и новыми необязательными параметрами, пожалуйста, смотрите раздел Что нового.

5 Запустите новый Zabbix агент

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

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

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

Documentation