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

Режим обновления позволяет обновить Визион с сохранением текущей конфигурации, но требующий ручной донастройки и ручного обновления удаленных компонентов.

Режим обновления Визиона предусматривает:

• бэкап конфигурации;
• обновление компонентов Визиона;
• копирование эталонной конфигурации (также и в режиме чистой установки);
• обновление файлов конфигурации nginx (на данный момент с перезаписью);
• сохранение в действии пользовательской конфигурации, кроме nginx;
• добавление в файл конфигурации vision_core новых полей со стандартными значениями;
• добавление новых ключей со стандартными значениями в vault.

На данном этапе режим обновления не предусматривает полное обновление конфигурации, а также обновления компонентов Визион.Прокси и Визион.Агенты расположенных на удаленных узлах (плагент, vmagent и экспортеры).

Процесс обновления#

Подготовка#

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

• .secrets_vault;
• конфигурация nginx;
• конфигурационные файлы postgresql.conf, pg_hba.conf для postgresql;
• файлы конфигурации из директории /opt/skala-r/etc/vision/server.

Перед обновлением необходимо сохранить следующие конфигурации:

1. Параметры интеграций со сторонними системами(например, vmagent_proxy может быть настроен на отправку метрик в сторонний Prometheus);
2. Другие ручные изменения выполненные в файлах конфигурации компонентов Визиона.

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

Необходимо деинсталлировать все элементы каждого ПАК из разделов “Агенты” и “Плагины” в интерфейсе Визиона. Для этого необходимо выполнить следующие действия:

• в интерфейсе Визиона в разделе “Объекты” выбрать ПАК;
• деинсталлировать все “Агенты” и “Прокси” во вкладке “Агенты”. У всех элементов должен быть статус “Не установлен”;
• деинсталлировать все эелементы во вкладке “Плагины”.

После выполнения обновления необходимо выполнить установку элементов во вкладках “Агенты” и “Плагины”.

Обновление Визион.Сервера#

Перед установкой/обновлением проводится проверка установленных пакетов. Если есть неустановленные зависимости, установка/обновление будут прерваны.

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

• запустить установку пакетов зависимостей командой ./setup.sh -p из директории дистрибутива (или альтернативно ./setup.sh -g для установки пакетов зависимостей из репозитория OC);

• Для ОС РЕДОС 8 и Альт СП р10 (c10f2) будет предложено установить Postgres Pro. Подробно об этом написано в разделе дополнительной документации Обновление postgresql ;

• запустить установку сервера Визиона командой ./setup.sh -u (пункт 8 в меню выбора). Будет запущен процесс обновления;

• после успешного обновления запустить скрипт ./setup.sh и выбрать опцию “Проверка работы сервисов”. Критерием корректности развертывания является значение “active” для всех сервисов, приведенных в таблице в выводе скрипта ./setup.sh;

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

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

Для установки плагента необходимо выполнить следующие действия: 

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

Доконфигурирование параметров Визиона#

После обновления необходимо проверить конфигурацию Визиона и внести необходимые изменения.

Не рекомендуется просто копировать конфигурации из директории /opt/skala-r/vision/server/default, так как в этом случае будут перезаписаны пользовательские изменения.

C помощью представленных в таблице команд или иным способом сравнить текущую конфигурацию и эталонную. При наличии новых ключей, фрагментов и файлов произвести добавление соответствующих ключей, фрагментов и файлов в действующую конфигурацию.

Для файла /opt/skala-r/etc/vision/server/vision_core/config.yml производится запись новых ключей с базовыми значениями при работе скрипта /opt/skala-r/vision/tools/update_server_configs.sh во время процедуры обновления. Несмотря на это, рекомендуется произвести контрольную сверку файлов конфигурации.

Для того, чтобы сверить конфигурации можно использовать команду diff -ry -W 200 --left-column где, -W 200 - вывод не более 200 знаков (по умолчанию 130), --left-column - вывод только левой колонки общих строк

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

После сверки файлов конфигурации необходимо проверить следующие параметры:

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

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

2. все ранее настроенные вручную параметры в файлах конфигурации (например, config.yml, .secrets_vault и другие) при необходимости донастроить, если появились новые параметры;

3. конфигурацию nginx, если она изменялась вручную, необходимо сконфигурировать заново;

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

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