DION Rooms — программно-аппаратное расширение DION для переговорных комнат. С его помощью можно бронировать переговорные комнаты и подключаться во встречи DION, используя оборудование, установленное в этих комнатах.
Внутри переговорной комнаты устанавливается ПК, к которому подключены дисплей, микрофон и динамики. На дисплее отображается заставка системы DION Rooms. Взаимодействие пользователя с системой происходит через панель управления — планшет, расположенный на столе. С его помощью можно подключиться в запланированную или спонтанную встречу от лица переговорной комнаты, управлять устройствами (например, включать/выключать микрофон во встрече), а также вывести на экран изображение со своего устройства без подключения проводов.
На планшете, установленном у входа в переговорную комнату, отображается статус занятости комнаты. Можно забронировать свободный слот под свою встречу.
Для работы системы необходима интеграция с корпоративным календарем. Каждой переговорной комнате должен соответствовать почтовый ящик помещения.
На данный момент система DION ROOMS поддерживает интеграцию с календарем Microsoft Exchange и RuPost по протоколу CalDav.
Для Exchange поддерживается NTLM аутентификация.
Если вы используете другую систему, обратитесь к вашей аккаунт-команде.
Обязательные компоненты | ||||
Название компонента | Тип устройства | ПО DION | Расположение | Назначение |
Сервер DION Rooms | Сервер или виртуальная машина | Сервисы DRCS и коннектор к почтовому серверу: EWS connector или CalDav connector | ЦОД заказчика | Ядро системы. Передает управляющие команды от планшетов в DION и обратно, интегрируется с корпоративным календарем и передает информацию на планшеты, создает встречи со ссылкой на подключение в DION. |
Главный экран |
Компьютер с подключенной периферией (экран, камера, микрофон, звук) |
Web браузер | В переговорной комнате |
Техническое оснащение переговорной комнаты: экран, микрофон, динамики. Подключается в конференции DION от имени переговорной комнаты, передает медиа данные на сервера DION. Необходим для каждой переговорной комнаты. |
Панель управления (Controller) | Планшет |
controller-release-{yyyy-mm-dd}.apk в режиме киоска где {yyyy-mm-dd} - дата в формате ГГГГ-ММ-ДД |
На столе в переговорной комнате | Пульт управления переговорной комнатой. Позволяет начать или завершить встречу, управлять аудио и видео, демонстрировать рабочие столы. Необходим для каждой переговорной комнаты. |
Опциональные компоненты | ||||
Название компонента | Тип устройства | ПО DION | Расположение | Назначение |
Панель бронирования (TSA) | Планшет | TSA-release-{yyyy-mm-dd}.apk в режиме киоска | При входе в переговорную комнату | Отображает занятость переговорной комнаты и данные о встречах (организатор, время, место проведения и пр.). Позволяет быстро забронировать переговорную комнату. Может отсутствовать для всех или некоторых переговорных комнат. |
Решение DION Rooms является расширением системы DION, которое служит для подключения переговорных комнат в облачные или гибридные конференции DION.
Для работоспособности системы необходимо, чтобы подключение к облаку DION было стабильным. При недоступности соединения с облаком система не сможет продолжить работу.
Изучите требования в таблице и подготовьте сервер, а также необходимый набор устройств для каждой переговорной комнаты.
Обязательные компоненты | ||||||
Название | Тип устройства | Операционная система | CPU* | RAM* | Дисковое пространство* | Дополнительно |
Сервер DION Rooms | Сервер или виртуальная машина | Linux, например Ubuntu 22.04 |
2 CPU 2.2 ГГц |
4 GB | 10 ГБ | |
Главный экран |
Компьютер с подключенной периферией (экран, микрофон, звук) |
Windows 10 | 2 CPU | 4GB | 25 ГБ | ПК, ноутбук, мини-ПК |
Панель управления (Controller) | Планшет | Android 11 и выше | - | 4 GB | 64 ГБ |
Разрешение экрана: 2000x1200 px Диагональ экрана: 10" |
Опциональные компоненты | ||||||
Название | Тип устройства | Операционная система | CPU* | RAM* | Дисковое пространство* | Дополнительно |
Панель бронирования (TSA) | Планшет | Android 11 и выше | - | 4 GB | 64 ГБ |
Разрешение экрана: 2000x1200 px Диагональ экрана: 10" |
* в таблице указаны минимальные требования. Система поддерживает работу на устройствах с характеристиками, превышающими указанные
Обеспечьте необходимые для работы системы сетевые доступы.
Список доступов находится по ссылке в разделе DION Rooms.
Сервер DION Rooms должен быть доступен для внутренних подключений по DNS имени. Например, drcs.company.ru, где company.ru — доменное имя вашей организации
Сертификаты используются для авторизации запросов между компонентами системы, а также для взаимодействия сервиса DRCS с облаком DION.
Сертификат сроком действия на год предоставляется по запросу командой DION. Обратитесь к вашей аккаунт-команде или в службу поддержки DION (support@diongo.ru).
Вам необходимо получить три файла:
Необходимо самостоятельно отслеживать срок действия сертификата и своевременно обратиться в службу поддержки DION за новым сертификатом.
Для работы Dion Rooms необходимо иметь:
Подробная информация о заведении учетных записей представлена в разделе Регистрация пользовательской инструкции. Если требуется создать большое количество учетных записей в DION, можно воспользоваться Массовыми операциями. Если вам требуется активировать созданную учетную запись без ввода PIN, обратитесь в службу поддержки DION.
Актуальные дистрибутивы доступны по ссылке.
Примеры в данном разделе приведены для ОС Ubuntu
Для установки вам потребуются root
права.
При недостатке прав подставляйте sudo
перед каждой командой или введите команду sudo su
один раз в начале работы.
Войдите в консоль на машине, где будут развернуты сервисы DRCS и ews/caldav connector.
sudo apt update
sudo apt upgrade
2. Установите на машину docker
и docker compose
Существует несколько способов установки Docker.
Рекомендуем воспользоваться официальной инструкцией на сайте Docker.
Самый простой вариант — использование скрипта для установки из официальной инструкции. Этот вариант подходит только при наличии доступа в Интернет с машины, где выполняется установка. Если доступ есть, для установки docker можно выполнить команды:
sudo curl -fsSL https://get.docker.com -o get-docker.sh sudo sh get-docker.sh
Если доступа в Интернет с машины нет, необходимо воспользоваться другими методами из официальной инструкции.
В случае если использование пакетов из сторонних источников запрещено или невозможно, можно установить пакеты docker.io и docker-compose из репозитория ОС:
apt install docker.io docker-compose
Однако, стоит помнить, что в большинстве репозиториев всё ещё содержатся устаревшие версии этих пакетов, из-за чего необходимо будет использовать команду
docker-compose
вместоdocker compose
.
3. Перенесите на машину содержимое архива с дистрибутивами для Сервера DION ROOMS:
Можно также скачать архив целиком и распаковать уже на машине, например при помощи утилит
wget
иunzip
. Их может потребоваться дополнительно установить.Для этого создайте новую директорию, например,
/opt/dion-rooms/
:
mkdir /opt/dion-rooms/
Скачайте архив:
wget <ссылка-на-архив>
После этого выполните команду для разархивирования:
unzip -d <путь к созданной папке> <путь к архиву>
4. Перенесите на машину сертификаты и ключ, полученные от команды DION. Рекомендуется сложить их в отдельную папку, например /opt/dion-rooms/certs
.
5. Перенесите на машину сертификат выпущенный на DNS-имя по которому к серверу будут обращаться устройства в переговорной. Файлы с расширениями .crt и .key необходимо переименовать в server.crt и server.key соответственно. Файл server.crt должен включать полную цепочку - Root, Intermediate, Server. Рекомендуется сложить эти файлы в отдельную папку. В этой же папке создайте файл server.pass и добавьте в него пароль от ключа сертификата если таковой имеется. Если нет то файл нужно оставить пустым. Допускается использование папки из пункта 4.
6. Убедитесь, что на машине присутствуют файлы в составе:
Сертификаты могут находиться отдельно друг от друга и от папки в которую распакован дистрибутив.
Для этого выполните команду:
ls -aslh <путь до папки, куда распаковали архив, либо перенесли файлы>
7. Перейдите в эту папку:
cd <путь до папки, куда распаковали архив, либо перенесли файлы>
8. Запустите скрипт-установщик от имени суперпользователя и дождитесь сообщения об успешном выполнении:
sudo ./install.sh
Если ОС на вашем сервере стоит ОС отличная от Ubuntu или Debian скрипт выдаст сообщение о неподдерживаемой ОС - его можно игнорировать и нажать Y, а затем Enter, если у вас уже установлен Docker.
Для редактирования конфигурационных файлов и перезапуска сервисов вам потребуются root права.
При недостатке прав подставляйте
sudo
перед каждой командой или введите командуsudo -i
один раз в начале работы.
Для выполнения этого шага необходимо убедиться, что вы находитесь в папке, куда распаковали архив, либо перенесли файлы. Для этого выполните команду:
pwd
Если путь не совпадает, перейдите в нужную папку:
cd <путь до папки, куда распаковали архив, либо перенесли файлы>
1. Откройте на редактирование конфигурационный файл .env
Можно использовать любой удобный текстовый редактор, например, nano
.
nano .env
2. Необходимо заполнить конфигурационный файл в соответствии с подсказками в самом файле и ниже. Вносите изменения только в те переменные, которые указаны в инструкции:
Вписывайте значения без пробелов и без кавычек. Будьте внимательны при заполнении.
Если в какой-либо из переменных содержится знак доллара ($) его нужно удвоить, вписав $$ вместо каждого $.
Если сервер уже запущен и вы хотите внести изменения в значения переменных, нужно полностью перезапускать сервер командами
docker compose down
иdocker compose up -d
(илиdocker-compose down
иdocker-compose up -d
соответственно). Только так новые значения будут применены.
GRPC_DIR=
.crt
, выданного командой DION:DION_GRPC_SERVICE_CERTIFICATE_CHAIN=
.key
, выданного командой DION:DION_GRPC_SERVICE_PRIVATE_KEY=
SECURITY_TOKEN=
CERTS_PATH=/home/ubuntu/cert
CERTS_PATH=
TZ=Europe/Moscow
TZ=
METRICS_EXPORTER_CONNECTOR_ID=rooms-service-my-company-1
где my-company - имя вашей компании.METRICS_EXPORTER_CONNECTOR_ID=
x-x-x
в формате: https://x-x-x/EWS/Exchange.asmx
Пример заполнения для почтового сервера post.domain.ru: EXCHANGE_URL=https://post.domain.ru/EWS/Exchange.asmx
EXCHANGE_URL=
EXCHANGE_DOMAIN=domain.ru
EXCHANGE_DOMAIN=
EXCHANGE_USERNAME=test
EXCHANGE_USERNAME=
EXCHANGE_PASSWORD=
CDA_URL=
CDA_DOMAIN=domain.ru
CDA_DOMAIN=
CDA_USERNAME=
CDA_PASSWORD=
3. Запустите сервисы:
docker compose up -d
или
docker-compose up -d
4. Удостоверьтесь что сервисы запустились корректно:
docker ps
проверьте все ли контейнеры запустились. Должно быть запущено 3 контейнера: их имена (колонка NAMES) должны содержать слова proxy, rooms-service, ews-connector (caldav-connector вместо ews-connector для CalDav-установок). У всех контейнеров из перечисленных должен быть статус Up:Если 1 или более контейнеров не присутствуют в списке значит скорее всего есть ошибка в конфигурации. Чтобы увидеть “упавшие” контейнеры нужно выполнить команду docker ps -a
, такие контейнеры будут отмечены как Exited. Можно использовать команду docker logs
чтобы посмотреть логи “упавшего” контейнера чтобы понять в чём ошибка.
2. Когда сервисы запустились успешно, можно попытаться подключить одно из устройств переговорной. Если устройство не подключается можно обратиться к логам сервисов с помощью команды docker logs <имя_контейнера>
. Имя контейнера можно взять из столбца NAMES вывода команды docker ps
. Опционально можно использовать ключ -f
вместе с командой docker logs чтобы получать сообщения от сервиса в реальном времени. Выйти из такого режима просмотра логов можно сочетанием клавиш Ctrl+C.
Если вы видите в логах большие ступенчатые полотна исключений и/или слова Error/Ошибка и у вас при этом не подключаются устройства переговорных, хотя вы уверены что настроили сервер правильно - обращайтесь в поддержку DION.
docker compose down
или
docker-compose down
3. Выполните стандартный процесс установки сервера DION Rooms, кроме этапов установки Docker и конфигурирования сервисов. Можно либо создать новую директорию для новой версии, либо, сначала остановив старые, переименовать или переместить директорию со старой версией.
4. Сверьте файл .env от старой версией с одноимённым файлом от новой версии. Если список переменных в обоих файлах совпадает, вы можете просто заменить файл .env от новой версии им же от старой. Если же список переменных отличается, то нужно пройти пункты 1 и 2 стандартного процесса конфигурирования заново.
5. Запустите обновлённые сервисы:
docker compose up -d
или
docker-compose up -d
6. Для проверки работоспособности новой версии можно руководствоваться пунктом 4 раздела “Конфигурация и запуск сервисов”. Важно, чтобы контейнеры чьи имена содержат слова proxy, rooms-service, ews-connector существовали в одном экземпляре.
Установите ADB на компьютер:
1. Сбросьте все настройки планшета до заводских
2. Настройте устройство, пропуская добавление Google аккаунта
3. Включите режим разработчика на планшете:
Настройки > О планшете > Нажать 6 раз по строке "Номер сборки"
4. Отключите выключение экрана на планшете во время зарядки:
Настройки > Система > Для разработчиков > Не выключать экран
5. Включите на планшете отладку по USB:
Настройки > Система > Для разработчиков > Отладка по USB
6. Подключите планшет к компьютеру через USB, должно появиться окно с просьбой разрешить отладку по USB, согласитесь.
1. Запустите командную строку (например Windows PowerShell) и перейдите в директорию, где установлен Android SDK Platform Tools
2. Установите приложение командой:
.\adb install -t “путь_к_apk”
В случае успеха, команда выдаст текст “Success” в консоль
Пример:
2. Если высветится запрос “Проверить безопасность приложения?” выбрать “Не проверять”.
3. Перейдите в настройки приложения: Настройки → Приложения и уведомления → Нажать на приложение панели управления (TCCA)
4. Сделайте приложение панели управления главным: в настройках приложения Дополнительно → Главное приложение → Выбрать приложение панели управления (TCCA)
5. Сделайте установленное приложение владельцем устройства. Для этого в командной строке введите:
.\adb shell dpm set-device-owner tech.inno.dion.rooms.tcca/tech.inno.dion.rooms.tcca.KioskDeviceAdminReceiver
Пример:
6. Закройте и заново запустите приложение для применения режима киоск.
При первом запуске приложения откроется окно настройки:
*Секретный токен
— совпадает со значением SECURITY_TOKEN в .env
файле
*DRCS URL
— FQDN вашего сервера Dion Rooms в формате https://FQDN_сервера/api-rooms
*Название помещения
— название переговорной комнаты, любое текстовое название. Как правило, название позволяет однозначно идентифицировать комнату, например “Переговорная Аврора”
*Имя почтового аккаунта
— часть адреса электронной почты, созданной для переговорной комнаты, до @. Например: room_X@xxx.com
*Имя комнаты Дион
— название главной персональной комнаты DION
Для большинства учетных записей имя главной комнаты совпадает с именем почтового аккаунта. Однако бывают исключения. Чтобы не ошибиться, рекомендуем войти в личный кабинет на сайте dion.vc под учетной записью, созданной для переговорной комнаты. Одна комната будет создана системой автоматически. Именно название этой комнаты требуется вписать в поле.
Сеть WiFi
— название гостевой сети WiFi, необязательное поле
Пароль
— пароль от гостевой сети WiFi, необязательное поле
Кабинет руководителя
— Переключатель комнаты в режим руководителя(возможность бронирования нескольких встреч на одно и то же время)
*обязательные параметры
Нажмите кнопку “Продолжить”, после чего настройки сохранятся и произойдет переход к выбору фонового изображения.
Выбор фонового изображения:
Нажмите кнопку “Сохранить”
После первого запуска настройки применятся. Их изменение возможно только путем удаления приложения и повторной установки или удаления данных приложения.
Приложение готово к работе:
password
После ввода параметров подключение Controller к DRCS происходит автоматически, ближайшие события для настроенной переговорной отобразятся на панели управления
Для внесения изменений выполните следующие шаги:
Для обновления приложения выполните следующие шаги:
Для обновления приложения выполните заново шаги по установке после удаления.
1. Сбросьте все настройки планшета до заводских
2. Настройте устройство, пропуская добавление Google аккаунта
3. Включите режим разработчика на планшете:
Настройки > О планшете > Нажать 6 раз по строке "Номер сборки"
4. Включите на планшете отладку по USB:
Настройки > Система > Для разработчиков > Отладка по USB
5. Подключите планшет к компьютеру через USB. Должно появиться окно с просьбой разрешить отладку по USB, согласитесь.
1. Запустите командную строку (например Windows Power Shell) и перейдите в директорию, где установлен Android SDK Platform Tools
2. Установите приложение командой:
.\adb install -t "путь к apk файлу"
3. Перейдите в настройки приложения: Настройки → Приложения и уведомления → Нажать на приложение панели бронирования (TSA)
4. Сделайте приложение панели управления главным: в настройках приложения Дополнительно → Главное приложение → Выбрать приложение панели бронирования (TSA)
5. Сделайте установленное приложение владельцем устройства. Для этого в командной строке введите:
.\adb shell dpm set-device-owner com.inno.tech.dion.roomsTSA/.MyAdmin
6. Если высветится запрос “Проверить безопасность приложения?” выбрать “Не проверять”.
При первом запуске приложения откроется окно настройки:
*Секретный токен
— совпадает со значением SECURITY_TOKEN в .env
файле
*DRCS URL
— FQDN вашего сервера Dion Rooms в формате https://FQDN_сервера/api-rooms
*Название помещения
— название переговорной комнаты. Как правило, название позволяет однозначно идентифицировать комнату. Можно использовать название из MS Exchange.
*Вместимость
— количество человек, которые могут размещаться в данной локации. Как правило, совпадает с данными из параметров помещений в MS Exchange.
*Имя почтового аккаунта
— часть адреса электронной почты, созданной для переговорной комнаты, до @. Например: room_X@xxx.com
Сеть WiFi
— название гостевой сети WiFi
Пароль
— пароль от гостевой сети WiFi
*обязательные параметры
Нажмите кнопку “Продолжить”, после чего настройки сохранятся и произойдет переход к выбору фонового изображения.
Выбор фонового изображения:
Нажмите кнопку “Сохранить”
После первого запуска настройки применятся. Их изменение возможно только путем удаления приложения и повторной установки.
После этого приложение должно перейти в рабочее состояние.
password
После ввода параметров подключение TSA к DRCS происходит автоматически, ближайшие события для настроенной переговорной отобразятся на панели управления
Для внесения изменений выполните следующие шаги:
Для обновления приложения выполните следующие шаги:
Для обновления приложения выполните заново шаги по установке после удаления.
В переговорной комнате установлен персональный компьютер. К нему подключаются устройства ввода вывода. На этом компьютере необходимо держать открытым браузер. DION поддерживает браузеры Google Chrome, Yandex Browser или Microsoft Edge. Рекомендуем использовать Google Chrome.
ПК в переговорной комнате, как правило, находятся в общем доступе. Во избежание некорректных действий пользователей, рекомендуем настроить браузер, в котором будет открыт DION, для работы в режиме Киоска. Режим Киоска позволит использовать только разрешенное ПО и ограничит доступ к настройкам ОС.
Настройка режима киоска описана, например, в данной статье в разделе “Одно приложение, полноэкранный киоск”:
https://learn.microsoft.com/ru-ru/mem/intune/configuration/kiosk-settings-windows
В браузере Chrome перейдите на сайт https://rooms.dion.vc и выполните вход в личный кабинет от лица переговорной комнаты. Используйте соответствующую учетную запись, которая была создана на этапе подготовки.
После успешного входа откроется окно настроек.
*Токен
— совпадает с SECURITY_TOKEN в .env
файле
*DRCS URL
— FQDN сервера DION Rooms, где вы развернули сервис DRCS, в формате https://FQDN_сервера/api-rooms
*Название помещения
— Id переговорной комнаты. Это часть адреса электронной почты до @. Например: room_X@xxx.com
*Имя почтового аккаунта
— часть адреса электронной почты, созданной для переговорной комнаты, до @. Например: room_X@xxx.com
*обязательные параметры
Нажмите кнопку “Продолжить”, после чего настройки сохранятся и произойдет переход к выбору фонового изображения.
Нажмите кнопку “Продолжить”.
Система переходит в рабочее состояние.
После выполнения шагов из данной инструкции вы должны иметь возможность использовать систему: