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

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

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

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

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

Режим обновления не предусматривает полное обновление конфигурации, а также обновление компонентов Визион.Прокси и Визион.Агент, расположенных на удалённых узлах (plagent, 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 для всех сервисов, перечисленных в выводе скрипта.
Убедитесь, что в веб-интерфейсе Визиона в разделе Настройки О программе указана необходимая версия Визиона.

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

Для установки plagent:

В разделе Объекты сформируйте инвентори-файл для нужного ПАК.
Из директории дистрибутива запустите скрипт:
```
./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:

diff -ry /path/to/reference /path/to/current/config

Здесь:

/path/to/reference — путь к файлу или директории в эталонной конфигурации;
/path/to/current/config — путь к файлу или директории в действующей конфигурации.

Для большего удобства можно добавить в вызов команды дополнительные аргументы:

diff -ry -W 200 --left-column /path/to/reference /path/to/current/config

Здесь:

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

Для компонентов, не указанных ниже, производится автоматическая генерация конфигурационныйх файлов через запуск /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.

NGINX

Эталонная конфигурация:

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

Действующая конфигурация:

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

PostgreSQL

Эталонная конфигурация:

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

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

РЕД ОС, PostgresSQL 12:
- /var/lib/pgsql/data;
- /var/lib/pgsql/data/postgresql.conf;
- /var/lib/pgsql/data/pg_hba.conf.
РЕД ОС, PostgreSQL 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, PostgreSQL:
- /var/lib/pgsql/data;
- /var/lib/pgsql/data/postgresql.conf;
- /var/lib/pgsql/data/pg_hba.conf.
ALT Linux, 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 Special Edition:
- /etc/postgresql/11/main/;
- /etc/postgresql/11/main/postgresql.conf;
- /etc/postgresql/11/main/pg_hba.conf.

vision_core

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

Действующая конфигурация: /opt/skala-r/etc/vision/server/vision_core.

Grafana

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

Действующая конфигурация: /opt/skala-r/etc/vision/server/grafana.

snmp_notifier

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

Действующая конфигурация: /opt/skala-r/etc/vision/server/snmp_notifier/web.yml.

VictoriaLogs

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

Действующая конфигурация: /opt/skala-r/etc/vision/server/victorialogs/.

vision_taskdaemon

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

Действующая конфигурация: /opt/skala-r/etc/vision/server/vision_taskdaemon.

vision_utilizer

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

Действующая конфигурация: /opt/skala-r/etc/vision/server/vision_utilizer/config.yml.

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

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

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

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

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

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