Перейти к основному контенту

SUSE

В этом руководстве описано, как развернуть MyEMS на SUSE Linux Enterprise Server.

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

В данном руководстве рассматривается установка MyEMS на SUSE Linux Enterprise Server 15. Требования к оборудованию зависят от выбранной базы данных и количества подключенных к системе устройств. Для запуска MyEMS и MySQL на одном сервере требуется не менее 4 ГБ оперативной памяти.

Клонирование исходного кода:

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 vi /myems-api/.env

Добавление порта в брандмауэр:

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#Debian

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

sudo systemctl start nginx.service
  • Конфигурация NGINX
sudo vi /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 vi /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/ на реальный, если сервис myems-api развернут на другом сервере
    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 vi /var/www/myems-admin/app/api.js
Предупреждение

Папка 'upload' предназначена для файлов, загружаемых пользователями. НЕ УДАЛЯЙТЕ/НЕ ПЕРЕМЕЩАЙТЕ/НЕ ПЕРЕЗАПИСЫВАЙТЕ папку 'upload' при обновлении myems-admin.

 /var/www/myems-admin/upload

Добавление порта в брандмауэр:

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

Шаг 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

Скопируйте файл exmaple.env в .env и отредактируйте его:

sudo cp /myems-modbus-tcp/example.env /myems-modbus-tcp/.env
sudo vi /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

Скопируйте файл exmaple.env в .env и отредактируйте его:

sudo cp /myems-cleaning/example.env /myems-cleaning/.env
sudo vi /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

Скопируйте файл exmaple.env в .env и отредактируйте его:

sudo cp /myems-normalization/example.env /myems-normalization/.env
sudo vi /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
pip install -r requirements.txt

Скопируйте файл exmaple.env в .env и отредактируйте его:

sudo cp /myems-aggregation/example.env /myems-aggregation/.env
vi /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.

Удаление стандартных файлов:

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' и замените демонстрационный адрес 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;
    }
}

Перезапуск NGINX:

sudo systemctl restart nginx
  • Установка веб-интерфейса MyEMS:

Установка NodeJS: Требования к версии:

  • Node.js 22.22.2, 24.5.0 или новее
  • npm 10.9.7, 11.5.1 или новее
sudo zypper install -y nodejs
  • Редактирование файла config.js:
Примечание

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

cd myems/myems-web
sudo vi src/config.js

Сборка и архивирование:

sudo npm i
sudo npm run build

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

sudo mv build  /var/www/myems-web

Добавление порта в брандмауэр:

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

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

Поздравляем! Теперь вы можете войти в административный интерфейс MyEMS Admin UI и веб-интерфейс MyEMS 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

Пароль:

!MyEMS1

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