Debian/Ubuntu

In deze handleiding wordt uitgelegd hoe je MyEMS op een Debian- of Ubuntu-server installeert.

Vereisten

Deze handleiding beschrijft hoe je MyEMS installeert op Ubuntu 24.04 LTS / Ubuntu 22.04 LTS / Ubuntu 20.04 LTS / Ubuntu 18.04 LTS / Debian 12 Bookworm / Debian 11 Bullseye / Debian 10 Buster. De hardwarevereisten zijn afhankelijk van de gekozen database en het aantal apparaten dat op het systeem is aangesloten. Om MyEMS en MySQL op één machine te draaien, heb je minimaal 4GB RAM nodig.

Kloon de broncode:

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

Stap 1 Database

Zie Database

Stap 2 myems-api

Installeer de myems-api service:

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

cd /myems-api

sudo apt install python3-pip

sudo pip install -r requirements.txt

Notitie

(Ubuntu 24.04 LTS)If the code does not work, you can use the following code: sudo pip install -r requirements.txt --break-system-packages

Maak een .env-bestand op basis van example.env en pas het .env-bestand aan indien nodig:

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

sudo nano /myems-api/.env

Voeg de poort toe aan de firewall:

sudo ufw allow 8000

Stel de systemd-configuratiebestanden in:

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/

Activeer vervolgens de services zodat ze automatisch opstarten bij het opstarten:

sudo systemctl enable myems-api.socket

sudo systemctl enable myems-api.service

Start de services:

sudo systemctl start myems-api.socket

sudo systemctl start myems-api.service

Stap 3 myems-admin

Installeer de NGINX-server

Zie http://nginx.org/en/linux_packages.html#Debian

Activeer de nginx-service:

sudo systemctl start nginx.service

Configureer NGINX

sudo nano /etc/nginx/nginx.conf

Voeg in de 'http'-sectie enkele richtlijnen toe:

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;
    ...

}

Voeg een nieuw bestand toe onder /etc/nginx/conf.d/

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

Schrijf de richtlijnen zoals hieronder en vervang de standaard myems-api url http://127.0.0.1:8000/ door de werkelijke url als de myems-api service op een andere server draait

server {
    listen                 8001;
    server_name     myems-admin;
    location / {
        root    /var/www/myems-admin;
        index index.html index.htm;
    }
    ## To avoid CORS issue, use Nginx to proxy myems-api to path /api
    ## Add another location /api in 'server'
    ## Replace the default myems-api url http://127.0.0.1:8000/ with actual url if the myems-api servcie hosted on a different server
    location /api {
        proxy_pass http://127.0.0.1:8000/;
        proxy_connect_timeout 75;
        proxy_read_timeout 600;
        send_timeout 600;
    }
}

Installeer myems-admin: Als de server geen verbinding kan maken met internet, comprimeer dan de map myems/myems-admin, upload deze naar de server en pak deze uit naar ~/myems/myems-admin

sudo mkdir /var/www

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

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

Controleer het configuratiebestand en pas het indien nodig aan:

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

Voorzichtigheid

De map 'upload' is voor door gebruikers geüploade bestanden. Verwijder/verplaats/overschrijf de map 'upload' niet wanneer je myems-admin bijwerkt.

 /var/www/myems-admin/upload

Voeg de poort toe aan de firewall:

sudo ufw allow 8001

Herstart de nginx-service:

sudo systemctl restart nginx.service

Stap 4 myems-modbus-tcp

In deze stap installeer je de myems-modbus-tcp service.

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

cd /myems-modbus-tcp

sudo pip install -r requirements.txt

Notitie

(Ubuntu 24.04 LTS)If the code does not work, you can use the following code: sudo pip install -r requirements.txt --break-system-packages

Kopieer het example.env-bestand naar .env en pas het .env-bestand aan:

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

sudo nano /myems-modbus-tcp/.env

Stel de systemd-service in:

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

Activeer de service:

sudo systemctl enable myems-modbus-tcp.service

Start de service:

sudo systemctl start myems-modbus-tcp.service

Controleer de status van de service:

sudo systemctl status myems-modbus-tcp.service

Bekijk het logbestand:

cat /myems-modbus-tcp.log

Stap 5 myems-cleaning

In deze stap installeer je de myems-cleaning service.

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

cd /myems-cleaning

sudo pip install -r requirements.txt

Notitie

(Ubuntu 24.04 LTS)If the code does not work, you can use the following code: sudo pip install -r requirements.txt --break-system-packages

Kopieer het example.env-bestand naar .env en pas het .env-bestand aan:

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

sudo nano /myems-cleaning/.env

Stel de systemd-service in:

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

Activeer de service:

sudo systemctl enable myems-cleaning.service

Start de service:

sudo systemctl start myems-cleaning.service

Controleer de status van de service:

sudo systemctl status myems-cleaning.service

Bekijk het logbestand:

cat /myems-cleaning.log

Stap 6 myems-normalization

In deze stap installeer je de myems-normalization service.

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

cd /myems-normalization

sudo pip install -r requirements.txt

Notitie

(Ubuntu 24.04 LTS)If the code does not work, you can use the following code: sudo pip install -r requirements.txt --break-system-packages

Kopieer het example.env-bestand naar .env en pas het .env-bestand aan:

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

sudo nano /myems-normalization/.env

Stel de systemd-service in:

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

Activeer de service:

sudo systemctl enable myems-normalization.service

Start de service:

sudo systemctl start myems-normalization.service

Controleer de status van de service:

sudo systemctl status myems-normalization.service

Bekijk het logbestand:

cat /myems-normalization.log

Stap 7 myems-aggregation

In deze stap installeer je de myems-aggregation service.

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

cd /myems-aggregation

sudo pip install -r requirements.txt

Notitie

(Ubuntu 24.04 LTS)If the code does not work, you can use the following code: sudo pip install -r requirements.txt --break-system-packages

Kopieer het example.env-bestand naar .env en pas het .env-bestand aan:

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

sudo nano /myems-aggregation/.env

Stel de systemd-service in:

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

Activeer de service:

sudo systemctl enable myems-aggregation.service

Start de service:

sudo systemctl start myems-aggregation.service

Controleer de status van de service:

sudo systemctl status myems-aggregation.service

Bekijk het logbestand:

cat /myems-aggregation.log

Stap 8 myems-web

In deze stap installeer je de myems-web UI-service.

Installeer de NGINX-server

Zie http://nginx.org/en/linux_packages.html#Debian

Configureer NGINX

Verwijder standaardbestanden

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

Voeg een nieuw bestand toe onder /etc/nginx/conf.d/

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

Voeg een nieuwe 'server'-sectie toe met de volgende richtlijnen:

server {
    listen                 80;
    server_name     myems-web;
    location / {
        root    /var/www/myems-web;
        index index.html index.htm;
        # voeg de try_files-richtlijn toe om 404-fouten bij het vernieuwen van pagina's te voorkomen
        try_files $uri  /index.html;
    }
    ## Om CORS-problemen te voorkomen, gebruik Nginx om myems-api naar pad /api te proxy'en
    ## Voeg een andere locatie /api toe in 'server' en vervang het demo-adres http://127.0.0.1:8000/ door de werkelijke url
    location /api {
        proxy_pass http://127.0.0.1:8000/;
        proxy_connect_timeout 75;
        proxy_read_timeout 600;
        send_timeout 600;
    }
}

Herstart NGINX

sudo systemctl restart nginx

Installeer MyEMS Web UI:

Installeer NodeJS:

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

sudo apt-get install -y nodejs

Pas het config.js-bestand aan:

Notitie

Haal de mapboxToken op via https://mapbox.com en stel showOnlineMap in op true. Wil je de online kaartfunctie uitschakelen, stel showOnlineMap dan in op false

cd myems/myems-web

sudo nano src/config.js

Bouwen

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

sudo npm run build

Installeren Let op: het volgende pad moet hetzelfde zijn als geconfigureerd in nginx.conf.

sudo rm -r /var/www/myems-web

sudo mv build  /var/www/myems-web

Voeg de poort toe aan de firewall:

sudo ufw allow 80

Herstart NGINX

sudo systemctl restart nginx

Na installatie

Gefeliciteerd! Je kunt nu inloggen op de MyEMS Admin UI en Web UI.

Standaardpoorten

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

Stel dat het serveradres 192.168.1.8 is (vervang dit door het werkelijke serveradres) Toegang tot MyEMS Web UI via http://192.168.1.8 (poort 80 kan worden weggelaten) Toegang tot MyEMS Admin UI via http://192.168.1.8:8001

Standaardwachtwoorden

MyEMS Admin UI

Gebruikersnaam:

administrator

Wachtwoord:

!MyEMS1

MyEMS Web UI

Gebruikersnaam:

administrator@myems.io

Wachtwoord:

!MyEMS1

Problemen oplossen

Als 'error: externally-managed-environment' optreedt bij het uitvoeren van 'sudo pip install -r requirements.txt'

Maak een configuratiemap voor een virtuele omgeving aan:

sudo python -m venv venv

Begin met het gebruik van de virtuele omgeving

source venv/bin/activate

Installeer de vereisten

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

Deactiveer de virtuele omgeving

deactivate

Vereisten​

Stap 1 Database​

Stap 2 myems-api​

Stap 3 myems-admin​

Stap 4 myems-modbus-tcp​

Stap 5 myems-cleaning​

Stap 6 myems-normalization​

Stap 7 myems-aggregation​

Stap 8 myems-web​

Na installatie​

Standaardpoorten​

Standaardwachtwoorden​

Problemen oplossen​

Vereisten

Stap 1 Database

Stap 2 myems-api

Stap 3 myems-admin

Stap 4 myems-modbus-tcp

Stap 5 myems-cleaning

Stap 6 myems-normalization

Stap 7 myems-aggregation

Stap 8 myems-web

Na installatie

Standaardpoorten

Standaardwachtwoorden

Problemen oplossen