Local Server/en

Important! If the HTTPS protocol is used on your own domain name, then for correct operation, a certificate issued by GlobalSign is required. This certificate is compatible with all operating systems used in the SmartPlayer platform. Otherwise, SmartPlayer does not guarantee the binding of devices to the server if other certificates are used. You can purchase it here: https://www.reg.ru/ssl-certificate/GlobalSign/gs_domainssl

SmartPlayer Local Platform Operation Scheme

Option 1. Deployment on the Customer's Server, Without Using a Virtualization System

Минимальные требования для локального сервера:

Требования OS

Можно выбрать любую из перечисленных. Операционные системы расположены по приоритетам c рекомендованной (первая позиция) до возможной (последняя позиция):

• Ubuntu Server 24.04. LTS (возможна установка без доступа в внешнюю сеть)
• Astra Linux Орел (ver. 1.7) - российская linux операционная система (возможна установка без доступа в внешнюю сеть)
• Astra Linux Орел (ver. 1.8) - российская linux операционная система (возможна установка без доступа в внешнюю сеть)

At the time of installation of the local server:

• remote ssh access for user with root rights - used for configuration
• remote sftp access for a user with root rights - used to upload files to the server
• Internet access - used to install dependencies for the server application
• [Optional] first account (e-mail address) is the main account on the local server, if not provided by default root@smartplayer.org

На время установки локального сервера:

• удаленный ssh доступ для пользователя с root правами - используется для настройки
• удаленный sftp доступ для пользователя с root правами - используется для закачки файлов на сервер
• доступ в сеть интернет - используется для установки зависимостей для серверного приложения
• [Необязательно] первая учетка (e-mail адрес) - главная учетка на локальном сервере, если не предоставлено по умолчанию root@smartplayer.org

Option 2. Deployment on the customer's server, using the vmWare virtualization system.

The disc is ejected with the platform fully installed. The network administrator imports the virtual machine into his virtualization environment, after starting the server, a fully operational platform is ready.

Scope of delivery:

• UbuntuServer-disk1.vmdk - the disk with the installed platform. About 3-4 Gb.
• UbuntuServer.mf - manifest file
• UbuntuServer.ovf - template with settings for a virtual machine

To prepare the image, you need:

• Static IP address (domain name) on which the server will be deployed, personal account, configured paths to client applications.
• [Not necessary]. Full network settings, when preparing the image, a completely ready-made working network interface is created.

Full network settings include:

• Static IP address
• Gateway address
• Network mask
• Primary DNS
• Secondary DNS
• DNS suffix

Для подготовки образа требуются:

• Статичный IP адрес(доменное имя) на котором будет развернут сервер, личный кабинет, сконфигурированные пути к клиентским приложения.
• [Необязательно]. Полные сетевые настройки, при подготовке образа создается полностью готовый работоспособный сетевой интерфейс.

Полные сетевые настройки включают в себя:

• Static IP address
• Gateway address
• Network mask
• Primary DNS
• Secondary DNS
• DNS suffix

Вариант 3. Развертывания на сервере заказчика, с использованием виртуализации Hyper-V

Выгружается диск с полностью установленной платформой. Следующим шагом сетевой администратор импортирует виртуальную машину в свою среду виртуализации, после запуска сервера полностью работоспособная платформа готова.
Состав поставки:

1. Архив с Ubuntu-server, экспортированной из Hyper-V.

Для подготовки образа требуются:

• статичный IP-адрес(доменное имя), на котором будет развернут сервер Ubuntu, личный кабинет и сконфигурированные пути к клиентским приложениям;
• Необязательно
  полные сетевые настройки. При подготовке образа создается полностью готовый работоспособный сетевой интерфейс.

Полные сетевые настройки включают в себя:

1. Static IP address
2. Gateway address
3. Network mask
4. Primary DNS
5. Secondary DNS
6. DNS suffix

(Установка данного решения осуществляется за дополнительную оплату, уточняйте у менеджера)

Требования к аппаратному обеспечению при установки серверного приложения в режиме кластеризации

Кластеризация — это метод, который позволяет объединить несколько серверов в одну систему, чтобы они могли работать вместе и выполнять общие задачи. В этом случае эти серверы называются узлами кластера. Основная идея кластеризации — повысить надежность, производительность и доступность приложения.
Для корректной работы серверного приложения в режиме кластеризации ниже будут прописаны требования для каждого из элементов: Master Node — это контролирующий центр всего кластера. Он управляет всеми процессами и координирует работу остальных узлов называемых worker nodes.

Master node CPU

CPU	RAM
1xXeon (12 ядер)	От 32 Gb

Worker Node — это рабочие мощности кластера, которые непосредственно выполняют все задачи и процессы, нужные для работы приложений. Каждый Worker Node занимается исполнением контейнера и сервиса, на которых работает приложение.

Worker name

CPU	RAM
1xXeon (8 ядер)	От 24 Gb

Рекомендуется использовать/добавлять одну "worker node" на 1500-2000 устройств. S3-хранилище — это тип облачного хранилища, созданного для хранения больших объёмов данных. "S3" означает Simple Storage Service. S3- это единое хранилище к которому подключаются сервера при кластеризации.

S3

CPU	RAM
1xXeon (12 ядер)	От 24 Gb

Существует зависимость от поколения версии клиентского приложения. Чем более ранняя версия клиентского приложения установлена, тем более сильно она нагружает сервер в связи с большим количество обращений (запрсоов). Поэтому рекомендуется всегда иметь актуальную версию клиентского приложения.

Ответы на частые вопросы по работе с внутренней сети заказчика

• Вопрос: Какие порты необходимо открыть ?
• Ответ: Для работы локального сервера (разворачивается на мощностях заказчика) по 80 порту (сервер http), по 443 порту (сервер https). Для работы облачного сервера SmartPlayer в ограничениях сети запросите документ у интегратора или представителя SmartPlayer.

---

• Вопрос: Направление открытия портов на стороне клиентского приложения ( оно может быть IN или OUT ) ?
• Ответ: Необходимо открыть в обе стороны IN и OUT

---

• Вопрос: Описание обмена данными между облачныи сервером и клиентским приложение ?
• Ответ: Сервер может работать по двум протоколам http или https. При реализации сервера по протоколу https заказчик предоставляет сертификат и самостоятельно следит за актуализацией его после завершения срока действия сертификата. Связь между сервером и клиентскими приложениями осуществляется по 80 порту (сервер http), по 443 порту (сервер https). Для взаимодействия используется протокол WebSocket (WS) или WebSocketSecure (WSS) в зависимости от настройки сервера. Необходимые порты в локальной сети. 80 порт или 443 порт в зависимости от конфигурации сервера. При наличии в сети прокси, пакеты передаваемые между сервером и личным кабинетом, клиентскими приложениями не должны модифицироваться. Инициализация открытия соединения идет с стороны клиентского приложения.

---

• Вопрос: Какой объем трафика ?
• Ответ: Зависит от проигрываемого контента на устройства. В режиме пинг-понг расход трафика минимальный, исчесляемый в килобайтах.

---

• Вопрос: Когда будет происходить обмен трафиком?
• Ответ: Разделим трафик на две категории:
  • трафик пинг-понг обмен происходит круглосуточно
  • трафик получения контента на клиенсткие приложения происходит в момент загрузке его на устройство. Загрузку контента можно отложить по расписанию, например поставить в ночное время когда канал связи менее загружен