centos-rhel

sidebar_position: 3

CentOS/RHEL/Rocky/AlmaLinux/Oracle Linux

Neste guia, você irá implantar o MyEMS em um servidor CentOS ou RHEL.

Pré-requisitos

Este guia descreve como instalar o MyEMS no CentOS Stream 9 / Red Hat Enterprise Linux 9 (RHEL 9) / Rocky 9 / AlmaLinux 9.1 / Oracle Linux 9.1. Os requisitos de hardware dependem do banco de dados escolhido e da quantidade de dispositivos conectados ao sistema. Para executar o MyEMS e o MySQL em uma única máquina, você precisará de pelo menos 4GB de RAM.

Atualizar o sistema e instalar ferramentas:

sudo dnf update

sudo dnf install git

sudo dnf install python3-pip

Clonar o código-fonte:

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

Passo 1: Banco de Dados

Consulte Banco de Dados

Passo 2: myems-api

Instalar o serviço 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) Se o código não funcionar, você pode usar o seguinte código: sudo pip install -r requirements.txt --break-system-packages

Criar o arquivo .env com base no example.env e editar o arquivo .env se necessário:

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

sudo nano /myems-api/.env

Adicionar porta ao firewall:

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

sudo firewall-cmd --reload

Configurar os arquivos de configuração do 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/

Em seguida, habilite os serviços para que eles iniciem automaticamente na inicialização do sistema:

sudo systemctl enable myems-api.socket

sudo systemctl enable myems-api.service

Iniciar os serviços:

sudo systemctl start myems-api.socket

sudo systemctl start myems-api.service

Passo 3: myems-admin

Instalar o Servidor NGINX

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

Habilitar o serviço nginx:

sudo systemctl start nginx.service

Configurar o NGINX

sudo nano /etc/nginx/nginx.conf

Na seção 'http', adicione algumas diretivas:

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

}

Adicionar um novo arquivo em /etc/nginx/conf.d/:

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

Escreva as diretivas abaixo, e substitua a URL padrão do myems-api http://127.0.0.1:8000/ pela URL real se o serviço myems-api estiver hospedado em um servidor diferente:

server {
    listen                 8001;
    server_name     myems-admin;
    location / {
        root    /var/www/myems-admin;
        index index.html index.htm;
    }
    ## Para evitar problema de CORS, use o Nginx para proxyar o myems-api para o caminho /api
    ## Adicione outra localização /api no 'server'
    ## Substitua a URL padrão do myems-api http://127.0.0.1:8000/ pela URL real se o serviço myems-api estiver hospedado em um servidor diferente
    location /api {
        proxy_pass http://127.0.0.1:8000/;
        proxy_connect_timeout 75;
        proxy_read_timeout 600;
        send_timeout 600;
    }
}

Instalar o myems-admin: Se o servidor não puder se conectar à internet, comprima a pasta myems/myems-admin e faça o upload para o servidor, depois extraia-a em ~/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

Verifique o arquivo de configuração e altere-o se necessário:

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

Cuidado

A pasta 'upload' é destinada aos arquivos enviados pelos usuários. NÃO exclua/mova/sobrescreva a pasta 'upload' ao atualizar o myems-admin.

 /var/www/myems-admin/upload

Desbloquear a porta e adicioná-la ao 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

Reiniciar o serviço nginx:

sudo systemctl restart nginx.service

Dica

Se você encontrar o erro nginx '403 Forbidden', poderá corrigi-lo alterando o modo do SELinux com o comando sudo setenforce 0

Passo 4: myems-modbus-tcp

Neste passo, você irá instalar o serviço 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) Se o código não funcionar, você pode usar o seguinte código: sudo pip install -r requirements.txt --break-system-packages

Copiar o arquivo example.env para .env e modificar o arquivo .env:

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

sudo nano /myems-modbus-tcp/.env

Configurar o serviço systemd:

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

Habilitar o serviço:

sudo systemctl enable myems-modbus-tcp.service

Iniciar o serviço:

sudo systemctl start myems-modbus-tcp.service

Monitorar o serviço:

sudo systemctl status myems-modbus-tcp.service

Visualizar o log:

cat /myems-modbus-tcp.log

Passo 5: myems-cleaning

Neste passo, você irá instalar o serviço 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) Se o código não funcionar, você pode usar o seguinte código: sudo pip install -r requirements.txt --break-system-packages

Copiar o arquivo example.env para .env e modificar o arquivo .env:

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

sudo nano /myems-cleaning/.env

Configurar o serviço systemd:

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

Habilitar o serviço:

sudo systemctl enable myems-cleaning.service

Iniciar o serviço:

sudo systemctl start myems-cleaning.service

Monitorar o serviço:

sudo systemctl status myems-cleaning.service

Visualizar o log:

cat /myems-cleaning.log

Passo 6: myems-normalization

Neste passo, você irá instalar o serviço 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) Se o código não funcionar, você pode usar o seguinte código: sudo pip install -r requirements.txt --break-system-packages

Copiar o arquivo example.env para .env e modificar o arquivo .env:

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

sudo nano /myems-normalization/.env

Configurar o serviço systemd:

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

Habilitar o serviço:

sudo systemctl enable myems-normalization.service

Iniciar o serviço:

sudo systemctl start myems-normalization.service

Monitorar o serviço:

sudo systemctl status myems-normalization.service

Visualizar o log:

cat /myems-normalization.log

Passo 7: myems-aggregation

Neste passo, você irá instalar o serviço 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) Se o código não funcionar, você pode usar o seguinte código: sudo pip install -r requirements.txt --break-system-packages

Copiar o arquivo example.env para .env e modificar o arquivo .env:

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

sudo nano /myems-aggregation/.env

Configurar o serviço systemd:

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

Habilitar o serviço:

sudo systemctl enable myems-aggregation.service

Iniciar o serviço:

sudo systemctl start myems-aggregation.service

Monitorar o serviço:

sudo systemctl status myems-aggregation.service

Visualizar o log:

cat /myems-aggregation.log

Passo 8: myems-web

Neste passo, você irá instalar o serviço de UI myems-web.

Instalar o Servidor NGINX

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

Configurar o NGINX

Remover arquivos padrão:

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

Adicionar um novo arquivo em /etc/nginx/conf.d/:

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

Adicionar uma nova seção 'server' com as diretivas abaixo:

server {
    listen                 80;
    server_name     myems-web;
    location / {
        root    /var/www/myems-web;
        index index.html index.htm;
        # adicionar a diretiva try_files para evitar erro 404 ao atualizar as páginas
        try_files $uri  /index.html;
    }
    ## Para evitar problema de CORS, use o Nginx para proxyar o myems-api para o caminho /api
    ## Adicione outra localização /api no 'server'
    ## Substitua a URL padrão do myems-api http://127.0.0.1:8000/ pela URL real se o serviço myems-api estiver hospedado em um servidor diferente
    location /api {
        proxy_pass http://127.0.0.1:8000/;
        proxy_connect_timeout 75;
        proxy_read_timeout 600;
        send_timeout 600;
    }
}

Instalar a UI Web do MyEMS:

Configurar o NodeJS:

sudo dnf install nodejs

Modificar o arquivo config.js:

Nota

Obtenha o mapboxToken em https://mapbox.com e, em seguida, defina showOnlineMap como true. Se você quiser desativar o recurso de mapa online, defina showOnlineMap como false.

cd ~/myems/myems-web

sudo nano src/config.js

Construir e Comprimir:

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

sudo npm run build

Instalar: Faça o upload dos arquivos para o seu servidor web. Observação: o caminho a seguir deve ser o mesmo configurado no nginx.conf.

sudo mv build  /var/www/myems-web

Desbloquear a porta e adicioná-la ao 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

Reiniciar o serviço nginx:

sudo systemctl restart nginx.service

Dica

Se você encontrar o erro nginx '500 Internal Server Error', poderá corrigi-lo alterando o modo do SELinux com o comando sudo setenforce 0

Pós-instalação

Parabéns! Agora você pode fazer login na UI Admin e na UI Web do MyEMS.

Portas Padrão

MyEMS Web UI: 80

MyEMS API: 8000

MyEMS Admin UI: 8001

Senhas Padrão

Admin UI

administrator

!MyEMS1

Web UI

administrator@myems.io

!MyEMS1

sidebar_position: 3​

CentOS/RHEL/Rocky/AlmaLinux/Oracle Linux

Pré-requisitos​

Passo 1: Banco de Dados​

Passo 2: myems-api​

Passo 3: myems-admin​

Passo 4: myems-modbus-tcp​

Passo 5: myems-cleaning​

Passo 6: myems-normalization​

Passo 7: myems-aggregation​

Passo 8: myems-web​

Pós-instalação​

Portas Padrão​

Senhas Padrão​

Solução de Problemas​

sidebar_position: 3

Pré-requisitos

Passo 1: Banco de Dados

Passo 2: myems-api

Passo 3: myems-admin

Passo 4: myems-modbus-tcp

Passo 5: myems-cleaning

Passo 6: myems-normalization

Passo 7: myems-aggregation

Passo 8: myems-web

Pós-instalação

Portas Padrão

Senhas Padrão

Solução de Problemas