Документация по KeenVision

# Вопросы и ответы.

# Как проверить состояние сервера и перезапустить его?

Для проверки состояния сервера выполните меню Health

Для перезапуска сервера выполните меню Stop а затем Start

# Как подключается устройство?

Устройство подключается в три этапа.

Для того чтобы объяснить, как это работает, введем два обозначения:

  • SERVER_IP - IP V4 адрес сервера;
  • RECEIVER_URL - адрес сервера, который вводится в приложении "KeenVision Receiver".

# Этап1 - получение сертификатов.

После того, как в устройстве, в приложении "KeenVision Receiver" вводятся адрес сервера и имя пользователя, чтобы получить SSL-сертификаты, приложение соединяется с сервером по протоколу HTTPS, по следующему адресу:

https://<RECEIVER_URL>/auth

Со стороны сервера, работает сервис выдачи SSL-сертификатов для устройств. Адрес доступа к сервису зависит от параметра конфигурационного файла external.player_http_auth_port_ssl.

Если параметр равен true, то сервис работает по протоколу HTTPS по адресу:

https://<SERVER_IP>:<external.player_http_auth_port>/auth

Если параметр равен false, то сервис работает по протоколу HTTP по адресам:

http://<SERVER_IP>:<external.http_port>/auth
и
http://<SERVER_IP>:<external.http_port>

Чтобы устройство соединилось с сервером, устройству должен быть доступен сервис. При доступе из Интернет, адрес (и/или протокол) работы сервиса и адрес (и/или протокол), по которому соединяется устройство, могут не совпадать. Например, в качестве адреса можно использовать доменное имя.

Для обеспечения доступа к сервису, на оборудовании, которое обеспечивает доступ в Интернет, установите и настройте прокси-сервер Apache или nginx.

ВНИМАНИЕ!

Устройство получит сертификаты, если на портале:

После получения устройством сертификатов, в нем удаляется имя пользователя и адрес подключения по протоколу HTTPS, в приложении "KeenVision Receiver" больше нельзя изменить адрес сервера и имя пользователя.

# Этап2 - подключение к брокеру сообщений по протоколу AMQPS.

На первом этапе устройство получило клиентские SSL-сертификаты для подключения и адрес для подключения к брокеру сообщений RabbitMQ по протоколу AMQPS.

Устройство получит адрес для подключения, который указан в параметре external.amqp_uri. Если этот параметр имеет пустое значение, то адрес для подключения будет такой:

<external.uri>:<ports.rabbitmq.players>

Сам брокер сообщений работает по адресу:

<SERVER_IP>:<ports.rabbitmq.players>

# Этап3 - загрузка файлов с сервера в устройство.

После того как устройство получит по протоколу AMQPS расписание от сервера, оно начнет загрузку медиафайлов с сервера. Скриншоты экрана устройства выгружаются на сервер аналогичным образом. Работа с файлами производится при помощи сервиса объектного хранилища MinIO™️.

Сервис работает по адресу:

http://<SERVER_IP>:<ports.s3>

Для входа в веб-интерфейс управления сервисом MinIO™️ нужно использовать:

  • access_key из параметра конфигурационного файла secrets.s3.access_key
  • secret_key из параметра конфигурационного файла secrets.s3.secret_key

Встроенный nginx сервер перенаправляет пакеты с

http://<external.uri>: <external.http_port>

на адрес

http://<SERVER_IP>:<ports.s3>

# Что делать если устройство не подключается.

# Проверить сгенерированные сертификаты.

Если не пройден первый этап подключения устройства - устройство не появилось в дереве устройств, то необходимо проверить сертификат для авторизации плееров через https.

От имени пользователя с правами "Настройка сервера", в веб-браузере откройте портал. Нажмите в верхнем меню пункт "Настройки". Проверьте данные сертификата для авторизации плееров через https. В полях "Дополнительное имя субъекта" и "Субъект" должен быть указан правильный адрес сервера (IP-адрес или имя домена).

В файле c:\Program Files\KeenVision3Server\certificates\amqp.crt находится сертификат для брокера сообщений, если он не действителен, то Этап2 подключения не пройдет! Устройство не свяжется с сервером.

Для проверки сертификата, нужно сделать на нем двойной клик в проводнике Windows. В открывшемся окне нажать закладку "Состав" и посмотреть поле "Дополнительное имя субъекта". В этом поле должен отражаться адрес сервера (IP-адрес или имя домена).

Новые сертификаты автоматически создаются после изменения схемы подключения.

# Что делать если не удается загрузить файлы на портал.

Проверьте, можно ли сделать скриншот экрана устройства. Если скриншот удалось сделать, то причина в том, что в браузере портал открыт адресу отличному от адреса из конфигурационного файла.

Если скриншот сделать не удалось, то проведите диагностику сервера.

← Встроенный веб-сервер →