QUICK START Быстрая установка платформы ELTEX SC Версия ПО 1.21 |
|
Платформа Eltex SC (Eltex Smart Control) разработана для организации единой системы управления, конфигурирования и мониторинга устройств Интернета вещей (датчиков, электросчетчиков, web-камер и т.п.). Использование данной системы с графическим web-интерфейсом и мобильным приложением позволяет:
Минимальные системные требования сервера:
Поддерживаемые дистрибутивы: 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. Для этого потребуется указать:
|
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 |
Для доступа к платформе через web-интерфейс используйте адрес, указанный ранее в конфигурации /etc/ansible-iot-1.21/vars/default.yml.
Логин: admin |
Более подробная документация доступна в разделе «Документы и файлы» на официальном сайте ЭЛТЕКС: https://eltex-co.ru/catalog/platforma_eltex-sc_umnyy_dom/eltex_sc/ |