Обновление Визион до версии 1.6

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

Общий принцип и порядок проведения обновления (детальное описание ниже):

  1. Сделать бэкап текущих файлов конфигурации и убедиться, что в бэкап попали данные для последующего восстановления, в том числе ручные правки, если они имелись.
  2. Загрузить архив нового дистрибутива и распаковать его.
  3. В UI Визиона для каждого ПАК деинсталлировать Агенты и Плагины.
  4. Запустить обновление используя скрипт ./setup.sh из директории дистрибутива, выполнить те же шаги что и при чистой установке.
  5. Обновить plagent используя стандартный подход с генерацией inventory файла и запуском плейбука Ansible.
  6. В UI Визиона для каждого ПАК запустить установку Агентов и плагинов.
  7. Восстановить из бэкапа ручные правки, перезапустить сервисы.

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

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

  • /opt/skala-r/etc/vision

  • /etc/nginx

  • Altlinux, RedOS:

    • /var/lib/pgsql/data/postgresql.conf
    • /var/lib/pgsql/data/pg_hba.conf

  • Astra Linux:

    • /etc/postgresql/11/main/postgresql.conf
    • /etc/postgresql/11/main/pg_hba.conf

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

  • Пароли из /opt/skala-r/vision/.secrets_vault.
  • Сертификат TLS для Nginx (см. в /etc/nginx).
  • Параметры интеграций со сторонними системами. Например, vmagent_proxy может быть настроен на отправку метрик в сторонний Prometheus.
  • Параметры авторизации стороннего провайдера OAuth (KeyCloak, Аванпост).
  • Параметры почтового шлюза SMTP.
  • Параметры отправки SNMP-трапов.
  • Другие ручные изменения выполненные в файлах конфигурации Визиона.

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

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

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

Обновление#

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

Загрузите архив с дистрибутивом версии Визиона 1.6 на узел Визион.Сервера и распакуйте его:

tar -xzf <имя_архива>

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

  1. Из директории дистрибутива запустите установку пакетов:

    • Для установки пакетов зависимостей из дистрибутива Визион:

      ./setup.sh -p

    • Для установки пакетов зависимостей из репозиториев ОС:

      ./setup.sh -g

  2. Запустите установку сервера Визиона:

    ./setup.sh -i

  3. Выберите из списка или укажите IP-адрес сервера Визиона в подсети, которая предназначена для отправки данных в Визион с других узлов.

  4. После успешной установки запустите скрипт ./setup.sh и выберите опцию “Проверка работы сервисов”.

    Критерием корректности развертывания является значение “active” для всех сервисов, приведенных в таблице в выводе скрипта.

  5. В веб-интерфейсе Визиона в разделе Настройки в пункте О программе убедитесь, что указана необходимая версия Визиона.

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

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

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

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

  1. Сформируйте инвентори-файл для нужного ПАК в разделе Объекты интерфейса Визиона, нажав ⠇, пункт “Инвентори”. Файл будет скачан, а также доступен в директории /opt/skala-r/vision/server/inventory/ на узле Визион.Сервера.

  2. Запустите скрипт ./setup.sh из директории дистрибутива.

  3. Выберите опцию Установка plagent.

  4. Выберите сформированный инвентори-файл.

  5. При необходимости отредактируйте, указав значения ключей ansible_user, ansible_ssh_pass, ansible_become_password для доступа к узлам по SSH.

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

В интерфейсе Визиона в разделе Объекты установите все Агенты и Плагины всех ПАК.

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

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

    • SMTP-шлюз: в интерфейсе Визиона в разделе “Настройки SMTP”.

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

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

При изменении конфигурационных файлов перезапустите затронутые сервисы и запустите скрипт /opt/skala-r/vision/tools/update_server_configs.sh.

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

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