3 Установка и обновление. Заметки

1 Установка

Смотрите раздел установки из исходных кодов для получения наиболее подробных сведений.

2 Совместимость версий

Старые агенты от Zabbix 1.0, Zabbix 1.1.x, Zabbix 1.4.x и Zabbix 1.6.x могут быть использованы совместно с Zabbix 1.8. Не требуется никаких изменений в конфигурации на стороне агента.

Старые версии Zabbix прокси 1.6.x не могут работать совместно с Zabbix 1.8, они должны быть обновлены.

3 Важные замечания

3.1 Для версии 1.8
  • Все узлы сети теперь должны принадлежать по крайней мере одной группе.
  • Номер ЦПУ для ключа system.cpu.util в системах Linux теперь начинается с 0.
  • Теперь ключ vfs.fs.size возвращает данные в байтах для всех операционных систем.
  • Теперь ключ vfs.fs.size учитывает зарезервированное дисковое пространство для root пользователя.
  • Комментарии в конце строк файла конфигурации больше не разрешены (возможно только лишь для численных параметров).
3.2 Для версии 1.8.3
  • Параметр service.ntp для ключей элементов данных net.tcp.service и net.tcp.service.perf переименован в ntp. Старый синтаксис продолжает поддерживаться.
  • При попытке запустить демона, скомпилированного с поддержкой IPv6, на системах без поддержки IPv6 будет выдана ошибка:
Listener failed with error: socket() for [[(null)]:10051] failed with error 97: Address family not supported by protocol.
3.3 Для версии 1.8.5
  • Был изменен метод вызова внешних команд у демонов Zabbix для того, чтобы можно было завершать работу вышедших из под контроля процессов. Вместо использования ранее стандартного метода popen, Zabbix теперь явно вызывает /bin/sh для выполнения желаемой команды.
  • При попытке запустить Zabbix демона, скомпилированного в системе Linux с ядром 2.6.27 или более поздней версии, на системах с ядром 2.6.26 или более ранней версии будет сообщено об ошибке:socket() for [[-]:10050] failed with error 22: Invalid argument
3.4 Для версии 1.8.6
  • Демоны Zabbix теперь отказываются запускаться, если в конфигурационном файле содержатся некорректные параметры. Если в конфигурационном файле накопились старые параметры, то после обновления демонов они перейдут в нерабочее состояние до тех пор, пока конфигурационные параметры не будут исправлены.
3.5 Для версии 1.8.8
  • В базе данных Zabbix в некоторых случаях возможно есть узлы сети и прокси с одинаковыми именами. В 1.8.8, Zabbix сервер завершает свою работу, если обнаружит подобную ситуацию. Эта проверка удалена в 1.8.9 версии.
3.6 Для версии 1.8.9

Завершение работы при обнаружении дубликатов узлов сети, введенное в версии 1.8.8, было удалено.

3.7 Для версии 1.8.16

Было введено ограничение на принимаемые данные в 128МБ при использовании Zabbix протокола. Любые другие данные (включая старые протоколы Zabbix) все еще ограничены 16МБ.

Изменения в требованиях к системе

Дополнительные или повышенные требования к системе:

  • Поддержка PHP 4 прекращена.
  • Максимальный размер памяти для PHP должен быть не менее 128МБ (параметр memory_limit).
  • Максимальный размер PHP POST должен быть не менее 16MB (параметр post_max_size).

Смотрите также изменения в требованиях для версий 1.8.2, 1.8.3 и 1.8.9.

1 Известные проблемы

Веб-интерфейс Zabbix версии 1.8 не работает с бэкэндом SQLite. Пожалуйста, воспользуйтесь одной одной из других поддерживаемых баз данных.

1.1 Для версии 1.8
  • Проверка на PHP mbstring может быть неуспешной в PHP < 5.2 в Zabbix 1.8. Чтобы обойти данную проблему, скопируйте файл zabbix.conf.php.example в zabbix.conf.php и измените его параметры вручную, включая параметры доступа к базе данных.
  • Для поддержки IPMI вам необходима свежая версия OpenIPMI - 2.0.14 или более новая.
  • Сортировка в веб-интерфейсе не производится для записей, которые содержат позиционные переменные. Например с именами элементов начинающихся с $1 и других).
  • Экспортирование в XML включает информацию о SNMP и других полях независимо от типа элемента данных.
  • Имена узлов сети с пробелами не работают при отправке данных из файла используя zabbix_sender (исправлено в версии 1.8.2).
  • Загрузка изображений для карт сетей может завершаться ошибкой, если база данных неправильно настроена. Удостоверьтесь, что база данных, таблицы и поля находятся в кодировке UTF-8.
  • Скомпилированные файлы (agent, sender, get) могут не работать на 64-битных системах с версией glibc старее чем 2.5. Общий симптом в таком случае это проблемы с запуском и получение сообщения об ошибке: Floating point exception. Используйте более старые версии, или скомпилируйте с нуля на целевой системе.
1.2 Для версии 1.8.2

Из-за изменений в веб-интерфейсе, некоторые установки могут некорректно отображать старые данные в веб-интерфейсе. К ним относятся:

  • Появление неправильных триггеров с именем ERROR, обычно в разделе Мониторинг → Триггеры, при отображении всех узлов сети из всех групп узлов сети. Этот триггер можно удалить - нажмите на него, затем нажмите на Удалить в форме редактирования триггера и подтвердите удаление.

Возможно вам прийдется удалить часть URL groupid=&hostid=&, прежде чем удалить сам триггер.

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

2 Процедура обновления

Следующие шаги должны быть выполнены для успешного обновления с Zabbix 1.6.x до 1.8. Вся процедура обновления может занять несколько часов, в зависимости от размера базы данных Zabbix.

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

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

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

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

2.3 Сделайте резервную копию файлов настроек, PHP файлов и исполняемых файлов Zabbix

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

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

Вы можете использовать уже скомпилированные исполняемые файлы или скомпилировать свои.

2.5 Просмотрите параметры настроек сервера

Некоторые параметры в zabbix_server.conf изменились в 1.8, а также добавились новые параметры. Вы можете ознакомиться с ними.

  • Параметр настройки StartDBSyncers был удален из файлов конфигураций Zabbix сервера и Zabbix прокси.
2.6 Обновление базы данных

Обновление базы данных требуемый шаг при обновлении с одной мажорной версии Zabbix на другую, например с 1.6 до 1.8. Этот шаг не требуется выполнять при минорных обновлениях, таких как с 1.8.x до 1.8.x, если обратное не указано в заметках о выпуске новой версии.

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

MySQL

alter table dhosts drop index dhosts_1;
       alter table dservices drop index dservices_1;
       alter table httptest drop index httptest_2;
       alter table httptest drop index httptest_3;
       alter table history_log drop index history_log_2;
       alter table history_text drop index history_text_2;
       alter table actions drop index actions_1;
       alter table escalations drop index escalations_2;
       alter table graphs_items drop index graphs_items_1;
       alter table graphs_items drop index graphs_items_2;
       alter table services drop index services_1; 

Oracle или PostgreSQL

drop index dhosts_1;
       drop index dservices_1;
       drop index httptest_2;
       drop index httptest_3;
       drop index history_log_2;
       drop index history_text_2;
       drop index actions_1;
       drop index escalations_2;
       drop index graphs_items_1;
       drop index graphs_items_2;
       drop index services_1; 

Игнорируйте любые сообщения предупреждений о несуществующих индексах!

Скрипты обновления базы данных размещены в папке upgrades/dbpatches/1.8/<db engine>:

  • MySQL: upgrades/dbpatches/1.8/mysql/patch.sql
  • Oracle: upgrades/dbpatches/1.8/oracle/patch.sql
  • PostgreSQL: upgrades/dbpatches/1.8/postgresql/patch.sql

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

Если вы конвертируете базу данных в UTF-8, то эта процедура может занять много часов

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

Эти скрипты предназначены только для обновления с Zabbix 1.6.x до 1.8! Для обновления с более ранних версий используйте скрипты из Zabbix 1.6.x.

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

Следуйте инструкции по установке.

2.8 Запустите новые исполняемые файлы Zabbix

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