Статья описывает установку Vinteo Server 40 на поддерживаемый открытый дистрибутив Linux с помощью самораспаковывающегося установочного файла .run.
.run. Для Astra Linux Special Edition обычно используют выпуск 1.8.4. Другой выпуск линейки 1.8 — только если поддержка подтвердила совместимость. В примерах команд имя файла записано как srv-<версия>.run.
Поддерживаемые ОС
Основные целевые ОС:
- Debian 13;
- Astra Linux Special Edition 1.8 — предпочтительно 1.8.4.
Основной способ установки — файл
.run. Он запускает установщик Vinteo, который настраивает источники пакетов и устанавливает выбранные компоненты.
Для сервера без доступа в интернет используется тот же файл с параметром install --no-change-apt и заранее подготовленным локальным зеркалом ОС. Параметр --no-change-apt сохраняет системные источники APT.
Что подготовить
До запуска установщика необходимо обеспечить:
- установленную и обновлённую поддерживаемую ОС;
- административный доступ
rootили эквивалентный доступ черезsudo; - корректные IP-параметры, DNS и синхронизацию времени;
- доступ к репозиториям выбранной ОС либо к полному локальному зеркалу;
- свободное место для загрузки пакетов и установки компонентов;
- установочный файл Vinteo Server требуемой версии;
- согласованную схему лицензирования (см. Выбор схемы лицензирования);
- на серверах с видеокартой NVIDIA — пакеты заголовков ядра до запуска
.run(раздел ниже).
Перед началом проверьте состояние ОС:
cat /etc/os-release
uname -r
ip -br address
timedatectl status
apt-get update
apt-get check
df -hКоманды apt-get update и apt-get check должны завершаться без ошибок. Если сервер использует локальное зеркало, в выводе не должно быть обращений к недоступным публичным адресам.
Заголовки ядра для GPU-серверов
Раздел нужен только если на сервере есть видеокарта NVIDIA.
Драйвер NVIDIA собирается под текущее ядро Linux. Для сборки системе нужны пакеты заголовков ядра (linux-headers). Если их нет:
- пакеты драйвера могут установиться;
- модуль ядра при этом не соберётся;
- после перезагрузки видеокарта не заработает.
В логе установщика часто бывает строка:
WARNING: No kernel headers were found, skipping module build.
Команда dkms status в таком случае обычно показывает статус added, а нужен installed. Повторная перезагрузка сама по себе проблему не решает — сначала ставят заголовки и повторяют сборку.
На Debian 13 (amd64) выполните от root до запуска .run:
apt update
apt install "linux-headers-$(uname -r)" linux-headers-amd64"linux-headers-$(uname -r)"— заголовки для ядра, которое работает сейчас;linux-headers-amd64— чтобы заголовки были и после обновления ядра Debian.
Перед согласием на установку пакетов посмотрите список изменений APT: вместе с headers может установиться новое ядро. Если сервер без интернета, эти пакеты должны быть в локальном зеркале.
На Astra Linux поставьте заголовки из репозитория ОС, который согласовали с поддержкой, для нужного ядра. Команду Debian с linux-headers-amd64 на Astra копировать нельзя — набор пакетов другой.
После установки заголовков сразу перезагружать сервер не нужно. Перезагрузку делают в конце, если этого требует раздел Перезагрузка.
Дисковое пространство
Свободное место нужно на всём пути установки: файл .run, временная распаковка, копия репозитория пакетов Vinteo, сами компоненты и данные ОС. Смотрите каждый раздел (том), который участвует, а не только общий размер диска.
Цифры 2 / 4 / 10 / 32 GiB в таблице — ориентир для планирования. Это не жёсткий минимум «для всех серверов». Если файл .run уже лежит на диске, отдельно «бросать» под него ещё столько же свободного места не нужно.
| Каталог / файловая система | Предварительный запас | Назначение |
|---|---|---|
Каталог с файлом .run |
размер файла (ориентир — 2 GiB) | установочный файл |
/tmp или выбранный TMPDIR |
4 GiB | распаковка комплекта |
/srv (/srv/vcs/repository) |
4 GiB дополнительно | постоянная копия репозитория пакетов |
/usr (в т.ч. /usr/vserver) |
10 GiB | исполняемые файлы и зависимости |
/var (в т.ч. /var/www) |
10 GiB | данные служб, кэш и индексы APT |
/boot, если выделен отдельно |
2 GiB | только если обновляется ядро |
/user-dir и каталоги записей |
индивидуально | конфигурация, записи, медиаданные |
Если /usr, /var, /srv и временный каталог на одном разделе, заложите около 32 GiB свободно до скачивания .run (без записей конференций и прочих пользовательских данных). На этом же разделе должна уместиться уже установленная ОС.
При обновлении установщик может какое-то время хранить и старый репозиторий /srv/vcs/repository, и новый repository.new. На /srv должно хватить места на оба набора файлов сразу.
/home или на диске записей не помогает, если заполнены /var или /usr. Если каталоги на разных разделах — запас считают по каждому разделу отдельно.
Перед запуском проверьте место и то, на каком разделе лежит каждый путь:
df -hT . / /usr /var /srv /tmp /boot
df -i . / /usr /var /srv /tmp /boot
findmnt -T /usr
findmnt -T /var
findmnt -T /srv
findmnt -T /tmp
findmnt -T /var/www
findmnt -T /var/lib/asterisk
findmnt -T /usr/vserverЕсли каталога ещё нет, проверьте его родителя. Команда df -i показывает свободные inode: место в гигабайтах может остаться, а создавать файлы уже будет нельзя.
Если в /tmp мало места или это tmpfs (память), создайте каталог на диске и укажите его при запуске:
install -d -m 0700 /srv/vinteo-install-tmp
df -hT /srv/vinteo-install-tmp
df -i /srv/vinteo-install-tmp
findmnt -T /srv/vinteo-install-tmp
TMPDIR=/srv/vinteo-install-tmp ./srv-<версия>.runЕсли и временный каталог, и репозиторий лежат на одном /srv, нужно примерно 8 GiB свободно (4 GiB на распаковку + 4 GiB на новую копию репозитория). При обновлении сверху остаётся занятое место старой копией репозитория.
Получение установщика
Установочные файлы предоставляются только через техническую поддержку: support@vinteo.ru. Необходимо использовать файл, указанный для конкретной установки или обновления.
Если браузер сохранил архив с расширением .gz, переименуйте его обратно в .run:
mv srv-<версия>.gz srv-<версия>.run
chmod +x ./srv-<версия>.runУстановка с доступом к репозиториям ОС
Шаг 1. Запустите установщик от root:
./srv-<версия>.runШаг 2. В интерактивном режиме выберите продукт и схему лицензирования. Для промышленной установки обычно выбирается сетевое лицензирование net (NLS) с последующей настройкой локального или выделенного NLS. Схемы Static / Dynamic указывайте только если так определила техническая поддержка. Прямое подключение клиента к nls.vinteo.com для промышленной эксплуатации не рекомендуется.
Шаг 3. Перед подтверждением транзакции APT просмотрите список устанавливаемых, обновляемых и удаляемых пакетов. Убедитесь, что зависимости ОС загружаются из ожидаемых репозиториев, а пакеты Vinteo — из репозитория установочного файла.
Шаг 4. Подтвердите установку и дождитесь завершения без ошибок.
На сервере с NVIDIA до перезагрузки проверьте сборку драйвера:
dkms status
uname -rВ выводе у NVIDIA должен быть статус installed для того ядра, с которым сервер загрузится после перезагрузки. Статусы added и built означают, что модуль ещё не готов к работе. Если ядро не меняли — сравнивайте с uname -r. Если APT ставил новое ядро — смотрите строку для этого нового ядра.
Установка без доступа в интернет
В закрытой сети заранее настройте локальное зеркало совместимого выпуска Debian и проверьте apt-get update. В зеркале должны быть и заголовки ядра для GPU-сборки, если сервер с NVIDIA.
Запустите установщик с сохранением системной конфигурации APT:
./srv-<версия>.run -- install --no-change-aptПервый -- отделяет параметры самораспаковывающегося архива: всё после него передаётся установщику Vinteo.
--no-change-apt в стандартном режиме authoritative установщик перезаписывает /etc/apt/sources.list и очищает каталог /etc/apt/sources.list.d/, после чего создаёт источники из своего профиля. Это затрагивает и добавленные администратором файлы .list и .sources. Перенос настроек локального зеркала из sources.list в sources.list.d сам по себе не защищает их от удаления.
С параметром --no-change-apt установщик сохраняет /etc/apt/sources.list и сторонние файлы в /etc/apt/sources.list.d/, а собственный источник Vinteo записывает в /etc/apt/sources.list.d/vinteo.list. Не используйте имя vinteo.list для настроек зеркала ОС. Указывайте параметр как при первой установке, так и при последующих обновлениях, если нужно сохранить свои источники пакетов.
Перед запуском сохраните резервную копию /etc/apt/, настройте доступное зеркало совместимого выпуска ОС со всеми необходимыми зависимостями и отключите недоступные публичные источники во всех файлах APT. Проверьте, что apt-get update и apt-get check завершаются без ошибок и обращений к недоступным адресам.
Параметр не отключает apt-get update, установку зависимостей и обновление уже установленных пакетов ОС и Vinteo при обновлении работающей системы. Он также не отключает ранее настроенные публичные источники и не восстанавливает настройки, заменённые предыдущим запуском без параметра: перед повторным запуском восстановите нужные источники и проверьте APT.
Перезагрузка
Перезагрузка требуется, если установщик сообщил о ней либо были установлены или обновлены:
- ядро ОС;
- драйвер NVIDIA или DKMS-модуль;
- системные библиотеки, для которых необходим перезапуск ОС.
Если ничего из этого не менялось, перезагрузка только из‑за установки Vinteo не обязательна.
Не перезагружайте сервер «чтобы дособрать драйвер», если заголовки ядра ещё не стояли: сначала headers, затем установка, проверка dkms status (installed), и только потом — перезагрузка по правилам этого раздела.
После перезагрузки проверьте:
uname -r
ip -br address
dpkg --audit
apt-get check
systemctl --failedНа GPU-сервере дополнительно убедитесь, что nvidia-smi видит все установленные GPU.
Настройка лицензирования
После установки настройте схему в порядке предпочтения:
- Локальный NLS — клиент и ССЛ на хосте ВКС, ССЛ к Root NLS;
- Выделенный NLS — клиент к ССЛ в контуре заказчика, ССЛ к Root NLS;
- Закрытый контур — ССЛ в контуре без Root NLS;
- Static или Dynamic — без NLS.
Обзор схем: Выбор схемы лицензирования.
Только для теста или пилота: Публичный NLS (nls.vinteo.com без локального ССЛ).
Состав лицензий и подтверждение регистрации выполняет техническая поддержка (support@vinteo.ru).
Первый вход в веб-интерфейс
В поставках с первоначальной инициализацией администратора реквизиты первого входа записываются в файл /root/vinteo-bootstrap-admin. Пользователь веб-интерфейса — admin.
Откройте веб-интерфейс по HTTPS, войдите под admin с временным паролем из файла и задайте постоянный пароль. Затем выйдите и проверьте повторный вход.
По умолчанию может использоваться самоподписанный сертификат — браузер покажет предупреждение. Замена на сертификат доверенного УЦ выполняется через файлы Nginx: Сертификат HTTPS.
Перевыпуск временного пароля
Нужен, если временный пароль уже израсходован или сессию потеряли до смены пароля, а постоянный пароль ещё не задавали.
Условия: установка пакетов уже закончилась, база данных отвечает. Сначала убедитесь, что на сервере есть файлы из команд ниже. Если файлов нет — напишите в support@vinteo.ru, не подбирайте обходные команды самостоятельно.
set -a
. /etc/vcs/db.env
set +a
/usr/bin/php /usr/lib/server-db/bootstrap-admin.php --reissue
cat /root/vinteo-bootstrap-adminФайл содержит пароль. Не включайте его содержимое в заявки, журналы работ или снимки экрана.
Bootstrap credential is not in recoverable state обратитесь в техническую поддержку. Если установка оборвалась из-за нехватки места, сначала устраните эту проблему.
Проверка результата
Для сервера с NVIDIA удобный порядок действий:
- поставить заголовки ядра;
- запустить установщик
.run; - убедиться, что
dkms statusпоказывает installed; - перезагрузить сервер, если это требуется;
- проверить, что
nvidia-smiвидит все видеокарты.
dpkg --audit
apt-get check
systemctl --failed
vinteostat -aДля сервера с GPU дополнительно:
dkms status
nvidia-smiКритерии успешной установки:
dpkg --auditне выводит незавершённо настроенные пакеты;apt-get checkзавершается без ошибок зависимостей;- основные службы Vinteo активны;
vinteostat -aпоказывает ожидаемую версию и лицензии;- веб-интерфейс доступен по HTTPS;
- тестовая конференция создаётся, аудио- и видеотрафик проходят;
- на сервере с NVIDIA: в
dkms statusу драйвера статус installed, вnvidia-smiвидны все видеокарты.
Ограничения
- Не подключайте репозитории разработки на промышленном сервере без указания технической поддержки.
- Не удаляйте пакеты Vinteo через
apt purge --auto-remove«для чистой переустановки» — можно затронуть системные зависимости. - Не ставьте произвольную версию драйвера NVIDIA без проверки совместимости с ОС, ядром и комплектом Vinteo.
- Перед обновлением уже работающей системы 40.x сохраните конфигурацию и прочитайте примечания к вашей версии.
- Если поддержка выдала особый комплект установщика, следуйте её инструкции для этой поставки — не переносите разовые обходные шаги на все установки 40.x.