Установка системы через веб-интерфейс (UI-инсталлятор)

В дополнение к установке через файл конфигурации, система 5А предоставляет возможность установки через веб-интерфейс. Мастер установки в пошаговом режиме проведёт администратора через все этапы развёртывания системы.

Распаковка файлов

1. Войдите на сервер развёртывания под подходящей учётной записью пользователя.

2. Загрузите файл дистрибутива системы 5А (например, installator_2.1.2_rc7.tar.gz) или смонтируйте диск с ним.

3. Разархивируйте файл дистрибутива:

   tar -zxf installator_2.1.2_rc7.tar.gz

4. Проверьте, что в директории появились файлы:

   • install.sh — скрипт для установки через командную строку;
   • installer-ui — исполняемый файл для запуска веб-интерфейса мастера установки;
   • repo — директория с компонентами системы;
   • inventory.yml — файл конфигурации (будет заполнен автоматически при работе с мастером).

Запуск мастера установки

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

   ./installer-ui

2. В терминале появится сообщение с адресом для доступа к мастеру установки:

   time=2026-06-11T09:59:46.967+03:00 level=INFO msg=listening component=server addr=:8080
   Wizard UI → http://localhost:8080

3. Откройте указанный адрес в браузере.

   ℹ️

   Если мастер установки запущен на удалённом сервере, используйте его IP-адрес вместо localhost, например http://172.27.2.34:8080.

Работа с мастером установки

Мастер установки состоит из семи последовательных шагов, отображённых в боковом меню:

1. Приветствие
2. SSH доступ
3. Режим
4. Серверы
5. Проверка
6. Установка
7. Готово

Шаг 1. Приветствие

На странице приветствия отображается информация о том, что мастер поможет установить систему «Балансировщик 5А» на ваши серверы.

Перед началом установки убедитесь, что выполнены предварительные условия:

• Целевые серверы доступны по SSH.
• Есть приватный ключ или пароль для подключения.
• Пользователь SSH имеет права sudo.
• На серверах установлен Docker Engine.

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

Нажмите Начать установку для перехода к следующему шагу.

Шаг 2. SSH доступ

На этом шаге выберите способ аутентификации для подключения к целевым серверам.

Способ 1: Приватный ключ

Выберите источник ключа:

• Из ~/.ssh/ — автоматически подхватываются ключи из стандартной директории пользователя.
• Загрузить файл — загрузите файл с приватным ключом через интерфейс.
• Указать путь — вручную укажите путь к файлу приватного ключа.

Заполните поля:

• Ключ — выберите или укажите путь к приватному ключу.
• Пользователь SSH — укажите имя пользователя для подключения (например, root или installer).
• Порт SSH — порт для SSH-подключения (по умолчанию 22, изменение недоступно).

Способ 2: Пароль

Заполните поля:

• Пароль — введите пароль пользователя.
• Пользователь SSH — укажите имя пользователя для подключения.

Нажмите Далее для продолжения.

Шаг 3. Режим установки

Выберите тип установки в зависимости от вашей архитектуры:

• Всё вместе — развёртывание управляющего контура и агентов на указанных серверах. Рекомендуется для тестовых и небольших продуктивных сред.
• Только управляющий контур — установка только компонентов управления (backend, frontend, postgres, orchestrator, monitoring, redis) без агентов. Используется, если агенты будут развёрнуты позже или уже развёрнуты.
• Только агенты — установка только модулей балансировки (агентов) к уже работающему управляющему контуру.

Нажмите Далее для перехода к настройке серверов.

Шаг 4. Настройка серверов

Этот шаг зависит от выбранного режима установки.

Режим «Всё вместе»

Управляющий контур

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

Заполните обязательные поля:

• IP-адрес — адрес сервера для управляющего контура.
• Порт админ-панели — порт, на котором будет доступен веб-интерфейс (по умолчанию 8081).

Учётные данные PostgreSQL

• Пользователь — имя пользователя базы данных.
• Пароль — пароль для доступа к PostgreSQL.

Учётные данные Redis

• Пароль — пароль для доступа к Redis.

Веб-интерфейс (HTTPS) [#wizard-https]

Заполните поля для настройки защищённого доступа к веб-интерфейсу:

• FQDN веб-интерфейса — полное доменное имя, по которому будет доступен веб-интерфейс (например, admin.5a.internal).
• HTTPS-порт — порт для доступа по HTTPS (например, 8443).
• Файл сертификата — имя файла TLS-сертификата (например, web.crt).
• Файл ключа — имя файла приватного ключа TLS-сертификата (например, web.key).

Внутреннее шифрование

Настройте внутреннюю защищённую связь между компонентами системы:

• Файл CA-сертификата — укажите файл CA-сертификата, помещённого в каталог repo/certs/ (например, sub_ca.crt).
• Файл ключа CA — укажите файл приватного ключа CA, помещённого в каталог repo/certs/ (например, sub_ca.key).

Учётные данные администратора

• Логин — логин для первичного пользователя системы 5А (получает права администратора).
• Пароль — пароль для первичного пользователя.

Расширенные настройки (изменяйте только если знаете, что делаете)

При раскрытии раздела доступны для изменения следующие параметры (значения уже проставлены по умолчанию):

• Backend HTTP — порт для HTTP-запросов к бэкенду.
• Backend gRPC — порт для gRPC-запросов к бэкенду.
• PostgreSQL порт — порт для подключения к базе данных.
• Redis порт — порт для подключения к Redis.
• Orch gRPC — порт для gRPC-запросов к оркестратору.
• Grafana порт — порт для доступа к Grafana.
• Prometheus порт — порт для доступа к Prometheus.

Агенты

Над списком агентов расположен выбор Сетевой пресет — способ разделить управление и рабочий трафик на всех машинах установки:

• Одна сеть (combined) — управление и рабочий трафик по одному адресу.
• Две сети (separated) — у рабочего трафика свой адрес, а порты агента и SSH принимаются только со стороны управления. Рекомендуемый вариант.
• Две сети + VRF (isolated) — то же плюс отдельная таблица маршрутизации у рабочего трафика; требуется ядро 5.15 или новее.

Пресет выбирается один на всю установку, кнопка Чем отличаются открывает подробное сравнение. Полное описание — в разделе Разделение управления и рабочего трафика.

Для каждого агента заполните:

• IP управления (management) — адрес, по которому установщик и система обращаются к агенту.
• Data IP — адрес рабочего трафика: балансировка, GSLB, проверки доступности, анонсы маршрутов. В пресете «Две сети + VRF» обязателен; в остальных, если оставить поле пустым, машина будет работать по адресу управления. Адрес должен быть уже поднят на машине — установщик его не назначает.
• Data-интерфейс — интерфейс рабочего трафика. Отображается и обязателен только в пресете «Две сети + VRF».
• Роли — одна или несколько:
  • SLB — L4/L7-балансировка;
  • GSLB — функции GSLB;
  • NET — сетевой агент: интерфейсы, адреса, маршрутизация, правила NAT/Firewall.
• SLB Cluster ID — идентификатор SLB-кластера. Обязателен при роли SLB.
• GSLB Cluster ID — идентификатор GSLB-кластера. Обязателен при роли GSLB. Рядом заполняется блок Redis для GSLB: адрес и пароль базы, которая держит согласованность GSLB-серверов.
• NET Cluster ID — идентификатор кластера для агента, у которого выбрана только роль NET. Если выбраны также SLB или GSLB, поле не отображается: сетевой агент присоединяется к их кластеру.

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

Для добавления дополнительных агентов нажмите Добавить агента.

Расширенные настройки для агентов

При раскрытии раздела доступны опции:

• SNMP — включение SNMP-агента для сбора метрик.
• LLDP — включение демона LLDP для обнаружения соседних устройств.

Подробнее о настройке SNMP и LLDP см. в разделе Подключаемые модули.

Нажмите Далее для перехода к проверке.

Шаг 5. Проверка перед установкой

На этом этапе система выполняет проверку готовности серверов к установке.

Статусы проверок:

• OK — проверка пройдена успешно.
• Предупреждение — проверка прошла с замечаниями (например, недостаточно оперативной памяти). Установка возможна, но могут возникнуть проблемы с производительностью.
• Ошибка (блокер) — критическая проблема, препятствующая установке. Требуется устранение.

Управление проверками:

• Повторить — перезапустить все проверки заново.
• Исправить — при наличии ошибок, которые система может исправить автоматически, появляется кнопка Исправить проблему. После нажатия система выполняет необходимые действия (например, добавляет пользователя в группу docker). После исправления рекомендуется повторно запустить проверки.

Детальный просмотр:

Каждый компонент системы (frontend, backend, postgres, orchestrator, monitoring) можно раскрыть для просмотра деталей проверок.

Пример ошибки, которую система может исправить автоматически:

Docker ошибка
  X Пользователь в группе docker  
  Пользователь на frontend не входит в группу docker.
  Добавьте пользователя в группу:
  sudo usermod -aG docker $USER
  Изменения вступят в силу после переподключения к серверу.

После нажатия Исправить система автоматически выполнит команду.

Если все проверки прошли успешно (или только с предупреждениями), нажмите Далее для перехода к установке.

Шаг 6. Установка

На этом этапе выполняется развёртывание компонентов системы на целевых серверах. Ход установки отображается в реальном времени.

При возникновении ошибок в процессе установки:

• Ошибки выводятся в консоли, где был запущен installer-ui.
• В интерфейсе мастера отображается статус каждого компонента.
• В случае критической ошибки установка останавливается. Рекомендуется проанализировать лог ошибок, устранить проблему и запустить установку заново.

Пример ошибки в процессе установки:

Мониторинг (monitoring) 
  Grafana
    Установка Grafana
    Конфигурация Grafana  изменено
    Директория данных Grafana  изменено
    Проверка наличия образа Grafana
    Загрузка образа Grafana  ошибка
    failed to transfer file: no space left on device

При успешном завершении установки система автоматически переходит к финальному шагу.

Шаг 7. Готово

Установка завершена. На экране отображается:

• Сообщение «Система успешно установлена».
• Ссылка для доступа к системе: http://<IP_адрес_фронтенда>:<порт>
• Учётные данные администратора (логин и пароль, которые были указаны на шаге настройки серверов) — доступны для копирования.

Рекомендации после установки:

1. Добавьте лицензию в центре лицензирования.
2. Создайте пользователей и настройте права доступа.
3. Проверьте работоспособность компонентов в разделе «Состояние системы».
4. Настройте конфигурации балансировки трафика.

Подробнее см. раздел Дальнейшие шаги.

Решение проблем при установке

Ошибка аутентификации по SSH

Если при проверке SSH-доступа появляется ошибка:

• Убедитесь, что на целевом сервере добавлен ваш публичный SSH-ключ.
• Проверьте правильность имени пользователя.
• Убедитесь, что целевой сервер доступен по сети.

Подробнее см. Настройка SSH-ключей.

Ошибка «Пользователь не в группе docker»

Система предлагает автоматическое исправление. Нажмите Исправить. Если автоматическое исправление недоступно, выполните вручную на целевом сервере:

sudo usermod -aG docker $USER

Изменения вступят в силу после переподключения к серверу.

Неподдерживаемая операционная система

Если система определяет, что ОС не входит в список поддерживаемых, установка возможна, но не гарантируется стабильная работа. Рекомендуется использовать одну из поддерживаемых ОС:

• Debian 12
• Ubuntu Server 24.04 LTS
• Astra Linux Common Edition (Орел) 2.12
• Astra Linux Special Edition 1.8
• Альт Сервер 11
• CentOS Stream 9
• RedOS 7.3 / 8.0

Недостаточно свободного места

Если в процессе установки возникает ошибка «no space left on device»:

• Освободите место на целевом сервере.
• Удалите неиспользуемые файлы, логи, старые образы Docker.
• При необходимости увеличьте размер диска.

Другие ошибки

Все ошибки, возникающие в процессе установки, дублируются в консоль, где был запущен installer-ui. Для анализа:

1. Просмотрите вывод в консоли.
2. Найдите компонент, на котором произошла ошибка.
3. Устраните причину (например, недостаток прав, отсутствие пакетов, проблемы с сетью).
4. Нажмите Повторить на шаге проверки или перезапустите мастер установки.

Следующие шаги

После успешной установки через UI-инсталлятор выполните действия, описанные в разделе Дальнейшие шаги:

• Добавление и активация лицензии
• Создание пользователей и настройка прав
• Проверка состояния системы
• Настройка конфигураций балансировки