Debian/Ubuntu

W tym przewodniku wdrożysz MyEMS na serwerze Debian lub Ubuntu.

Wymagania wstępne

Ten przewodnik opisuje, jak zainstalować MyEMS na 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. Wymagania sprzętowe zależą od wybranej bazy danych oraz liczby urządzeń podłączonych do systemu. Aby uruchomić MyEMS i MySQL na jednej maszynie, potrzebujesz co najmniej 4 GB pamięci RAM.

Sklonuj kod źródłowy:

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

Krok 1 Baza danych

Zobacz Baza danych

Krok 2 myems-api

Zainstaluj usługę myems-api:

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

cd /myems-api

sudo apt install python3-pip

sudo pip install -r requirements.txt

Uwaga

(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

Utwórz plik .env na podstawie example.env i edytuj go w razie potrzeby:

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

sudo nano /myems-api/.env

Dodaj port do zapory:

sudo ufw allow 8000

Skonfiguruj pliki 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/

Następnie włącz usługi, aby uruchamiały się automatycznie przy starcie systemu:

sudo systemctl enable myems-api.socket

sudo systemctl enable myems-api.service

Uruchom usługi:

sudo systemctl start myems-api.socket

sudo systemctl start myems-api.service

Krok 3 myems-admin

Zainstaluj serwer NGINX

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

Włącz usługę nginx:

sudo systemctl start nginx.service

Skonfiguruj NGINX

sudo nano /etc/nginx/nginx.conf

W sekcji 'http' dodaj następujące dyrektywy:

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

}

Dodaj nowy plik w katalogu /etc/nginx/conf.d/

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

Wypełnij plik poniższymi dyrektywami i zamień domyślny adres myems-api http://127.0.0.1:8000/ na właściwy, jeśli usługa myems-api jest uruchomiona na innym serwerze

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

Zainstaluj myems-admin: Jeśli serwer nie ma dostępu do internetu, skompresuj folder myems/myems-admin, prześlij go na serwer i rozpakuj do ~/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

Sprawdź plik konfiguracyjny i zmień go w razie potrzeby:

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

Ostrzeżenie

Folder 'upload' służy do przechowywania plików przesłanych przez użytkowników. NIE usuwaj/przenoś/nie nadpisuj folderu 'upload' podczas aktualizacji myems-admin.

 /var/www/myems-admin/upload

Dodaj port do zapory:

sudo ufw allow 8001

Zrestartuj usługę nginx:

sudo systemctl restart nginx.service

Krok 4 myems-modbus-tcp

W tym kroku zainstalujesz usługę myems-modbus-tcp.

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

cd /myems-modbus-tcp

sudo pip install -r requirements.txt

Uwaga

(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

Skopiuj plik example.env do .env i zmodyfikuj plik .env:

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

sudo nano /myems-modbus-tcp/.env

Skonfiguruj usługę systemd:

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

Włącz usługę:

sudo systemctl enable myems-modbus-tcp.service

Uruchom usługę:

sudo systemctl start myems-modbus-tcp.service

Monitoruj usługę:

sudo systemctl status myems-modbus-tcp.service

Wyświetl log:

cat /myems-modbus-tcp.log

Krok 5 myems-cleaning

W tym kroku zainstalujesz usługę myems-cleaning.

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

cd /myems-cleaning

sudo pip install -r requirements.txt

Uwaga

(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

Skopiuj plik example.env do .env i zmodyfikuj plik .env:

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

sudo nano /myems-cleaning/.env

Skonfiguruj usługę systemd:

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

Włącz usługę:

sudo systemctl enable myems-cleaning.service

Uruchom usługę:

sudo systemctl start myems-cleaning.service

Monitoruj usługę:

sudo systemctl status myems-cleaning.service

Wyświetl log:

cat /myems-cleaning.log

Krok 6 myems-normalization

W tym kroku zainstalujesz usługę myems-normalization.

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

cd /myems-normalization

sudo pip install -r requirements.txt

Uwaga

(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

Skopiuj plik example.env do .env i zmodyfikuj plik .env:

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

sudo nano /myems-normalization/.env

Skonfiguruj usługę systemd:

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

Włącz usługę:

sudo systemctl enable myems-normalization.service

Uruchom usługę:

sudo systemctl start myems-normalization.service

Monitoruj usługę:

sudo systemctl status myems-normalization.service

Wyświetl log:

cat /myems-normalization.log

Krok 7 myems-aggregation

W tym kroku zainstalujesz usługę myems-aggregation.

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

cd /myems-aggregation

sudo pip install -r requirements.txt

Uwaga

(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

Skopiuj plik example.env do .env i zmodyfikuj plik .env:

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

sudo nano /myems-aggregation/.env

Skonfiguruj usługę systemd:

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

Włącz usługę:

sudo systemctl enable myems-aggregation.service

Uruchom usługę:

sudo systemctl start myems-aggregation.service

Monitoruj usługę:

sudo systemctl status myems-aggregation.service

Wyświetl log:

cat /myems-aggregation.log

Krok 8 myems-web

W tym kroku zainstalujesz usługę interfejsu MyEMS Web UI.

Zainstaluj serwer NGINX zobacz: http://nginx.org/en/linux_packages.html#Debian
Skonfiguruj NGINX

Usuń domyślne pliki

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

Dodaj nowy plik w katalogu /etc/nginx/conf.d/

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

Dodaj nową sekcję 'server' z poniższymi dyrektywami:

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' and replace demo address http://127.0.0.1:8000/ with actual url
    location /api {
        proxy_pass http://127.0.0.1:8000/;
        proxy_connect_timeout 75;
        proxy_read_timeout 600;
        send_timeout 600;
    }
}

Zrestartuj NGINX

sudo systemctl restart nginx

Zainstaluj MyEMS Web UI:

Skonfiguruj NodeJS:

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

sudo apt-get install -y nodejs

Zmodyfikuj plik config.js:

Uwaga

Uzyskaj mapboxToken na stronie https://mapbox.com i ustaw showOnlineMap na true. Jeśli chcesz wyłączyć funkcję mapy online, ustaw showOnlineMap na false

cd myems/myems-web

sudo nano src/config.js

Zbuduj

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

sudo npm run build

Instalacja Zwróć uwagę, że poniższa ścieżka powinna być taka sama, jak skonfigurowana w nginx.conf.

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

sudo mv build  /var/www/myems-web

Dodaj port do zapory:

sudo ufw allow 80

Zrestartuj NGINX

sudo systemctl restart nginx

Po instalacji

Gratulacje! Możesz teraz zalogować się do MyEMS Admin UI i Web UI.

Domyślne porty

MyEMS Web UI: 80

MyEMS API: 8000

MyEMS Admin UI: 8001

Zakładając, że adres serwera to 192.168.1.8 (zamień na właściwy adres serwera) Uzyskaj dostęp do MyEMS Web UI pod adresem http://192.168.1.8 (80 można pominąć) Uzyskaj dostęp do MyEMS Admin UI pod adresem http://192.168.1.8:8001

Domyślne hasła

MyEMS Admin UI

Nazwa użytkownika:

administrator

Hasło:

!MyEMS1

MyEMS Web UI

Nazwa użytkownika:

administrator@myems.io

Hasło:

!MyEMS1

Rozwiązywanie problemów

If 'error: externally-managed-environment' occurs when executing 'sudo pip install -r requirements.txt'

Create a virtual environment configuration directory:

sudo python -m venv venv

Start using the virtual environment

source venv/bin/activate

Install the requirements

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

Deactivate the virtual environment

deactivate

Wymagania wstępne​

Krok 1 Baza danych​

Krok 2 myems-api​

Krok 3 myems-admin​

Krok 4 myems-modbus-tcp​

Krok 5 myems-cleaning​

Krok 6 myems-normalization​

Krok 7 myems-aggregation​

Krok 8 myems-web​

Po instalacji​

Domyślne porty​

Domyślne hasła​

Rozwiązywanie problemów​

Wymagania wstępne

Krok 1 Baza danych

Krok 2 myems-api

Krok 3 myems-admin

Krok 4 myems-modbus-tcp

Krok 5 myems-cleaning

Krok 6 myems-normalization

Krok 7 myems-aggregation

Krok 8 myems-web

Po instalacji

Domyślne porty

Domyślne hasła

Rozwiązywanie problemów