Kylin OS

Neste guia, você implantará o MyEMS em um servidor Kylin V11.

Pré-requisitos

Este guia descreve como instalar o MyEMS no Kylin V11. Os requisitos de hardware dependem do banco de dados escolhido e do número de dispositivos conectados ao sistema. Para executar o MyEMS e o MySQL em uma única máquina, você precisa de pelo menos 8 GB de RAM.

Atualize o sistema e instale as ferramentas:

sudo yum update

sudo yum install git

systemctl stop firewalld

Clone o código fonte:

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

Passo 1 Banco de Dados

Consulte Banco de Dados

Passo 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 baseado no example.env e edite-o conforme necessário:

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

sudo nano /myems-api/.env

Adicione a porta ao firewall:

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

sudo firewall-cmd --reload

Instale 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 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

Passo 3 myems-admin

Instale o servidor NGINX

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

Habilite o serviço nginx:

yum install -y nginx
sudo systemctl start nginx.service

Configure o NGINX

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

}

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

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

Escreva as seguintes diretivas. Se o serviço myems-api estiver em outro servidor, substitua o endereço padrão do myems-api http://127.0.0.1:8000/ pelo endereço real.

server {
    listen                 8001;
    server_name     myems-admin;
    location / {
        root    /var/www/myems-admin;
        index index.html index.htm;
    }
    ## Para evitar problemas de CORS, use o Nginx como proxy para myems-api no caminho /api
    ## Adicione outra localização /api em '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;
    }
}

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

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

Aviso A pasta 'upload' é para arquivos enviados pelo usuário. Não exclua/mova/sobrescreva a pasta 'upload' ao atualizar o myems-admin.

 /var/www/myems-admin/upload

Adicione a porta 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

Reinicie o serviço nginx:

sudo systemctl restart nginx.service

Dica Se você encontrar um erro '403 Forbidden' no nginx, pode corrigi-lo alterando o modo SELinux usando o comando 'sudo setforce 0'.

Passo 4 myems-modbus-tcp

Neste passo, você 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

Instale 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

Passo 5 myems-cleaning

Neste passo, você 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

Instale 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

Passo 6 myems-normalization

Neste passo, você 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

Instale 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

Passo 7 myems-aggregation

Neste passo, você 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

sudo nano /myems-aggregation/.env

Instale 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

Passo 8 myems-web

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

Instale o servidor NGINX. Consulte http://nginx.org/en/linux_packages.html#Debian
Configure o NGINX. Remova o arquivo 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

Escreva as seguintes diretivas. Se o serviço myems-api estiver hospedado em um servidor diferente, substitua o endereço padrão do myems-api http://127.0.0.1:8000/ pelo endereço real.

server {
    listen                 80;
    server_name     myems-web;
    location / {
        root    /var/www/myems-web;
        index index.html index.htm;
        # adicione a diretiva try_files para evitar erro 404 ao atualizar páginas
        try_files $uri  /index.html;
    }
    ## Para evitar problemas de CORS, use o Nginx como proxy para myems-api no caminho /api
    ## Adicione outra localização /api em '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;
    }
}

Instale a interface web do MyEMS:

Edite o arquivo de configuração:

Nota Obtenha um mapboxToken em https://mapbox.com e defina showOnlineMap como true. Se quiser desligar a função de mapa online, defina showOnlineMap como false.

cd ~/myems/myems-web

sudo nano src/config.js

Compile:

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

sudo npm run build

Instale: Observe que o caminho abaixo deve corresponder ao caminho configurado no nginx.conf.

sudo rm -r /var/www/myems-web

sudo mv build  /var/www/myems-web

Adicione a porta 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

Reinicie o NGINX:

sudo systemctl restart nginx

Dica Se você encontrar um erro '500 Internal Server Error' no nginx, pode corrigi-lo alterando o modo SELinux usando o comando 'sudo setforce 0'.

Após a Instalação

Parabéns! Agora você pode fazer login na interface administrativa do MyEMS e na interface web.

Portas Padrão

Interface web do MyEMS: 80 API do MyEMS: 8000 Interface administrativa do MyEMS: 8001

Assumindo que o endereço do servidor é 192.168.1.8 (substitua pelo endereço real do seu servidor) Endereço da interface web do MyEMS: http://192.168.1.8 (a porta 80 pode ser omitida) Endereço da interface administrativa do MyEMS: http://192.168.1.8:8001

Senhas Padrão

Interface administrativa do MyEMS Nome de usuário:

administrator

Senha:

!MyEMS1

Interface web do MyEMS Nome de usuário:

administrator

Senha:

!MyEMS1

Solução de Problemas

Instalação do MySQL 8.0

1. Preparação

Verifique o ambiente do sistema

# Verifique a versão do sistema
cat /etc/redhat-release

# Verifique se o MySQL já está instalado
rpm -qa | grep mysql
rpm -qa | grep mariadb

# Desinstale o mariadb se existir
rpm -e --nodeps mariadb-libs-*

2. Baixe o pacote rpm oficial do MySQL

https://cdn.mysql.com//Downloads/MySQL-8.0/mysql-8.0.45-1.el8.x86_64.rpm-bundle.tar

3. Instale o MySQL 8.0

tar -xvf *.tar
yum localinstall *.rpm

# Se você encontrar problemas de chave GPG, use este comando temporariamente
yum install -y mysql-community-server --nogpgcheck

4. Inicie o Serviço MySQL

# Inicie o MySQL
systemctl start mysqld

# Habilite a inicialização automática no boot
systemctl enable mysqld

# Verifique o status do serviço
systemctl status mysqld

5. Obtenha a Senha Inicial

# Verifique a senha temporária gerada pelo MySQL
grep 'temporary password' /var/log/mysqld.log

6. Configuração de Segurança

# Execute o script de instalação segura
mysql_secure_installation

Siga as instruções:

Digite a senha temporária
Defina uma nova senha (deve incluir letras maiúsculas, minúsculas, números e caracteres especiais)
Alterar a senha do root? Y
Remover usuários anônimos? Y
Não permitir login root remoto? Escolha conforme necessário
Remover banco de dados de teste? Y
Recarregar tabelas de privilégios? Y

# Faça login no MySQL
mysql -u root -p

# Verifique a versão
SELECT VERSION();

# Liste os bancos de dados
SHOW DATABASES;

8. Configure o Conjunto de Caracteres (Opcional)

Edite o arquivo de configuração:

vi /etc/my.cnf

Adicione o seguinte:

[client]
default-character-set=utf8mb4

[mysql]
default-character-set=utf8mb4

[mysqld]
character-set-server=utf8mb4
collation-server=utf8mb4_unicode_ci
init-connect='SET NAMES utf8mb4'

# Reduza a política de senha se necessário
validate_password.policy = LOW
validate_password.length = 6
validate_password.mixed_case_count = 0
validate_password.number_count = 0
validate_password.special_char_count = 0

Reinicie o serviço:

systemctl restart mysqld

9. Configurações do Firewall

# Abra a porta 3306
firewall-cmd --permanent --add-port=3306/tcp
firewall-cmd --reload

# Ou pare o firewall (não recomendado)
# systemctl stop firewalld

10. Configuração de Acesso Remoto (Opcional)

-- Faça login no MySQL
mysql -u root -p

-- Crie um usuário para acesso remoto
CREATE USER 'root'@'%' IDENTIFIED BY '!MyEMS1';
-- Atualize a senha
ALTER USER 'root'@'%' IDENTIFIED BY '!MyEMS1';
-- Conceda privilégios
GRANT ALL PRIVILEGES ON *.* TO 'root'@'%' WITH GRANT OPTION;

-- Aplique as alterações
FLUSH PRIVILEGES;

Problemas Comuns

1. Erro de Memória Insuficiente

Se o servidor tiver pouca memória, limite o uso de memória do MySQL:

vi /etc/my.cnf
# Adicione estas configurações
innodb_buffer_pool_size = 256M
innodb_log_buffer_size = 16M
max_connections = 100

2. Solução de Problemas de Inicialização

# Veja o log de erros
tail -f /var/log/mysqld.log

# Verifique o uso da porta
netstat -tlnp | grep 3306

3. Modificação da Política de Senha

-- Veja a política de senha atual
SHOW VARIABLES LIKE 'validate_password%';

-- Reduza a política (se for necessária uma senha simples)
SET GLOBAL validate_password.policy = LOW;
SET GLOBAL validate_password.length = 6;

Verifique a Instalação

# Verifique o processo do MySQL
ps aux | grep mysql

# Verifique a porta
netstat -tlnp | grep 3306

# Verifique a versão do MySQL
mysql --version

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​

Após a Instalação​

Portas Padrão​

Senhas Padrão​

Solução de Problemas​

Instalação do MySQL 8.0​

1. Preparação​

2. Baixe o pacote rpm oficial do MySQL​

3. Instale o MySQL 8.0​

4. Inicie o Serviço MySQL​

5. Obtenha a Senha Inicial​

6. Configuração de Segurança​

7. Faça Login e Verifique o MySQL​

8. Configure o Conjunto de Caracteres (Opcional)​

9. Configurações do Firewall​

10. Configuração de Acesso Remoto (Opcional)​

Problemas Comuns​

1. Erro de Memória Insuficiente​

2. Solução de Problemas de Inicialização​

3. Modificação da Política de Senha​

Verifique a Instalação​

Pré-requisitos

Passo 1 Banco de Dados

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

Após a Instalação

Portas Padrão

Senhas Padrão

Solução de Problemas

Instalação do MySQL 8.0

1. Preparação

2. Baixe o pacote rpm oficial do MySQL

3. Instale o MySQL 8.0

4. Inicie o Serviço MySQL

5. Obtenha a Senha Inicial

6. Configuração de Segurança

7. Faça Login e Verifique o MySQL

8. Configure o Conjunto de Caracteres (Opcional)

9. Configurações do Firewall

10. Configuração de Acesso Remoto (Opcional)

Problemas Comuns

1. Erro de Memória Insuficiente

2. Solução de Problemas de Inicialização

3. Modificação da Política de Senha

Verifique a Instalação