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

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

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-трапов.
  • Другие ручные изменения выполненные в файлах конфигурации Визиона.

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

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

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

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

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

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

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

  1. Запустите установку пакетов зависимостей командой ./setup.sh -p из директории дистрибутива (или альтернативно ./setup.sh -g для установки пакетов зависимостей из репозитория OC)
  2. Запустите установку сервера Визиона командой ./setup.sh -i и выберите из списка или укажите IP адрес сервера Визиона в подсети, которая предназначена для отправки данных в Визион с других узлов
  3. После успешной установки запустите скрипт ./setup.sh и выберите опцию “Проверка работы сервисов”. Критерием корректности развертывания является значение “active” для всех сервисов, приведенных в таблице в выводе скрипта (исключением является сервис vision_iamsyncer который будет запущен только при включенной опции auth.user_update_enabled в config.yml vision core)
  4. В веб-интерфейсе Визиона в разделе “Настройки” в пункте “О программе” убедитесь, что отображается необходимая версия Визиона.

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

Cписок вероятных проблем указан в инструкции для релиза 1.5.1

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

Чтобы установить Плагент:

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

Восстановление параметров Визиона

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

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

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

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

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

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

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