CentOS/RHEL/Rocky/AlmaLinux/Oracle Linux

En esta guía, desplegarás MyEMS en un servidor CentOS o RHEL.

Requisitos previos

Esta guía describe cómo instalar MyEMS en CentOS Stream 9 / Red Hat Enterprise Linux 9 (RHEL 9) / Rocky 9 / AlmaLinux 9.1 / Oracle Linux 9.1. Los requisitos de hardware dependen de la base de datos elegida y la cantidad de dispositivos conectados al sistema. Para ejecutar MyEMS y MySQL en una sola máquina, necesitarás al menos 4GB de RAM.

Actualiza el sistema e instala las herramientas

sudo dnf update

sudo dnf install git

sudo dnf install python3-pip

Clona el código fuente:

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

Paso 1 Base de datos

Consulta Base de datos

Paso 2 myems-api

Instala el servicio myems-api:

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

cd /myems-api

sudo pip install -r requirements.txt

Nota

(CentOS Stream 9/RHEL 9/Rocky 9/AlmaLinux 9.1/Oracle Linux 9.1) Si el código no funciona, puedes usar el siguiente comando: sudo pip install -r requirements.txt --break-system-packages

Crea el archivo .env basado en example.env y edítalo si es necesario:

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

sudo nano /myems-api/.env

Agrega el puerto al firewall:

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

sudo firewall-cmd --reload

Configura los archivos de 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/

Luego habilita los servicios para que se inicien automáticamente al arrancar:

sudo systemctl enable myems-api.socket

sudo systemctl enable myems-api.service

Inicia los servicios:

sudo systemctl start myems-api.socket

sudo systemctl start myems-api.service

Paso 3 myems-admin

Instala el servidor NGINX

Consulta http://nginx.org/en/linux_packages.html#RHEL

Habilita el servicio nginx:

sudo systemctl start nginx.service

Configura NGINX

sudo nano /etc/nginx/nginx.conf

En la sección 'http', agrega algunas directivas:

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

}

Agrega un nuevo archivo en /etc/nginx/conf.d/

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

Escribe las directivas como se muestra a continuación y reemplaza la URL predeterminada de myems-api http://127.0.0.1:8000/ por la URL real si el servicio myems-api está alojado en otro servidor.

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

Instala myems-admin: Si el servidor no puede conectarse a Internet, comprime la carpeta myems/myems-admin, súbela al servidor y extráela en ~/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

Verifica el archivo de configuración y cámbialo si es necesario:

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

Precaución

La carpeta 'upload' es para archivos subidos por el usuario. NO elimines, muevas ni sobrescribas la carpeta 'upload' cuando actualices myems-admin.

 /var/www/myems-admin/upload

Desbloquea el puerto y agrégalo al firewall:

sudo semanage port -a -t http_port_t  -p tcp 8001

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

sudo firewall-cmd --reload

Reinicia el servicio nginx:

sudo systemctl restart nginx.service

Consejo

Si encuentras el error '403 Forbidden' de nginx, puedes solucionarlo cambiando el modo de SELinux con el comando 'sudo setenforce 0'

Paso 4 myems-modbus-tcp

En este paso, instalarás el servicio myems-modbus-tcp.

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

cd /myems-modbus-tcp

sudo pip install -r requirements.txt

Nota

(CentOS Stream 9/RHEL 9/Rocky 9/AlmaLinux 9.1/Oracle Linux 9.1) Si el código no funciona, puedes usar el siguiente comando: sudo pip install -r requirements.txt --break-system-packages

Copia el archivo exmaple.env a .env y modifícalo:

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

sudo nano /myems-modbus-tcp/.env

Configura el servicio systemd:

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

Habilita el servicio:

sudo systemctl enable myems-modbus-tcp.service

Inicia el servicio:

sudo systemctl start myems-modbus-tcp.service

Monitorea el servicio:

sudo systemctl status myems-modbus-tcp.service

Visualiza el registro:

cat /myems-modbus-tcp.log

Paso 5 myems-cleaning

En este paso, instalarás el servicio myems-cleaning.

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

cd /myems-cleaning

sudo pip install -r requirements.txt

Nota

(CentOS Stream 9/RHEL 9/Rocky 9/AlmaLinux 9.1/Oracle Linux 9.1) Si el código no funciona, puedes usar el siguiente comando: sudo pip install -r requirements.txt --break-system-packages

Copia el archivo exmaple.env a .env y modifícalo:

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

sudo nano /myems-cleaning/.env

Configura el servicio systemd:

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

Habilita el servicio:

sudo systemctl enable myems-cleaning.service

Inicia el servicio:

sudo systemctl start myems-cleaning.service

Monitorea el servicio:

sudo systemctl status myems-cleaning.service

Visualiza el registro:

cat /myems-cleaning.log

Paso 6 myems-normalization

En este paso, instalarás el servicio myems-normalization.

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

cd /myems-normalization

sudo pip install -r requirements.txt

Nota

(CentOS Stream 9/RHEL 9/Rocky 9/AlmaLinux 9.1/Oracle Linux 9.1) Si el código no funciona, puedes usar el siguiente comando: sudo pip install -r requirements.txt --break-system-packages

Copia el archivo exmaple.env a .env y modifícalo:

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

sudo nano /myems-normalization/.env

Configura el servicio systemd:

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

Habilita el servicio:

sudo systemctl enable myems-normalization.service

Inicia el servicio:

sudo systemctl start myems-normalization.service

Monitorea el servicio:

sudo systemctl status myems-normalization.service

Visualiza el registro:

cat /myems-normalization.log

Paso 7 myems-aggregation

En este paso, instalarás el servicio myems-aggregation.

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

cd /myems-aggregation

sudo pip install -r requirements.txt

Nota

(CentOS Stream 9/RHEL 9/Rocky 9/AlmaLinux 9.1/Oracle Linux 9.1) Si el código no funciona, puedes usar el siguiente comando: sudo pip install -r requirements.txt --break-system-packages

Copia el archivo exmaple.env a .env y modifícalo:

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

sudo nano /myems-aggregation/.env

Configura el servicio systemd:

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

Habilita el servicio:

sudo systemctl enable myems-aggregation.service

Inicia el servicio:

sudo systemctl start myems-aggregation.service

Monitorea el servicio:

sudo systemctl status myems-aggregation.service

Visualiza el registro:

cat /myems-aggregation.log

Paso 8 myems-web

En este paso, instalarás el servicio de interfaz de usuario myems-web.

Instala el servidor NGINX

Consulta http://nginx.org/en/linux_packages.html#RHEL

Configura NGINX

Elimina los archivos predeterminados

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

Agrega un nuevo archivo en /etc/nginx/conf.d/

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

Agrega una nueva sección 'server' con las siguientes directivas:

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

Instala la interfaz web de MyEMS:

Configura NodeJS:

sudo dnf install nodejs

Modifica el archivo config.js:

Nota

Obtén el mapboxToken en https://mapbox.com y luego establece showOnlineMap en true. Si deseas desactivar la función de mapa en línea, establece showOnlineMap en false

cd ~/myems/myems-web

sudo nano src/config.js

Compila y comprime

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

sudo npm run build

Instala Sube los archivos a tu servidor web. Ten en cuenta que la siguiente ruta debe ser la misma que la configurada en nginx.conf.

sudo mv build  /var/www/myems-web

Desbloquea el puerto y agrégalo al firewall:

sudo semanage port -a -t http_port_t  -p tcp 80

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

sudo firewall-cmd --reload

Reinicia el servicio nginx:

sudo systemctl restart nginx.service

Consejo

Si encuentras el error '500 Internal Server Error' de nginx, puedes solucionarlo cambiando el modo de SELinux con el comando 'sudo setenforce 0'

Post-instalación

¡Felicidades! Ahora puedes iniciar sesión en la interfaz de administración y en la interfaz web de MyEMS.

Puertos predeterminados

Interfaz web de MyEMS: 80

API de MyEMS: 8000

Interfaz de administración de MyEMS: 8001

Contraseñas predeterminadas

Admin UI

administrator

!MyEMS1

Web UI

administrator@myems.io

!MyEMS1

Requisitos previos​

Paso 1 Base de datos​

Paso 2 myems-api​

Paso 3 myems-admin​

Paso 4 myems-modbus-tcp​

Paso 5 myems-cleaning​

Paso 6 myems-normalization​

Paso 7 myems-aggregation​

Paso 8 myems-web​

Post-instalación​

Puertos predeterminados​

Contraseñas predeterminadas​

Troubleshooting​

Requisitos previos

Paso 1 Base de datos

Paso 2 myems-api

Paso 3 myems-admin

Paso 4 myems-modbus-tcp

Paso 5 myems-cleaning

Paso 6 myems-normalization

Paso 7 myems-aggregation

Paso 8 myems-web

Post-instalación

Puertos predeterminados

Contraseñas predeterminadas

Troubleshooting