Kylin OS

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

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

В этом руководстве описывается, как установить MyEMS на Kylin V11. Аппаратные требования зависят от выбранной базы данных и количества устройств, подключенных к системе. Для запуска MyEMS и MySQL на одном компьютере вам потребуется не менее 8 ГБ ОЗУ.

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

sudo yum update

sudo yum install git

systemctl stop firewalld

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

cd ~
git clone https://gitee.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 --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:

yum install -y 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

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

server {
    listen                 8001;
    server_name     myems-admin;
    location / {
        root    /var/www/myems-admin;
        index index.html index.htm;
    }
    ## Чтобы избежать проблем с CORS, используйте Nginx для перенаправления myems-api по пути /api
    ## Добавьте еще одно местоположение /api в 'server'
    ## Замените URL myems-api по умолчанию http://127.0.0.1:8000/ на реальный URL, если служба 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 nano /var/www/myems-admin/app/api.js

Внимание

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

 /var/www/myems-admin/upload

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

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

Перезапустите службу nginx:

sudo systemctl restart nginx.service

Совет

Если вы столкнулись с ошибкой nginx '403 Запрещено', вы можете исправить это, изменив режим SELinux командой 'sudo setforce 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

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

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

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
    ## Добавьте еще одно местоположение /api в 'server'
    ## Замените URL myems-api по умолчанию http://127.0.0.1:8000/ на реальный URL, если служба myems-api размещена на другом сервере
    location /api {
        proxy_pass http://127.0.0.1:8000/;
        proxy_connect_timeout 75;
        proxy_read_timeout 600;
        send_timeout 600;
    }
}

Установите веб-интерфейс MyEMS:

Отредактируйте файл конфигурации:

Примечание

Получите токен 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 rm -r /var/www/myems-web

sudo mv build  /var/www/myems-web

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

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

Перезапустите NGINX

sudo systemctl restart nginx

Совет

Если вы столкнулись с ошибкой nginx '500 Внутренняя ошибка сервера', вы можете исправить это, изменив режим SELinux командой 'sudo setforce 0'.

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

Поздравляем! Теперь вы можете войти в административный интерфейс и веб-интерфейс MyEMS.

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

Веб-интерфейс MyEMS: 80 API MyEMS: 8000 Административный интерфейс MyEMS: 8001

Предположим, что адрес сервера — 192.168.1.8 (замените его на реальный адрес вашего сервера) Адрес веб-интерфейса MyEMS: http://192.168.1.8 (порт 80 можно опустить) Адрес административного интерфейса MyEMS: http://192.168.1.8:8001

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

Административный интерфейс MyEMS Имя пользователя:

administrator

Пароль:

!MyEMS1

Веб-интерфейс MyEMS Имя пользователя:

administrator

Пароль:

!MyEMS1

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

Установка MySQL 8.0

1. Подготовка

Проверьте окружение системы

# Проверить версию системы
cat /etc/redhat-release

# Проверить, установлен ли MySQL уже
rpm -qa | grep mysql
rpm -qa | grep mariadb

# Удалить mariadb, если она существует
rpm -e --nodeps mariadb-libs-*

2. Скачайте официальный RPM-пакет MySQL

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

3. Установите MySQL 8.0

tar -xvf *.tar
yum localinstall *.rpm

# Если возникнут проблемы с GPG-ключом, используйте это временно
yum install -y mysql-community-server --nogpgcheck

4. Запустите службу MySQL

# Запустить MySQL
systemctl start mysqld

# Включить автозапуск при загрузке
systemctl enable mysqld

# Проверить состояние службы
systemctl status mysqld

5. Получите начальный пароль

# Посмотреть временный пароль, сгенерированный MySQL
grep 'temporary password' /var/log/mysqld.log

6. Безопасная настройка

# Запустить скрипт безопасной установки
mysql_secure_installation

Следуйте инструкциям:

Введите временный пароль
Установите новый пароль (он должен содержать заглавные и строчные буквы, цифры и специальные символы)
Изменить пароль root? Y
Удалить анонимных пользователей? Y
Запретить удаленный вход root? Выберите по необходимости
Удалить тестовую базу данных? Y
Перезагрузить таблицы привилегий? Y

7. Войдите и проверьте MySQL

# Войти в MySQL
mysql -u root -p

# Проверить версию
SELECT VERSION();

# Показать базы данных
SHOW DATABASES;

8. Настройте кодировку (необязательно)

Отредактируйте файл конфигурации:

vi /etc/my.cnf

Добавьте следующее:

[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'


# При необходимости снизьте политику паролей
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

Перезапустите службу:

systemctl restart mysqld

9. Настройка брандмауэра

# Открыть порт 3306
firewall-cmd --permanent --add-port=3306/tcp
firewall-cmd --reload

# Или остановить брандмауэр (не рекомендуется)
# systemctl stop firewalld

10. Настройка удаленного доступа (необязательно)

-- Войти в MySQL
mysql -u root -p

-- Создать пользователя для удаленного доступа
CREATE USER 'root'@'%' IDENTIFIED BY '!MyEMS1';
-- Обновить пароль
ALTER USER 'root'@'%' IDENTIFIED BY '!MyEMS1';
-- Дать все привилегии
GRANT ALL PRIVILEGES ON *.* TO 'root'@'%' WITH GRANT OPTION;

-- Применить изменения
FLUSH PRIVILEGES;

Частые проблемы

1. Ошибка нехватки памяти

Если на сервере мало памяти, ограничьте использование памяти MySQL:

vi /etc/my.cnf
# Добавьте эти настройки
innodb_buffer_pool_size = 256M
innodb_log_buffer_size = 16M
max_connections = 100

2. Решение проблем с запуском

# Посмотреть журнал ошибок
tail -f /var/log/mysqld.log

# Проверить использование портов
netstat -tlnp | grep 3306

3. Изменение политики паролей

-- Посмотреть текущую политику паролей
SHOW VARIABLES LIKE 'validate_password%';

-- Снизить политику (если нужен простой пароль)
SET GLOBAL validate_password.policy = LOW;
SET GLOBAL validate_password.length = 6;

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

# Проверить процесс MySQL
ps aux | grep mysql

# Проверить порт
netstat -tlnp | grep 3306

# Проверить версию MySQL
mysql --version

---

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

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

Шаг 2 myems-api

Шаг 3 myems-admin​

Шаг 4 myems-modbus-tcp​

Шаг 5 myems-cleaning​

Шаг 6 myems-normalization​

Шаг 7 myems-aggregation​

Шаг 8 myems-web​

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

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

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

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

Установка MySQL 8.0​

1. Подготовка​

2. Скачайте официальный RPM-пакет MySQL​

3. Установите MySQL 8.0​

4. Запустите службу MySQL​

5. Получите начальный пароль​

6. Безопасная настройка​

7. Войдите и проверьте MySQL​

8. Настройте кодировку (необязательно)​

9. Настройка брандмауэра​

10. Настройка удаленного доступа (необязательно)​

Частые проблемы​

1. Ошибка нехватки памяти​

2. Решение проблем с запуском​

3. Изменение политики паролей​

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

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

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

Шаг 3 myems-admin

Шаг 4 myems-modbus-tcp

Шаг 5 myems-cleaning

Шаг 6 myems-normalization

Шаг 7 myems-aggregation

Шаг 8 myems-web

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

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

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

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

Установка MySQL 8.0

1. Подготовка

2. Скачайте официальный RPM-пакет MySQL

3. Установите MySQL 8.0

4. Запустите службу MySQL

5. Получите начальный пароль

6. Безопасная настройка

7. Войдите и проверьте MySQL

8. Настройте кодировку (необязательно)

9. Настройка брандмауэра

10. Настройка удаленного доступа (необязательно)

Частые проблемы

1. Ошибка нехватки памяти

2. Решение проблем с запуском

3. Изменение политики паролей

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