FreeBSD
In this guide, you will deploy MyEMS on FreeBSD server. In dieser Anleitung stellen Sie MyEMS mit FreeBSD bereit.
Prerequisites
Diese Anleitung beschreibt, wie Sie MyEMS auf FreeBSD 13.2 installieren. Die Hardwareanforderungen hängen von der gewählten Datenbank und der Anzahl der an das System angeschlossenen Geräte ab. Um MyEMS und MySQL auf einem einzigen Rechner laufen zu lassen, benötigen Sie mindestens 4GB RAM.
Aktualisieren Sie das System und installieren Sie Tools:
pkg install git
pkg install python3
pkg install py39-pip-22.3.1
pkg install nginx
pkg install monit
Quellcode klonen:
cd ~
git clone https://github.com/myems/myems
Schritt 1 Database
Siehe Database
Schritt 2 myems-api
- myems-api Dienst installieren:
cp -r ~/myems/myems-api /myems-api
cd /myems-api
pip install -r requirements.txt
Wenn der Fehler „Failed Building Wheel for Pillow“ auftritt, müssen Sie Kissen installieren
Erstellen Sie eine .env basierend auf example.env und bearbeiten Sie die .env bei Bedarf:
cp /myems-api/example.env /myems-api/.env
nano /myems-api/.env
monit einrichten und Dateien konfigurieren:
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
Starten Sie die Dienste:
monit restart
Schritt 3 myems-admin
- NGINX Server installieren
beziehen sich auf http://nginx.org/en/docs/install.html
Enable the nginx service:
service nginx enable
- NGINX einrichten
nano /etc/nginx/nginx.conf
Fügen Sie im Abschnitt "http" einige Richtlinien hinzu:
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;
...
}
Fügen Sie eine neue Datei unter /etc/nginx/conf.d/:
nano /etc/nginx/conf.d/myems-admin.conf
Schreiben Sie mit Direktiven wie unten, ersetzen Sie die Standard-myems-api URL http://127.0.0.1:8000/ mit tatsächlicher URL, wenn die myems-ap servcie auf einem anderen Server gehostet wird
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;
}
}
- myems-admin installieren : Wenn der Server keine Verbindung zum Internet herstellen kann, komprimieren Sie bitte den Ordner myems/myems-admin und laden Sie ihn auf den Server hoch und extrahieren Sie ihn in ~/myems/myems-admin
mkdir /var/www
cp -r ~/myems/myems-admin /var/www/myems-admin
chmod 0755 /var/www/myems-admin
Überprüfen Sie die Konfigurationsdatei und ändern Sie sie bei Bedarf:
nano /var/www/myems-admin/app/api.js
Der Ordner "upload" ist für vom Benutzer hochgeladene Dateien. Löschen/verschieben/überschreiben Sie NICHT den 'upload' Ordner, wenn Sie myems-admin aktualisiert haben.
/var/www/myems-admin/upload
Starten Sie den nginx-Dienst neu:
service nginx restart
Wenn der Nginx-Fehler „403 Forbidden“ auftritt, können Sie ihn beheben, indem Sie den SELinx-Modus mit dem Befehl „sudo setenforce 0“ ändern.
Schritt 4 myems-modbus-tcp
In diesem Schritt installieren Sie den Dienst myems-modbus-tcp.
cp -r ~/myems/myems-modbus-tcp /myems-modbus-tcp
cd /myems-modbus-tcp
pip install -r requirements.txt
Kopieren Sie die Datei exmaple.env in .env und ändern Sie die Datei .env:
cp /myems-modbus-tcp/example.env /myems-modbus-tcp/.env
nano /myems-modbus-tcp/.env
monit Dienst einrichten:
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
Starten Sie den Dienst:
monit restart
Schritt 5 myems-cleaning
In diesem Schritt installieren Sie den myems-cleaning Service.
cp -r ~/myems/myems-cleaning /myems-cleaning
cd /myems-cleaning
pip install -r requirements.txt
Kopieren Sie die Datei exmaple.env in .env und ändern Sie die Datei .env:
cp /myems-cleaning/example.env /myems-cleaning/.env
nano /myems-cleaning/.env
monit Dienst einrichten:
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
Starten Sie den Dienst:
monit restart
Schritt 6 myems-normalization
In diesem Schritt installieren Sie den myems-normalization service.
cp -r ~/myems/myems-normalization /myems-normalization
cd /myems-normalization
pip install -r requirements.txt
Kopieren Sie die Datei exmaple.env in .env und ändern Sie die Datei .env:
cp /myems-normalization/example.env /myems-normalization/.env
nano /myems-normalization/.env
monit Dienst einrichten:
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
Starten Sie den Dienst:
monit restart
Schritt 7 myems-aggregation
In diesem Schritt installieren Sie den myems-aggregation service.
cp -r ~/myems/myems-aggregation /myems-aggregation
cd /myems-aggregation
pip install -r requirements.txt
Kopieren Sie die Datei exmaple.env in .env und ändern Sie die Datei .env:
cp /myems-aggregation/example.env /myems-aggregation/.env
nano /myems-aggregation/.env
monit Dienst einrichten:
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
Starten Sie den Dienst:
monit restart
Step 8 myems-web
In diesem Schritt installieren Sie den myems-web UI Service.
- NGINX-Server installieren
beziehen sich auf http://nginx.org/en/docs/install.html
- Konfigurieren Sie NGINX
nano /etc/nginx/nginx.conf
Fügen Sie im Abschnitt 'http' einige Anweisungen hinzu:
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;
...
}
Aktualisieren der nginx Standard-Conf-Datei:
nano /etc/nginx/conf.d/default.conf
Schreiben Sie mit Direktiven wie unten und ersetzen Sie die Standard-myems-api-URL http://127.0.0.1:8000/ mit tatsächlicher URL, wenn die myems-api-Servcie auf einem anderen Server gehostet wird
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;
}
}
- MyEMS Web UI installieren:
NodeJS einrichten:
pkg install node-18.16.0
Konfigurationsdateien ändern:
Von https://mapbox.com Holen Sie sich das mapboxToken und setzen Sie showOnlineMap auf true Wenn Sie die Online-Kartenfunktion deaktivieren möchten, setzen Sie showOnlineMap auf false
cd ~/myems/myems-web
nano src/config.js
Erstellen:
npm i --unsafe-perm=true --allow-root --legacy-peer-deps
npm run build
Installieren Beachten Sie, dass der folgende Pfad mit dem in nginx.conf konfigurierten identisch sein sollte.
rm -r /var/www/myems-web
mv build /var/www/myems-web
Starten Sie NGINX neu
service nginx restart
Post-installation## Nach der Installation
Glückwunsch! Sie können sich jetzt bei der MyEMS Admin-Benutzeroberfläche und der Web-Benutzeroberfläche anmelden.
Standardports
MyEMS Web UI: 80
MyEMS API: 8000
MyEMS Admin UI: 8001
Standardpasswörter
Admin UI
administrator
!MyEMS1
Web UI
administrator@myems.io
!MyEMS1