Fedora CoreOS

在本指南中，您將在Fedora CoreOS上部署MyEMS。

前提

本指南介紹如何在Fedora CoreOS 37上安裝MyEMS。硬體需求取決於所選資料庫和連接到系統的設備數量。要在一臺機器上運行MyEMS和MySQL，您至少需要4GB的RAM。

更新系統並安裝工具:

rpm-ostree install git

rpm-ostree install python3

rpm-ostree install python3-pip

rpm-ostree install nginx

克隆源代碼：

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

第1步資料庫

參考 Database

第2步 myems-api

安裝 myems-api 服務:

sudo cp -r ~/myems/myems-api /var/myems-api

cd /var/myems-api

sudo pip install -r requirements.txt

根據example.env創建.env檔，並根據需要編輯.env：

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

sudo nano /var/myems-api/.env

將端口添加到防火牆：

sudo firewall-cmd --add-service=http --permanent

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

sudo firewall-cmd --reload

安裝 systemd 配置檔:

sudo cp /var/myems-api/myems-api.service /etc/systemd/system/

sudo cp /var/myems-api/myems-api.socket /etc/systemd/system/

sudo cp /var/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

In the 'http' section, add some directives:

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

編寫如下指令, 如果myems-api服務運行在其他伺服器上則用實際的地址替換 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;
    }
    ## 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 : 如果伺服器無法連接到internet，請壓縮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”檔夾用於用戶上傳的檔。升級myems-admin時，請勿刪除/移動/覆蓋“upload”檔夾。

 /var/www/myems-admin/upload

將端口添加到防火牆：

sudo firewall-cmd --add-service=http --permanent

sudo firewall-cmd --add-port=8001/tcp --permanent

sudo firewall-cmd --reload

重啟nginx服務:

sudo systemctl restart nginx.service

提示

如果您遇到“403 Forbidden”nginx錯誤，可以通過使用命令“sudo setforce 0”更改SELinx模式來修復它

第4步 myems-modbus-tcp

在此步驟中，您將安裝myems-modbus-tcp服務。

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

cd /var/myems-modbus-tcp

sudo pip install -r requirements.txt

將exmaple.ev檔複製到.env並修改.env檔：

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

sudo nano /var/myems-modbus-tcp/.env

修改檔main.py:

fh = RotatingFileHandler('/var/myems-modbus-tcp.log', maxBytes=1024*1024, backupCount=1)

安裝 systemd 服務:

sudo cp myems-modbus-tcp.service /etc/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 /var/myems-cleaning

cd /var/myems-cleaning

sudo pip install -r requirements.txt

將exmaple.ev檔複製到.env並修改.env檔：

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

sudo nano /var/myems-cleaning/.env

修改檔main.py:

fh = RotatingFileHandler('/var/myems-cleaning.log', maxBytes=1024*1024, backupCount=1)

安裝systemd服務：

sudo cp /var/myems-cleaning/myems-cleaning.service /etc/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 /var/myems-normalization

cd /var/myems-normalization

sudo pip install -r requirements.txt

將exmaple.ev檔複製到.env並修改.env檔：

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

sudo nano /var/myems-normalization/.env

修改檔main.py:

fh = RotatingFileHandler('/var/myems-normalization.log', maxBytes=1024*1024, backupCount=1)

安裝systemd服務

sudo cp /var/myems-normalization/myems-normalization.service /etc/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 /var/myems-aggregation

cd /var/myems-aggregation

sudo pip install -r requirements.txt

將exmaple.ev檔複製到.env並修改.env檔：

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

nano /var/myems-aggregation/.env

修改檔main.py:

fh = RotatingFileHandler('/var/myems-aggregation.log', maxBytes=1024*1024, backupCount=1)

安裝systemd服務

sudo cp /var/myems-aggregation/myems-aggregation.service /etc/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服務託管在不同的伺服器上，則使用實際的地址替換默認的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;
        # 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:

sudo dnf install nodejs

修改配置檔：

備註

從 https://mapbox.com 獲取 mapboxToken 然後設置 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

安裝: 將檔上傳到web伺服器。注意，以下路徑應該與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

提示

如果您遇到“500內部伺服器錯誤”nginx錯誤，可以通過使用命令“sudo setforce 0”更改SELinx模式來修復它

安裝後

祝賀您現在可以登錄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

安裝後

默認端口

默認密碼

故障排除