Skip to main content

Встановлення Fledge

Fledge надзвичайно легкий і може працювати на недорогих периферійних пристроях, датчиках і виконавчих платах. Для цілей цього посібника ми припускаємо, що всі сервіси працюють на Raspberry Pi під керуванням операційної системи Bullseye. Переконайтеся, що у вашій системі достатньо місця для читання даних.

Якщо у вашій системі не встановлено підтримувану версію операційної системи Raspberry Pi, ви можете знайти інструкції щодо її завантаження та встановлення на сторінці https://www.raspberrypi.org/downloads/operating-systems/. Після встановлення підтримуваної операційної системи переконайтеся, що у вас є останні оновлення, виконавши такі команди на сервері Fledge:

   sudo apt-get update
   sudo apt-get upgrade
   sudo apt-get update

Загалом для встановлення Fledge знадобляться такі пакети:

  • Ядро Fledge
  • Інтерфейс користувача Fledge
  • Одна або кілька сервісів Fledge South
  • Одна або кілька сервісів Fledge North (Північні сервіси OSI PI та OCS включені в ядро Fledge)

Використання пакетів репозіторію для встановлення Fledge​

Якщо ви вирішите використовувати репозиторій пакетів Dianomic Systems для встановлення пакетів, вам потрібно буде виконати наведені нижче дії для конкретної платформи, яку ви використовуєте.

Ubuntu чи Debian​

У системах Ubuntu або Debian, включаючи Raspberry Pi, підтримується пакетний менеджер apt. Вам потрібно буде додати сервер архівування Dianomic Systems до конфігурації apt у вашій системі. Перше, що потрібно зробити, це додати ключ, який використовується для перевірки сховища пакетів. Для цього виконайте команду

wget -q -O - http://archives.fledge-iot.org/KEY.gpg | sudo apt-key add -

Після завершення ви можете додати сам репозиторій у файл конфігурації apt /etc/apt/sources.list. Найпростішим способом зробити це є використання команди add-apt-repository. Точна команда буде відрізнятися залежно від системи:

  • Raspberry Pi не має команди apt-add-repository, користувач повинен редагувати файл джерел apt вручну
sudo vi /etc/apt/sources.list

і додайте лінію

 deb  http://archives.fledge-iot.org/latest/bullseye/armv7l/ /

до кінця файлу.

Примітка Замініть bullseye на назву версії операційної системи Raspberry, яку ви встановили.

  • Користувачам із системою Intel або AMD із Ubuntu 18.04 слід запускати
 sudo add-apt-repository "deb http://archives.fledge-iot.org/latest/ubuntu1804/x86_64/ / "
  • Користувачам із системою Intel або AMD із Ubuntu 20.04 слід запускати
sudo add-apt-repository "deb http://archives.fledge-iot.org/latest/ubuntu2004/x86_64/ / "
  • Користувачі з системою Arm з Ubuntu 18.04, як-от плата Odroid, слід запускати
sudo add-apt-repository "deb http://archives.fledge-iot.org/latest/ubuntu1804/aarch64/ / "
  • Користувачі операційної системи Mendel на Google Coral створюють файл /etc/apt/sources.list.d/fledge.list і вставляють такий вміст
deb http://archives.fledge-iot.org/latest/mendel/aarch64/ /

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

sudo apt -y update

Тепер ви готові до встановлення пакетів Fledge. Це можна зробити, виконавши команду

sudo apt -y install *package*

Ви також можете встановити кілька пакетів за допомогою однієї команди. Щоб установити базовий пакет fledge, інтерфейс користувача fledge і плагін синусоїди півдня, запустіть команду

sudo DEBIAN_FRONTEND=noninteractive apt -y install fledge fledge-gui fledge-south-sinusoid

Встановлення завантажених пакетів Fledge​

Припустимо, що ви завантажили пакети за наведеним вище посиланням. Використовуйте SSH для входу в систему, яка розміщуватиме сервіси Fledge. Для кожного пакета Fledge, який ви вирішили встановити, введіть таку команду

sudo apt -y install <filename>

Примітка Завантажені файли називаються за назвою пакета та поточною версією програмного забезпечення. Тому ці назви змінюватимуться з часом у міру випуску нових версій. На момент написання версії пакета Fledge — 2.3.0, тому ім’я файлу пакета — fledge_2.3.0_x86_64.deb на 64-розрядній платформі X86. У результаті імена файлів, показані в наступних прикладах, можуть відрізнятися від імен файлів, які ви завантажили.

Основними пакетами для встановлення є ядро Fledge і графічний інтерфейс користувача Fledge

sudo DEBIAN_FRONTEND=noninteractive apt -y install ./fledge_2.3.0_x86_64.deb
sudo apt -y install ./fledge-gui_2.3.0.deb

Вам потрібно буде встановити один із кількох плагінів South для отримання даних. Ви можете зробити це зараз або під час додавання джерела даних. Наприклад, щоб установити плагін для сенсорної плати Sense HAT, введіть

sudo apt -y install ./fledge-south-sensehat_2.3.0_armv7l.deb

Примітка У цьому випадку ми показуємо назву пакета на платформі Raspberry Pi. Плагін sensehat підтримується не на всіх платформах, оскільки для нього потрібні спеціальні апаратні підключення Raspberry Pi.

Вам також може знадобитися встановити один або кілька плагінів North для передачі даних. Підтримка OSIsoft PI та OCS включена в базовий пакет Fledge, тому вам не потрібно нічого інсталювати, якщо ви надсилаєте дані лише цим системам.

Конфігурація Firewall​

кщо ви встановлюєте пакети в середовищі, закритому вогнем, вам потрібно буде відкрити кілька розташувань для вихідних з’єднань. Це буде відрізнятися залежно від способу встановлення пакетів.

Якщо ви завантажуєте або встановлюєте пакети на протипожежну машину, цій машині потрібно буде отримати доступ до archives.fledge-iot.org, щоб мати можливість отримати пакети Fledge. Буде використано стандартний порт HTTP, порт 80.

Також рекомендується дозволити машині доступ до джерела пакетів для вашої інсталяції Linux. Це дозволяє вам оновлювати машину важливими виправленнями, а також інсталювати будь-які пакети Linux, які потрібні для Fledge або плагінів, які ви завантажуєте.

У рамках встановлення компонентів Python Fledge за допомогою утиліти pip встановлюється ряд пакетів Python. Щоб дозволити це, вам потрібно відкрити доступ до набору місць, з яких pip завантажуватиме пакети. Необхідний набір місць є

  • python.org

  • pypi.org

  • pythonhosted.org

У всіх випадках стандартний порт HTTPS, 443, використовується для зв’язку, і це єдиний порт, який потрібно відкрити.

Примітка Якщо ви завантажуєте пакети на іншу машину та копіюєте їх на свою машину за брандмауером, ви все одно повинні відкрити доступ для pip до розташування пакетів Python.

Перевірка встановлення пакета​

Щоб перевірити, які пакети встановлено, увійдіть у свою хост-систему через ssh і скористайтеся командою dpkg::

dpkg -l | grep 'fledge'

Запуск з PostgreSQL​

Щоб запустити Fledge з PostgreSQL, спершу вам потрібно явно встановити пакет PostgreSQL. Перегляньте посилання нижче для налаштування

For Debian Platform For Red Had Platform

Також вам потрібно змінити значення плагіна Storage. Дивиться Configure Storage Plugin чи за допомогою команди curl нижче

 $ curl -sX PUT localhost:8081/fledge/category/Storage/plugin -d '{"value": "postgres"}'
    {
      "description": "The main storage plugin to load",
      "type": "string",
      "order": "1",
      "displayName": "Storage Plugin",
      "default": "sqlite",
      "value": "postgres"
    }

Тепер настав час перезапустити Fledge. Після цього ви побачите, що Fledge працює з PostgreSQL.

Використання Docker Containerizer для встановлення Fledge​

Контейнери Fledge Docker надаються в приватному сховищі. Це сховище не має аутентифікації чи шифрування.

Наступні кроки описують, як встановити Fledge за допомогою цих контейнерів:

  • Відредагуйте файл daemon.json, розташуванням якого за замовчуванням є /etc/docker/daemon.json у Linux. Якщо файл daemon.json не існує, створіть його. Якщо припустити, що у файлі немає інших параметрів, він повинен мати такий вміст:
{ "insecure-registries":["54.204.128.201:5000"] }
  • Перезапустіть Docker, щоб зміни набули чинності
sudo systemctl restart docker.service
  • Перевірте за допомогою команди
docker info

Ви повинні побачити наступний результат:

Insecure Registries:
52.3.255.136:5000
127.0.0.0/8

Ви також можете звернутися до документації Docker тут.

Ubuntu 20.04​

  • Витягнути реєстр Docker
docker pull 54.204.128.201:5000/fledge:latest-ubuntu2004
  • Щоб запустити контейнер Docker
docker run -d --name fledge -p 8081:8081 -p 1995:1995 -p 8082:80 54.204.128.201:5000/fledge:latest-ubuntu2004

Тут GUI перенаправляється на порт 8082 на хост-машині, це може бути будь-який порт і опускатися, якщо порт 80 вільний.

  • Можна перевірити, чи працюють Fledge і графічний інтерфейс Fledge, використовуючи наступні команди на хост машині

Fledge

curl -sX GET http://localhost:8081/fledge/ping

Fledge GUI

http://localhost:8082
  • Закріплення до діючого контейнера
docker exec -it fledge bash

Примітка Для встановлення Ubuntu 18.04 вам просто потрібно замінити ubuntu2004 на ubuntu1804. Наразі зображення доступні лише для версій Ubuntu 18.04 і 20.04.