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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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