Настройка NLS

Локальный, выделенный и публичный NLS

bg-dots
bg-dots

Общие сведения

Статья описывает настройку сетевого лицензирования (NLS) на сервере Vinteo.

  • КССЛ — корневой сервер сетевого лицензирования;
  • ССЛ — сетевой сервер лицензирования;
  • КСЛ — клиент сетевого лицензирования.

Локальный NLS — схема, при которой на том же хосте, что и сервер Vinteo, работают КСЛ и ССЛ.

Заметка:

Используется для одиночного сервера ВКС и для каскадирования.

Выделенный NLS — схема, при которой ССЛ устанавливается на отдельный хост в контуре заказчика, а КСЛ на серверах Vinteo подключаются к этому ССЛ по сети.

Заметка:

Используется при резервировании и когда на площадке несколько отдельностоящих серверов ВКС.

Схему и способ регистрации ССЛ необходимо согласовать с технической поддержкой (support@vinteo.ru) до начала работ.

Порядок настройки:

  1. Локальный NLS — ССЛ уже установлен вместе с сервером ВКС → Регистрация ССЛ → Регистрация КСЛ.
  2. Выделенный NLS — Выделенный ССЛ (установка и конфигурация) → Регистрация ССЛ на хосте ССЛ → Регистрация КСЛ на каждом сервере ВКС.
  3. Публичный NLS — Публичный NLS (ССЛ в контуре заказчика не разворачивается).

Библиотека GOST

Библиотека libengine-gost-openssl (или libgost-astra) нужна как зависимость пакета ССЛ. Она устанавливается до установки пакета ССЛ. Страница пакета: libengine-gost-openssl.

curl -LO http://ftp.ru.debian.org/debian/pool/main/libe/libengine-gost-openssl/libengine-gost-openssl_3.0.1-2+b1_amd64.deb
apt install -y ./libengine-gost-openssl_3.0.1-2+b1_amd64.deb

Та же библиотека устанавливается на хостах, где для связи с ССЛ выбирается шифрование GOST.

Выделенный ССЛ

Раздел нужен только для выделенного NLS. Для локального NLS переходите к Регистрации ССЛ.

После установки и конфигурации на хосте ССЛ выполните Регистрацию ССЛ, затем на серверах ВКС — Регистрацию КСЛ.

Установка

Дистрибутив ССЛ необходимо получить у технической поддержки (support@vinteo.ru). ССЛ поставляется пакетами nls-server-net и nls-server-hasp. На хосте устанавливается один вариант — пакеты конфликтуют. Клиент на сервере ВКС — той же линейки: nls-client-net или nls-client-hasp.

Внимание!
Если ССЛ разворачивается не на физическом хосте, а на виртуальной машине, используется пакет nls-server-hasp (и клиент nls-client-hasp). Вариант nls-server-net — для физического хоста, когда техническая поддержка не выдаёт ключ HASP.

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

apt update && apt upgrade -y
apt install -y wget curl gnupg lsb-release

Шаг 2. Установите PostgreSQL и убедитесь, что кластер принимает подключения. Без работающего PostgreSQL установка пакета ССЛ не завершится:

apt install -y postgresql postgresql-contrib
pg_lsclusters
pg_isready

Если кластер в состоянии down, а в журнале отсутствует каталог conf.d, создайте его и запустите кластер (номер версии замените на свой, например 17):

mkdir -p /etc/postgresql/17/main/conf.d
chown postgres:postgres /etc/postgresql/17/main/conf.d
systemctl start postgresql@17-main
pg_isready

Шаг 3. Установите библиотеку GOST — см. Библиотека GOST.

Шаг 4. Установите согласованный пакет ССЛ (имя файла уточните у поддержки):

apt install ./nls-server-net_<версия>_amd64.deb

При ошибках зависимостей:

apt install -f

Если настройка пакета прервалась из‑за PostgreSQL, после запуска кластера выполните:

dpkg --configure -a

Шаг 5. Проверьте наличие файлов:

ls -la /usr/bin/network_license_server
ls -la /etc/vcs/nls/
ls -la /lib/systemd/system/nls-server.service

Шаг 6. Не запускайте службу ССЛ до завершения Регистрации ССЛ. Пока нет файла /etc/vcs/nls/nls-last.conf, попытка systemctl start nls-server может завершиться по таймауту: при старте служба снова входит в режим регистрации. После появления nls-last.conf:

systemctl enable nls-server
systemctl start nls-server
systemctl status nls-server

На каждом сервере ВКС, который будет брать лицензии с этого ССЛ, локальный nls-server останавливается и отключается из автозагрузки, если он не нужен другим ролям:

systemctl stop nls-server && systemctl disable nls-server

Конфигурация ССЛ для удалённых клиентов

Файл /etc/vcs/nls/nls.conf на выделенном хосте. После установки часто заданы LOCAL 1 и BIND_IP 127.0.0.1 — для выделенного ССЛ их необходимо изменить. Пути, регистрацию и параметры БД без необходимости изменять не следует.

Чтобы ССЛ принимал подключения КСЛ с серверов ВКС по сети:

LOCAL 0
BIND_IP 0.0.0.0

Если указано BIND_IP 127.0.0.1, строку закомментируйте или замените на 0.0.0.0.

После изменения nls.conf перезапустите nls-server в согласованное окно работ (если служба уже запущена после регистрации).

Сервер ВКС должен иметь доступ к порту лицензирования ССЛ (PORT_TCP_IN; типовой — 4000). Порт HTTPS веб-панели для client -reg не используется.

Веб-интерфейс ССЛ (по необходимости)

Панель поставляется пакетом nls-dashboard (версия согласуется с поддержкой). Пакет размещает файлы в /var/www/html/nls/dashboard, устанавливает Nginx и добавляет сайт /etc/nginx/conf.d/nls.conf (по умолчанию HTTPS на порту 8443, сертификаты из /etc/vcs/nls/crt/).

apt install ./nls-dashboard_<версия>_amd64.deb
nginx -t
systemctl enable --now nginx
systemctl reload nginx
test -f /var/www/html/nls/dashboard/index.html

В каталоге панели должен быть index.html без лишней вложенности …/dashboard/dist/….

Для панели через Nginx в nls.conf задаются HTTP API и WebSocket (TLS завершается на Nginx):

PORT_HTTP 5000
PORT_WS 7000
USE_HTTPS 0

В файле /etc/nginx/conf.d/nls.conf upstream API обычно 127.0.0.1:5000, WebSocket — часто 127.0.0.1:7001 (location /ws/notifications). Порт upstream должен совпадать с PORT_WS в nls.conf (типовой PORT_WS — 7000). При расхождении правьте Nginx или PORT_WS, затем nginx -t и systemctl reload nginx.

При необходимости порт 8443 заменяется на 443. Перед сменой проверяется занятость порта и другие сайты в /etc/nginx/sites-enabled/ и /etc/nginx/conf.d/.

Изменение только Nginx не требует перезапуска nls-server; смена USE_HTTPS или портов в nls.conf — требует.

Вход: https://<DNS-имя-или-IP-ССЛ>:8443/ (или без :8443, если слушается 443). Пользователь панели — su. Пароль на этом же хосте: network_license_server -su (вывод не сохраняется в тикетах и скриншотах).

В панели подтверждается запрос регистрации сервера ВКС и назначаются лицензии. Код 200 на HTML означает только загрузку страницы; работоспособность проверяется по /api и WebSocket. См. Диагностика.

Регистрация ССЛ

Регистрация ССЛ общая для локального и выделенного NLS. Команды выполняются на хосте, где работает ССЛ:

  • локальный NLS — на сервере ВКС;
  • выделенный NLS — на хосте ССЛ после установки.

Онлайн-регистрация

Перед запуском убедитесь, что с хоста ССЛ есть сетевой доступ к КССЛ по адресу 31.128.48.15 (порт согласуйте с технической поддержкой).

Шаг 1. Запустите сервер сетевого лицензирования в режиме регистрации:

network_license_server -nls -reg

Шаг 2. Сообщите в техническую поддержку (support@vinteo.ru), что запрос на регистрацию отправлен.

Шаг 3. После подтверждения на КССЛ запустите службу и включите автозагрузку:

systemctl start nls-server && systemctl enable nls-server

Офлайн-регистрация

Офлайн-регистрация выполняется в закрытом контуре (без обращения ССЛ к КССЛ) и только по согласованию с технической поддержкой (support@vinteo.ru) до начала работ.

Внимание!
При использовании виртуализации офлайн-регистрация выполняется только через HASP.

Шаг 1. Запустите сервер сетевого лицензирования в режиме офлайн-регистрации:

network_license_server -nls --reg

Откроется меню действий:

  • 1) Create NLS registration file — создать файл заявки на регистрацию для передачи на КССЛ;
  • 2) Registering NLS by file — зарегистрировать ССЛ по файлу, полученному от КССЛ;
  • 3) Loading licenses from file — загрузить пул лицензий из файла;
  • 4) Exit — выйти из меню.

Шаг 2. Выберите 1) и укажите путь для сохранения файла заявки (по умолчанию — nls-registration-request.data в домашнем каталоге текущего пользователя) либо подтвердите значение по умолчанию клавишей Enter:

После успешного создания файла мастер сообщает об этом и возвращает в меню:

Файл заявки необходимо передать в техническую поддержку (support@vinteo.ru) для оформления регистрации на КССЛ.

Шаг 3. Когда от поддержки получен файл регистрации, выберите 2) и укажите путь к этому файлу:

Шаг 4. При необходимости загрузите лицензии пунктом 3) Loading licenses from file, затем выйдите из меню (4) Exit).

Шаг 5. Запустите службу ССЛ и включите автозагрузку:

systemctl start nls-server && systemctl enable nls-server

После регистрации ССЛ зарегистрируйте КСЛ — см. Регистрация КСЛ.

Регистрация КСЛ

Регистрация КСЛ выполняется командой client -reg на сервере ВКС. Процесс одинаков для локального, выделенного и публичного NLS — отличаются только значения параметров мастера.

Внимание!
Публичный NLS (nls.vinteo.com) предназначен только для тестовых установок и пилотных проектов. Для рабочей эксплуатации используйте локальный или выделенный NLS.

Перед запуском мастера:

  • локальный NLS — ССЛ на этом же хосте уже зарегистрирован;
  • выделенный NLS — на хосте ВКС остановлен локальный nls-server (см. Установка); DNS-имя выделенного ССЛ разрешается с сервера ВКС;
  • публичный NLS — локальный nls-server остановлен и отключён из автозагрузки; с сервера ВКС доступен nls.vinteo.com по TCP 4000.
# выделенный и публичный NLS — если локальный nls-server ещё запущен:
systemctl stop nls-server && systemctl disable nls-server

Шаг 1. Запустите мастер:

client -reg

Шаг 2. Укажите параметры по выбранной схеме. Порт HTTPS веб-панели ССЛ не используется.

Параметр Локальный NLS Выделенный NLS Публичный NLS
Enter the type of keys to encrypt 2 (Diffie–Hellman) или 1 (GOST) 2 (Diffie–Hellman) или 1 (GOST) 1 (GOST)
Enter Network License Server address 127.0.0.1 IP-адрес или DNS-имя выделенного ССЛ nls.vinteo.com
Enter Network License Server port 4000 4000 4000
Enter a description of your server понятное имя сервера ВКС для опознания запроса поддержкой понятное имя сервера ВКС для опознания запроса поддержкой понятное имя сервера ВКС для опознания запроса поддержкой

Порт по умолчанию — 4000.

Шаг 3. Запустите КСЛ и включите автозагрузку:

systemctl start nls-client && systemctl enable nls-client

В /etc/vcs/nls-client/default.conf должны совпадать адрес и порт из таблицы (не порт HTTPS панели).

Для выделенного NLS: если на ССЛ опубликована веб-панель, после отправки запроса подтвердите регистрацию сервера ВКС в панели и назначьте лицензии.

Для публичного NLS: после отправки запроса клиент остаётся на этапе “Connected to the server” — ожидаемое состояние до подтверждения. Сообщите в техническую поддержку (support@vinteo.ru) имя хоста из мастера. После назначения лицензий перезапустите КСЛ:

systemctl restart nls-client

Проверка — в разделе Диагностика.

Публичный NLS

Для публичного NLS ССЛ в контуре заказчика не разворачивается: регистрируется только КСЛ. Параметры мастера — в колонке Публичный NLS таблицы выше; после отправки запроса клиент остаётся на этапе “Connected to the server” до подтверждения технической поддержкой. Проверки — в Диагностике публичного NLS.

Диагностика

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

Службы и версия

systemctl status nls-server
systemctl status nls-client
network_license_server --version
  • Локальный NLS — на одном хосте проверяются и nls-server, и nls-client.
  • Выделенный NLS — nls-server на хосте ССЛ; nls-client на сервере ВКС (локальный nls-server на ВКС обычно остановлен).
  • Публичный NLS — на сервере ВКС проверяется nls-client; локальный nls-server должен быть остановлен.

Дополнительно на выделенном ССЛ:

systemctl is-active nginx nls-server

Конфигурация

cat /etc/vcs/nls/nls.conf
cat /etc/vcs/nls-client/default.conf

В /etc/vcs/nls-client/default.conf адрес и порт должны соответствовать схеме:

Схема Адрес ССЛ / NLS Порт
Локальный 127.0.0.1 4000
Выделенный IP или DNS выделенного ССЛ 4000
Публичный nls.vinteo.com 4000

Для выделенного ССЛ в /etc/vcs/nls/nls.conf проверяются LOCAL 0 и внешняя привязка (BIND_IP 0.0.0.0 или отсутствие BIND_IP 127.0.0.1). Порт HTTPS панели в конфигурации КСЛ не указывается.

Журналы

journalctl -u nls-server -e
journalctl -u nls-client -e

Состояние подключения и доступные лицензии также отображаются в веб-интерфейсе сервера ВКС: Система → Лицензии.

Веб-панель выделенного ССЛ

Если панель опубликована:

nginx -t
test -f /var/www/html/nls/dashboard/index.html

Просматривается /var/log/nginx/nls.error.log (секреты перед передачей удаляются).

Типовые признаки сбоев:

  • удалённый ВКС не подключается — LOCAL, BIND_IP, PORT_TCP_IN, DNS и сетевые правила;
  • 502 на /api — состояние nls-server и соответствие порта и протокола upstream;
  • страница есть, данные не обновляются — WebSocket /ws/notifications, заголовки Upgrade/Connection;
  • HTML открывается с кодом 200, но это не подтверждает выдачу лицензий — проверяются /api и WebSocket.

Диагностика публичного NLS

При ошибках подключения проверяется доступность nls.vinteo.com:4000 с сервера ВКС и журналы nls-client. До подтверждения регистрации ТП состояние “Connected to the server” у клиента — ожидаемое.

Установка на открытый дистрибутив Сертификат HTTPS