Установка

Статья описывает установку коррелятора с помощью инсталлятора.

Требования

• Linux x86_64
• systemd (systemctl, journalctl)
• Утилиты openssl, curl и hostname в PATH. В дистрибутивах семейства RHEL (RHEL, CentOS, Alma, Rocky, UBI) пакет hostname устанавливается отдельно и по умолчанию отсутствует — установите его явно, например dnf install hostname
• Права root (sudo), если не используется режим без root (см. Шаги установки)
• Свободные порты: 9919 (публичный API и прием событий) и 9910 (межнодовый обмен)

Состав дистрибутива

Архив дистрибутива содержит:

Элемент	Назначение
setup.sh	единственная точка входа: install, update, uninstall либо меню при запуске без аргументов
source/smrtc-server	исполняемый файл коррелятора (linux/amd64)
config/smrtc.yml.sample	шаблон, из которого формируется конфигурация ноды
services/smrtc.service.sample	шаблон unit systemd
certs/ca-cert-req.sample	конфигурация запроса openssl для удостоверяющего центра кластера
certs/node-cert-req.sample	конфигурация запроса openssl для сертификата ноды: OU равен имени кластера, список SAN
smrtc-install.yaml.example	пример файла ответов для неинтерактивной установки
README-INSTALL.md	краткая инструкция по установке

Во время работы инсталлятора рядом с setup.sh появляется каталог staging/: в нем лежат сформированные из шаблонов файлы, сгенерированные сертификаты, а при обновлении — резервные копии прежней конфигурации, keystore и unit systemd.

Запуск инсталлятора

tar -xzf smrtc-linux-installer-<версия>.tar.gz
cd smrtc-linux-installer
sudo bash setup.sh install

Параметры setup.sh:

Параметр	Назначение
-c, --config <yaml>	неинтерактивная установка, обновление или удаление по YAML-файлу ответов
--dry-run	только для uninstall: показывает, что будет удалено, без внесения изменений
-h, --help	вывод справки

Запуск setup.sh без аргументов открывает меню выбора действия (install, update, uninstall). Действие по умолчанию — update, если в системе уже присутствует unit /etc/systemd/system/smrtc.service, и install — если его нет.

Шаги установки

Интерактивная установка проходит через шесть шагов:

1. Каталоги установки — каталог установки (по умолчанию /app/smrtc) и каталог журналов (по умолчанию /app/logs/smrtc). Если на хосте уже обнаружена установка, инсталлятор предлагает ее пути как значения по умолчанию
2. Режим без прав root — необязательный режим без root, а также служебные пользователь и группа (по умолчанию smrtc/smrtc)
3. Настройки кластера — присоединяется ли нода к существующему кластеру, адреса транспорта уже работающих нод, является ли нода метаданных-мастером, и имя кластера. Подробнее о развертывании кластера — в статье Добавление ноды в кластер
4. Локальные учетные данные администратора — пароль встроенного пользователя admin. Запрашивается только при первой установке; присоединяемая нода получает административную учетную запись из кластера
5. Настройки TLS — использовать существующий удостоверяющий центр или сгенерировать новый, а также значения CN, страны, региона, города, организации, внешнего IP-адреса и списка альтернативных имен (SAN) сертификата ноды
6. Подключение к Smart Monitor — адреса, использование TLS, пользователь и пароль. Присоединяемая нода указывает только пароль — остальные значения она получает из кластера

Публичный порт зафиксирован на значении 9919 и на этом шаге не запрашивается. По завершении установки сервис smrtc включается и запускается, а адрес коррелятора регистрируется в Smart Monitor.

Проверка результата

Работоспособность ноды проверяется запросом к /health: эндпоинт сам сообщает готовность ноды, включая состояние control plane, корреляции, активных списков и приема событий (event ingest):

cat /app/smrtc/certs/ca.crt > smrtc-local-ca.crt
curl --cacert smrtc-local-ca.crt https://<host>:9919/health

После успешной установки в интерфейсе Smart Monitor в разделе Настройки появляется группа ПОТОКОВЫЙ КОРРЕЛЯТОР.

Расположение файлов

Путь	Назначение
/app/smrtc/bin/smrtc-server	исполняемый файл коррелятора
/app/smrtc/config/smrtc.yml	конфигурация ноды
/app/smrtc/config/keystore	хранилище секретов (пароль admin и пароль подключения к Smart Monitor)
/app/smrtc/certs/	материал TLS: ca.crt, ca.key, node-cert.pem, node-key.pem
/app/smrtc/data/	данные ноды: метаданные raft, состояние кластера, телеметрия, активные списки, сработки
/etc/systemd/system/smrtc.service	unit systemd

Значения параметров smrtc.yml описаны в статье Конфигурация ноды.

Добавление ноды в кластер

Добавление новой ноды в кластер коррелятора: порядок развертывания, требования к сертификатам и автоматическая установка по файлу ответов.

Обновление и удаление

Обновление установленной ноды коррелятора до новой версии, полное удаление коррелятора с ноды и управление сервисом.