FreeBSD

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

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

В этом руководстве описывается установка MyEMS на FreeBSD 13.2. Аппаратные требования зависят от выбранной базы данных и количества устройств, подключенных к системе. Для запуска MyEMS и MySQL на одном компьютере потребуется не менее 4 ГБ оперативной памяти.

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

pkg install git

pkg install python3

pkg install py39-pip-22.3.1

pkg install nginx

pkg install monit

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

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

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

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

Шаг 2. myems-api

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

cp -r ~/myems/myems-api /myems-api

cd /myems-api

pip install -r requirements.txt

Совет

Если вы столкнулись с ошибкой 'Failed building wheel for pillow', ознакомьтесь с установкой Pillow

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

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

nano /myems-api/.env

Используйте сервис мониторинга monit и отредактируйте конфигурационный файл 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

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

monit restart

Шаг 3. myems-admin

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

См. http://nginx.org/en/docs/install.html

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

service nginx enable

Настройте NGINX

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/

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

Установите myems-admin: Если сервер не имеет доступа к интернету, сожмите папку myems/myems-admin, загрузите её на сервер и распакуйте в ~/myems/myems-admin

mkdir /var/www

cp -r ~/myems/myems-admin  /var/www/myems-admin

chmod 0755 /var/www/myems-admin

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

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

 /var/www/myems-admin/upload

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

service nginx restart

Шаг 4. myems-modbus-tcp

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

cp -r ~/myems/myems-modbus-tcp /myems-modbus-tcp

cd /myems-modbus-tcp

pip install -r requirements.txt

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

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

nano /myems-modbus-tcp/.env

Используйте сервис мониторинга monit и отредактируйте конфигурационный файл 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

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

monit restart

Шаг 5. myems-cleaning

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

cp -r ~/myems/myems-cleaning /myems-cleaning

cd /myems-cleaning

pip install -r requirements.txt

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

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

nano /myems-cleaning/.env

Используйте сервис мониторинга monit и отредактируйте конфигурационный файл 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

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

monit restart

Шаг 6. myems-normalization

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

cp -r ~/myems/myems-normalization /myems-normalization

cd /myems-normalization

pip install -r requirements.txt

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

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

nano /myems-normalization/.env

Используйте сервис мониторинга monit и отредактируйте конфигурационный файл 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

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

monit restart

Шаг 7. myems-aggregation

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

cp -r ~/myems/myems-aggregation /myems-aggregation

cd /myems-aggregation

pip install -r requirements.txt

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

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

nano /myems-aggregation/.env

Используйте сервис мониторинга monit и отредактируйте конфигурационный файл 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

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

monit restart

Шаг 8. myems-web

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

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

См. http://nginx.org/en/docs/install.html

Настройте 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;
        # 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;
    }
}

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

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

Node.js 22.22.2, 24.5.0 или новее
npm 10.9.7, 11.5.1 или новее

pkg install node-18.16.0

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

Примечание

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

cd ~/myems/myems-web

nano src/config.js

Сборка

npm i

npm run build

Установка Обратите внимание, что путь должен совпадать с указанным в nginx.conf.

rm -r /var/www/myems-web

mv build  /var/www/myems-web

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

service nginx restart

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

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

Пароль:

!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

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

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

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

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