SUSE

Dans ce guide, vous allez déployer MyEMS sur SUSE Linux Enterprise Server.

Prérequis

Ce guide détaille l'installation de MyEMS sur SUSE Linux Enterprise Server 15. Les exigences matérielles dépendent de la base de données choisie et du nombre de périphériques 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.

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 du fichier example.env et le modifier si nécessaire :

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

sudo vi /myems-api/.env

Ouvrir le port dans le pare-feu :

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 à http://nginx.org/en/linux_packages.html#Debian

Activer le service nginx :

sudo systemctl start nginx.service

Configurer NGINX

sudo vi /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 vi /etc/nginx/conf.d/myems-admin.conf

Écrire les directives ci-dessous, 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 vers 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 myems-api est hébergé sur un serveur différent
    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, compressez le dossier myems/myems-admin, téléchargez-le sur le serveur et extrayez-le 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 vi /var/www/myems-admin/app/api.js

Attention

Le dossier « upload » contient 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 dans le pare-feu :

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

sudo firewall-cmd --reload

É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 le modifier :

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

sudo vi /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 le modifier :

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

sudo vi /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 le modifier :

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

sudo vi /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

pip install -r requirements.txt

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

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

vi /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 interface myems-web.

Installer le serveur NGINX Se référer à http://nginx.org/en/linux_packages.html#Debian
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 vers le chemin /api
    ## Ajouter une autre location /api dans la section 'server' et remplacer l'adresse exemple http://127.0.0.1:8000/ par l'URL réelle
    location /api {
        proxy_pass http://127.0.0.1:8000/;
        proxy_connect_timeout 75;
        proxy_read_timeout 600;
        send_timeout 600;
    }
}

Redémarrer NGINX :

sudo systemctl restart nginx

Installer l'interface MyEMS Web UI : Configurer NodeJS :

sudo zypper install -y 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 vi src/config.js

Construire et compresser le projet :

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

sudo npm run build

Installer le projet : Téléchargez les fichiers sur votre serveur web. Notez que le chemin ci-dessous doit correspondre à celui configuré dans nginx.conf.

sudo mv build  /var/www/myems-web

Ouvrir le port dans le pare-feu :

sudo firewall-cmd --zone=public --add-port=80/tcp --permanent

sudo firewall-cmd --reload

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