Raspberry Pi

In diesem Handbuch stellen Sie MyEMS auf einem Raspberry Pi bereit.

Voraussetzungen

Raspberry Pi 5 oder Raspberry Pi 4 Model B
Raspberry Pi OS (64-Bit) – Eine Portierung von Debian Bookworm mit Raspberry Pi Desktop, Veröffentlichungsdatum: 04.07.2024

Quellcode klonen

sudo apt install git

sudo apt install pip

sudo apt install ufw

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

Schritt 1 Datenbank

MySQL-Server einrichten

sudo apt update

sudo apt upgrade

sudo apt install mariadb-server

Standardmäßig wird MySQL ohne festgelegtes Passwort installiert, d. h. Sie können auf den MySQL-Server ohne Authentifizierung zugreifen. Führen Sie den folgenden Befehl aus, um den MySQL-Sicherungsvorgang zu starten.

sudo mysql_secure_installation

Enter current password for root (enter for none): [Eingabetaste drücken]
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

Datenbankschema und Skripte für MyEMS installieren Siehe Datenbank

Schritt 2 myems-api

myems-api-Dienst installieren:

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

cd /myems-api

Um den Fehler „error: externally-managed-environment“ zu vermeiden, erstellen Sie einen Ordner für die virtuelle Umgebungs konfiguration:

sudo python -m venv venv

Virtuelle Umgebung aktivieren

source venv/bin/activate

Benötigte Pakete installieren

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

Virtuelle Umgebung deaktivieren

deactivate

.env-Datei anhand der example.env erstellen und bei Bedarf bearbeiten:

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

sudo nano /myems-api/.env

Gunicorn-Pfad in myems-api.service anpassen:

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

Port in der Firewall freischalten:

sudo ufw allow 8000

Systemd-Konfigurationsdateien einrichten:

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/

Dienste anschließend aktivieren, damit sie beim Systemstart automatisch starten:

sudo systemctl enable myems-api.socket

sudo systemctl enable myems-api.service

Dienste starten:

sudo systemctl start myems-api.socket

sudo systemctl start myems-api.service

Schritt 3 myems-admin

NGINX-Server installieren Siehe 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 konfigurieren

sudo nano /etc/nginx/nginx.conf

Im Abschnitt „http“ folgende Direktiven hinzufügen:

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;

    ...
}

Im Abschnitt „http“ einen neuen „server“-Abschnitt mit folgenden Direktiven hinzufügen:

  server {
      listen                 8001;
      server_name     myems-admin;
      location / {
          root    /var/www/myems-admin;
          index index.html index.htm;
      }
      ## Um CORS-Fehler zu vermeiden, nutze Nginx zum Proxy von myems-api auf den Pfad /api
      ## Füge einen weiteren location /api im 'server'-Abschnitt hinzu und ersetze die Demo-Adresse http://127.0.0.1:8000/ durch die tatsächliche URL
      location /api {
          proxy_pass http://127.0.0.1:8000/;
          proxy_connect_timeout 75;
          proxy_read_timeout 600;
          send_timeout 600;
      }
  }

myems-admin installieren:

sudo mkdir /var/www

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

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

Konfigurationsdatei prüfen und bei Bedarf bearbeiten:

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

Vorsicht

Der Ordner „upload“ dient für vom Benutzer hochgeladene Dateien. Löschen, verschieben oder überschreiben Sie den Ordner „upload“ nicht bei einem Update von myems-admin.

 /var/www/myems-admin/upload

NGINX starten:

sudo systemctl start nginx

Port in der Firewall freischalten:

sudo ufw allow 8001

Schritt 4 myems-modbus-tcp

In diesem Schritt installieren Sie den myems-modbus-tcp-Dienst.

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

cd /myems-modbus-tcp

Um den Fehler „error: externally-managed-environment“ zu vermeiden, erstellen Sie einen Ordner für die virtuelle Umgebungs konfiguration:

sudo python -m venv venv

Virtuelle Umgebung aktivieren

source venv/bin/activate

Benötigte Pakete installieren

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

Virtuelle Umgebung deaktivieren

deactivate

example.env zu .env kopieren und .env bearbeiten:

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

sudo nano /myems-modbus-tcp/.env

Python-Pfad in myems-modbus-tcp.service anpassen

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-Dienst einrichten:

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

Dienst aktivieren:

sudo systemctl enable myems-modbus-tcp.service

Dienst starten:

sudo systemctl start myems-modbus-tcp.service

Dienst überwachen:

sudo systemctl status myems-modbus-tcp.service

Log anzeigen:

cat /myems-modbus-tcp.log

Schritt 5 myems-cleaning

In diesem Schritt installieren Sie den myems-cleaning-Dienst.

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

cd /myems-cleaning

Um den Fehler „error: externally-managed-environment“ zu vermeiden, erstellen Sie einen Ordner für die virtuelle Umgebungs konfiguration:

sudo python -m venv venv

Virtuelle Umgebung aktivieren

source venv/bin/activate

Benötigte Pakete installieren

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

Virtuelle Umgebung deaktivieren

deactivate

example.env zu .env kopieren und .env bearbeiten:

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

nano /myems-cleaning/.env

Python-Pfad in myems-cleaning.service anpassen

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-Dienst einrichten:

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

Dienst aktivieren:

sudo systemctl enable myems-cleaning.service

Dienst starten:

sudo systemctl start myems-cleaning.service

Dienst überwachen:

sudo systemctl status myems-cleaning.service

Log anzeigen:

cat /myems-cleaning.log

Schritt 6 myems-normalization

In diesem Schritt installieren Sie den myems-normalization-Dienst.

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

cd /myems-normalization

Um den Fehler „error: externally-managed-environment“ zu vermeiden, erstellen Sie einen Ordner für die virtuelle Umgebungs konfiguration:

sudo python -m venv venv

Virtuelle Umgebung aktivieren

source venv/bin/activate

Benötigte Pakete installieren

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

Virtuelle Umgebung deaktivieren

deactivate

example.env zu .env kopieren und .env bearbeiten:

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

sudo nano /myems-normalization/.env

Python-Pfad in myems-normalization.service anpassen

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-Dienst einrichten:

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

Dienst aktivieren:

sudo systemctl enable myems-normalization.service

Dienst starten:

sudo systemctl start myems-normalization.service

Dienst überwachen:

sudo systemctl status myems-normalization.service

Log anzeigen:

cat /myems-normalization.log

Schritt 7 myems-aggregation

In diesem Schritt installieren Sie den myems-aggregation-Dienst.

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

cd /myems-aggregation

Um den Fehler „error: externally-managed-environment“ zu vermeiden, erstellen Sie einen Ordner für die virtuelle Umgebungs konfiguration:

sudo python -m venv venv

Virtuelle Umgebung aktivieren

source venv/bin/activate

Benötigte Pakete installieren

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

Virtuelle Umgebung deaktivieren

deactivate

example.env zu .env kopieren und .env bearbeiten:

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

sudo nano /myems-aggregation/.env

Python-Pfad in myems-aggregation.service anpassen

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-Dienst einrichten:

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

Dienst aktivieren:

sudo systemctl enable myems-aggregation.service

Dienst starten:

sudo systemctl start myems-aggregation.service

Dienst überwachen:

sudo systemctl status myems-aggregation.service

Log anzeigen:

cat /myems-aggregation.log

Schritt 8 myems-web

In diesem Schritt installieren Sie den myems-web-UI-Dienst.

NGINX-Server installieren (wenn bereits bei myems-admin installiert, kann dies übersprungen werden) Siehe http://nginx.org/en/docs/install.html
NGINX konfigurieren Standarddateien entfernen

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

Neue Datei unter /etc/nginx/conf.d/ erstellen

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

Neuen „server“-Abschnitt mit folgenden Direktiven hinzufügen:

server {
    listen                 80;
    server_name     myems-web;
    location / {
        root    /var/www/myems-web;
        index index.html index.htm;
        # try_files-Direktive hinzufügen, um 404-Fehler beim Aktualisieren von Seiten zu vermeiden
        try_files $uri  /index.html;
    }
    ## Um CORS-Fehler zu vermeiden, nutze Nginx zum Proxy von myems-api auf den Pfad /api
    ## Füge einen weiteren location /api im 'server'-Abschnitt hinzu
    ## HINWEIS: Ersetze die Standardadresse http://127.0.0.1:8000/ durch die tatsächliche IP oder URL
    location /api {
        proxy_pass http://127.0.0.1:8000/;
        proxy_connect_timeout 75;
        proxy_read_timeout 600;
        send_timeout 600;
    }
}

MyEMS Web UI installieren: NodeJS installieren:

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

sudo apt-get install -y nodejs

Config.js-Datei bearbeiten:

Hinweis

Holen Sie sich einen MapboxToken unter https://mapbox.com und setzen Sie anschließend showOnlineMap auf true. Wenn Sie die Online-Kartenfunktion deaktivieren möchten, setzen Sie showOnlineMap auf false.

cd ~/myems/myems-web

sudo nano src/config.js

Build und Kompression durchführen:

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

sudo npm run build

Installieren

sudo mv build  /var/www/myems-web

NGINX neu starten:

sudo systemctl restart nginx

Port in der Firewall freischalten:

sudo ufw allow 80

Nach der Installation

Herzlichen Glückwunsch! Sie können sich jetzt bei der MyEMS Admin UI und der Web UI anmelden.

Standardports

MyEMS Web UI: 80 MyEMS API: 8000 MyEMS Admin UI: 8001

Vorausgesetzt, die Serveradresse lautet 192.168.1.8 (durch die tatsächliche Serveradresse ersetzen): Zugriff auf MyEMS Web UI unter http://192.168.1.8 (Port 80 kann weggelassen werden) Zugriff auf MyEMS Admin UI unter http://192.168.1.8:8001

Standardpasswörter

MyEMS Admin UI Benutzername:

administrator

Passwort:

!MyEMS1

MyEMS Web UI Benutzername:

administrator@myems.io

Passwort:

!MyEMS1

Voraussetzungen​

Quellcode klonen​

Schritt 1 Datenbank​

Schritt 2 myems-api​

Schritt 3 myems-admin​

Schritt 4 myems-modbus-tcp​

Schritt 5 myems-cleaning​

Schritt 6 myems-normalization​

Schritt 7 myems-aggregation​

Schritt 8 myems-web​

Nach der Installation​

Standardports​

Standardpasswörter​

Fehlerbehebung​

Voraussetzungen

Quellcode klonen

Schritt 1 Datenbank

Schritt 2 myems-api

Schritt 3 myems-admin

Schritt 4 myems-modbus-tcp

Schritt 5 myems-cleaning

Schritt 6 myems-normalization

Schritt 7 myems-aggregation

Schritt 8 myems-web

Nach der Installation

Standardports

Standardpasswörter

Fehlerbehebung