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

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

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

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

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

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

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

Подготовка#

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

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

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

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

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

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

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

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

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

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

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

запустить установку пакетов зависимостей командой ./setup.sh -p из директории дистрибутива (или альтернативно ./setup.sh -g для установки пакетов зависимостей из репозитория OC);
Для ОС РЕДОС 8 и Альт СП р10 (c10f2) будет предложено установить Postgres Pro. Подробно об этом написано в разделе дополнительной документации Обновление postgresql ;
запустить обновление сервера Визиона командой ./setup.sh -u (пункт 8 в меню выбора). Начнется процесс обновления;
после успешного обновления запустить скрипт ./setup.sh и выбрать опцию “Проверка работы сервисов”. Критерием корректности развертывания является значение “active” для всех сервисов, приведенных в таблице в выводе скрипта ./setup.sh;
необходимо убедиться, что в веб-интерфейсе Визиона в разделе “Настройки” в пункте “О программе” указана необходимая версия Визиона.

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

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

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

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

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

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

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

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

Несмотря на это, рекомендуется всегда проводить контрольную сверку файлов конфигурации.

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

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

Путь к конфигурационным файлам	Путь к эталонным файлам конфигурации	Команда для просмотра изменений
`/etc/nginx/` Скорее всего понадобятся только эти пути `/etc/nginx/nginx.conf` `/etc/nginx/sites-available.d/` `/etc/nginx/snippets/`	`/opt/skala-r/vision/server/default/nginx/` `/opt/skala-r/vision/server/default/nginx/nginx.conf` `/opt/skala-r/vision/server/default/nginx/sites-available.d/` `/opt/skala-r/vision/server/default/nginx/snippets/`	`diff -ry /opt/skala-r/vision/server/default/nginx /etc/nginx/` `diff -ry /opt/skala-r/vision/server/default/nginx/nginx.conf /etc/nginx/nginx.conf` `diff -ry /opt/skala-r/vision/server/default/nginx/sites-available.d/ /etc/nginx/sites-available.d/` `diff -ry /opt/skala-r/vision/server/default/nginx/snippets/ /etc/nginx/snippets/`
для redos: postgres 12 `/var/lib/pgsql/data` `/var/lib/pgsql/data/postgresql.conf` `/var/lib/pgsql/data/pg_hba.conf` postgres 16 `/var/lib/pgsql/16/data` `/var/lib/pgsql/16/data/postgresql.conf` `/var/lib/pgsql/16/data/pg_hba.conf` postgres PRO 16 `/var/lib/pgpro/std-16/data/` `/var/lib/pgpro/std-16/data/postgresql.conf` `/var/lib/pgpro/std-16/data/pg_hba.conf` для alt linux: `/var/lib/pgsql/data` `/var/lib/pgsql/data/postgresql.conf` `/var/lib/pgsql/data/pg_hba.conf` postgres PRO 16 `/var/lib/pgpro/std-16/data/` `/var/lib/pgpro/std-16/data/postgresql.conf` `/var/lib/pgpro/std-16/data/pg_hba.conf` для astra linux: `/etc/postgresql/11/main/` `/etc/postgresql/11/main/postgresql.conf` `/etc/postgresql/11/main/pg_hba.conf`	`/opt/skala-r/vision/server/default/postgresql/<postgres_version>` `/opt/skala-r/vision/server/default/postgresql/<postgres_version>/postgresql.conf` `/opt/skala-r/vision/server/default/postgresql/<postgres_version>/pg_hba.conf`	`diff -ry /opt/skala-r/vision/server/default/postgresql/<postgres_version> /var/lib/pgsql/data` `diff -ry <путь до конф. файлов в ОС>/postgresql.conf /opt/skala-r/vision/server/default/postgresql/<postgres_version>/postgresql.conf` `diff -ry <путь до конф. файлов в ОС>/pg_hba.conf /opt/skala-r/vision/server/default/postgresql/<postgres_version>/pg_hba.conf`
`/opt/skala-r/etc/vision/server/vision_core`	`/opt/skala-r/vision/server/default/server/vision_core`	`diff -ry /opt/skala-r/etc/vision/server/vision_core /opt/skala-r/vision/server/default/server/vision_core`
`/opt/skala-r/etc/vision/server/grafana`	`/opt/skala-r/vision/server/default/server/grafana`	`diff -ry /opt/skala-r/etc/vision/server/grafana /opt/skala-r/vision/server/default/server/grafana`
`/opt/skala-r/etc/vision/server/snmp_notifier/web.yml`	`/opt/skala-r/vision/server/default/server/snmp_notifier/web.yml`	`diff -ry /opt/skala-r/etc/vision/server/snmp_notifier/web.yml /opt/skala-r/vision/server/default/server/snmp_notifier/web.yml`
`/opt/skala-r/etc/vision/server/victorialogs/`	`/opt/skala-r/vision/server/default/server/victorialogs/`	`diff -ry /opt/skala-r/etc/vision/server/victorialogs /opt/skala-r/vision/server/default/server/victorialogs`
`/opt/skala-r/etc/vision/server/vision_taskdaemon`	`/opt/skala-r/vision/server/default/server/vision_taskdaemon`	`diff -ry /opt/skala-r/etc/vision/server/vision_taskdaemon /opt/skala-r/vision/server/default/server/vision_taskdaemon`
`/opt/skala-r/etc/vision/server/vision_utilizer/config.yml`	`/opt/skala-r/vision/server/default/server/vision_utilizer/config.yml`	`diff -ry /opt/skala-r/etc/vision/server/vision_utilizer /opt/skala-r/vision/server/default/server/vision_utilizer/config.yml`

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

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

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

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

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

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

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

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