Обновление до версии 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.