Fedora

Neste guia, você irá implantar o MyEMS em um servidor Fedora.

Pré-requisitos

Este guia descreve como instalar o MyEMS no Fedora 37 Server. 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.

Atualize o sistema e instale as ferramentas

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

Clone o código-fonte:

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

Etapa 1 Banco de Dados

Veja Banco de Dados

Etapa 2 myems-api

Instale o serviço myems-api:

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

Crie o arquivo .env com base no example.env e edite o arquivo .env se necessário:

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

Adicione a porta ao firewall:

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

Configure os arquivos 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 iniciem automaticamente na inicialização:

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

Inicie os serviços:

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

Etapa 3 myems-admin

Instale o servidor NGINX

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

Habilite o serviço nginx:

sudo systemctl start nginx.service

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

}

Adicione um novo arquivo em /etc/nginx/conf.d/

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

Escreva com 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 outro 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;
    }
}

Instale o myems-admin: Se o servidor não puder se conectar à internet, compacte a pasta myems/myems-admin, envie para o servidor e extraia 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 se necessário:

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

Cuidado

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

 /var/www/myems-admin/upload

Desbloqueie a porta e adicione ao firewall:

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

Reinicie o serviço nginx:

sudo systemctl restart nginx.service

Dica

Se você encontrar o erro '403 Forbidden' do nginx, pode corrigir alterando o modo do SELinux com o comando 'sudo setenforce 0'

Etapa 4 myems-modbus-tcp

Nesta etapa, 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

Copie o arquivo example.env para .env e modifique o arquivo .env:

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

Configure o serviço systemd:

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

Habilite o serviço:

sudo systemctl enable myems-modbus-tcp.service

Inicie o serviço:

sudo systemctl start myems-modbus-tcp.service

Monitore o serviço:

sudo systemctl status myems-modbus-tcp.service

Veja o log:

cat /myems-modbus-tcp.log

Etapa 5 myems-cleaning

Nesta etapa, 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

Copie o arquivo example.env para .env e modifique o arquivo .env:

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

Configure o serviço systemd:

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

Habilite o serviço:

sudo systemctl enable myems-cleaning.service

Inicie o serviço:

sudo systemctl start myems-cleaning.service

Monitore o serviço:

sudo systemctl status myems-cleaning.service

Veja o log:

cat /myems-cleaning.log

Etapa 6 myems-normalization

Nesta etapa, 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

Copie o arquivo example.env para .env e modifique o arquivo .env:

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

Configure o serviço systemd:

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

Habilite o serviço:

sudo systemctl enable myems-normalization.service

Inicie o serviço:

sudo systemctl start myems-normalization.service

Monitore o serviço:

sudo systemctl status myems-normalization.service

Veja o log:

cat /myems-normalization.log

Etapa 7 myems-aggregation

Nesta etapa, 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

Copie o arquivo example.env para .env e modifique o arquivo .env:

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

Configure o serviço systemd:

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

Habilite o serviço:

sudo systemctl enable myems-aggregation.service

Inicie o serviço:

sudo systemctl start myems-aggregation.service

Monitore o serviço:

sudo systemctl status myems-aggregation.service

Veja o log:

cat /myems-aggregation.log

Etapa 8 myems-web

Nesta etapa, você irá instalar o serviço de interface do usuário myems-web.

Instale o servidor NGINX

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

Configure o NGINX

Remova os arquivos padrão

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

Adicione um novo arquivo em /etc/nginx/conf.d/

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

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

Instale a interface web do MyEMS:

Configure o NodeJS:

sudo dnf install nodejs

Modifique o arquivo config.js:

Nota

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

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

Compile e compacte

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

Instale Envie os arquivos para o seu servidor web. Observe que o caminho a seguir deve ser o mesmo que foi configurado no nginx.conf.

sudo mv build  /var/www/myems-web

Desbloqueie a porta e adicione ao firewall:

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

Reinicie o serviço nginx:

sudo systemctl restart nginx.service

Dica

Se você encontrar o erro '500 Internal Server Error' do nginx, pode corrigir alterando o modo do SELinux com o comando 'sudo setenforce 0'

Pós-instalação

Parabéns! Agora você pode acessar a interface de administração e a interface web do MyEMS.

Portas Padrão

Interface Web do MyEMS: 80

API do MyEMS: 8000

Interface Admin do MyEMS: 8001

Supondo que o endereço do servidor seja 192.168.1.8 (substitua pelo endereço real) Acesse a interface web do MyEMS em http://192.168.1.8 (80 pode ser omitido) Acesse a interface admin do MyEMS em http://192.168.1.8:8001

Senhas Padrão

Interface Admin do MyEMS

Usuário:

administrator

Senha:

!MyEMS1

Interface Web do MyEMS

Usuário:

administrator@myems.io

Senha:

!MyEMS1

Pré-requisitos​

Etapa 1 Banco de Dados​

Etapa 2 myems-api​

Etapa 3 myems-admin​

Etapa 4 myems-modbus-tcp​

Etapa 5 myems-cleaning​

Etapa 6 myems-normalization​

Etapa 7 myems-aggregation​

Etapa 8 myems-web​

Pós-instalação​

Portas Padrão​

Senhas Padrão​

Solução de problemas​

Pré-requisitos

Etapa 1 Banco de Dados

Etapa 2 myems-api

Etapa 3 myems-admin

Etapa 4 myems-modbus-tcp

Etapa 5 myems-cleaning

Etapa 6 myems-normalization

Etapa 7 myems-aggregation

Etapa 8 myems-web

Pós-instalação

Portas Padrão

Senhas Padrão

Solução de problemas