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

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

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

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

резервное копирование конфигурации;
обновление компонентов Визиона;
копирование эталонной конфигурации (также и в режиме чистой установки);
обновление файлов конфигурации NGINX (на данный момент с перезаписью);
сохранение в действии пользовательской конфигурации, кроме NGINX;
добавление в файл конфигурации vision_core новых полей со стандартными значениями;
добавление новых ключей со стандартными значениями в Ansible 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
Для РЕД ОС 8 и Альт СП р10 (c10f2) будет предложено установить Postgres Pro. Подробно об этом написано в разделе Обновление PostgreSQL.
Запустить установку сервера Визиона:
```
./setup.sh -u
```
Будет запущен процесс обновления.
После успешного обновления запустить скрипт ./setup.sh и выбрать пункт Проверка работы сервисов.

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

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

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

Сформировать инвентори-файл для нужного ПАК во вкладке Объекты.
Запустить скрипт ./setup.sh из директории дистрибутива.
Выбрать пункт Установка plagent.
Выбрать сформированный инвентори-файл.
Отредактировать инвентори файла, указав значения ключей 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, указав пути к нужным файлам или директориям, например:

diff -ry /path/to/left /path/to/right

Для улучшения вывода используйте дополнительные аргументы, например:

diff -ry -W 200 --left-column /path/to/left /path/to/right

где:

-W 200 — вывод не более 200 знаков в строке (по умолчанию 130);
--left-column — вывод только левой колонки общих строк.

NGINX

Конфигурационные файлы:

/etc/nginx/nginx.conf
/etc/nginx/sites-available.d/
/etc/nginx/snippets/

Эталонные конфигурационные файлы:

/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

AlertManager

Конфигурационный файл: /opt/skala-r/etc/vision/server/alertmanager.

Эталонный конфигурационный файл: /opt/skala-r/vision/server/default/server/alertmanager.

Grafana

Конфигурационные файлы: /opt/skala-r/etc/vision/server/grafana.

Эталонные конфигурационные файлы/opt/skala-r/vision/server/default/server/grafana.

snmp_notifier

Конфигурационные файлы: /opt/skala-r/etc/vision/server/snmp_notifier.

Эталонные конфигурационные файлы: /opt/skala-r/vision/server/default/server/snmp_notifier.

VictoriaLogs

Конфигурационные файлы: /opt/skala-r/etc/vision/server/victorialogs/.

Эталонные конфигурационные файлы: /opt/skala-r/vision/server/default/server/victorialogs/.

VictoriaMetrics

Конфигурационные файлы: /opt/skala-r/etc/vision/server/victoriametrics_st.

Эталонные конфигурационные файлы: /opt/skala-r/vision/server/default/server/victoriametrics_st.

vision_alertcollector

Конфигурационные файлы: /opt/skala-r/etc/vision/server/vision_alertcollector.

Эталонные конфигурационные файлы: /opt/skala-r/vision/server/default/server/vision_alertcollector.

vision_backup

Конфигурационные файлы: /opt/skala-r/etc/vision/server/vision_backup.

Эталонные конфигурационные файлы: /opt/skala-r/vision/server/default/server/vision_backup

vision_core

Конфигурационные файлы: /opt/skala-r/etc/vision/server/vision_core.

Эталонные конфигурационные файлы: /opt/skala-r/vision/server/default/server/vision_core.

vision_iamsyncer

Конфигурационные файлы: /opt/skala-r/etc/vision/server/vision_iamsyncer.

Эталонные конфигурационные файлы: /opt/skala-r/vision/server/default/server/vision_iamsyncer.

vision_taskdaemon

Конфигурационные файлы: /opt/skala-r/etc/vision/server/vision_taskdaemon.

Эталонные конфигурационные файлы: /opt/skala-r/vision/server/default/server/vision_taskdaemon.

vision_utilizer

Конфигурационные файлы: /opt/skala-r/etc/vision/server/vision_utilizer.

Эталонные конфигурационные файлы: /opt/skala-r/vision/server/default/server/vision_utilizer.

vmalert_st

Конфигурационные файлы: /opt/skala-r/etc/vision/server/vmalert_st.

Эталонные конфигурационные файлы: /opt/skala-r/vision/server/default/server/vmalert_st.

vmalert_vl

Конфигурационные файлы: /opt/skala-r/etc/vision/server/vmalert_vl.

Эталонные конфигурационные файлы: /opt/skala-r/vision/server/default/server/vmalert_vl.

PostgreSQL

Путь к конфигурационным файлам зависит от используемого дистрибутива Linux и версии PostgreSQL.

РЕД ОС, PostgreSQL 12:
- /var/lib/pgsql/data/postgresql.conf
- /var/lib/pgsql/data/pg_hba.conf
РЕД ОС, PostgreSQL 16:
- /var/lib/pgsql/16/data/postgresql.conf
- /var/lib/pgsql/16/data/pg_hba.conf
РЕД ОС, Postgres PRO 16:
- /var/lib/pgpro/std-16/data/postgresql.conf
- /var/lib/pgpro/std-16/data/pg_hba.conf
ALT Linux:
- /var/lib/pgsql/data/postgresql.conf
- /var/lib/pgsql/data/pg_hba.conf
ALT Linux, Postgres PRO 16:
- /var/lib/pgpro/std-16/data/postgresql.conf
- /var/lib/pgpro/std-16/data/pg_hba.conf
Astra Linux:
- /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

Проверка параметров после сверки конфигурации

После внесения изменений в конфигурацию необходимо:

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

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

Параметры шлюзов для отправки уведомлений о срабатывании правил оповещения:
- SMTP-шлюз: в интерфейсе Визиона в разделе "Настройки SMTP".
- SNMP-шлюз: через API.
Все ранее настроенные вручную параметры в файлах конфигурации (например, config.yml, .secrets_vault и другие) при необходимости донастроить, если появились новые параметры;
Если конфигурация NGINX изменялась вручную, нужно будет настроить её заново.
При необходимости перенастроить ролевую модель согласно Руководству Администратора.

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