Этот раздел описывает требуемые шаги для успешного обновления с Zabbix 4.0.x до Zabbix 4.2.x с использованием официальных пакетов Zabbix для Red Hat Enterprise Linux/CentOS.
Пожалуйста, обратите внимание, что поддержка Jabber оповещений была удалена из официальных пакетов Zabbix сервера начиная с версии 4.2.0-1 из-за отсутствия поддержки и наличии уязвимостей в libiksemel библиотеке. Если вам необходимо наличие этой функции, смотрите этот раздел для получения более подробной информации.
В то время как обновление Zabbix агентов не является обязательным шагом (но рекомендуемым), Zabbix сервер и прокси должны быть одной мажорной версии. Поэтому, при наличии сервер-прокси инсталляции, Zabbix сервер и все прокси должны быть остановлены и обновлены. Оставление прокси запущенными в процессе обновления сервера более не принесёт никакой пользы, так как в процессе обновления прокси их старые данные будут отброшены и новые данные не будут собираться пока конфигурация прокси не будет синхронизирована с сервером.
Обратите внимание, что при наличии прокси с SQLite базой данных, данные истории этих прокси будут потеряны до обновления, так как обновление файла базы данных SQLite не поддерживется и этот файл необходимо удалить вручную. Когда прокси запускается в первый раз и будет отсутствовать файл базы данных SQLite, прокси создаст его автоматически.
В зависимости от размера базы данных обновление базы данных до версии 4.2 может занять продолжительное время.
Перед выполнением обновления убедитесь что прочитали все соответствующие заметки по обновлению!
Доступны следующие заметки по обновлению:
Обновление с | Прочитайте заметки по обновлению полностью | Наиболее важные изменения между версиями |
---|---|---|
4.0.x | Для: Zabbix 4.2 |
Более старые прокси более не могут передавать данные на обновленный сервер; Более новые агенты более не могут работать с более старым Zabbix сервером |
3.4.x | Для: Zabbix 4.0 Zabbix 4.2 |
Библиотеки 'libpthread' и 'zlib' теперь обязательны; Поддержка протокола в виде простого текста убрана и заголовок обязателен; Zabbix агенты версий Pre-1.4 более не поддерживаются; Параметр Server в конфигурации пассивного прокси теперь обязателен |
3.2.x | Для: Zabbix 3.4 Zabbix 4.0 Zabbix 4.2 |
Поддержка SQLite в виде основной базы данных убрана для Zabbix сервера/веб-интерфейса; Поддерживается Perl совместимые регулярные выражения (PCRE) вместо POSIX расширенных; Библиотеки 'libpcre' and 'libevent' обязательны для Zabbix сервера; Добавлены проверки кода выхода для пользовательских параметров, удаленных команд и элементов данных system.run[] без 'nowait' флага, а также для выполняемых скриптов Zabbix сервером; Zabbix Java gateway необходимо обновить для поддержки новых функций |
3.0.x LTS | Для: Zabbix 3.2 Zabbix 3.4 Zabbix 4.0 Zabbix 4.2 |
Обновление базы данных может быть медленным, в зависимости от размеров таблиц истории |
Вы возможно захотите также проверить требования для 4.2.
Возможно удобно запустить две параллельные SSH сессии на время обновления, выполняя шаги обновления в одной сессии и наблюдая за файлами журналов сервера/прокси в другой. Например, при выполнении tail -f zabbix_server.log
или tail -f zabbix_proxy.log
во второй SSH сессии будут отображаться последние записи из файла журнала и возможные ошибки в режиме реального времени. Такой подход может быть критичным на продуктивных серверах.
Остановите Zabbix сервер, чтобы быть уверенными, что в базу данных не будет происходить запись новых данных.
При обновлении прокси, остановите также и его.
Более невозможно запустить обновленный сервер и более старые, не обновленные прокси, которые бы отправляли данные на более новый сервер. Такой подход, который никогда не рекомендовался и не поддерживался в Zabbix, теперь официально отключён при обновлении до 4.2 (и более новых версий) с любой версии до 4.2, так как сервер будет игнорировать данные с не обновленных прокси.
Этот шаг очень важен. Убедитесь, что у вас есть архивная копия вашей базы данных. Это поможет, если процедура обновления закончится неудачно (отсутствие свободного места на диске, выключение питания, любая неожиданная проблема).
Выполните резервное копирование бинарных файлов Zabbix, файлов конфигурации и папки с PHP файлами.
Файлы конфигурации:
# mkdir /opt/zabbix-backup/
# cp /etc/zabbix/zabbix_server.conf /opt/zabbix-backup/
# cp /etc/httpd/conf.d/zabbix.conf /opt/zabbix-backup/
Файлы PHP и бинарные файлы Zabbix:
Чтобы продолжить обновление, необходимо обновить пакет текущий репозитория.
Для обновления компонентов Zabbix вы можете выполнить что-то вроде:
Если используете PostgreSQL, в команде замените mysql
на pgsql
. Если обновляете прокси, в команде замените server
на proxy
.
Для получения более подробных сведений смотрите заметки по обновлению на предмет обязательных изменений.
Запустите обновленные компоненты Zabbix.
После обновления вам, возможно, потребуется очистить cookies веб-браузера и кэш веб-браузера, чтобы Zabbix веб-интерфейс работал правильно.
Имеется возможность обновления между минорными версиями 4.2.x (например, с 4.2.1 на 4.2.3). Процедура минорного обновления Zabbix очень проста.
Для выполнения минорного обновления Zabbix необходимо выполнить:
Для выполнения обновления минорной версии Zabbix сервера выполните:
Для выполнения обновления минорной версии Zabbix агента выполните:
Обратите внимание, что в этих командах вы можете также использовать 'update' вместо 'upgrade'. В то время как 'upgrade' удалит устаревшие пакеты, 'update' сохранит их.
Рекомендуемый способ добавления поддержки Jabber оповещений к Zabbix серверу - сборка заново из пакета с исходным кодом.
$ sudo yum -y install iksemel-devel gcc
$ rpm -ivh http://repo.zabbix.com/zabbix/4.2/rhel/7/SRPMS/zabbix-4.2.1-1.el7.src.rpm
$ cd ~/rpmbuild/SPECS
$ sudo yum-builddep -y zabbix.spec
$ sed -i.bak -r 's/^(build_flags=.*--enable-server)"$/\1 --with-jabber"/;s/^(Release\s*:\s*[^1-9]*[1-9][0-9]*)(.*)/\1.1\2/' zabbix.spec
$ rpmbuild -ba zabbix.spec
[..]
Wrote: /root/rpmbuild/SRPMS/zabbix-4.2.1-1.1.el7.src.rpm
Wrote: /root/rpmbuild/RPMS/x86_64/zabbix-agent-4.2.1-1.1.el7.x86_64.rpm
Wrote: /root/rpmbuild/RPMS/x86_64/zabbix-get-4.2.1-1.1.el7.x86_64.rpm
Wrote: /root/rpmbuild/RPMS/x86_64/zabbix-sender-4.2.1-1.1.el7.x86_64.rpm
Wrote: /root/rpmbuild/RPMS/x86_64/zabbix-proxy-mysql-4.2.1-1.1.el7.x86_64.rpm
Wrote: /root/rpmbuild/RPMS/x86_64/zabbix-proxy-pgsql-4.2.1-1.1.el7.x86_64.rpm
Wrote: /root/rpmbuild/RPMS/x86_64/zabbix-proxy-sqlite3-4.2.1-1.1.el7.x86_64.rpm
Wrote: /root/rpmbuild/RPMS/x86_64/zabbix-java-gateway-4.2.1-1.1.el7.x86_64.rpm
Wrote: /root/rpmbuild/RPMS/x86_64/zabbix-server-mysql-4.2.1-1.1.el7.x86_64.rpm
Wrote: /root/rpmbuild/RPMS/x86_64/zabbix-server-pgsql-4.2.1-1.1.el7.x86_64.rpm
Wrote: /root/rpmbuild/RPMS/noarch/zabbix-web-4.2.1-1.1.el7.noarch.rpm
Wrote: /root/rpmbuild/RPMS/noarch/zabbix-web-mysql-4.2.1-1.1.el7.noarch.rpm
Wrote: /root/rpmbuild/RPMS/noarch/zabbix-web-pgsql-4.2.1-1.1.el7.noarch.rpm
Wrote: /root/rpmbuild/RPMS/noarch/zabbix-web-japanese-4.2.1-1.1.el7.noarch.rpm
Wrote: /root/rpmbuild/RPMS/x86_64/zabbix-debuginfo-4.2.1-1.1.el7.x86_64.rpm
Executing(%clean): /bin/sh -e /var/tmp/rpm-tmp.XFsa0b
+ umask 022
+ cd /root/rpmbuild/BUILD
+ cd zabbix-4.2.1
+ rm -rf /root/rpmbuild/BUILDROOT/zabbix-4.2.1-1.1.el7.x86_64
+ exit 0