¶ РУКОВОДСТВО СИСТЕМНОГО АДМИНИСТРАТОРА
¶ 1 Установка необходимого ПО
¶ 1.1 Установка библиотек
1.1.1 Библиотеки для Web Recorder:
- Pip3 – система управления пакетами для Python3:
sudo apt install python3-pip - Flask - фреймворк для создания веб-приложений на языке программирования Python:
pip3 install Flask flask_wtf - Google API — библиотека python для доступа к GSuite и Google Drive:
pip3 install google-api-python-client google-auth-httplib2 google-auth-oauthlib - Установка venv (Virtual Environment):
sudo apt install -y python3-venv - Mosquitto – MQTT-брокер:
sudo apt-add-repository ppa:mosquitto-dev/mosquitto-ppa
sudo apt-get update
sudo apt-get install mosquitto
sudo apt-get install mosquitto-clients
sudo apt clean
pip3 install paho-mqtt
1.1.2 Библиотеки для Web Router:
- Все те же самые библиотеки
- DHCP:
pip3 install flask_socketio isc_dhcp_leases
¶ 1.2 Установка программ комплекса
1.2.1 для Web Recorder
- Клонирование репозитория:
git clone https://git.miem.hse.ru/19102/web.git - Клонирование подмодулей (репозиторий auth)
git submodule init
git submodule update
1.2.1 для Web Router
- Клонирование репозитория:
git clone -b router https://git.miem.hse.ru/19102/web.git - Клонирование подмодулей (репозиторий auth)
git submodule init
git submodule update
¶ 2. Настройка ПО
¶ 2.1 Настройка автозапуска для Recorder и Router
Для того, чтобы программные скрипты автоматически запускались при включении модуля, необходимо в домашнем каталоге отредактировать скрипт autostart.sh. Например, для автоматического запуска сайта и доп. файлов, которые хранятся в каталоге web (находится в домашнем каталоге), необходимо выполнить следующие шаги в системе:
- Перейти в домашний каталог;
- Создать файл
autostart.sh, если его нет, и открыть его на редактирование; - Убедиться, что первая строка файла выглядит, как: #!/bin/bash
- Дополнить файл следующими строками:
cd /home/jetson/web
source env/bin/activate
./run_server.sh &
./sub-customCameras.sh &
./sub-account.sh &
Финальная версия скрипта autostart.sh должна выглядеть так:
#!/bin/bash
cd /home/jetson/web
source env/bin/activate
./run_server.sh &
./sub-customCameras.sh &
./sub-account.sh &
Рассмотрим данные команды:
- cd /home/jetson/web – переход в директорию веба
- source env/bin/activate – активируем виртуальную среду Python (необходимо для дальнейшего использования переменных окружения). НО ! сначала нужно создать виртуальную среду с помощью команды python3 -m venv env в директории web. Поэтому перед запуском
autostart.shубедитесь, что вирутальная среда создана. - ./run_server.sh – запускаем bash-файл, который включает веб-сервер flask
- ./sub-customCameras.sh - запускаем bash-файл, который активирует прослушку mqtt топика для получения данных о камерах с веба
- ./sub-account.sh – запускаем bash-файл, который активирует прослушку mqtt топика для получения данных об изменениях аккаунта с роутера
¶ 2.2 Настройка конфигурации
Конфигурация flask-сервера находится в файле .flaskenv (с переменными окружения) и, сервер срабатывает только при запуске в виртуальной среде Python.
.flaskenv:
FLASK_APP=app.рy
FLASK_ENV=development
FLASK_RUN_HOST=172.18.191.110
FLASK_RUN_PORT=5000
- FLASK_APP – начальная точка сервера (главный файл)
- FLASK_ENV – тип запуска приложения (development – в процессе разработки, production – готового веб-сервера)
- FLASK_RUN_HOST – хост, на котором запускается сервер
- FLASK_RUN_PORT – порт, на котором запускается сервер
Для изменения конфигурации сервера необходимо остановить работу flask, изменить необходимые переменные окружения, сохранить файл и запустить сервер в директории web с помощью команды**./run_server.sh**
¶ 2.3 Настройка авторизации Google Api Drive
Для настройки веб-приложения Google-авторизации и дальнейшего доступа к изменению и чтению данных из Google Drive необходимо перейти на сайт Google Cloud. На сайте необходим пройти авторизацию через аккаунт Recorder TVCenter в домене miem.hse.ru. После успешной авторизации можно переходить в консоль Google Cloud
В консоли справа находим пункт APIs & Services ---> Dashboard
Дальше переходим в пункт Credentials и нажимаем на приложение «Веб-клиент 2» из списка OAuth 2.0 приложений.
Здесь можно редактировать: название приложения, основные URL-адреса приложения, redirect URLs (необходимы для перенаправления пользователя на определенные URL-адреса при успешном входе в Google-аккаунт) и т.д.
При любом редактировании веб-приложения, необходимо сохранять изменения и после скачать обновленный JSON-файл приложения, переименовать его в credentials.json и переместить в директорию auth
¶ 3 Передача данных по MQTT
MQTT (англ. message queuing telemetry transport) — упрощённый сетевой протокол, работающий поверх TCP/IP, ориентированный на обмен сообщениями между устройствами по принципу издатель-подписчик.
Таблица 1. MQTT-передача данных:
| Топик | IP-адрес брокера | Описание |
|---|---|---|
| accounts/gdrive/token | 172.18.191.41 (роутер) или 172.18.191.110 (рекордер) | По данному топику передается данные об авторизованном пользователе, в том числе токен. Информация передается в виде json-строки с IP-адреса брокера 172.18.191.41 с возможностью передачи другим устройствам, входящих в сеть. Подписаться к топику: mosquitto_sub -h 172.18.191.41-p 1883 -t "accounts/gdrive/token" |
| accounts/cameras/custom | 127.0.0.1 | Передача и прием информации о камерах со страницы сайта /recorder. Данные передаются при запуске сервера, а также при любом изменении камер (удаление, редактирование, добавление). Передача происходит в локальной сети устройства и с помощью программы sub-customCameras.sh принимается информация от брокера и создается файл custom_cams.json со списком камер в директории /home/user/ telecenter/Recorder/ . Подписаться к топику: mosquitto_sub -h 127.0.0.1 -p 1883 -t " accounts/cameras/custom" |
¶ 4 Описание работы с базой данных Erudite
Erudite - база комнат, оборудования, дисциплин и занятий в МИЭМе. Является модулем NVR, так как авторизация проходит через него. Erudite это более удобная и гибкая замена Google AdminSDK. Данный сервис построен на базе mongodb, где мы храним и манипулируем данными, которые нам нужны для использования другими сервисами.
Вся информация о камерах, которую используют модули АСБ, была перенесена из GSuite в базу данных Эрудит в таблицу equipment.Все файлы и программы, предназначенные для работы с базой данных представлены в директории /telecenter/core/db/:
Таблица 2. Файлы и программы для работы с БД Эрудит:
| Наименование файла | Вызов программы/чтение файла | Описание |
|---|---|---|
| from-db.рy | python3 from-db.рy | Программа предназначена для отправки GET-запроса на получение данных о камерах с базы данных Эрудит. Формируется или перезаписывается файл db-rooms.json с записанной туда информацией о камерах. |
| to-db.рy | python3 to-db.рy | Программа предназначена для отправки POST-запроса на добавление в БД Эрудит всех камер, описанных в файле rooms.json. До отправки данных программа с помощью библиотеки onvif получает данные о профилях и RTSP-протоколах камеры. Занесенные ранее в базу данных устройства повторно не создаются в таблице. |
| rooms.json | cat rooms.json | В файле хранятся данные об актуальных устройствах (находящихся в сети) в формате JSON с указанием IP-адреса, порта и типа устройства. Устройства отсортированы по названиям комнат. |
| db-rooms.json | cat db-rooms.json | Сформированный программой from-db.рy JSON-файл с информацией об устройствах из базы данных Эрудит. Все устройства отсортированы по названиям комнат. |
Пример файла rooms.json :
{ "00А": [ { "ip": "172.18.200.54", "port": 80, "type": "ONVIFCam" }, { "ip": "172.18.200.55", "port": 80, "type": "ONVIFCam" } ], "505": [ { "ip": "172.18.200.56", "port": 80, "type": "ONVIFCam" } ] }
Пример файла db-rooms.json :
{ "520": { "cameras": [ { "name": "Camera_172.18.212.12", "type": "ONVIFCam", "room_name": "520", "room_id": "string", "ip": "172.18.212.12", "port": 80, "rtsp_main": "rtsp://172.18.212.12:554/Streaming/Channels/1", "mac": "58:04:CB:01:1F:2A", "rtsp_0": "rtsp://172.18.212.12:554/Streaming/Channels/1", "rtsp_1": "rtsp://172.18.212.12:554/Streaming/Channels/2", "id": "609d4b5c6d14a101d1f2bc8d" } ], "audio": [] } }