Ir para o conteúdo principal

FreeBSD

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

Pré-requisitos​

Este guia descreve como instalar o MyEMS no FreeBSD 13.2. 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

pkg install git
pkg install python3
pkg install py39-pip-22.3.1
pkg install nginx
pkg install monit

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:
cp -r ~/myems/myems-api /myems-api
cd /myems-api
pip install -r requirements.txt
Dica

If you encounter 'Failed building wheel for pillow' error, you need to Installation Pillow

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

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

Use o serviço de monitoramento monit e edite o arquivo de configuração do monit:

nano /etc/monit.d/myems-api
check process mymes-api with pidfile /var/run/myems-api/pid
start program = "/usr/local/bin/gunicorn -b 0.0.0.0:8000 --pid /var/run/myems-api/pid --timeout 600 --workers=4 app:api &"
stop program = "/bin/kill -s TERM $MAINPID"
if 3 restarts within 5 cycles then unmonitor

Inicie os serviços:

monit restart

Etapa 3 myems-admin​

  • Instale o servidor NGINX

Consulte http://nginx.org/en/docs/install.html

Habilite o serviço nginx:

service nginx enable
  • Configure o NGINX
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/

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
mkdir /var/www
cp -r ~/myems/myems-admin  /var/www/myems-admin
chmod 0755 /var/www/myems-admin
Verifique o arquivo de configuração e altere se necessário:
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

Reinicie o serviço nginx:

service nginx restart

Etapa 4 myems-modbus-tcp​

Nesta etapa, você irá instalar o serviço myems-modbus-tcp.

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

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

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

Use o serviço de monitoramento monit e edite o arquivo de configuração do monit:

nano /etc/monit.d/myems-modbus-tcp
check file myems-modbus-tcp path /myems-modbus-tcp/main.py
start program = "/usr/local/bin/python3 /myems-modbus-tcp/main.py"
stop program = "/bin/kill -s TERM $MAINPID"
if 3 restarts within 5 cycles then unmonitor

Inicie o serviço:

monit restart

Etapa 5 myems-cleaning​

Nesta etapa, você irá instalar o serviço myems-cleaning.

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

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

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

Use o serviço de monitoramento monit e edite o arquivo de configuração do monit:

nano /etc/monit.d/myems-cleaning
check file myems-cleaning path /myems-cleaning/main.py
start program = "/usr/local/bin/python3 /myems-cleaning/main.py"
stop program = "/bin/kill -s TERM $MAINPID"
if 3 restarts within 5 cycles then unmonitor

Inicie o serviço:

monit restart

Etapa 6 myems-normalization​

Nesta etapa, você irá instalar o serviço myems-normalization.

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

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

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

Use o serviço de monitoramento monit e edite o arquivo de configuração do monit:

nano /etc/monit.d/myems-normalization
check file myems-normalization path /myems-normalization/main.py
start program = "/usr/local/bin/python3 /myems-normalization/main.py"
stop program = "/bin/kill -s TERM $MAINPID"
if 3 restarts within 5 cycles then unmonitor

Inicie o serviço:

monit restart

Etapa 7 myems-aggregation​

Nesta etapa, você irá instalar o serviço myems-aggregation.

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

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

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

Use o serviço de monitoramento monit e edite o arquivo de configuração do monit:

nano /etc/monit.d/myems-aggregation
check file myems-aggregation path /myems-aggregation/main.py
start program = "/usr/local/bin/python3 /myems-aggregation/main.py"
stop program = "/bin/kill -s TERM $MAINPID"
if 3 restarts within 5 cycles then unmonitor

Inicie o serviço:

monit restart

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/docs/install.html

  • 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:

pkg install node-18.16.0

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
nano src/config.js

Compile

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

Instale Observe que o caminho a seguir deve ser o mesmo que foi configurado no nginx.conf.

rm -r /var/www/myems-web
mv build  /var/www/myems-web

Reinicie o serviço nginx:

service nginx restart

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

Solução de problemas​