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

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

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

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

  • бэкап конфигурации;
  • обновление компонентов Визиона;
  • копирование эталонной конфигурации (также и в режиме чистой установки);
  • обновление файлов конфигурации 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

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

  3. Запустить установку сервера Визиона:

    ./setup.sh -u

    Будет запущен процесс обновления.

  4. После успешного обновления запустить скрипт ./setup.sh и выбрать опцию Проверка работы сервисов.

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

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

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

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

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

  • RedOS, PostgreSQL 12:

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

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

  • RedOS, PostgreSQL 16:

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

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

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

  1. Запустить скрипт из дистрибутива /opt/skala-r/vision/tools/update_server_configs.sh.

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

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

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

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

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

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

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

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

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