QUICK START
Быстрая установка платформы ELTEX SC
Версия ПО 1.21
Минимальные системные требования
Платформа Eltex SC (Eltex Smart Control) разработана для организации единой системы управления, конфигурирования и мониторинга устройств Интернета вещей (датчиков, электросчетчиков, web-камер и т.п.). Использование данной системы с графическим web-интерфейсом и мобильным приложением позволяет:
- управлять учетными записями пользователей (добавление, изменение, удаление);
- осуществлять мониторинг состояния устройств Умного дома;
- получать уведомления о событиях;
- создавать сценарии работы устройств в доме.
Минимальные системные требования сервера:
- число аппаратных серверов — 1;
- процессор — i5 3,0 ГГц;
- оперативная память — 8 ГБ;
- место на диске — 1000 ГБ.
Установка платформы Eltex SC
Поддерживаемые дистрибутивы: Ubuntu 20.04.
Внимание!
Установка Eltex SC на сервер, не отвечающий минимальным системным требованиям, ведет к неработоспособности платформы!
С версии 1.19.4 установка через deb-пакеты не осуществляется.
В инструкции приведена установка платформы Eltex SC на операционную систему Ubuntu 20.04. Информацию по установке более ранних версий платформы Eltex SC (1.19.4 и ниже) можно найти по ссылке: Архив Eltex SC.
Перед развертыванием необходимо установить Ansible и необходимые для его работы компоненты.
Рекомендуется устанавливать Ansible из официального репозитория проекта.
Ansible — система управления конфигурациями, написанная на языке программирования Python, с использованием декларативного языка разметки для описания конфигураций.
Используется для автоматизации настройки и развертывания программного обеспечения и в частности для ПО Eltex SC.
1. Установите Ansible на сервер Ubuntu 20.04 (server). Пример установки в консоли:
apt update apt install software-properties-common add-apt-repository --yes --update ppa:ansible/ansible apt install ansible
Более подробная информация по установке Ansible доступна по ссылке.
Выполните проверку версии (должна быть не менее v2.9):
ansible --version
2. После установки Ansible добавьте необходимые для его работы коллекции.
Пример добавления в консоли:
ansible-galaxy collection install community.general ansible-galaxy collection install community.crypto ansible-galaxy collection install community.docker
3. Подготовьте конфигурацию.
Файлы конфигурации направляются в виде архива tar.gz, который необходимо распаковать в директорию /etc с правами root .
Пример:
tar -C /etc -xvf ansible-iot-1.21.tar.gz
После распаковки архива все пакеты и зависимости будут развернуты в директории на текущем сервере.
Файлы конфигурации и плейбуки (скрипты/конфигурации) Ansible будут расположены в директории /etc/ansible-iot-1.21
4. Далее необходимо отредактировать файл /etc/ansible-iot-1.21/inventory
Откройте файл в любом доступном текстовом редакторе, например nano. Укажите пароль от root в переменной ansible_sudo_pass:
Далее в примере для пользователя root используется пароль rootpasswd
При инсталляции необходимо указать валидный пароль!
[default] localhost ansible_connection=local ansible_sudo_pass=rootpasswd
5. Далее необходимо настроить параметры доступа к платформе.
Для базовой установки достаточно отредактировать файл конфигурации /etc/ansible-iot-1.21/vars/default.yml
Откройте файл в любом доступном текстовом редакторе, например nano. Укажите корректный IP-адрес или доменное имя в переменной server_name:
server_name: ip_адрес_сервера use_external_mongodb: false external_mongodb_addr: "{{ server_name }}" external_mongodb_port: 27017 web_http_port: 80 web_https_port: 443 use_https_web_from_core: true web_enable_certbot: false web_certbot_email: test@email.com mail_smtp_submitter: test@email.com mail_smtp_password: password mail_smtp_auth: "true" mail_smtp_host: email.com mail_smtp_port: 587 flussonic_url: "" flussonic_api_key: "" flussonic_operator_id: "" flussonic_admin_login: "" install_dir: /storage/iot
Для функций самостоятельной регистрации, регистрации демонстрационных учетных записей, а также для процедуры восстановления пароля может потребоваться активация почтовых оповещений через e-mail. Для этого потребуется указать:
- mail_smtp_submitter — учетная запись e-mail;
- mail_smtp_password — пароль от учетной записи e-mail;
- mail_smtp_auth — проверка подлинности smtp (включена по умолчанию);
- mail_smtp_host — адрес smtp-сервера;
- mail_smtp_port — smtp-порт сервера.
6. После этого можно запустить установку:
cd /etc/ansible-iot-1.21 ansible-playbook install.yml
Платформа будет доступна по адресу: http://[IP-адрес вашего сервера Eltex SC]
Данный адрес был ранее указан в переменной server_name файла конфигурации /etc/ansible-iot-1.21/vars/default.yml
Порты доступа к API платформы можно изменить только в случае редактирования соответствующих настроек в файле конфигурации .
Изучить файл конфигурации вы можете в полной документации к Eltex SC.
Расположение конфигурационных файлов:
Конфигурации для ядра, web и сервера e-mail-/sms-рассылок располагаются в: /etc/ansible-iot-1.21/templates
default-for-docker.yml.j2
eltex-sc-web.j2
notification.properties.j2
Директория хранения журналов работы платформы: /storage/iot/core/var/log/eltex-sc/server.log
Первый вход на платформу Eltex SC
Для доступа к платформе через web-интерфейс используйте адрес, указанный ранее в конфигурации /etc/ansible-iot-1.21/vars/default.yml.
- Перейдите по адресу: http://IP-адрес_вашего_сервера_Eltex-SC/. Откроется страница авторизации.
- Введите логин и пароль.
Данные от учетной записи «Администратор»
Логин: admin
Пароль: Test18plat34Form