Обновление до версии 1.5.1

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

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

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

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

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

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

При обновлении с версии 1.4.2 восстановите конфигурацию дашбордов, следуя инструкции.

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

systemctl restart vision_core

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

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

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

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

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

Обновление

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

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

Запустите скрипт ./setup.sh из директории дистрибутива.
Выберите пункт Установить пакеты зависимостей из репозитория дистрибутива или Установить пакеты зависимостей из репозитория OC. Дождитесь окончания установки пакетов.
Запустите скрипт ./setup.sh из директории дистрибутива.
Выберите пункт Установить Сервер Визиона.
Выберите из списка или укажите IP адрес Сервера Визиона в подсети, которая предназначена для отправки данных в Визион с других узлов.
После успешной установки запустите скрипт ./setup.sh и выберите пункт Проверка работы сервисов.

Критерием корректности развёртывания является значение active для всех сервисов, приведенных в таблице в выводе скрипта.
Убедитесь, что в разделе Настройки О программе указана необходимая версия Визиона.

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

Службы 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

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

Не запускаются сервисы 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------).

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

Установить plagent:

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

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

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

Параметры шлюзов для отправки уведомлений о срабатывании правил оповещения:
- SMTP-шлюз: в интерфейсе Визиона в разделе Настройки SMTP.
- SNMP-шлюз: через API.
Все ранее вручную настроенные параметры в файлах конфигурации (например, config.yml, nginx.conf и прочие) необходимости заново внести.

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