¶ 1. Сервер отчетности JasperReport Server
¶ 1.1. Требования к серверу
Для запуска сервера отчетности необходимо выполнение следующих условий:
- На сервере должен быть установлен пакет Docker и Docker-compose
- Минимальное кол-во vCPU: 1
- Минимальное кол-во RAM: 2 Гб
- СУБД PostgresSQL либо MySQL (по умолчанию используется PostgresSQL)
- Доступ к репозиторию registry.infsys.ru для скачивания докер-образа
¶ 1.2. Пуск сервера отчетности
¶ 1.2.1 Запуск докер-экземпляра
Для запуска докер-образа сервера отчетности необходимо задать следующие переменные
| DB_EXIST | true/false - подключение к новой или существующей БД |
| DB_TYPE | тип БД: postgres / mysql |
| DB_HOST | имя или адрес хоста БД |
| DB_PORT | порт СУБД |
| DB_USER | пользователь БД default postgres |
| DB_PASSWORD | пароль пользователя к БД default postgres |
| DB_NAME | имя БД (БД должна быть предварительно создана) |
| SMTP_HOST | почтовый хост для отсылки отчетов и уведомлений |
| SMTP_USERNAME | пользователь для подключения к почтовому серверу |
| SMTP_PASSWORD | пароль пользователя |
| SMTP_PROTOCOL | протокол default smtp |
| SMTP_PORT | порт почтовой отправки default 25 |
| SMTP_FROM | адрес от имени которого будут приходить письма default example@domain.com |
Пуск докер сервера осуществляется следующим образом:
- Подключитесь в репозиторию
docker login registry.infsys.ru - Если нет выхода в Инет, предварительно скачайте образ сервера отчетов
` docker pull registry.infsys.ru/iss/jasperserver71 - Запустите докер север
docker run -d --name jasperserver --env-file env.list -p 8080:8080 registry.infsys.ru/iss/jasperserver71
Файл env.list содержит все необходимые переменные
DB_EXIST=false
DB_TYPE=postgresql
DB_HOST=10.3.2.203
DB_PORT=5432
DB_USER=postgres
DB_PASSWORD=postgres
SMTP_HOST=mail.example.ru
SMTP_USERNAME=support@example.ru
SMTP_PASSWORD=password
SMTP_PROTOCOL=smtp
SMTP_PORT=25
SMTP_FROM=support@example.ru
Указано минимальное кол-во переменных для запуска. Если указать DB_EXIST=false, не требуется создавать БД, скрипт развертывания создает ее самостоятельно.
- Проверьте доступность сервера
URL http://${dockerHost}:8080/jasperserver
Лгогин/пароль: jasperadmin/jasperadmin
¶ 1.2.2. Запуск сервера отчетности в среде K8
- helm скрипт развертывания сервера отчетности доступен в репозитории registry.infsys.ru/stable
- Подключите репозиторий
helm repo add sem-next http://registry.infsys.ru/stable/
- выполните обновление скриптов helm
helm repo update - Внесите все необходимые параметры в файл переменных, либо используйте опцию --set
- Запустите сервер в K8
helm install <имя инстанса> [-f <имя файла yaml >] sem-next/jasper -n <имя namespace>
, где
- <имя инстанса> - любое имя. имя инстанса будет участвовать в формирвоании имен Pod-ов b services
- <имя файла yaml > - путь к файлу с начальными значениями
- sem-next - репозиторий, предварительно подключенный (см. описание на первой странице проекта)
- jasper - имя пакета
Пример:
helm install report sem-next/jasper -n inspark
При изменении начальных значений необхдимо провести upgrade инстанса:
helm upgrade <имя инстанса> [-f <имя файла yaml >] sem-next/jasper -n <имя namespace>
Удаление инстанса выполняется командой:
helm uninstall <имя инстанса> -n <имя namespace>
¶ 1.3. Настройка сервера платформы для работы с Jasper Server
- В файле настройке sem-mext.xml в секции SSOToke параметр enabled = true
<SSOToken description="Создание SSO токена semona для доверительной авторизации пользователей semona
в своих системах">
<enabled description="Если true - токен sso создается">
true
</enabled>
- В конфигурационном файле proxy сервера должна быть секция проксирования на сервер jasperreport
location /jasperserver {
proxy_pass http://localhost:8088;
proxy_set_header Host $host;
proxy_set_header X-Forwarded-For $host;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_set_header X-Real_IP $remote_addr;
}
- убедиться, что:
underscores_in_headers on;
¶ 1.4. Конфигурирование сервера
- Войти в консоль администрирования Jasperserver http://<сервер>/jasperserver/
- В меню
Manage-Server Settings – Server Attributesсоздать атрибуты (для подключения к postgresql сервера платформы):
- host – задать адрес сервера БД платформы (localhost, в случае локально установленной БД)
- port – задать порт сервера БД платформы
- user – пользователь БД платформы
- password – пароль пользователя БД платформы (установить флаг Encrypted).
- semdb - имя БД платформы
- Импортировать дистрибутив-шаблоны отчетов «reports.zip» (поставка отчетов), используя меню
Manage-Server Settings - Import
¶ 1.5 Настройка уведомлений и рассылок сервера отчетности
*в работе *
¶ 1.6 Настройка расписания рассылок отчетов
-
Зайти в веб-консоль управления JasperServer, администратором сервера отчетов jasperadmin, перейдя по адресу:
http://HOSTNAME/jasperserver -
Для удобства рекомендуется заранее создать папку в которой будут хранится уже сформированные отчеты для рассылки. Для этого делаем правый клик на папке с отчетами и «Добавить папку»
-
Задать имя папки, например «Рассылка»
-
Выбрать интересующий отчет. Отчеты, позволяющие задавать смещение от даты запуска (для гибкого определения той даты, на которую будет строится выбранный отчет), находятся в папке Admin. К данной папке доступ есть только у jasperadmin. Необходимо выполнять настройку запуска имеющихся в ней отчетов по расписанию под этим логином.
-
Правым кликом переходим в раздел расписание
-
Создать расписание
-
Определить дату и время рассылки отчета
-
В поле «Рецидив: Тип повторения: Календарь» или «Простой» (вместо «ни какой»)для выбрать интересующей частоты рассылки по дням, месяцам и времени
-
Перейти на вкладку «Параметры»
-
Задать «Задание параметров пользователем?» - в значение false, «Название компании для отчетов по расписанию» установить имя компании для которой создается расписание, «Рубрика для расписания» или «Объект для расписания» - установить параметр из списка с учетом того, что система при установке параметров в данном поле не контролирует принадлежность объекта или рубрики к компании (если установить параметр не пренадлежайщий компании отчет будет пустым), «Смещение от текущей даты». В поле «Смещение от текущей даты» необходимо определить дату, на которую будет строится выбранный отчет (указанная дата в отчет не включается). Вместо конкретной даты нужно указать смещение от текущей даты (в случае запуска по расписанию - текущая дата будет установленное время запуска отчета по расписанию) в виде DAY-N, WEEK-N, MONTH-N, QUARTER-N, SEMI-N, YEAR-N -N (где - это смещение назад, + смещение вперед, N количество периодов на которое необходимо сместить период отчета, например DAY-1, окончание периода отчета вчера), также должны быть заданы специальные параметры отчета например «Потребление» и «Число расчетного периода», их задание аналогична параметризации отчета пользователем в ручном режиме.
Например, 15.09.2020 формируется отчет. В поле «Смещение от текущей даты» введено DAY-15. В итоге будет построен отчет за август (с 1 по 31 августа, 2020г.)
- На вкладке «Параметры вывода» задать имя файла, описание, выходной язык, формат файла.
- Также на вкладке «Параметры вывода», чуть ниже, в «Выходное значение» «вывести в репозиторий» задать через «Обзор…» путь к папке, созданной в п.2(«Рассылка»)
- На вкладке «Уведомления» задать параметры рассылки: почтовые адреса, тему, сообщение и пр.
Также дополнительно можно задать параметры почтового уведомления для уведомления о статусе задания: «уведомление об успехе», «уведомление об ошибке»,«Включить информацию о работе отчета», «Включить трассировку стека» - После выполнения всех настроек сохраняем задание и задаем его имя и описание
- Убеждаемся, что задание сформировалось и помечено как «Включено»
¶ 1.7 Проверка интеграции
- Зайдите любым пользователем в платформу
- в разделе Объекты встать на Рубрику или любой Объект
- по правой клавише мыши выбрать любой отчет из меню
- должен произойти переход на отчет сервера jasperserver без запроса дополнительного пароля.
¶ 2. Картографический сервер
¶ 2.1. Требования к серверу
- Минимальные параметры для сервера картографии:
HHD: 200GB
vCPU: 8
RAM: 16GB - Допускается виртуальный сервер, рекомендуется HDD использовать «быстрые» диски, например SSD.
- На сервере предварительно должен быть установлен пакет Docker
- сайт DockerHub.com должен быть доступен. В противном случае предварительно необходимо выполнить экспорт докера overv/openstreetmap-tile-server с https://hub.docker.com/r/overv/openstreetmap-tile-server
¶ 2.3. Инструкция по развертыванию
- Скачать карты. Ниже в п.2.5 приведены ссылки на карты регионов РФ.
- Создать тома для карт
docker volume create openstreetmap-data
docker volume create openstreetmap-rendered-tiles
В случае использования отдельного тома для размещения докер-файлов необходимо в файле /lib/systemd/system/docker.service задать новый путь:
# Old - taken from the generated docker.service file in Ubuntu 16.04's docker.io package
ExecStart=/usr/bin/dockerd -H fd:// $DOCKER_OPTS
# New
ExecStart=/usr/bin/dockerd --data-root /new_location/ -H fd:// $DOCKER_OPTS
Перезапустить демон докера. В случае необходимости перенести данные из /var/lib/docker/ в новую локацию
- Выполнить импорт карт в докер контейнер OpenStreetMap
Для всей России рекомендуем использовать:
docker run \
-v /home/sem/russia-latest.osm.pbf:/data.osm.pbf \
-v openstreetmap-nodes:/nodes \
-v openstreetmap-data:/var/lib/postgresql/12/main \
-v openstreetmap-rendered-tiles:/var/lib/mod_tile \
-e "OSM2PGSQL_EXTRA_ARGS=--flat-nodes /nodes/flat_nodes.bin" \
overv/openstreetmap-tile-server \
import
Для регионов (на примере Калининграда):
docker run \
-v /home/sem/kaliningrad-latest.osm.pbf:/data.osm.pbf \
-v openstreetmap-rendered-tiles:/var/lib/mod_tile \
-v openstreetmap-data:/var/lib/postgresql/12/main \
overv/openstreetmap-tile-server \
import
- Запустить докер контейнер OpenStreetMap
docker run \
-p 8080:80 \
-e THREADS=16 \
-e "OSM2PGSQL_EXTRA_ARGS=-C 8192" \
-e AUTOVACUUM=off \
-e ALLOW_CORS=enabled \
-v openstreetmap-data:/var/lib/postgresql/12/main \
-v openstreetmap-rendered-tiles:/var/lib/mod_tile \
-d overv/openstreetmap-tile-server \
run
Производительность сервера зависит от количества нитей (THREADS) и кэша для рендера (OSM2PGSQL_EXTRA_ARGS). Текущие настройки исходят из предположения 2 нити на vCPU и 50% кэша от RAM. Но, эти параметры могут иметь сильную зависимость от скорости дисков.
При первом запуске потребуется довольно много времени, чтобы отрендерить большие плитки.
- Проверка: Карта доступна по адресу: http://localhost:8080
¶ 2.4. Подключение картографического сервера к Inspark PlatformIoT
В случае успешного выполнения инструкции по установке сервера картографии, выполните его подключение к платформе. Для этого в файле /etc/nginx/sites-enabled/semona.conf nginx сервера модуля proxy необходимо выполнить следующие изменения:
location /tiles {
if (!-f $request_filename) {
rewrite ^(\/tiles\/)(.*)_(.*) $scheme://<server>:<port>/tile/$2/$3 last;
break;
}
}
где,
server - адрес или dns имя картографического сервера,
port - порт, по которому доступен сервер картографии
Если в файле semona.conf уже была секция location /tiles , ее следует изменить на описанную выше.
Секциейif {}поддерживается обратная совместимость с решением, когда нет сервера картографии, но есть файлы. В этом случае файлы с tile-картами загрузятся с диска в уникальном формате (_). Если есть сервер картографии, то рекомендуется убрать секцию if.
В инструкции выше приведен пример развертывания сервера с доступом по порту 8080. Ниже приведен пример кофигурации для сервера картографии с именем osm-server:
location /tiles {
if (!-f $request_filename) {
rewrite ^(\/tiles\/)(.*)_(.*) $scheme://osm-server:8080/tile/$2/$3 last;
break;
}
}
¶ 2.5. Ссылки на Карты
Ниже приведены ссылки на карты регионов РФ
Файлы c картой всей России:
http://download.geofabrik.de/russia-latest.osm.pbf
Файлы с картами регионов(http://download.geofabrik.de/russia.html):
Центральный федеральный округ:
http://download.geofabrik.de/russia/central-fed-district-latest.osm.pbf
Крымский федеральный округ:
http://download.geofabrik.de/russia/crimean-fed-district-latest.osm.pbf
Дальневосточный федеральный округ:
http://download.geofabrik.de/russia/far-eastern-fed-district-latest.osm.pbf
Северо-Кавказский федеральный округ:
http://download.geofabrik.de/russia/north-caucasus-fed-district-latest.osm.pbf
Северо-Западный федеральный округ:
http://download.geofabrik.de/russia/northwestern-fed-district-latest.osm.pbf
Сибирский федеральный округ:
http://download.geofabrik.de/russia/siberian-fed-district-latest.osm.pbf
Южный федеральный округ:
http://download.geofabrik.de/russia/south-fed-district-latest.osm.pbf
Уральский федеральный округ:
http://download.geofabrik.de/russia/ural-fed-district-latest.osm.pbf
Приволжский федеральный округ:
http://download.geofabrik.de/russia/volga-fed-district-latest.osm.pbf
Калининградска область:
http://download.geofabrik.de/russia/kaliningrad-latest.osm.pbf
¶ 3. Модуль прогноза погоды
Модуль прогноза погоды представляет собой отдельный серверный компонент, который устанавливается в отдельном экземпляре сервера приложений. Этот компонент эмулирует поведение метеодатчиков с использованием внешнего сервиса погоды. На стороне ядра платформы реализован виртуальное метеоустройство (метео-контроллер), который запрашивает погоду у модуля прогноза.
¶ 3.1. Требования к модулю погоды
- На сервере должен быть установлен пакет Docker и Docker-compose
- Минимальное кол-во vCPU: 0,5
- Минимальное кол-во RAM: 256 Мб
- Должен быть доступен провайдер погоды в сети Интернет
- Должен быть достпен реестр докеров registry.infsys.ru
¶ 3.2. Инструкция по развертыванию
¶ 3.2.1. Запуск докер-экземпляра
Пуск докер сервера осуществляется следующим образом:
- Подключитесь в репозиторию
docker login registry.infsys.ru - Если нет выхода в Инет, предварительно скачайте образ сервера отчетов
` docker pull registry.infsys.ru/iss/weather - Запустите докер север
docker run -d --name weather -p 8080:8080 registry.infsys.ru/iss/weather
¶ 3.2.2. Запуск сервера отчетности в среде K8
- helm скрипт развертывания сервера отчетности доступен в репозитории registry.infsys.ru/stable
- Подключите репозиторий
helm repo add sem-next http://registry.infsys.ru/stable/
-
выполните обновление скриптов helm
helm repo update -
Внесите все необходимые параметры в файл переменных, либо используйте опцию --set
| Параметр | Значение в value.yaml | Коммментарии |
|----------|-----------------------|--------------|
| images.repository| registry.infsys.ru/iss/weather| образ weather |
| images.tag | latest | тег для контейнеров |
| images.pullPolicy | Always | иногда полезно ставить Always, не всегда измененные контейнеры имеют новый тег
|
| service.port | 8080 | порт http для обращения клиентов к weather|
| providers| openweathermap | В текущей версии используется только провайдер погоды openweathermap. Для этого провайдера можно внести любое кол-во AppID, по которым сервис будет запрашивать погоду |
| max-requests-per-minute | 58 | максимальное количество запросов в минуту к провайдеру | -
Запустите сервер в K8
helm install <имя инстанса> [-f <имя файла yaml >] sem-next/weather -n <имя namespace>
, где
- <имя инстанса> - любое имя. имя инстанса будет участвовать в формирвоании имен Pod-ов b services
- <имя файла yaml > - путь к файлу с начальными значениями
- sem-next - репозиторий, предварительно подключенный (см. описание на первой странице проекта)
- weather - имя пакета
Пример:
helm install oras sem-next/weather -n inspark
При изменении начальных значений необхдимо провести upgrade инстанса:
helm upgrade <имя инстанса> [-f <имя файла yaml >] sem-next/weather -n <имя namespace>
Удаление инстанса выполняется командой:
helm uninstall <имя инстанса> -n <имя namespace>
¶ 3.3. Настройка платформы для работы с модулем погоды
Для запуска модуля прогноза погоды, в конфигурационном файле sem-next.xml пропишите секцию запуска приложений при старте сервера приложений:
<weather>
<uri>http://127.0.0.1:8085/weather/api</uri>
</weather>
В секции настройки указывается TCP/IP адрес хоста, где запускается модуль погоды. Если модуль погоды запускается для конкретного инстанса платформы, вместе с остальными модулями ядра, то указывается адрес основного хоста.
¶ 4. MS Active Directory интеграция
Настройка на MS AD осуществляется в конфигурационном файле sem-next.xml для варианта отдельного сервиса приложений, либо в настройках переменных yaml файла при развертывании сервисов платформы в k8.
¶ 4.1. Настройки sem-next.xml (вариант выделенного сервера)
- Основная секция настройки находится в разделе ActiveDirectory
<ActiveDirectory description="Определяет параметры подключения к Microsoft Active Directory">
<enabled description="Разрешена авторизация в MS AD">true</enabled>
<order description="0 - авторизации в MS AD, при неуспехе в InsparkIoT или 1 - авторизации в InsparkIoT, при неуспехе в MS AD">1
</order>
<url description="адрес подключения к MS AD">ldap://XX.XX.XX.XX:389</url>
<searchBase description="Вершина каталога от которой искать пользователей">
dc=portal,dc=cbr,dc=ru
</searchBase>
<user description="Пользователь для подключения к MS AD">
cn=melkartsync,cn=Users,dc=portal,dc=cbr,dc=ru
</user>
<password description="Пароль пользователя">****</password>
<principalSuffix description="Суффикс домена пользователя, если AD требует полного указания имени
пользователя.">@example_dns.com</principalSuffix>
</ActiveDirectory>
- Секция
<order description>определяет порядок авторизации пользователя. Поддерживается вариант<MS AD- InsparkIoT>, в этом случае пользователь авторизуется сначала в MS AD и при неуспехе в InsparkIoT, и обратный вариант<InsparkIoT - MS AD>. principalSuffixобязательно указывать для всех версий MS AD.- При
order 0 /orderатрибуты пользователя синхронизируются со следующими полями в MS AD:
| Атрибут | Поле InsparkIoT | Поле MS AD |
|---|---|---|
| login | Логин пользователя | sAMAccountName |
| firstname | Имя пользователя | givenName |
| lastname | Фамилия пользователя | sn |
| post | Должность | title |
| phone | Телефоны | telephoneNumber |
| Адрес электронной | ||
| state | Состояние | msDS-UserAccountDisabled |
| ilocale | Локаль | preferredLanguage |
| comment | Заметки о пользователе | displayName |
- При создании пользователя в InsparkIoT, при настроенной интеграции, производится поиск пользователя в MS AD. Если пользователь найден в MS AD, создается пользователь в InsparkIoT с атрибутами из MS AD (см. выше). Если в дереве MS AD не поддерживается уникальность login, то следует указывать имя пользователя с учетом principalSuffix, например:
user_login@xx.exammple.com - При интеграции, обновление пароля в InsparkIoT не поддерживается.
- Редактирование атрибутов пользователя работает только для тех атрибутов, которые не соответствуют атрибутам MS AD.
¶ 4.2. Настройка интеграции для варианта K8
В случае развертывания платформы в среде K8 , интеграци настраивается с помощью переменных файла yaml.
В стартовом файле value.yaml применены следующие значения переменных:
## 5. Настроить переменные приложения
## AD переменные
activedirectory:
enabled: false
url: ""
search_base: ""
## Вершина каталога от которой искать пользователей
user: ""
password: ""
suffix: ""
## Суффикс домена пользователя, не задавать если для входа будет использоваться полное
# имя входа (userPrincipalName ), в противном случаи задавать домен или его часть учетной записи пользователей.
# Например, для аутентификации пользователей из домена infsys.ru, чтобы пользователи вводили только имя входа, необходимо задать @infsys.ru.
# Например, для аутентификации пользователя в лесу Active Directiry из portal.cbr.ru и vip.cbr.ru, если searchBase задать dc=cbr,dc=ru
# и порт 3268, данный параметр необходимо задать .cbr.ru, тогда в качестве логина пользователя можно использовать часть userPrincipalName
# - semuser@portal, общая часть домена пользователя будет подставлена из параметра.
## включена ли отправка уведомлений
Значения переменных описано выше.
¶ 5. Модули видео-мониторинга AxxonSoft
¶ 5.1 Установка модулей
Для установки модулей на хосте требуется наличие JRE (от 8.x и выше). Также доступен docker-образ.
Для установки в качестве демона-Linux необходимо (приведен порядок действий для axxsonNet, для ПК-Интеллект порядок точно такой же):
- Создать директорию /opt/axon-gate и поместить в нее jar модуль, application.yml
mkdir /opt/axon-gate
cp axon-gate.jar /opt/axon-gate
cp application.yml /opt/axon-gate
- Создать директорию для логов:
mkdir -p /var/log/axon-gate
Настроить к ней путь в конфиге application.yml:
logging:
path: /var/log/axon-gate
- Создать символьную ссылку в директории /etc/init.d
cd /etc/init.d
chmod +x /opt/axon-gate/axon-gate.jar
ln -s /opt/axon-gate/axon-gate.jar axon-gate
- Перечитать списко сервисов linux
systemctl daemon-reload
- Запуск и остановку сервиса можно осуществлять стандартными командами, т.е.
service axon-gate start
service axon-gate status
service axon-gate stop
Запуск с командной строки:
java -jar <модуль>.jar
¶ 5.2 Модуль видеоаналитики с ПК «ИНТЕЛЛЕКТ»
Модуль обеспечивает:
- прием событий по web-socket от сервера ПК «Интеллект» (далее ПК-И);
- получение медиа-контента, который связан с событиями;
- запрос в архиве кадра и ролика, связанный с событием;
- парсинг события для получения значения сигнала платформы;
- он-лайн видео-поток;
- обработка событий от серверов распознавания лиц.
- В платформе InsparkIoT в разделе Устройства должно быть заведено устройство с типом
AXXSONSOFT_INTELLECT. У устройства обязательным параметром является параметр „connect“ - строковый параметр, остальные параметры необязательны и зависят от состава сигналов камер, которые будут обрабатываться.
В параметр
connectмодуль запишет строку http для получения он-лайн видео-потока.
-
В типовой конфигурации, в схеме подключения для камеры в поле
АДРЕСсхемы подключения необходимо указать ID камеры в ПК-И. -
В конфигурации модуля необходимо указать требуемые параметры подключения. Пример конфигурационного модуля указан ниже. В секции
events.refsуказываются значения для фильтрации потока событий, получаемый через web socket. В модуле интеграции поддерживается следующие атрибуты событий ПК-И:
- src_objecttype - значение соответсвует параметру intellectObject модуля ;
- src_action - значение соответсвует параметру intellectAction модуля;
- CAM_ID, SRC_OBJECT_ID - значение соответсвует параметру camIdAttr модуля;
- evasion - значение соответсвует параметру evasion модуля. Этот параметр используется для случаев идентификации лиц;
Для получения контента с серверов распознавания лиц, в секции face.servers небходимо указать их id и ссылки в ПК-И.
# tomcat port
server:
port: 8788
spring:
profiles:
active: prod
logging:
path: /var/log/itv-gate
level:
root: INFO
event-receiver: INFO
event-processor: INFO
cam-holder: INFO
url-builder: INFO
#
# адрес подключения к ПК-ИНТЕЛЛЕКТ
#
itv:
rest:
url: http://10.10.10.10:3111/
user: admin
password: admin
# урл прокси, должен заменить оригинальный урл видео в ссылках
proxy: https://example.ru/video/
http:
url: http://10.10.10.10:3140/
#
# Параметры подключения к серверам платформы
#
sem-next:
rest:
url: http://localhost:8080/sem-restservices/
user: root
password: xxxxxxx
artemis:
broker-url: tcp://localhost:61616
user: artemis-user
password: xxxxxxx
#
# тестовые посылки
#
emulator:
enabled: false
period: 30
events:
# задержка отправки в платформу, секунд
delay: 30
# сопоставление типов событий интеллект идентификаторам событий sem-next и каналам параметров
refs:
# события обнаружения людей без маски
-
# объект интеллект, значение атрибута src_objecttype
intellectObject: FIRSERVER
# действие события значение атрибута src_action
intellectAction: MASK_NOT_DETECTED
# normal = маска не надета
evasion: normal
# атрибут события для получения идентификатора камеры, поддерживаются CAM_ID, SRC_OBJECT_ID
camIdAttr: CAM_ID
# идентификатор события sem-next (event.id), может быть не задан если событие не требуется
semEventId: 5030
# шаблон текста события, поддерживаются подстановки
# $CAM - название камеры с идентификатором, прим CAM:43
# $ZONE - зона размещения камеры в sem-next
# $NAME - имя, $PATRONYMIC - отчество, $SURNAME - фамилия человека
# $DEPARTMENT - отдел
# $EMOTION - эмоция
# $ETHNICITY - рассовая принадлежность
# $GENDER - пол
# $PARAM0 - значение param0 из атрибутов события камер
# $SIMILARITY - точность распознавания, процентов
semEventMessageTemplate: $CAM - $ZONE, человек без маски $NAME $PATRONYMIC $SURNAME из $DEPARTMENT. Точность распознавания $SIMILARITY%.
# канал устройства sem-next, связанный с событием интеллект, для отправки значение
semChannel: detectMask
# значение, отправляемое в канал (значение или подстановка $LIVE_VIDEO)
value: 1
# бывает ли миниатюра для данного события на сервере распознавания лиц
face: true
-
intellectObject: FIRSERVER
intellectAction: MASK_NOT_RIGHT_PLACE
evasion: normal
camIdAttr: CAM_ID
semEventId: 5030
semEventMessageTemplate: $CAM - $ZONE, лицо не опознано
semChannel: detectMask
value: 1
face: true
# люди с неправильно надетой маской
-
intellectObject: FIRSERVER
intellectAction: MASK_NOT_DETECTED
evasion: mask_not_in_place
camIdAttr: CAM_ID
semEventId: 5029
semEventMessageTemplate: $CAM - $ZONE, человек без маски $NAME $PATRONYMIC $SURNAME из $DEPARTMENT. Точность распознавания $SIMILARITY%.
semChannel: detectMask
value: 1
face: true
-
intellectObject: FIRSERVER
intellectAction: MASK_NOT_RIGHT_PLACE
evasion: mask_not_in_place
camIdAttr: CAM_ID
semEventId: 5029
semEventMessageTemplate: $CAM - $ZONE, лицо не опознано
semChannel: detectMask
value: 1
face: true
# обнаружение человеков в комнате
-
intellectObject: _POSE_DETECTOR
intellectAction: ANY_POSE_ACTION
camIdAttr: SRC_OBJECT_ID
semEventId:
semEventMessageTemplate:
semChannel: noPeople
value: true
# возможность автоматического завершения события по таймеру
autoclose:
enabled: true
# задержка, секунд
delay: 300
# значение закрывающего измерения
value: false
# обнаружение скоплений людей
-
intellectObject: _POSE_DETECTOR
intellectAction: DISTANCE_DETECTOR_EVENT
camIdAttr: SRC_OBJECT_ID
semEventId: 5028
semEventMessageTemplate: $CAM - $ZONE
semChannel: detectGroup
value: 1
# встречи апликанта и студента
-
intellectObject: CAM
intellectAction: DEPARTMENT
camIdAttr: SRC_OBJECT_ID
semEventId: 5031
semEventMessageTemplate: $CAM - $ZONE, $PARAM0
semChannel: detectApproach
value: 1
# камера включена/выключена
-
intellectObject: CAM
intellectAction: ATTACH
camIdAttr: SRC_OBJECT_ID
semEventId:
semChannel: workState
value: true
-
intellectObject: CAM
intellectAction: DETACH
camIdAttr: SRC_OBJECT_ID
semEventId:
semChannel: workState
value: false
# стоит на охране/снята с охраны
-
intellectObject: CAM
intellectAction: ARM
camIdAttr: SRC_OBJECT_ID
semEventId:
semChannel: secureState
value: true
-
intellectObject: CAM
intellectAction: DISARM
camIdAttr: SRC_OBJECT_ID
semEventId:
semChannel: secureState
value: false
# идет ли запись
-
intellectObject: CAM
intellectAction: REC
camIdAttr: SRC_OBJECT_ID
semEventId:
semChannel: recordState
value: true
-
intellectObject: CAM
intellectAction: REC_STOP
camIdAttr: SRC_OBJECT_ID
semEventId:
semChannel: recordState
value: false
# сигнал тревоги
-
intellectObject: CAM
intellectAction: MD_START
camIdAttr: SRC_OBJECT_ID
semEventId:
semChannel: alarmState
value: true
-
intellectObject: CAM
intellectAction: MD_STOP
camIdAttr: SRC_OBJECT_ID
semEventId:
semChannel: alarmState
value: false
# серверы распознавания лиц
face:
servers:
-
id: 1
proxy: https://example.ru/face/
-
id: 2
proxy: https://example.ru/face2/
-
id: 3
proxy: https://example.ru/face3/
-
id: 4
proxy: https://example.ru/face4/
в конфигурационном файле значения semChannel и value соответсвуют названию параметров и их значениям в Устройстве платформы.
¶ 5.3 Модуль видеоаналитики с AxxsonNet
Модуль обеспечивает:
- прием событий AxxsonNet по web-socket (далее AxxsonNet);
- получение медиа-контента, который связан с событиями;
- запрос в архиве кадра и ролика, связанный с событием;
- парсинг события для получения значения сигнала платформы;
- он-лайн видео-поток;
- обработка событий от серверов распознавания лиц.
- В платформе InsparkIoT в разделе Устройства должно быть заведено устройство с типом
AXXSON_NEXT. У устройства обязательным параметром является параметр „connect“ - строковый параметр, остальные параметры необязательны и зависят от состава сигналов камер, которые будут обрабатываться.
В параметр
connectмодуль запишет строку http для получения он-лайн видео-потока.
-
В типовой конфигурации, в схеме подключения для камеры в поле
АДРЕСсхемы подключения необходимо указать ID камеры в ПК-И. -
В конфигурации модуля необходимо указать требуемые параметры подключения. Пример конфигурационного модуля указан ниже. В секции
events.refsуказываются значения для фильтрации потока событий, получаемый через web socket. В модуле интеграции поддерживается следующие атрибуты событий AxxonNet:
- event_type - значение соответсвует параметру events.refs.event_type модуля AxxonNet;
- type - значение соответсвует параметру events.refs.type модуля AxxonNet;
# tomcat port - значение порта не меняются
server:
port: 8789
servlet:
context-path: /axon
spring:
mvc:
# нужно для эмулятора
async:
request-timeout: -1
data:
rest:
# пагинация, кол-во страниц по умолчанию
default-page-size: 100
# dev | prod профили логирования
profiles:
active: prod
# сериализация Date в unix timestamp (см. https://github.com/FasterXML/jackson-databind/wiki/Serialization-Features)
jackson:
serialization:
write-dates-as-timestamps: true
# path to logs
logging:
path: logs
level:
root: INFO
receiver: INFO
emulator: INFO
event-processor: INFO
url-builder: INFO
# эмулятор, эмулирует события камер AxxonNet
emulator: false
axon:
websocket:
# урл подключения к вэбсокету, поставляющему события камер
# url: ws://183.16.4.20:8000/events
# URL эмулятора, его реализует это же приложение, для целей разработки
url: ws://localhost:8789/axon/emulator
# данные basic авторизации
user: root
password: root
rest:
url: http://183.16.4.20:8000/
user: root
password: root
# урл прокси, должен заменить оригинальный урл видео в ссылках
proxy: http://183.16.4.20:8000/
sem-next:
rest:
url: http://10.3.2.103/sem-restservices/
user: root
password: pass
artemis:
broker-url: tcp://10.4.2.58:61616
user: artemis
password: pass
event-import-queue: jms.queue.EventImport
measure-queue: jms.queue.Measure
events:
# задержка отправки в sem-next, секунд
delay: 10
# сопоставление типов событий axon событиям и каналам sem-next
refs:
-
# событие axon, значение атрибута event_type
event_type: EvasionDetected
# событие axon, значение атрибута type
type: detector_event
# идентификатор события sem-next (event.id), может быть не задан если событие не требуется
semEventId: 7509
# шаблон текста события, поддерживаются подстановки
# $CAM - название камеры (используется имя схемы подключения, DeviceConnect.name)
# $ZONE - зона размещения камеры в sem-next
semEventMessageTemplate: $CAM - $ZONE, человек без маски.
# канал устройства sem-next для отправки значения
semChannel: detectMask
# значение, отправляемое в канал
value: 1
# бывает ли миниатюра для данного события
face: true
¶ 6. Интеграция в Superset Apache
Интеграция обеспечивает SSO между Inspark IoT и Superset по протоколу OAuth.
Полное описание интеграции представлено в разделе Настрйока аналитического модуля.
¶ 7. Интеграция с сервисом Autodesk Forge
¶ 7.1 Ограничения, требования к интеграции
- Поддерживаются только модели в формате Autodesk Revit.
- В модели Revit должны быть указаны объекты платформы (датчики, параметры), в которых заполняются атрибуты согласно требованиям по подготовке модели для работы с платформой.
- Все модели обрабатыватся и хранятся в облачном сервисе AutoDesk Forge, доступ к которому имеет только компания Inspark.
- При длительном времени не использования модели, сервис Autodesk Forge может применить политики очистки хранилища от неиспользуемых моделей.
- Платформа Inspark не хранит Revit и обработанные модели 3D. На момент загрузки виджета Autodesk 3D, сервис Forge должен быть доступен для загрузки 3D модели.
¶ 7.2. Порядок подготовки модели revit
Для работы с 3D моделью в платформе Inspark необходимо использовать семейство устройств Inspark. Экземпляры из этого семейства размещаются в требуемых местах revit-модели в проекте.
Ссылки на файлы семейства (семейство и общие параметры): sem-revit-family.zip. Для подключения семейства к проекту revit, необходимо, чтобы файл семейства и его общие параметры находились в одной папке.
При расстановке в revit-модели устройств важно заполнить атрибуты, необходимые для отображения в платформе Inspark:
device_name– наименование устройстваcalcdeviceparam_id– id вычисляемых параметров устройства через запятуюcontrdeviceparam_id– id измеряемых параметров устройства через запятую.
Подготовленную revit-модель далее, с помощью сервисов магазина платформы Inspark отправляют на обработку в сервис Autodesk Forge. см. документацию Магазин.Forge
¶ 7.3. Подключение сервисов 3D сервиса Autodesk Revit к платформе
За подключение сервисов 3D в helm файле инстанса отвечает параметр forge
## интеграционные настройки для AutoDesk Forge плагина
forge:
enabled: true
forge_id: "develop"
где forge_id - имя папки хранилища Forge, которое использовано в магазине при загрузки модели.