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

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

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

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

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

2. Деинсталлировать все агенты и прокси во вкладке Агенты. У всех элементов должен быть статус Не установлен.

3. Деинсталлировать все элементы во вкладке Плагины.

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

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

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

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

1. В директории дистрибутива выполнить команду:

   • Для установки пакетов зависимостей из дистрибутива:

     ./setup.sh -p
     

   • Для установки пакетов зависимостей из репозиториев ОС:

     ./setup-sh -g
     

• Для ОС РЕДОС 8 и Альт СП р10 (c10f2) будет предложено установить Postgres Pro. Подробности см. в разделе Обновление PostgreSQL .

1. Запустить обновление сервера Визиона:

   ./setup.sh -u
   

   Начнется процесс обновления.

2. После успешного обновления запустить скрипт:

   ./setup.sh
   

3. Выбрать опцию Проверка работы сервисов.

   Критерием корректности развертывания является значение active для всех сервисов, приведенных в таблице в выводе скрипта.

4. Убедиться, что в веб-интерфейсе Визиона в разделе Настройки в пункте О программе указана необходимая версия Визиона.

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

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

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

2. Из директории дистрибутива запустите скрипт:

   ./setup.sh
   

3. Выберите опцию Установка plagent.

4. Выберите сформированный инвентори-файл.

5. Отредактируйте инвентори-файл, указав значения ключей 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 во время процедуры обновления.

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

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

1. Запустите скрипт от имени пользователя root:

   /opt/skala-r/vision/tools/update_server_configs.sh
   

2. Перезапустите сервисы NGINX, PostgreSQL, VictoriaLogs если для них тоже менялась конфигурация.

Для сверки конфигураций используйте утилиту 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 — вывод только левой колонки общих строк.

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

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

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

PostgreSQL#

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

• RedOS, PostgresSQL 12

  • /var/lib/pgsql/data

  • /var/lib/pgsql/data/postgresql.conf

  • /var/lib/pgsql/data/pg_hba.conf

• RedOS, PostgreSQL 16

  • /var/lib/pgsql/16/data

  • /var/lib/pgsql/16/data/postgresql.conf

  • /var/lib/pgsql/16/data/pg_hba.conf

• RedOS, 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:

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

vision_core#

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

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

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

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

VictoriaLogs#

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

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

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

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

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

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

• SMTP-шлюз: в интерфейсе Визиона в разделе “Настройки SMTP”.

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

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

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

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

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

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