Установка Flussonic Media Server
В этой главе вы узнаете, как установить и запустить Flussonic Media Server, а также как обновить его до актуальной версии или откатиться на предыдущую при необходимости.
Содержание:
- Перед установкой Flussonic Media Server
- Установка Flussonic Media Server
- Активация Flussonic Media Server
- Как изменить пароль администратора?
- Обновление Flussonic Media Server
- Какая версия Flussonic стоит сейчас?
- Как откатиться на предыдущую версию?
- Промежуточные обновления между релизам
- Запуск и остановка Flussonic Media Server
- Запуск Flussonic в Docker контейнере
Перед установкой Flussonic Media Server
Прежде чем приступить к установке Flussonic Media Server, убедитесь, что удовлетворены следующие условия:
- Ваша система соответствует рекомендуемым системным требованиям.
- У вас открыт HTTP-порт 80 и он не прослушивается никаким другим приложением в вашей ОС (по умолчанию Flussonic Media Server использует HTTP-порт 80).
Если все условия выполнены, то можно переходить к установке.
Установка Flussonic Media Server
Вы можете установить Flussonic Media Server на Ubuntu, CentOS/RedHat и других RPM-системах.
На Ubuntu
Поддерживаемые архитектуры: amd64, arm64.
Поддерживаемые версии ОС: Ubuntu LTS 22.04, 20.04.
Установите Flussonic Media Server из Debian package:
wget -q -O /etc/apt/trusted.gpg.d/flussonic.gpg http://apt.flussonic.com/binary/gpg.key;
echo "deb http://apt.flussonic.com binary/" > /etc/apt/sources.list.d/flussonic.list;
apt update;
apt -y install flussonic flussonic-transcoder;
Note
Пакет flussonic-transcoder
необходим только в случае, если вы планируете использовать CPU для выполнения транскодирования.
Чтобы узнать, какие пакеты можно установить, используйте команду ниже:
apt-get -y --install-recommends --install-suggests install flussonic
После завершения установки, можно приступить к запуску Flussonic Media Server.
На RPM-системах CentOS/RedHat и подобных им
Danger
Мы не рекомендуем использование rpm-дистрибутивов: CentOS, RedHat, Suse и т.п. Это связано с целым перечнем причин. Мы не оказываем поддержки по проблемам, связанным с использованием rpm-пакетов и rpm-дистрибутивов, пользователям, покупающим меньше 10 лицензий.
Устанавливаем Flussonic Media Server из Yum repository:
cat > /etc/yum.repos.d/Flussonic.repo <<EOF
[flussonic]
name=Flussonic
baseurl=http://apt.flussonic.com/rpm
enabled=1
gpgcheck=0
EOF
yum -y install flussonic-erlang flussonic flussonic-transcoder
service flussonic start
Активация Flussonic Media Server
После завершения установки необходимо активировать Flussonic Media Server.
Чтобы активировать Flussonic Media Server:
1) Запустите Flussonic Media Server, используя команду ниже:
service flussonic start
2) Откройте веб-интерфейс Flussonic Media Server, прописав в адресной строке браузера URL http://FLUSSONIC-IP:80/
, где FLUSSONIC-IP
— IP-адрес вашего сервера с Flussonic.
3) Введите полученный лицензионный ключ, а также логин и пароль администратора для управления Flussonic Media Server, которые вы будете использовать. Вы можете найти лицензионный ключ в личном кабинете на my.flussonic.com.
Caution
Логин и пароль не должны содержать символов @, ;, #, [, \, /, =, $
Подробнее о лицензировании Flussonic см. на странице Использование лицензионного ключа.
4) Проверьте успешность установки Flussonic Media Server, выполнив следующую команду:
service flussonic status
Flussonic Media Server готов к работе.
Tip
Для большого количества клиентов необходимо произвести тюнинг ОС.
Warning
Полностью отключите swap, так как его наличие несовместимо с видеостримингом. Если на сервере не хватает оперативной памяти, её нельзя расширять с помощью swap
.
При первом запуске веб-интерфейса и сохранении введенных логина, пароля и лицензионного ключа автоматически создается конфигурационный файл. Он содержит настройки по умолчанию, такие как путь к базе Pulse и лог сессий. Подробнее о файле конфигурации см. Управление конфигурацией Flussonic Media Server.
Если у вас есть опыт использования Flussonic, вы можете подготовить этот файл вручную: пропишите логин и пароль в файле и скопируйте его на сервер сразу после установки.
Как изменить пароль администратора?
Изменить пароль администратора можно через редактирование конфигурационного файла либо через веб-интерфейсе.
Редактирование конфигурационного файла
Чтобы изменить пароль администратора через конфигурационнный файл:
1) Откройте конфигурационный файл /etc/flussonic/flussonic.conf
и измените пароль в значении директивы edit_auth
.
2) Чтобы применить изменения, перечитайте настройки сервера вручную, выполнив команду:
service flussonic reload
Через веб-интерфейс
Чтобы изменить пароль через веб-интерфейс:
1) Перейдите на страницу Config в боковом меню.
2) Перейдите на вкладку Settings и найдите раздел Access. Введите новый пароль в поле Admin UI password и повторите пароль в поле ниже. Затем кликните Save, чтобы применить изменения.
Обновление Flussonic Media Server
Для обновления версии Flussonic Media Server необходимо ещё раз обновить пакеты и установить Flussonic Media Server:
apt-get update
apt-get -y install flussonic
service flussonic restart
Какая версия стоит сейчас?
Чтобы посмотреть версию Flussonic Media Server, установленную на вашем компьютере, выполните следующую команду в терминале:
dpkg -l | grep flussonic
Как откатиться на предыдущую версию?
Иногда может потребоваться установить предыдущую версию Flussonic Media Server. Для этого необходимо указать версию пакета flussonic
и его зависимостей.
Предположим, что нужна версия 22.11.
1) Узнаем версии зависимостей с помощью apt-cache
:
apt-cache show flussonic=22.11 | egrep '^(Depends|Suggests):'
Вывод будет примерно следующий:
Depends: flussonic-erlang (=24.0.6.3), flussonic-transcoder-base (=22.08.3)
2) Установим с указанием полученных версий:
apt-get install flussonic=22.11 flussonic-erlang=24.0.6.3 flussonic-transcoder-base=22.08.3
Danger
Перед установкой пакетов обязательно делайте резервную копию конфигурационных файлов из директории /etc/flussonic
и .db
файлов из директории /opt/flussonic/priv
(эта директория используются по умолчанию, в конфиге вы можете задать произвольный путь).
Danger
На других дистрибутивах Linux, для которых нет пакетов, мы не можем гарантировать работоспособность сервера.
Промежуточные обновления между релизами
Мы выпускаем новую версию Flussonic каждый месяц, но у нас также есть репозиторий с промежуточными обновлениями. Каждый день он обновляется новой сборкой Flussonic, которая содержит новые функции и исправления ошибок. Промежуточные обновления — это Release Candidate-версии, которые мы используем в нашей лаборатории и предлагаем некоторым клиентам, которые хотят получить обновления до выхода следующего официального релиза.
Эта инструкция поможет вам установить промежуточное обновление, вернуться к официальному выпуску, создать резервную копию конфигурации и подготовить информацию для группы поддержки в случае сбоя при установке.
Установка промежуточного обновления
1) Удалите установленную версию Flussonic и ее зависимости:
apt remove flussonic
2) Измените используемый репозиторий на репозиторий с промежуточными обновлениями и установите Flussonic:
echo "deb http://apt.flussonic.com/repo master/" > /etc/apt/sources.list.d/flussonic.list;
apt update;
apt install flussonic;
service flussonic restart
Возврат к официальному релизу
1) Удалите установленную версию Flussonic и ее зависимости:
Danger
Перед удалением пакетов создайте резервную копию файлов конфигурации, расположенных в директории /etc/flussonic
и файлов .db
из директории /opt/flussonic/priv
(эта директория используется по умолчанию, но можно прописать другую в конфигурационном файле Flussonic).
apt remove flussonic
2) Измените используемый репозиторий на репозиторий с официальными выпусками и установите Flussonic:
echo "deb http://apt.flussonic.com binary/" > /etc/apt/sources.list.d/flussonic.list;
apt update;
apt install flussonic;
service flussonic restart
Danger
Если Flussonic не запускается, выполните команды service flussonic run
и journalctl -u flussonic -n 100
и покажите результат службе поддержки.
Запуск и остановка Flussonic Media Server
Необходимо использовать следующие команды:
- для запуска сервиса:
service flussonic start
- для остановки сервиса:
service flussonic stop
- для перезапуска сервиса:
service flussonic restart
- для переконфигурации без отключения клиентов:
service flussonic reload
Запуск Flussonic в Docker контейнере
Flussonic Media Server доступен для установки в Docker контейнеры.
Установка в Docker позволит запускать Flussonic в разных операционных системах, если они поддерживают Docker, а не только в Ubuntu. Также такая установка позволит вам использовать все преимущества Docker: изоляцию, безопасность, управление контейнерами, и т.д. Мы рекомендуем Docker для тестирования и экспериментов, для небольших сервисов и когда используете только TCP/HTTP
протоколы.
Чтобы запустить Flussonic в контейнере:
docker run -p 80:80 -v /etc/flussonic:/etc/flussonic flussonic/flussonic
Note
Порт 80 должен быть свободен.
Чтобы запустить контейнер Flussonic с аппаратным транскодированием на NVIDIA NVENC, выполните команду ниже:
docker run --rm -p 80:80 -v /etc/flussonic:/etc/flussonic --gpus all -e NVIDIA_DRIVER_CAPABILITIES='all' flussonic/flussonic:latest
Мы не рекомендуем использовать следующие функции Flussonic при его работе из контейнера, так как требуется дополнительная настройка:
- UDP захват (IGMP)
- Аппаратное транскодирование(QSV)
- Протокол WebRTC