Fedora

Dans ce guide, vous allez déployer MyEMS sur un serveur Fedora.

Prérequis

Ce guide détaille l'installation de MyEMS sur Fedora 37 Server. Les exigences matérielles dépendent de la base de données choisie et du nombre de dispositifs connectés au système. Pour exécuter MyEMS et MySQL sur une seule machine, vous aurez besoin d'au moins 4 Go de RAM.

Mettre à jour le système et installer les outils nécessaires

sudo dnf update
sudo dnf install git
sudo dnf install python3-pip

Cloner le code source :

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

Étape 1 Base de données

Voir Base de données

Étape 2 myems-api

Installer le service myems-api :

sudo cp -r ~/myems/myems-api /myems-api
cd /myems-api
sudo pip install -r requirements.txt

Créer le fichier .env à partir de example.env et le modifier si nécessaire :

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

Ouvrir le port dans le pare-feu :

sudo firewall-cmd --add-service=http --permanent
sudo firewall-cmd --zone=public --add-port=8000/tcp --permanent
sudo firewall-cmd --reload

Configurer les fichiers 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/

Activer ensuite les services pour qu'ils démarrent automatiquement au démarrage du système :

sudo systemctl enable myems-api.socket
sudo systemctl enable myems-api.service

Démarrer les services :

sudo systemctl start myems-api.socket
sudo systemctl start myems-api.service

Étape 3 myems-admin

Installer le serveur NGINX Se référer à la documentation officielle : http://nginx.org/en/linux_packages.html#RHEL

Activer le service nginx :

sudo systemctl start nginx.service

Configurer NGINX

sudo nano /etc/nginx/nginx.conf

Dans la section « http », ajouter les directives suivantes :

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

}

Ajouter un nouveau fichier dans le répertoire /etc/nginx/conf.d/

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

Rédiger le fichier avec les directives ci-dessous, et remplacer l'URL par défaut de myems-api http://127.0.0.1:8000/ par l'URL réelle si le service myems-api est hébergé sur un serveur différent

server {
    listen                 8001;
    server_name     myems-admin;
    location / {
        root    /var/www/myems-admin;
        index index.html index.htm;
    }
    ## Pour éviter le problème CORS, utiliser Nginx pour proxyfier myems-api sur le chemin /api
    ## Ajouter une autre location /api dans la section 'server'
    ## Remplacer l'URL par défaut de myems-api http://127.0.0.1:8000/ par l'URL réelle si le service est sur un autre serveur
    location /api {
        proxy_pass http://127.0.0.1:8000/;
        proxy_connect_timeout 75;
        proxy_read_timeout 600;
        send_timeout 600;
    }
}

Installer myems-admin : Si le serveur n'a pas accès à Internet, compresser le dossier myems/myems-admin, l'envoyer sur le serveur puis l'extraire dans ~/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

Vérifier le fichier de configuration et le modifier si nécessaire :

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

Attention

Le dossier « upload » stocke les fichiers téléchargés par les utilisateurs. NE PAS supprimer, déplacer ou écraser ce dossier lors de la mise à jour de myems-admin.

 /var/www/myems-admin/upload

Ouvrir le port et l'ajouter au pare-feu :

sudo firewall-cmd --add-service=http --permanent
sudo firewall-cmd --zone=public --add-port=8001/tcp --permanent
sudo firewall-cmd --reload

Redémarrer le service nginx :

sudo systemctl restart nginx.service

Astuce

Si vous rencontrez l'erreur nginx « 403 Forbidden », vous pouvez la corriger en modifiant le mode SELinux avec la commande 'sudo setenforce 0'

Étape 4 myems-modbus-tcp

Dans cette étape, vous allez installer le service myems-modbus-tcp.

sudo cp -r ~/myems/myems-modbus-tcp /myems-modbus-tcp
cd /myems-modbus-tcp
sudo pip install -r requirements.txt

Copier le fichier example.env en .env et modifier le fichier .env :

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

Configurer le service systemd :

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

Activer le service :

sudo systemctl enable myems-modbus-tcp.service

Démarrer le service :

sudo systemctl start myems-modbus-tcp.service

Surveiller le service :

sudo systemctl status myems-modbus-tcp.service

Consulter les logs :

cat /myems-modbus-tcp.log

Étape 5 myems-cleaning

Dans cette étape, vous allez installer le service myems-cleaning.

sudo cp -r ~/myems/myems-cleaning /myems-cleaning
cd /myems-cleaning
sudo pip install -r requirements.txt

Copier le fichier example.env en .env et modifier le fichier .env :

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

Configurer le service systemd :

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

Activer le service :

sudo systemctl enable myems-cleaning.service

Démarrer le service :

sudo systemctl start myems-cleaning.service

Surveiller le service :

sudo systemctl status myems-cleaning.service

Consulter les logs :

cat /myems-cleaning.log

Étape 6 myems-normalization

Dans cette étape, vous allez installer le service myems-normalization.

sudo cp -r ~/myems/myems-normalization /myems-normalization
cd /myems-normalization
sudo pip install -r requirements.txt

Copier le fichier example.env en .env et modifier le fichier .env :

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

Configurer le service systemd :

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

Activer le service :

sudo systemctl enable myems-normalization.service

Démarrer le service :

sudo systemctl start myems-normalization.service

Surveiller le service :

sudo systemctl status myems-normalization.service

Consulter les logs :

cat /myems-normalization.log

Étape 7 myems-aggregation

Dans cette étape, vous allez installer le service myems-aggregation.

sudo cp -r ~/myems/myems-aggregation /myems-aggregation
cd /myems-aggregation
sudo pip install -r requirements.txt

Copier le fichier example.env en .env et modifier le fichier .env :

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

Configurer le service systemd :

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

Activer le service :

sudo systemctl enable myems-aggregation.service

Démarrer le service :

sudo systemctl start myems-aggregation.service

Surveiller le service :

sudo systemctl status myems-aggregation.service

Consulter les logs :

cat /myems-aggregation.log

Étape 8 myems-web

Dans cette étape, vous allez installer le service d'interface myems-web.

Installer le serveur NGINX Se référer à la documentation officielle : http://nginx.org/en/linux_packages.html#RHEL
Configurer NGINX Supprimer les fichiers par défaut

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

Ajouter un nouveau fichier dans le répertoire /etc/nginx/conf.d/

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

Ajouter une nouvelle section « server » avec les directives ci-dessous :

server {
    listen                 80;
    server_name     myems-web;
    location / {
        root    /var/www/myems-web;
        index index.html index.htm;
        # Ajouter la directive try_files pour éviter l'erreur 404 lors du rafraîchissement des pages
        try_files $uri  /index.html;
    }
    ## Pour éviter le problème CORS, utiliser Nginx pour proxyfier myems-api sur le chemin /api
    ## Ajouter une autre location /api dans la section 'server'
    ## Remplacer l'URL par défaut de myems-api http://127.0.0.1:8000/ par l'URL réelle si le service est sur un autre serveur
    location /api {
        proxy_pass http://127.0.0.1:8000/;
        proxy_connect_timeout 75;
        proxy_read_timeout 600;
        send_timeout 600;
    }
}

Installer l'interface MyEMS Web : Configurer NodeJS :

sudo dnf install nodejs

Modifier le fichier config.js :

Note

Obtenir le mapboxToken sur https://mapbox.com, puis définir showOnlineMap sur true. Pour désactiver la carte en ligne, mettre showOnlineMap sur false.

cd ~/myems/myems-web
sudo nano src/config.js

Construire et compresser le projet :

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

Installer l'interface : Envoyer les fichiers sur le serveur web. Attention : le chemin ci-dessous doit correspondre à celui configuré dans nginx.conf.

sudo mv build  /var/www/myems-web

Ouvrir le port et l'ajouter au pare-feu :

sudo firewall-cmd --add-service=http --permanent
sudo firewall-cmd --add-port=80/tcp --permanent
sudo firewall-cmd --reload

Redémarrer le service nginx :

sudo systemctl restart nginx.service

Astuce

Si vous rencontrez l'erreur nginx « 500 Internal Server Error », vous pouvez la corriger en modifiant le mode SELinux avec la commande 'sudo setenforce 0'

Post-installation

Félicitations ! Vous pouvez désormais vous connecter aux interfaces MyEMS Admin et MyEMS Web.

Ports par défaut

MyEMS Web UI : 80 MyEMS API : 8000 MyEMS Admin UI : 8001

En supposant que l'adresse du serveur est 192.168.1.8 (remplacez par votre adresse réelle) Accéder à MyEMS Web UI : http://192.168.1.8 (le port 80 peut être omis) Accéder à MyEMS Admin UI : http://192.168.1.8:8001

Mot de passe par défaut

MyEMS Admin UI Identifiant :

administrator

Mot de passe :

!MyEMS1

MyEMS Web UI Identifiant :

administrator@myems.io

Mot de passe :

!MyEMS1

Prérequis​

Étape 1 Base de données​

Étape 2 myems-api​

Étape 3 myems-admin​

Étape 4 myems-modbus-tcp​

Étape 5 myems-cleaning​

Étape 6 myems-normalization​

Étape 7 myems-aggregation​

Étape 8 myems-web​

Post-installation​

Ports par défaut​

Mot de passe par défaut​

Dépannage​

Prérequis

Étape 1 Base de données

Étape 2 myems-api

Étape 3 myems-admin

Étape 4 myems-modbus-tcp

Étape 5 myems-cleaning

Étape 6 myems-normalization

Étape 7 myems-aggregation

Étape 8 myems-web

Post-installation

Ports par défaut

Mot de passe par défaut

Dépannage