Обновление Визион до версии 1.8.1

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

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

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

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

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

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

Подготовка#

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

Параметры интеграций со сторонними системами. Например, vmagent_proxy может быть настроен на отправку метрик в сторонний Prometheus.
Конфигурационные файлы sudo, если вносили в них изменения вручную:
- /etc/sudoers.d/vision
- /etc/sudoers.d/plagent
При обновлении эти файлы будут перезаписаны. Если вы добавляли в эти файлы настройки для плагина bash_exporter, перенесите их в файл /etc/sudoers.d/vision_bash_exporter.
Другие изменения в файлах конфигурации компонентов Визиона, выполненные вручную.

Для создания резервной копии действующей конфигурации используйте скрипт обновления. Он создаёт резервную копию конфигурации сервера Визиона, в которую входят:

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

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

Через интерфейс Визиона деинсталлируйте все элементы каждого ПАК из разделов Агенты и Плагины. Для этого:

В интерфейсе Визиона в разделе Объекты выберите ПАК.
Выберите вкладку Агенты и деинсталлируйте все Агенты и Прокси.

У всех элементов должен быть статус Не установлен.
Выберите вкладку Плагины и деинсталлируйте все элементы.

После обновления установите нужные компоненты повторно.

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

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

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

Из директории дистрибутива запустите установку пакетов зависимостей:
- Для установки зависимостей из дистрибутива:
```
./setup.sh -p
```
- Для установки пакетов зависимостей из репозиториев ОС:
```
./setup-sh -g
```
Для ОС РЕД ОС 8 и Альт СП р10 (c10f2) будет предложено установить Postgres Pro. Подробности см. в разделе Обновление postgresql .
Запустите обновление сервера Визиона:
```
./setup.sh -u
```
После успешного обновления запустите скрипт setup.sh без параметров:
```
./setup.sh
```
Выберите пункт Проверка работы сервисов.

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

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

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

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

Донастройка параметров Визиона#

После обновления проверьте конфигурацию Визиона и внесите необходимые изменения. Для этого сравните действующую конфигурацию и эталонную, например, с помощью утилиты 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/server/default, так как в этом случае будут перезаписаны пользовательские изменения.

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/<version>
- /opt/skala-r/vision/server/default/postgresql/<version>/postgresql.conf
- /opt/skala-r/vision/server/default/postgresql/<version>/pg_hba.conf
Действующая конфигурация:

Путь к действующим конфигурационным файлам зависит от используемого дистрибутива Linux и версии PostgreSQL.
- РЕД ОС, PostgreSQL 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
Компоненты Визион

Эталонная конфигурация:
- /opt/skala-r/vision/server/default/server/grafana
- /opt/skala-r/vision/server/default/server/snmp_notifier/web.yml
- /opt/skala-r/vision/server/default/server/victorialogs/
- /opt/skala-r/vision/server/default/server/vision_core
- /opt/skala-r/vision/server/default/server/vision_taskdaemon
- /opt/skala-r/vision/server/default/server/vision_utilizer/config.yml
Действующая конфигурация:
- /opt/skala-r/etc/vision/server/grafana
- /opt/skala-r/etc/vision/server/snmp_notifier/web.yml
- /opt/skala-r/etc/vision/server/victorialogs/
- /opt/skala-r/etc/vision/server/vision_core
- /opt/skala-r/etc/vision/server/vision_taskdaemon
- /opt/skala-r/etc/vision/server/vision_utilizer/config.yml

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

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

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

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

Примечание

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

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

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

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