FreeBSD

In questa guida, installerai MyEMS su un server FreeBSD.

Prerequisiti

Questa guida descrive come installare MyEMS su FreeBSD 13.2. I requisiti hardware dipendono dal database scelto e dal numero di dispositivi collegati al sistema. Per eseguire MyEMS e MySQL su una singola macchina sono necessari almeno 4GB di RAM.

Aggiorna il sistema e installa gli strumenti

pkg install git

pkg install python3

pkg install py39-pip-22.3.1

pkg install nginx

pkg install monit

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:

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

cd /myems-api

pip install -r requirements.txt

Suggerimento

Se riscontri l'errore 'Failed building wheel for pillow', consulta Installazione Pillow

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

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

nano /myems-api/.env

Utilizza il servizio di monitoraggio monit e modifica il file di configurazione monit:

nano /etc/monit.d/myems-api
check process mymes-api with pidfile /var/run/myems-api/pid
start program = "/usr/local/bin/gunicorn -b 0.0.0.0:8000 --pid /var/run/myems-api/pid --timeout 600 --workers=4 app:api &"
stop program = "/bin/kill -s TERM $MAINPID"
if 3 restarts within 5 cycles then unmonitor

Avvia i servizi:

monit restart

Passo 3 myems-admin

Installa il server NGINX

Consulta http://nginx.org/en/docs/install.html

Abilita il servizio nginx:

service nginx enable

Configura NGINX

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 sotto /etc/nginx/conf.d/

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

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

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 different server
    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, caricala sul server ed estraila in ~/myems/myems-admin

mkdir /var/www

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

chmod 0755 /var/www/myems-admin

Controlla il file di configurazione e modificalo se necessario:

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

Attenzione

La cartella 'upload' è destinata ai file caricati dagli utenti. NON eliminare/spostare/sovrascrivere la cartella 'upload' quando aggiorni myems-admin.

 /var/www/myems-admin/upload

Riavvia il servizio nginx:

service nginx restart

Passo 4 myems-modbus-tcp

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

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

cd /myems-modbus-tcp

pip install -r requirements.txt

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

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

nano /myems-modbus-tcp/.env

Utilizza il servizio di monitoraggio monit e modifica il file di configurazione monit:

nano /etc/monit.d/myems-modbus-tcp
check file myems-modbus-tcp path /myems-modbus-tcp/main.py
start program = "/usr/local/bin/python3 /myems-modbus-tcp/main.py"
stop program = "/bin/kill -s TERM $MAINPID"
if 3 restarts within 5 cycles then unmonitor

Avvia il servizio:

monit restart

Passo 5 myems-cleaning

In questo passaggio, installerai il servizio myems-cleaning.

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

cd /myems-cleaning

pip install -r requirements.txt

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

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

nano /myems-cleaning/.env

Utilizza il servizio di monitoraggio monit e modifica il file di configurazione monit:

nano /etc/monit.d/myems-cleaning
check file myems-cleaning path /myems-cleaning/main.py
start program = "/usr/local/bin/python3 /myems-cleaning/main.py"
stop program = "/bin/kill -s TERM $MAINPID"
if 3 restarts within 5 cycles then unmonitor

Avvia il servizio:

monit restart

Passo 6 myems-normalization

In questo passaggio, installerai il servizio myems-normalization.

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

cd /myems-normalization

pip install -r requirements.txt

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

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

nano /myems-normalization/.env

Utilizza il servizio di monitoraggio monit e modifica il file di configurazione monit:

nano /etc/monit.d/myems-normalization
check file myems-normalization path /myems-normalization/main.py
start program = "/usr/local/bin/python3 /myems-normalization/main.py"
stop program = "/bin/kill -s TERM $MAINPID"
if 3 restarts within 5 cycles then unmonitor

Avvia il servizio:

monit restart

Passo 7 myems-aggregation

In questo passaggio, installerai il servizio myems-aggregation.

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

cd /myems-aggregation

pip install -r requirements.txt

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

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

nano /myems-aggregation/.env

Utilizza il servizio di monitoraggio monit e modifica il file di configurazione monit:

nano /etc/monit.d/myems-aggregation
check file myems-aggregation path /myems-aggregation/main.py
start program = "/usr/local/bin/python3 /myems-aggregation/main.py"
stop program = "/bin/kill -s TERM $MAINPID"
if 3 restarts within 5 cycles then unmonitor

Avvia il servizio:

monit restart

Passo 8 myems-web

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

Installa il server NGINX

Consulta http://nginx.org/en/docs/install.html

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 sotto /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;
        # add try_files directive to avoid 404 error while refreshing pages
        try_files $uri  /index.html;
    }
    ## 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 different server
    location /api {
        proxy_pass http://127.0.0.1:8000/;
        proxy_connect_timeout 75;
        proxy_read_timeout 600;
        send_timeout 600;
    }
}

Install MyEMS Web UI:

Installa NodeJS:

pkg install node-18.16.0

Modifica il file config.js:

Nota

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

cd ~/myems/myems-web

nano src/config.js

Compila

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

npm run build

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

rm -r /var/www/myems-web

mv build  /var/www/myems-web

Riavvia il servizio nginx:

service nginx restart

Post-installazione

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

Porte predefinite

MyEMS Web UI: 80

MyEMS API: 8000

MyEMS Admin UI: 8001

Supponendo che l'indirizzo del server sia 192.168.1.8 (sostituisci con l'indirizzo reale) Accedi a MyEMS Web UI su http://192.168.1.8 (80 può essere omesso) Accedi a MyEMS Admin UI su http://192.168.1.8:8001

Password predefinite

MyEMS Admin UI

Nome utente:

administrator

Password:

!MyEMS1

MyEMS Web UI

Nome utente:

administrator@myems.io

Password:

!MyEMS1

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