MyEMS installeren op FreeBSD
In deze handleiding implementeer je MyEMS op een FreeBSD-server.
Vereisten
Deze handleiding beschrijft hoe je MyEMS installeert op FreeBSD 13.2. De hardwarevereisten zijn afhankelijk van de gekozen database en het aantal apparaten dat aan het systeem is verbonden. Om MyEMS en MySQL op één machine te draaien, heb je minimaal 8GB RAM nodig.
Systeem bijwerken en tools installeren:
pkg install git
pkg install python3
pkg install py39-pip-22.3.1
pkg install nginx
pkg install monit
Broncode klonen:
cd ~
git clone https://github.com/myems/myems
Stap 1 Database
Zie Database
Stap 2 myems-api
- myems-api-service installeren:
cp -r ~/myems/myems-api /myems-api
cd /myems-api
pip install -r requirements.txt
Als je de fout 'Failed building wheel for pillow' tegenkomt, moet je Pillow installeren
.env-bestand aanmaken op basis van example.env en het .env-bestand bewerken indien nodig:
cp /myems-api/example.env /myems-api/.env
nano /myems-api/.env
De monit-monitoringservice gebruiken en het monit-configuratiebestand bewerken:
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
Services starten:
monit restart
Stap 3 myems-admin
- NGINX-server installeren
Zie http://nginx.org/en/docs/install.html
NGINX-service activeren:
service nginx enable
- NGINX configureren
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;
...
}
Een nieuw bestand toevoegen onder /etc/nginx/conf.d/:
nano /etc/nginx/conf.d/myems-admin.conf
Schrijf de volgende richtlijnen 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 wordt gehost:
server {
listen 8001;
server_name myems-admin;
location / {
root /var/www/myems-admin;
index index.html index.htm;
}
## Om CORS-problemen te voorkomen, gebruik Nginx om myems-api te proxy'en naar het pad /api
## Voeg een andere locatie /api toe in 'server'
## 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 wordt gehost
location /api {
proxy_pass http://127.0.0.1:8000/;
proxy_connect_timeout 75;
proxy_read_timeout 600;
send_timeout 600;
}
}
- myems-admin installeren: Als de server geen verbinding met internet kan maken, comprimeer dan de map myems/myems-admin en upload deze naar de server en pak deze uit naar ~/myems/myems-admin
mkdir /var/www
cp -r ~/myems/myems-admin /var/www/myems-admin
chmod 0755 /var/www/myems-admin
De map 'upload' is bedoeld voor door gebruikers geüploade bestanden. VERWIJDER/VERPLAAT/OVEERSCHRIJ DE MAP 'upload' NIET wanneer je myems-admin bijwerkt.
/var/www/myems-admin/upload
NGINX-service herstarten:
service nginx restart