...

Scroll Ignore

scroll-pdf	true
scroll-office	true
scroll-chm	true
scroll-docbook	true
scroll-eclipsehelp	true
scroll-epub	true
scroll-html	true

Версия платформы — 1.14

Оглавление

printable	false

Введение

Eltex Smart Control (далее Eltex SC) разработан для организации единой системы управления, конфигурирования и мониторинга устройств «интернета вещей» (датчиков, электросчетчиков, веб-камер и т.п.). Использование данной системы с графическим веб-интерфейсом и мобильным приложением позволяет:

Управлять учетными записями пользователей (добавление, изменение, удаление);
Осуществлять мониторинг состояния устройств умного дома;
Получать уведомления о событиях;
Создавать сценарии работы устройств в доме.

Установка и настройка сервера Eltex SC

Система «Eltex SC» строится по клиент-серверной архитектуре. Серверную часть рекомендуется устанавливать на многопроцессорный компьютер под управлением OS Ubuntu 16.

...

Установить сторонние пакеты:
Ubuntu Server 16

1. Установить программное обеспечение software-properties-common:
sudo apt-get install -y software-properties-common

2. Установить программное обеспечение openjdk-8-jre:
sudo apt-get install -y openjdk-8-jre

3. Установить программное обеспечение gnupg:
sudo apt-get install -y gnupg

4. Скачать ключ "server-4.0.asc" утилитой wget:
wget https://www.mongodb.org/static/pgp/server-4.0.asc

5. Применить ключ "server-4.0.asc":
sudo apt-key add server-4.0.asc

6. Создать в текстовом редакторе файл файл:
/etc/apt/sources.list.d/mongodb-org-4.0.list

7. Записать строчку в файл, сохранить файл:
deb [ arch=amd64 ] https://repo.mongodb.org/apt/ubuntu xenial/mongodb-org/4.0 multiverse

8. Обновить пакеты в системе:
sudo apt-get update

9. Установить пакет mongodb-org:
sudo apt-get install -y mongodb-org

10. Запустить сервис mongod:
sudo service mongod start

11. Установить программное обеспечение nginx:
sudo apt-get install -y nginx

Ubuntu Server 18

1. Установить программное обеспечение software-properties-common:
sudo apt-get install -y software-properties-common

2. Установить программное обеспечение openjdkобеспечение openjdk-8-jre:
sudo apt-get install -y openjdk-8-jre

3. Установить программное обеспечение gnupg:
sudo apt-get install -y gnupg

4. Скачать ключ "server-4.0.asc" утилитой wget:
wget httpswget https://www.mongodb.org/static/pgp/server-4.0.asc

5. Применить ключ "server-4.0.asc":
sudo apt-key add server-4.0.asc

6. Создать в текстовом редакторе файл :
/etc/apt/sources.list.d/mongodb-org-4.0.list

7. Записать строчку в файл, сохранить файл:
deb [ arch=amd64 ] https://repo.mongodb.org/apt/ubuntu bionicubuntu bionic/mongodb-org/4.0 multiverse

8. Обновить пакеты в системе:
sudo apt-get update

9. Установить пакет mongodb-org:
sudo apt-get install -y mongodb-org

10. Запустить сервис mongod:
sudo service mongod start

11. Установить программное обеспечение nginx:
sudo apt-get install -y nginx
Скачать и установить пакеты платформы в указанном порядке:
Примечание
Получение пакетов осуществляется через коммерческий отдел.
sudo dpkg -i
Пакет eltex-notification-gw_1.12.xx_all.deb (вместо хх указывается актуальная версия)
Блок кода
title Установка
, установка осуществляется командой:
sudo dpkg -i eltex-notification-gw_1.12.xx_all.deb
dpkg -i

Пакет eltex-sc_1.14-xxx_all.deb (вместо ххх указывается актуальная версия)
Блок кода
title Установка
sudo
, установка осуществляется командой:
sudo dpkg -i eltex-sc_1.14-xxx_all.deb

Пакет eltex-sc-web_1.14-xxx_all.deb (вместо ххх указывается актуальная версия)
Блок кода
title Установка
sudo dpkg -i
, установка осуществляется командой:
sudo dpkg -i eltex-sc-web_1.14-xxx_all.deb

В процессе установки пакета eltex-sc-web_1.14-xxx_all.deb потребуется указать порт для доступа по http и https (по умолчанию 8074 и 8075):

...

По окончании установки будет запущен демон eltex-sc. Проверить его состояние можно командой:

...

service

...

eltex-sc

...

status

Результат должен быть следующим:

...

Конфигурация сервера: /etc/eltex-sc/server.yml

Scroll Pagebreak

Содержимое конфигурационного файла:

...

Блок кода

hz:
  instance:
    name: iot-core-hz-instance
  group:
    name: iot-core
    password: '11111'
  network:
    port: '5705'

mjollnir:
  sync-period: 0 0 23 1/1 * ?
  login: platform
  password: platform
  url: http://smart.eltex-co.ru:8078/api/v1

iot-core:
  host: localhost
  port: 27017
  user: ''
  password: ''
  database: iot-core

file-storage:
  host: localhost
  port: 27017
  user: ''
  password: ''
  database: iot-fs

Блок кода



license-storage:
  host: localhost
  port: 27017
  user: ''
  password: ''
  database: iot-licenses

eventlog:
  host: localhost
  port: 27017
  user: ''
  password: ''
  database: iot-events

monitoring-system:
  countAttempt: 3
  delayAttempt: 0

kafka:
  bootstrap-servers: localhost:9092
  enabled: false

Блок кода

video:
  flussonic:
    ip: <IP-адрес:порт>
  ivideon:
    client_id: <уникальное значение>
    client_secret: <уникальное значение>
ssl:
  key: /etc/ssl/private/eltex-sc-api.key
  crt: /etc/ssl/certs/eltex-sc-api.crt

...

Во всех случаях, чтобы войти в платформу, нужно указать ее адрес и номер порта. В общем случае в адресную строку браузера вводится следующее: <Адрес сервера Eltex-SC>:8074. Например: smart.eltex-co.ru:8074.

Проверка работоспособности платформы

Резервное копирование данных

Резервные копии баз данных (далее БД) расположены в следующих директориях:

...

При необходимости скрипт для создания резервных копий может быть запущен вручную из терминала с помощью командной оболочки:

...

sh

...

/etc/cron.daily/iot-backupdb

Для восстановления любой базы данных из резервной копии требуется:

Распаковать архив с БД;
Остановить сервис eltex-sc, если он запущен:
Блок кода
sudo

service

eltex-sc

stop
Выполнить команду:
Блок кода
sudo

mongorestore

-d

<имя

БД>

<путь

до

самой

последней

директории

из

архива>
Запустить сервис eltex-sc:
Блок кода
sudo

service

eltex-sc

start

Директория хранения журналов работы платформы: /var/log/eltex-sc/

Файлы разбиваются на части по размеру. Каждая часть сохраняется в файл с именем: server-YYYY-MM-DD.NN.log, где YYYY-MM-DD – дата, а NN – номер части.

Scroll Pagebreak

Чеклист

Проверить занятость ядер процессора и оперативной памяти

...

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

Интерфейс администратора

Интерфейс администратора служит для управления учетными записями пользователей (создание, редактирование, удаление), получения информации о подключенных к платформе контроллерах Умного дома и помощи в настройке оборудования у пользователей.

...

После входа появляется интерфейс учетной записи администратора.

Управление учетными записями

Создание

Чтобы создать учетную запись для нового пользователя, нужно нажать кнопку Добавить нового абонента. После этого откроется форма для заполнения данных о новом пользователе.

...

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

Редактирование

В процессе эксплуатации платформы может возникнуть необходимость в изменении данных учетных записей. Для начала требуется найти необходимую учетную запись в списке на домашней странице интерфейса. Для этого можно воспользоваться поиском по номеру договора, ФИО или номеру телефона абонента. Когда запись найдена, выбираем её и переходим в режим редактирования.

...

Информация

title	Важно!

На платформе реализовано каскадное удаление сущностей. Если удалить учетную запись, с которой связан дом, то он будет также удален вместе со всеми зарегистрированными в нем устройствами.

Журнал событий

Чтобы увидеть действия администратора, нужно в меню слева выбрать вкладку Журнал.

...

Справа от списка событий находится календарь, с помощью которого можно быстро перейти к событиям в предыдущие дни. Дни, в которые происходили какие-либо события, и есть записи в журнале, выделены серым.

Список контроллеров

Во вкладке меню Контроллеры можно посмотреть, какие контроллеры зарегистрированы в платформе, подключены или недоступны.

...

Для поиска контроллера по его параметрам нужно ввести интересующее значение в соответствующее поле и нажать Применить фильтр.

Сценарии для устройств

На вкладке Шаблоны сценариев представлен список сценариев для подключаемых к дому устройств.

...

После этого подтвердите удаление во всплывающем окне.

Лицензии

Время использования платформы и количество добавляемых устройств ограничивается типом лицензии, которая приобретается заказчиком.

Описание работы модуля лицензий

Заказчик передает файл лицензии администратору платформы Eltex SC.
Администратор заходит под своей учетной записью и в левом боковом меню выбирает вкладку Лицензии. Платформа переходит на страницу добавления лицензий.
Администратор нажимает Добавить лицензию и загружает полученный от пользователя файл в открывшемся окне загрузки.
Загруженный файл лицензии проходит этап верификации на сервере лицензий: при загрузке лицензии отправляется запрос на сервер лицензий для её валидации (подтверждения). Проверяется корректность лицензии, её срок, тип и другие параметры. После загрузки лицензия переходит в активированный режим.
При удачном прохождении валидации отображается статус Лицензия действительна. В противном случае отображается статус Лицензия не действительна.

...

Информация

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

Обновление ПО (прошивки)

Данный функционал позволяет обновлять программное обеспечение на подключенных к платформе устройствах. При нажатии вкладки Прошивки платформа переходит на страницу обновления прошивок в раздел Планировщик.

...

Более детально эти действия описаны ниже.

Scroll Pagebreak

Добавление группы

В выпадающем списке Администрирование выберите раздел Группы и на появившейся странице нажмите кнопку Добавить группу. Появляется форма для создания группы. Данный функционал позволяет объединять устройства по некоторым параметрам и в дальнейшем работать именно со сделанной выборкой устройств.

Выберите соответствующий тип прошивки в зависимости от того, на каком устройстве необходимо обновить ПО. На данный момент доступны типы: Прошивка RG35 и Прошивка ZWay устройства. По умолчанию выбран тип Прошивка RG35 и поиск по адресу дома.

Информация
В процессе разработки находится функционал динамического поиска, который позволит искать устройства по их IP/MAC-адресам и другим параметрам.

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

Информация
Поле поиска чувствительно к регистру, поэтому будьте внимательны при вводе адреса.

После заполнения полей и нажатия иконки поиска (или клавиши Enter) появляются результаты поиска. Для сохранения результатов следует установить флаг напротив соответствующего контроллера и нажать Сохранить.

Информация
В случае, когда к одному дому привязано несколько контроллеров, в результатах поиска отобразятся все. Отметьте флажком те устройства, которые необходимо объединить в группу.

При выборе вкладки Прошивка ZWay устройства появляется идентичная форма поиска. Создание группы осуществляется таким же способом, но в поиске отображаются лишь те устройства, статус которых "online".

После сохранения в разделе Группы появляется строка созданной группы с введенным ранее названием.

Информация
Функционал редактирования и удаления групп находится в процессе разработки.

Scroll Pagebreak

Добавление правила

В выпадающем списке Администрирование выберите раздел Правила и нажмите кнопку Добавить правило. Появится форма для создания правила:
Заполните поле Имя правила, из выпадающего списка выберите соответствующий тип прошивки (в данном примере выбран тип Прошивка RG35). После нажатия кнопки Файл прошивки появляется окно, в котором нужно выбрать файл прошивки и нажать Ок. Теперь имя файла отображается справа от кнопки, но он ещё не загружен. Загрузка начнется после нажатия кнопки Загрузить. В случае удачной загрузки появится подтверждающая надпись.
Чтобы сохранить правило, нажмите кнопку Сохранить. Для закрытия формы без сохранения достаточно кликнуть вне её области или нажать Esc.
Scroll Pagebreak

При выборе типа Прошивка ZWay устройства форма не меняется. Создание правила осуществляется таким же способом.
После сохранения в разделе Правила появляется строка созданного правила с введённым ранее названием и именем прикреплённого файла.

Информация
Функционал редактирования и удаления правил находится в процессе разработки.

Добавление задачи

Для упорядочивания выполнения обновлений на устройствах применяется планировщик событий.

В выпадающем списке Администрирование выберите раздел Планировщик или нажмите на иконку .
На появившейся странице нажмите кнопку Добавить задачу.Появится форма для создания задачи:
Заполните поле Название задачи, соответствующий Тип задачи выберите из выпадающего списка. Для контроллеров — Прошивка RG35 (в данном примере выбран именно этот тип), для ZWay устройств — Прошивка Устройств (OTA).
Следующим шагом является выбор времени запуска. В случае Немедленного запуска задачи выполнение начнется через 10 секунд после добавления задачи. Для отложенного старта в поле Настройка времени запуска откройте календарь, выберите дату и время запуска.
В настройках задачи выберите ранее созданные правило и группу.

Информация
Правила и группы в пункте Настройки задачи отфильтровываются по типу задачи.

Чтобы сохранить задачу, нажмите кнопку Сохранить. Для закрытия формы без сохранения достаточно кликнуть вне её области или нажать Esc.

При выборе типа задачи Прошивка Устройств (OTA) форма не меняется. Создание задачи осуществляется таким же способом.
После сохранения в разделе Планировщик появляется строка созданной задачи. Задача находится в статусе Ожидает.

Информация
Параметр Статус относится только к планировщику, показывая состояние запуска задачи, т.е. он не является показателем того, удачно закончилось обновление или нет.

Запуск задачи

Когда наступает время старта (или истекает 10 секунд в случае немедленного запуска), задача запускается. При этом статус меняется на Успешно, в колонке Время старта отображается время запуска, а в колонке Действия появляется иконка .

...

Информация
Для отслеживания выполнения шагов дочерней задачи следует обновлять страницу. Функционал проверки в реальном времени находится в процессе разработки.

Повторная авторизация

Страница обновления прошивок может потребовать повторную авторизацию при следующих условиях:

...

Дерево страниц

Сравнение версий

Старая версия 6

Новая версия Текущий

Ключ

Введение

Установка и настройка сервера Eltex SC

Проверка работоспособности платформы

Резервное копирование данных

Чеклист

Интерфейс администратора

Управление учетными записями

Создание

Редактирование

Журнал событий

Список контроллеров

Сценарии для устройств

Лицензии

Описание работы модуля лицензий

Обновление ПО (прошивки)

Добавление группы

Scroll Pagebreak

Добавление правила

Добавление задачи

Запуск задачи

Повторная авторизация

Дерево страниц

История страницы

Сравнение версий

Старая версия 6

Новая версия Текущий

Ключ

Введение

Установка и настройка сервера Eltex SC

Проверка работоспособности платформы

Резервное копирование данных

Чеклист

Интерфейс администратора

Управление учетными записями

Создание

Редактирование

Журнал событий

Список контроллеров

Сценарии для устройств

Лицензии

Описание работы модуля лицензий

Обновление ПО (прошивки)

Добавление группы

Scroll Pagebreak

Добавление правила

Добавление задачи

Запуск задачи

Повторная авторизация