Debian/Ubuntu

In questa guida, distribuirai MyEMS su un server Debian o Ubuntu.

Prerequisiti

Questa guida descrive come installare MyEMS su 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. I requisiti hardware dipendono dal database scelto e dal numero di dispositivi connessi al sistema. Per eseguire MyEMS e MySQL su una singola macchina avrai bisogno di almeno 4GB di RAM.

Clona il codice sorgente:

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

Passo 1 Database

Vedi Database

Passo 2 myems-api

Installa il servizio myems-api:

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

cd /myems-api

sudo apt install python3-pip

sudo pip install -r requirements.txt

Nota

(Ubuntu 24.04 LTS) Se il codice non funziona, puoi usare il seguente codice: sudo pip install -r requirements.txt --break-system-packages

Crea il file .env basato su example.env e modifica il file .env se necessario:

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

sudo nano /myems-api/.env

Aggiungi la porta al firewall:

sudo ufw allow 8000

Configura i file di configurazione 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/

Successivamente abilita i servizi in modo che partano automaticamente all'avvio:

sudo systemctl enable myems-api.socket

sudo systemctl enable myems-api.service

Avvia i servizi:

sudo systemctl start myems-api.socket

sudo systemctl start myems-api.service

Passo 3 myems-admin

Installa il server NGINX

riferimento a http://nginx.org/en/linux_packages.html#Debian

Abilita il servizio nginx:

sudo systemctl start nginx.service

Configura NGINX

sudo nano /etc/nginx/nginx.conf

Nella sezione 'http', aggiungi alcune direttive:

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

}

Aggiungi un nuovo file in /etc/nginx/conf.d/

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

Scrivi con le direttive come sotto, sostituisci l'URL predefinito di myems-api http://127.0.0.1:8000/ con l'URL effettivo se il servizio myems-api è ospitato su un server diverso

server {
    listen                 8001;
    server_name     myems-admin;
    location / {
        root    /var/www/myems-admin;
        index index.html index.htm;
    }
    ## Per evitare problemi di CORS, usa Nginx per fare il proxy di myems-api al percorso /api
    ## Aggiungi un'altra location /api in 'server'
    ## Sostituisci l'URL predefinito di myems-api http://127.0.0.1:8000/ con l'URL effettivo se il servizio myems-api è ospitato su un server diverso
    location /api {
        proxy_pass http://127.0.0.1:8000/;
        proxy_connect_timeout 75;
        proxy_read_timeout 600;
        send_timeout 600;
    }
}

Installa myems-admin : Se il server non può connettersi a internet, comprimi la cartella myems/myems-admin e caricala sul server e estraila in ~/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

Controlla il file di configurazione e modificalo se necessario:

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

Attenzione

La cartella 'upload' è per i file caricati dall'utente. NON eliminare/spostare/sovrascrivere la cartella 'upload' quando aggiorni myems-admin.

 /var/www/myems-admin/upload

Aggiungi la porta al firewall:

sudo ufw allow 8001

Riavvia il servizio nginx:

sudo systemctl restart nginx.service

Passo 4 myems-modbus-tcp

In questo passo, installerai il servizio myems-modbus-tcp.

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

cd /myems-modbus-tcp

sudo pip install -r requirements.txt

Nota

(Ubuntu 24.04 LTS) Se il codice non funziona, puoi usare il seguente codice: sudo pip install -r requirements.txt --break-system-packages

Copia il file example.env in .env e modifica il file .env:

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

sudo nano /myems-modbus-tcp/.env

Configura il servizio systemd:

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

Abilita il servizio:

sudo systemctl enable myems-modbus-tcp.service

Avvia il servizio:

sudo systemctl start myems-modbus-tcp.service

Monitora il servizio:

sudo systemctl status myems-modbus-tcp.service

Visualizza il log:

cat /myems-modbus-tcp.log

Passo 5 myems-cleaning

In questo passo, installerai il servizio myems-cleaning.

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

cd /myems-cleaning

sudo pip install -r requirements.txt

Nota

(Ubuntu 24.04 LTS) Se il codice non funziona, puoi usare il seguente codice: sudo pip install -r requirements.txt --break-system-packages

Copia il file example.env in .env e modifica il file .env:

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

sudo nano /myems-cleaning/.env

Configura il servizio systemd:

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

Abilita il servizio:

sudo systemctl enable myems-cleaning.service

Avvia il servizio:

sudo systemctl start myems-cleaning.service

Monitora il servizio:

sudo systemctl status myems-cleaning.service

Visualizza il log:

cat /myems-cleaning.log

Passo 6 myems-normalization

In questo passo, installerai il servizio myems-normalization.

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

cd /myems-normalization

sudo pip install -r requirements.txt

Nota

(Ubuntu 24.04 LTS) Se il codice non funziona, puoi usare il seguente codice: sudo pip install -r requirements.txt --break-system-packages

Copia il file example.env in .env e modifica il file .env:

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

sudo nano /myems-normalization/.env

Configura il servizio systemd:

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

Abilita il servizio:

sudo systemctl enable myems-normalization.service

Avvia il servizio:

sudo systemctl start myems-normalization.service

Monitora il servizio:

sudo systemctl status myems-normalization.service

Visualizza il log:

cat /myems-normalization.log

Passo 7 myems-aggregation

In questo passo, installerai il servizio myems-aggregation.

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

cd /myems-aggregation

sudo pip install -r requirements.txt

Nota

(Ubuntu 24.04 LTS) Se il codice non funziona, puoi usare il seguente codice: sudo pip install -r requirements.txt --break-system-packages

Copia il file example.env in .env e modifica il file .env:

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

sudo nano /myems-aggregation/.env

Configura il servizio systemd:

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

Abilita il servizio:

sudo systemctl enable myems-aggregation.service

Avvia il servizio:

sudo systemctl start myems-aggregation.service

Monitora il servizio:

sudo systemctl status myems-aggregation.service

Visualizza il log:

cat /myems-aggregation.log

Passo 8 myems-web

In questo passo, installerai il servizio UI myems-web.

Installa il server NGINX riferimento a http://nginx.org/en/linux_packages.html#Debian
Configura NGINX

Rimuovi i file predefiniti

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

Aggiungi un nuovo file in /etc/nginx/conf.d/

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

Aggiungi una nuova sezione 'server' con le direttive come sotto:

server {
    listen                 80;
    server_name     myems-web;
    location / {
        root    /var/www/myems-web;
        index index.html index.htm;
        # aggiungi la direttiva try_files per evitare l'errore 404 durante il refresh delle pagine
        try_files $uri  /index.html;
    }
    ## Per evitare problemi di CORS, usa Nginx per fare il proxy di myems-api al percorso /api
    ## Aggiungi un'altra location /api in 'server' e sostituisci l'indirizzo demo http://127.0.0.1:8000/ con l'URL effettivo
    location /api {
        proxy_pass http://127.0.0.1:8000/;
        proxy_connect_timeout 75;
        proxy_read_timeout 600;
        send_timeout 600;
    }
}

Riavvia NGINX

sudo systemctl restart nginx

Installa l'interfaccia utente web di MyEMS:

Configura NodeJS:

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

sudo apt-get install -y nodejs

Modifica il file config.js:

Nota

Ottieni il mapboxToken su https://mapbox.com e poi imposta showOnlineMap su true. Se vuoi disattivare la funzionalità mappa online, imposta showOnlineMap su false

cd myems/myems-web

sudo nano src/config.js

Compila

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

sudo npm run build

Installa Nota che il percorso seguente dovrebbe essere lo stesso configurato in nginx.conf.

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

sudo mv build  /var/www/myems-web

Aggiungi la porta al firewall:

sudo ufw allow 80

Riavvia NGINX

sudo systemctl restart nginx

Post-installazione

Congratulazioni! Ora puoi accedere all'interfaccia utente Admin e Web di MyEMS.

Porte predefinite

Interfaccia utente web di MyEMS: 80

MyEMS API: 8000

Interfaccia utente Admin di MyEMS: 8001

Supponendo che l'indirizzo del server sia 192.168.1.8 (sostituisci con l'indirizzo effettivo del server) Accedi all'interfaccia utente web di MyEMS su http://192.168.1.8 (80 può essere omesso) Accedi all'interfaccia utente Admin di MyEMS su http://192.168.1.8:8001

Password predefinite

Interfaccia utente Admin di MyEMS

Username:

administrator

Password:

!MyEMS1

Interfaccia utente web di MyEMS

Username:

administrator@myems.io

Password:

!MyEMS1

Risoluzione dei problemi

Se si verifica 'error: externally-managed-environment' quando esegui 'sudo pip install -r requirements.txt'

Crea una directory di configurazione dell'ambiente virtuale:

sudo python -m venv venv

Inizia a usare l'ambiente virtuale

source venv/bin/activate

Installa i requisiti

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

Disattiva l'ambiente virtuale

deactivate

Prerequisiti​

Passo 1 Database​

Passo 2 myems-api​

Passo 3 myems-admin​

Passo 4 myems-modbus-tcp​

Passo 5 myems-cleaning​

Passo 6 myems-normalization​

Passo 7 myems-aggregation​

Passo 8 myems-web​

Post-installazione​

Porte predefinite​

Password predefinite​

Risoluzione dei problemi​

Prerequisiti

Passo 1 Database

Passo 2 myems-api

Passo 3 myems-admin

Passo 4 myems-modbus-tcp

Passo 5 myems-cleaning

Passo 6 myems-normalization

Passo 7 myems-aggregation

Passo 8 myems-web

Post-installazione

Porte predefinite

Password predefinite

Risoluzione dei problemi