Raspberry Pi

В этом руководстве описано, как развернуть MyEMS на Raspberry Pi.

Предварительные требования

Raspberry Pi 5 или Raspberry Pi 4 Model B
Raspberry Pi OS (64-битная версия) — порт Debian Bookworm с рабочим столом Raspberry Pi, релиз от 04.07.2024

Клонирование исходного кода

sudo apt install git

sudo apt install pip

sudo apt install ufw

cd ~ && git clone https://github.com/myems/myems

Шаг 1: База данных

Настройка сервера MySQL

sudo apt update

sudo apt upgrade

sudo apt install mariadb-server

По умолчанию MySQL устанавливается без пароля, что позволяет получить доступ к серверу без аутентификации. Выполните следующую команду для запуска процесса защиты MySQL:

sudo mysql_secure_installation

Enter current password for root (enter for none): [Нажмите Enter]
Switch to unix_socket authentication [Y/n] Y
Change the root password? [Y/n] Y
New password: !MyEMS1
Re-enter new password: !MyEMS1
Remove anonymous users? [Y/n] Y
Disallow root login remotely? [Y/n] n
Remove test database and access to it? [Y/n] Y
Reload privilege tables now? [Y/n] Y

Установка схемы и скриптов базы данных для MyEMS.

См. раздел База данных

Шаг 2: myems-api

Установка сервиса myems-api:

sudo cp -r ~/myems/myems-api /myems-api

cd /myems-api

Чтобы предотвратить ошибку 'error: externally-managed-environment', создайте папку для конфигурации виртуального окружения:

sudo python -m venv venv

Активация виртуального окружения:

source venv/bin/activate

Установка зависимостей:

sudo venv/bin/pip install -r requirements.txt

Деактивация виртуального окружения:

deactivate

Создание файла .env на основе example.env и его редактирование при необходимости:

sudo cp /myems-api/example.env /myems-api/.env

sudo nano /myems-api/.env

Изменение пути к gunicorn в файле myems-api.service:

sudo nano /myems-api/myems-api.service

[Unit]
Description=myems-api daemon
Requires=myems-api.socket
After=network.target

[Service]
PIDFile=/run/myems-api/pid
User=root
Group=root
WorkingDirectory=/myems-api
ExecStart=/myems-api/venv/bin/gunicorn -b 0.0.0.0:8000 --pid /run/myems-api/pid --timeout 600 --workers=4 app:api
ExecReload=/bin/kill -s HUP $MAINPID
ExecStop=/bin/kill -s TERM $MAINPID
PrivateTmp=true

[Install]
WantedBy=multi-user.target

Добавление порта в брандмауэр:

sudo ufw allow 8000

Настройка файлов конфигурации systemd:

sudo cp /myems-api/myems-api.service /lib/systemd/system/

sudo cp /myems-api/myems-api.socket /lib/systemd/system/

sudo cp /myems-api/myems-api.conf /usr/lib/tmpfiles.d/

Далее включите автозапуск сервисов при старте системы:

sudo systemctl enable myems-api.socket

sudo systemctl enable myems-api.service

Запуск сервисов:

sudo systemctl start myems-api.socket

sudo systemctl start myems-api.service

Шаг 3: myems-admin

Установка сервера NGINX

Смотрите инструкцию по адресу http://nginx.org/en/linux_packages.html#Debian

sudo apt install curl gnupg2 ca-certificates lsb-release debian-archive-keyring

curl https://nginx.org/keys/nginx_signing.key | gpg --dearmor | sudo tee /usr/share/keyrings/nginx-archive-keyring.gpg >/dev/null

gpg --dry-run --quiet --no-keyring --import --import-options import-show /usr/share/keyrings/nginx-archive-keyring.gpg

echo "deb [signed-by=/usr/share/keyrings/nginx-archive-keyring.gpg] http://nginx.org/packages/debian `lsb_release -cs` nginx" | sudo tee /etc/apt/sources.list.d/nginx.list

echo -e "Package: *\nPin: origin nginx.org\nPin: release o=nginx\nPin-Priority: 900\n" | sudo tee /etc/apt/preferences.d/99nginx

sudo apt update

sudo apt install nginx

Конфигурация NGINX

sudo nano /etc/nginx/nginx.conf

В разделе 'http' добавьте следующие директивы:

http {
    client_header_timeout 600;
    client_max_body_size 512M;
    gzip on;
    gzip_min_length 512;
    gzip_proxied any;
    gzip_types *;
    gzip_vary on;
    proxy_buffering off;

    ...
}

В разделе 'http' добавьте новый раздел 'server' со следующими директивами:

  server {
      listen                 8001;
      server_name     myems-admin;
      location / {
          root    /var/www/myems-admin;
          index index.html index.htm;
      }
      ## Чтобы избежать проблем с CORS, используйте Nginx для проксирования myems-api по пути /api
      ## Добавьте дополнительный блок location /api в 'server' и замените демонстрационный адрес http://127.0.0.1:8000/ на реальный
      location /api {
          proxy_pass http://127.0.0.1:8000/;
          proxy_connect_timeout 75;
          proxy_read_timeout 600;
          send_timeout 600;
      }
  }

Установка myems-admin:

sudo mkdir /var/www

sudo cp -r ~/myems/myems-admin  /var/www/myems-admin

sudo chmod 0755 -R /var/www/myems-admin

Проверьте файл конфигурации и внесите необходимые изменения:

sudo nano /var/www/myems-admin/app/api.js

Предупреждение

Папка 'upload' предназначена для файлов, загружаемых пользователями. НЕ УДАЛЯЙТЕ/НЕ ПЕРЕМЕЩАЙТЕ/НЕ ПЕРЕЗАПИСЫВАЙТЕ папку 'upload' при обновлении myems-admin.

 /var/www/myems-admin/upload

Запуск Nginx:

sudo systemctl start nginx

Добавление порта в брандмауэр:

sudo ufw allow 8001

Шаг 4: myems-modbus-tcp

На этом шаге вы установите сервис myems-modbus-tcp.

sudo cp -r ~/myems/myems-modbus-tcp /myems-modbus-tcp

cd /myems-modbus-tcp

Чтобы предотвратить ошибку 'error: externally-managed-environment', создайте папку для конфигурации виртуального окружения:

sudo python -m venv venv

Активация виртуального окружения:

source venv/bin/activate

Установка зависимостей:

sudo venv/bin/pip install -r requirements.txt

Деактивация виртуального окружения:

deactivate

Скопируйте файл exmaple.env в .env и отредактируйте его:

sudo cp /myems-modbus-tcp/example.env /myems-modbus-tcp/.env

sudo nano /myems-modbus-tcp/.env

Изменение пути к Python в файле myems-modbus-tcp.service:

sudo nano myems-modbus-tcp.service

[Unit]
Description=myems-modbus-tcp daemon
After=network.target

[Service]
User=root
Group=root
ExecStart=/myems-modbus-tcp/venv/bin/python3 /myems-modbus-tcp/main.py
ExecReload=/bin/kill -s HUP $MAINPID
ExecStop=/bin/kill -s TERM $MAINPID
PrivateTmp=true
Restart=always

[Install]
WantedBy=multi-user.target

Настройка сервиса systemd:

sudo cp myems-modbus-tcp.service /lib/systemd/system/

Включение автозапуска сервиса:

sudo systemctl enable myems-modbus-tcp.service

Запуск сервиса:

sudo systemctl start myems-modbus-tcp.service

Мониторинг состояния сервиса:

sudo systemctl status myems-modbus-tcp.service

Просмотр логов:

cat /myems-modbus-tcp.log

Шаг 5: myems-cleaning

На этом шаге вы установите сервис myems-cleaning.

sudo cp -r ~/myems/myems-cleaning /myems-cleaning

cd /myems-cleaning

Чтобы предотвратить ошибку 'error: externally-managed-environment', создайте папку для конфигурации виртуального окружения:

sudo python -m venv venv

Активация виртуального окружения:

source venv/bin/activate

Установка зависимостей:

sudo venv/bin/pip install -r requirements.txt

Деактивация виртуального окружения:

deactivate

Скопируйте файл exmaple.env в .env и отредактируйте его:

sudo cp /myems-cleaning/example.env /myems-cleaning/.env

nano /myems-cleaning/.env

Изменение пути к Python в файле myems-cleaning.service:

sudo nano myems-cleaning.service

[Unit]
Description=myems-cleaning daemon
After=network.target

[Service]
User=root
Group=root
ExecStart=/myems-cleaning/venv/bin/python3 /myems-cleaning/main.py
ExecReload=/bin/kill -s HUP $MAINPID
ExecStop=/bin/kill -s TERM $MAINPID
PrivateTmp=true
Restart=always

[Install]
WantedBy=multi-user.target

Настройка сервиса systemd:

sudo cp /myems-cleaning/myems-cleaning.service /lib/systemd/system/

Включение автозапуска сервиса:

sudo systemctl enable myems-cleaning.service

Запуск сервиса:

sudo systemctl start myems-cleaning.service

Мониторинг состояния сервиса:

sudo systemctl status myems-cleaning.service

Просмотр логов:

cat /myems-cleaning.log

Шаг 6: myems-normalization

На этом шаге вы установите сервис myems-normalization.

sudo cp -r ~/myems/myems-normalization /myems-normalization

cd /myems-normalization

Чтобы предотвратить ошибку 'error: externally-managed-environment', создайте папку для конфигурации виртуального окружения:

sudo python -m venv venv

Активация виртуального окружения:

source venv/bin/activate

Установка зависимостей:

sudo venv/bin/pip install -r requirements.txt

Деактивация виртуального окружения:

deactivate

Скопируйте файл exmaple.env в .env и отредактируйте его:

sudo cp /myems-normalization/example.env /myems-normalization/.env

sudo nano /myems-normalization/.env

Изменение пути к Python в файле myems-normalization.service:

sudo nano myems-normalization.service

[Unit]
Description=myems-normalization daemon
After=network.target

[Service]
User=root
Group=root
ExecStart=/myems-normalization/venv/bin/python3 /myems-normalization/main.py
ExecReload=/bin/kill -s HUP $MAINPID
ExecStop=/bin/kill -s TERM $MAINPID
PrivateTmp=true
Restart=always

[Install]
WantedBy=multi-user.target

Настройка сервиса systemd:

sudo cp /myems-normalization/myems-normalization.service /lib/systemd/system/

Включение автозапуска сервиса:

sudo systemctl enable myems-normalization.service

Запуск сервиса:

sudo systemctl start myems-normalization.service

Мониторинг состояния сервиса:

sudo systemctl status myems-normalization.service

Просмотр логов:

cat /myems-normalization.log

Шаг 7: myems-aggregation

На этом шаге вы установите сервис myems-aggregation.

sudo cp -r ~/myems/myems-aggregation /myems-aggregation

cd /myems-aggregation

Чтобы предотвратить ошибку 'error: externally-managed-environment', создайте папку для конфигурации виртуального окружения:

sudo python -m venv venv

Активация виртуального окружения:

source venv/bin/activate

Установка зависимостей:

sudo venv/bin/pip install -r requirements.txt

Деактивация виртуального окружения:

deactivate

Скопируйте файл exmaple.env в .env и отредактируйте его:

sudo cp /myems-aggregation/example.env /myems-aggregation/.env

sudo nano /myems-aggregation/.env

Изменение пути к Python в файле myems-aggregation.service:

sudo nano myems-aggregation.service

[Unit]
Description=myems-aggregation daemon
After=network.target

[Service]
User=root
Group=root
ExecStart=/myems-aggregation/venv/bin/python3 /myems-aggregation/main.py
ExecReload=/bin/kill -s HUP $MAINPID
ExecStop=/bin/kill -s TERM $MAINPID
PrivateTmp=true
Restart=always

[Install]
WantedBy=multi-user.target

Настройка сервиса systemd:

sudo cp /myems-aggregation/myems-aggregation.service /lib/systemd/system/

Включение автозапуска сервиса:

sudo systemctl enable myems-aggregation.service

Запуск сервиса:

sudo systemctl start myems-aggregation.service

Мониторинг состояния сервиса:

sudo systemctl status myems-aggregation.service

Просмотр логов:

cat /myems-aggregation.log

Шаг 8: myems-web

На этом шаге вы установите веб-интерфейс myems-web.

Установка сервера NGINX (если уже установлен при настройке myems-admin, этот шаг можно пропустить) Смотрите инструкцию по адресу http://nginx.org/en/docs/install.html
Конфигурация NGINX

Удаление стандартных файлов:

sudo rm /etc/nginx/sites-enabled/default
sudo rm /etc/nginx/conf.d/default.conf

Создание нового файла в каталоге /etc/nginx/conf.d/:

sudo nano /etc/nginx/conf.d/myems-web.conf

Добавьте новый раздел 'server' со следующими директивами:

server {
    listen                 80;
    server_name     myems-web;
    location / {
        root    /var/www/myems-web;
        index index.html index.htm;
        # добавьте директиву try_files, чтобы избежать ошибки 404 при обновлении страниц
        try_files $uri  /index.html;
    }
    ## Чтобы избежать проблем с CORS, используйте Nginx для проксирования myems-api по пути /api
    ## Добавьте дополнительный блок location /api в 'server'
    ## Примечание: замените стандартный адрес http://127.0.0.1:8000/ на реальный IP или URL
    location /api {
        proxy_pass http://127.0.0.1:8000/;
        proxy_connect_timeout 75;
        proxy_read_timeout 600;
        send_timeout 600;
    }
}

Установка веб-интерфейса MyEMS:

Установка NodeJS:

curl -fsSL https://deb.nodesource.com/setup_20.x | sudo bash -

sudo apt-get install -y nodejs

Редактирование файла config.js:

Примечание

Получите mapboxToken на сайте https://mapbox.com, затем установите значение showOnlineMap в true. Если вы хотите отключить функцию онлайн-карты, установите showOnlineMap в false.

cd ~/myems/myems-web

sudo nano src/config.js

Сборка и архивирование:

sudo npm i --unsafe-perm=true --allow-root --legacy-peer-deps

sudo npm run build

Установка:

sudo mv build  /var/www/myems-web

Перезапуск NGINX:

sudo systemctl restart nginx

Добавление порта в брандмауэр:

sudo ufw allow 80

После установки

Поздравляем! Теперь вы можете войти в административный интерфейс MyEMS Admin UI и веб-интерфейс MyEMS Web UI.

Стандартные порты

MyEMS Web UI: 80

MyEMS API: 8000

MyEMS Admin UI: 8001

Предположим, что адрес сервера — 192.168.1.8 (замените на реальный адрес сервера): Доступ к MyEMS Web UI по адресу http://192.168.1.8 (порт 80 можно опустить) Доступ к MyEMS Admin UI по адресу http://192.168.1.8:8001

Стандартные пароли

MyEMS Admin UI

Имя пользователя:

administrator

Пароль:

!MyEMS1

MyEMS Web UI

Имя пользователя:

administrator@myems.io

Пароль:

!MyEMS1

Предварительные требования​

Клонирование исходного кода​

Шаг 1: База данных​

Шаг 2: myems-api​

Шаг 3: myems-admin​

Шаг 4: myems-modbus-tcp​

Шаг 5: myems-cleaning​

Шаг 6: myems-normalization​

Шаг 7: myems-aggregation​

Шаг 8: myems-web​

После установки​

Стандартные порты​

Стандартные пароли​

Устранение неполадок​

Предварительные требования

Клонирование исходного кода

Шаг 1: База данных

Шаг 2: myems-api

Шаг 3: myems-admin

Шаг 4: myems-modbus-tcp

Шаг 5: myems-cleaning

Шаг 6: myems-normalization

Шаг 7: myems-aggregation

Шаг 8: myems-web

После установки

Стандартные порты

Стандартные пароли

Устранение неполадок