Fedora

В этом руководстве вы развернете MyEMS на сервере Fedora.

Предварительные требования

В этом руководстве описана установка MyEMS на Fedora 37 Server. Требования к оборудованию зависят от выбранной базы данных и количества устройств, подключенных к системе. Для работы MyEMS и MySQL на одной машине потребуется не менее 4 ГБ оперативной памяти.

Обновите систему и установите инструменты:

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

Клонируйте исходный код:

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

Шаг 1. База данных

См. База данных

Шаг 2. myems-api

Установите сервис myems-api:

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

Создайте файл .env на основе example.env и при необходимости отредактируйте его:

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

Добавьте порт в файрвол:

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

Настройте конфигурационные файлы 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/

Затем включите автозапуск сервисов при загрузке:

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

Запустите сервисы:

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

Шаг 3. myems-admin

Установите сервер NGINX

см. http://nginx.org/en/linux_packages.html#RHEL

Включите сервис nginx:

sudo systemctl start nginx.service

Настройте NGINX

sudo nano /etc/nginx/nginx.conf

В секцию 'http' добавьте директивы:

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

}

Добавьте новый файл в /etc/nginx/conf.d/

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

Напишите директивы, как указано ниже, и замените URL-адрес myems-api по умолчанию http://127.0.0.1:8000/ на фактический, если сервис myems-api размещен на другом сервере:

server {
    listen                 8001;
    server_name     myems-admin;
    location / {
        root    /var/www/myems-admin;
        index index.html index.htm;
    }
    ## Во избежание проблем с CORS используйте Nginx для проксирования myems-api по пути /api
    ## Добавьте еще одну location /api в 'server'
    ## Замените URL myems-api по умолчанию http://127.0.0.1:8000/ на фактический, если сервис размещен на другом сервере
    location /api {
        proxy_pass http://127.0.0.1:8000/;
        proxy_connect_timeout 75;
        proxy_read_timeout 600;
        send_timeout 600;
    }
}

Установите myems-admin: Если сервер не подключен к интернету, пожалуйста, сожмите папку myems/myems-admin, загрузите ее на сервер и распакуйте в ~/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

Проверьте конфигурационный файл и при необходимости измените его:

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

Предупреждение

Папка 'upload' предназначена для файлов, загружаемых пользователем. НЕ удаляйте/не перемещайте/не перезаписывайте папку 'upload' при обновлении myems-admin.

 /var/www/myems-admin/upload

Откройте порт и добавьте его в файрвол:

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

Перезапустите сервис nginx:

sudo systemctl restart nginx.service

Совет

Если вы столкнулись с ошибкой nginx '403 Forbidden', вы можете исправить ее, изменив режим SELinux с помощью команды 'sudo setenforce 0'.

Шаг 4. myems-modbus-tcp

На этом шаге вы установите сервис myems-modbus-tcp.

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

Скопируйте файл example.env в .env и измените файл .env:

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

Настройте сервис systemd:

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

Включите сервис:

sudo systemctl enable myems-modbus-tcp.service

Запустите сервис:

sudo systemctl start myems-modbus-tcp.service

Отслеживайте статус сервиса:

sudo systemctl status myems-modbus-tcp.service

Просмотрите журнал:

cat /myems-modbus-tcp.log

Шаг 5. myems-cleaning

На этом шаге вы установите сервис myems-cleaning.

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

Скопируйте файл example.env в .env и измените файл .env:

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

Настройте сервис systemd:

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

Включите сервис:

sudo systemctl enable myems-cleaning.service

Запустите сервис:

sudo systemctl start myems-cleaning.service

Отслеживайте статус сервиса:

sudo systemctl status myems-cleaning.service

Просмотрите журнал:

cat /myems-cleaning.log

Шаг 6. myems-normalization

На этом шаге вы установите сервис myems-normalization.

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

Скопируйте файл example.env в .env и измените файл .env:

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

Настройте сервис systemd:

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

Включите сервис:

sudo systemctl enable myems-normalization.service

Запустите сервис:

sudo systemctl start myems-normalization.service

Отслеживайте статус сервиса:

sudo systemctl status myems-normalization.service

Просмотрите журнал:

cat /myems-normalization.log

Шаг 7. myems-aggregation

На этом шаге вы установите сервис myems-aggregation.

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

Скопируйте файл example.env в .env и измените файл .env:

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

Настройте сервис systemd:

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

Включите сервис:

sudo systemctl enable myems-aggregation.service

Запустите сервис:

sudo systemctl start myems-aggregation.service

Отслеживайте статус сервиса:

sudo systemctl status myems-aggregation.service

Просмотрите журнал:

cat /myems-aggregation.log

Шаг 8. myems-web

На этом шаге вы установите пользовательский интерфейс myems-web.

Установите сервер NGINX

см. http://nginx.org/en/linux_packages.html#RHEL

Настройте NGINX

Удалите файлы по умолчанию

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

Добавьте новый файл в /etc/nginx/conf.d/

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

Добавьте новую секцию 'server' с директивами, как указано ниже:

server {
    listen                 80;
    server_name     myems-web;
    location / {
        root    /var/www/myems-web;
        index index.html index.htm;
        # добавьте директиву try_files, чтобы избежать ошибки 404 при обновлении страниц
        try_files $uri  /index.html;
    }
    ## Во избежание проблем с CORS используйте Nginx для проксирования myems-api по пути /api
    ## Добавьте еще одну location /api в 'server'
    ## Замените URL myems-api по умолчанию http://127.0.0.1:8000/ на фактический, если сервис размещен на другом сервере
    location /api {
        proxy_pass http://127.0.0.1:8000/;
        proxy_connect_timeout 75;
        proxy_read_timeout 600;
        send_timeout 600;
    }
}

Установите MyEMS Web UI:

Настройте NodeJS:

sudo dnf install nodejs

Измените файл config.js:

Примечание

Получите токен mapbox на сайте https://mapbox.com и установите параметр showOnlineMap в true. Если вы хотите отключить функцию онлайн-карты, установите showOnlineMap в false.

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

Соберите проект

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

Установите Загрузите файлы на ваш веб-сервер. Обратите внимание, что следующий путь должен совпадать с путем, настроенным в nginx.conf.

sudo mv build  /var/www/myems-web

Откройте порт и добавьте его в файрвол:

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

Перезапустите сервис nginx:

sudo systemctl restart nginx.service

Совет

Если вы столкнулись с ошибкой nginx '500 Internal Server Error', вы можете исправить ее, изменив режим SELinux с помощью команды 'sudo setenforce 0'.

После установки

Поздравляем! Теперь вы можете войти в MyEMS Admin UI и Web UI.

Порт по умолчанию

MyEMS Web UI: 80

MyEMS API: 8000

MyEMS Admin UI: 8001

Предполагая, что адрес сервера 192.168.1.8 (замените на фактический адрес сервера). Доступ к MyEMS Web UI по адресу http://192.168.1.8 (80 можно опустить). Доступ к MyEMS Admin UI по адресу http://192.168.1.8:8001.

Пароли по умолчанию

MyEMS Admin UI

Имя пользователя:

administrator

Пароль:

!MyEMS1

MyEMS Web UI

Имя пользователя:

administrator@myems.io

Пароль:

!MyEMS1

Предварительные требования​

Шаг 1. База данных​

Шаг 2. myems-api​

Шаг 3. myems-admin​

Шаг 4. myems-modbus-tcp​

Шаг 5. myems-cleaning​

Шаг 6. myems-normalization​

Шаг 7. myems-aggregation​

Шаг 8. myems-web​

После установки​

Порт по умолчанию​

Пароли по умолчанию​

Устранение неполадок​

Предварительные требования

Шаг 1. База данных

Шаг 2. myems-api

Шаг 3. myems-admin

Шаг 4. myems-modbus-tcp

Шаг 5. myems-cleaning

Шаг 6. myems-normalization

Шаг 7. myems-aggregation

Шаг 8. myems-web

После установки

Порт по умолчанию

Пароли по умолчанию

Устранение неполадок