Перейти к основному содержимому
Версия: 6.1

Установка

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

Требования​

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

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

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

  • исполняемый файл smrtc-server
  • шаблоны конфигурации (каталоги config/, services/, certs/)
  • unit systemd для сервиса smrtc

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

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, состояние кластера, активные списки, сработки
/app/smrtc/content/контент-паки, импортируемые при старте (soc-baseline.zip при первой установке)
/etc/systemd/system/smrtc.serviceunit systemd

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