Обновление до версии 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.

  • ALT Linux, РЕД ОС:

    • /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.

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

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

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

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