Общие сведения
Статья описывает настройку сетевого лицензирования (NLS) на сервере Vinteo.
- КССЛ — корневой сервер сетевого лицензирования;
- ССЛ — сетевой сервер лицензирования;
- КСЛ — клиент сетевого лицензирования.
Локальный NLS — схема, при которой на том же хосте, что и сервер Vinteo, работают КСЛ и ССЛ.
Используется для одиночного сервера ВКС и для каскадирования.
Выделенный NLS — схема, при которой ССЛ устанавливается на отдельный хост в контуре заказчика, а КСЛ на серверах Vinteo подключаются к этому ССЛ по сети.
Используется при резервировании и когда на площадке несколько отдельностоящих серверов ВКС.
Схему и способ регистрации ССЛ необходимо согласовать с технической поддержкой (support@vinteo.ru) до начала работ.
Порядок настройки:
- Локальный NLS — ССЛ уже установлен вместе с сервером ВКС → Регистрация ССЛ → Регистрация КСЛ.
- Выделенный NLS — Выделенный ССЛ (установка и конфигурация) → Регистрация ССЛ на хосте ССЛ → Регистрация КСЛ на каждом сервере ВКС.
- Публичный 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) до начала работ.
Шаг 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 — на хосте ВКС остановлен локальный
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” у клиента — ожидаемое.