Инструкция по обновлению Визиона до версии 1.5.1

Обновление до версии Визион 1.5.1 поддерживается с версий 1.4.2 и 1.5. Если версия Визиона меньше указанных, произведите обновление по соответствующей инструкции.

1. Подготовка к обновлению#

При обновлении Визиона будут перегенерированы файлы конфигурации всех компонентов Визиона (Сервер, Прокси, Агенты), поэтому необходимо осуществить резервное копирование файлов конфигурации, которые могу располагаться в следующих директориях.

  • /opt/skala-r/etc/vision
  • /etc/nginx
  • Altlinux, RedOS: 
    • /var/lib/pgsql/data/postgresql.conf
    • /var/lib/pgsql/data/pg_hba.conf
  • Astra:
    • /etc/postgresql/11/main/postgresql.conf
    • /etc/postgresql/11/main/pg_hba.conf

Важно перед обновлением убедиться, что следующие данные присутствуют для восстановления, если они необходимы:

  • Банковский сертификат для Nginx.
  • Параметры интеграций со сторонними системами. Например, vmagent_proxy может быть настроен на отправку метрик в сторонний Prometheus.
  • Параметры авторизации стороннего провайдера OAuth.
  • Параметры почтового шлюза SMTP.
  • Параметры отправки SNMP-трапов.
  • Другие ручные изменения выполненные в файлах конфигурации Визиона.

При обновлении с версии 1.4.2 удалите дашборды в соответствии с инструкцией .

Важно! Список метрик и правил оповещения в пользовательском интерфейсе привязан к версии Визион. Поэтому если после обновления планируется использовать конфигурационный файл vision_core от предыдущей версии, то необходимо в нем вручную изменить версию Визион в поле vision_version в блоке general и перезагрузить сервис vision_core командой systemctl restart vision_core.

Загрузите архив с дистрибутивом новой версии Визиона на узел Визион.Сервера и распакуйте его командой tar -xzf <имя архива>.

2. Удаление предыдущих версий компонентов#

Деинсталлируйте все Агенты и Плагины всех ПАКов в интерфейсе Визиона.

  1. В интерфейсе Визиона в разделе “Объекты” выберите ПАК.
  2. Деинсталлируйте все Агенты и Прокси во вкладке “Агенты”. Дождитесь статуса “Не установлен” всех элементов.
  3. Убедитесь, что во во вкладке “Плагины” были деинсталлированы все элементы. Если нет, деинсталлируйте их.
  4. После выполнения обновления (п.3.2) проведите установку повторно во вкладках “Агенты” и “Плагины”.

3. Обновление#

3.1. Процедура обновления Визион.Сервера#

Для обновления Визиона установкой поверх старой версии выполните следующее:

  1. Запустите скрипт ./setup.sh из директории дистрибутива.
  2. Выберите опцию “Установить пакеты зависимостей из репозитория дистрибутива” или “Установить пакеты зависимостей из репозитория OC”. Дождитесь окончания установки пакетов.
  3. Запустите скрипт ./setup.sh из директории дистрибутива.
  4. Выберите опцию “Установить Сервер Визиона”.
  5. Выберите из списка или укажите IP адрес Сервера Визиона в подсети, которая предназначена для отправки данных в Визион с других узлов.
  6. После успешной установки запустите скрипт “./setup.sh” и выберите опцию “Проверка работы сервисов”. Критерием корректности развертывания является значение “active” для всех сервисов, приведенных в таблице в выводе скрипта.
  7. В веб-интерфейсе Визиона в разделе “Настройки” в пункте “О программе” убедитесь, что указана необходимая версия Визиона.

3.1.1. Решение известных проблем после обновления#

3.1.1.1. Службы vision_core и vision_taskdaemon не запустились#

Проблема: При запуске скрипта ./check_service.sh из директории /opt/skala-r/vision сервисы vision_core и vision_taskdaemon имеют статус failed, а в логах присутствует ошибка “Permission denied”.

Проверьте, что директории /opt/skala-r/var и /opt/skala-r/var/log принадлежат root и имеют права 755 и установите целевые права:

chmod 755 \
/opt/skala-r/var \
/opt/skala-r/var/log
systemctl restart vision_core vision_taskdaemon
systemctl status vision_core vision_taskdaemon

Если в логах присутствуют ошибки доступа к другим директориям, исправьте согласно примеру выше.

3.1.1.2. Не запускаются сервисы systemd Визион.Прокси или Визион.Агент#

Уточните причины невозможности запуска компонента в логах компонента. 

Вероятной причиной данной проблемы при обновлении является попытка вызова управляющих воздействий (установка, деинсталляция) плагинов из интерфейса Визиона со старой версией Агента Платформы, что приводит к неверным назначениям прав на директории. Перед устранением проблем убедитесь, что вы обновили Агент Платформы на всех узлах ПАКов.

Убедитесь, что общие директории продуктов skala-r имеют права 755 (rwxr-xr-x).

/opt/skala-r
/opt/skala-r/etc
/opt/skala-r/var
/opt/skala-r/var/log

Убедитесь, что директории компонентов Визиона имеют права 755 (rwxr-xr-x) и принадлежат пользователю и группе vision, включая все внутренние директории.

/opt/skala-r/vision/*
/opt/skala-r/etc/vision/*
/opt/skala-r/var/log/vision/*

Права на файлы компонентов Визион.Прокси и Визион.Агент:

  • создаваемые Агентом Платформы
    • файлы конфигурации /opt/skala-r/etc/vision/<agent|proxy>/<service>/*.<env|yml|...> - vision 400 (r-------).
    • бинарные файлы /opt/skala-r/vision/<agent|proxy>/<service>/* - vision 500 (r-x------)
    • сервисы systemd /etc/systemd/system/vision_*.service - 644 (rw-r--r--).
  • логи аудита компонентов /opt/skala-r/var/log/vision/audit/<component>/<service>/audit.log - 600 (rw------).

3.2. Установите/обновите агент Платформы#

Установить Плагент: 

  1. Сформируйте инвентори-файл для нужного ПАК во вкладке Объекты.
  2. Запустите скрипт ./setup.sh из директории дистрибутива.
  3. Выберите опцию “Установка plagent”.
  4. Выберите сформированный инвентори-файл.
  5. При необходимости отредактируйте, указав значения ключей ansible_user, ansible_ssh_pass, ansible_become_password для доступа к узлам по SSH.

3.3. Восстановите параметры Визиона#

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

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

  • SMTP-шлюз: в интерфейсе Визиона в разделе “Настройки SMTP”.
  • SNMP-шлюз: через API как указано в п. 9 Руководства Администратора Визион

Все ранее вручную настроенные параметры в файлах конфигурации (например, config.yml, nginx.conf и прочие) необходимости заново внести.

При изменении конфигурационных файлов перезапустите затронутые сервисы.

3.4. Настройка ролевой модели#

При необходимости перенастройте ролевую модель согласно Руководству Администратора .