CentOS/RHEL/Rocky/AlmaLinux/Oracle Linux

Dalam panduan ini, anda akan menggunakan MyEMS pada pelayan CentOS atau RHEL.

Prasyarat

Panduan ini menerangkan cara memasang MyEMS pada CentOS Stream 10 / Red Hat Enterprise Linux 10 (RHEL 10) / Rocky Linux 10 / AlmaLinux 10 / Oracle Linux 10. Keperluan perkakasan bergantung kepada pangkalan data yang dipilih dan bilangan peranti yang disambungkan ke sistem. Untuk menjalankan MyEMS dan MySQL pada satu mesin, anda memerlukan sekurang-kurangnya 8GB RAM.

Kemas kini sistem dan pasang alat

sudo dnf update

sudo dnf install git

sudo dnf install python3-pip

Klon kod sumber:

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

Step 1 Database

Lihat Pangkalan Data

Step 2 myems-api

Pasang perkhidmatan myems-api:

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

cd /myems-api

sudo pip install -r requirements.txt

Nota

(CentOS Stream 9/RHEL 9/Rocky 9/AlmaLinux 9.1/Oracle Linux 9.1)If the code does not work, you can use the following code: sudo pip install -r requirements.txt --break-system-packages

Buat fail .env berdasarkan example.env dan edit fail .env jika perlu:

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

sudo nano /myems-api/.env

Tambah port ke firewall:

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

sudo firewall-cmd --reload

Sediakan fail konfigurasi 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/

Seterusnya aktifkan perkhidmatan supaya ia bermula secara automatik semasa boot:

sudo systemctl enable myems-api.socket

sudo systemctl enable myems-api.service

Mulakan perkhidmatan :

sudo systemctl start myems-api.socket

sudo systemctl start myems-api.service

Step 3 myems-admin

Pasang Pelayan NGINX

rujuk http://nginx.org/en/linux_packages.html#RHEL

Aktifkan perkhidmatan nginx:

sudo systemctl start nginx.service

Konfigurasi NGINX

sudo nano /etc/nginx/nginx.conf

Dalam bahagian 'http', tambah beberapa arahan:

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

}

Tambah fail baharu di bawah /etc/nginx/conf.d/

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

Tulis dengan arahan seperti di bawah, dan gantikan url myems-api lalai http://127.0.0.1:8000/ dengan url sebenar jika perkhidmatan myems-api dihoskan pada pelayan yang berbeza

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

Pasang myems-admin : Jika pelayan tidak dapat menyambung ke internet, sila mampatkan folder myems/myems-admin dan muat naik ke pelayan serta ekstrak ke ~/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

Amaran

Folder 'upload' adalah untuk fail yang dimuat naik oleh pengguna. JANGAN padam/pindah/timpa folder 'upload' apabila anda menaik taraf myems-admin.

 /var/www/myems-admin/upload

Buka port dan tambah port ke firewall:

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

Mulakan semula perkhidmatan nginx:

sudo systemctl restart nginx.service

Petua

Jika anda menghadapi ralat '403 Forbidden' nginx, anda boleh membetulkannya dengan menukar mod SELinux menggunakan arahan 'sudo setenforce 0'

Step 4 myems-modbus-tcp

Dalam langkah ini, anda akan memasang perkhidmatan myems-modbus-tcp.

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

cd /myems-modbus-tcp

sudo pip install -r requirements.txt

Nota

(CentOS Stream 9/RHEL 9/Rocky 9/AlmaLinux 9.1/Oracle Linux 9.1)If the code does not work, you can use the following code: sudo pip install -r requirements.txt --break-system-packages

Salin fail example.env ke .env dan ubah fail .env:

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

sudo nano /myems-modbus-tcp/.env

Sediakan perkhidmatan systemd:

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

Aktifkan perkhidmatan:

sudo systemctl enable myems-modbus-tcp.service

Mulakan perkhidmatan:

sudo systemctl start myems-modbus-tcp.service

Pantau perkhidmatan:

sudo systemctl status myems-modbus-tcp.service

Lihat log:

cat /myems-modbus-tcp.log

Step 5 myems-cleaning

Dalam langkah ini, anda akan memasang perkhidmatan myems-cleaning.

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

cd /myems-cleaning

sudo pip install -r requirements.txt

Nota

(CentOS Stream 9/RHEL 9/Rocky 9/AlmaLinux 9.1/Oracle Linux 9.1)If the code does not work, you can use the following code: sudo pip install -r requirements.txt --break-system-packages

Salin fail example.env ke .env dan ubah fail .env:

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

sudo nano /myems-cleaning/.env

Sediakan perkhidmatan systemd:

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

Aktifkan perkhidmatan:

sudo systemctl enable myems-cleaning.service

Mulakan perkhidmatan:

sudo systemctl start myems-cleaning.service

Pantau perkhidmatan:

sudo systemctl status myems-cleaning.service

Lihat log:

cat /myems-cleaning.log

Step 6 myems-normalization

Dalam langkah ini, anda akan memasang perkhidmatan myems-normalization.

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

cd /myems-normalization

sudo pip install -r requirements.txt

Nota

(CentOS Stream 9/RHEL 9/Rocky 9/AlmaLinux 9.1/Oracle Linux 9.1)If the code does not work, you can use the following code: sudo pip install -r requirements.txt --break-system-packages

Salin fail example.env ke .env dan ubah fail .env:

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

sudo nano /myems-normalization/.env

Sediakan perkhidmatan systemd:

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

Aktifkan perkhidmatan:

sudo systemctl enable myems-normalization.service

Mulakan perkhidmatan:

sudo systemctl start myems-normalization.service

Pantau perkhidmatan:

sudo systemctl status myems-normalization.service

Lihat log:

cat /myems-normalization.log

Step 7 myems-aggregation

Dalam langkah ini, anda akan memasang perkhidmatan myems-aggregation.

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

cd /myems-aggregation

sudo pip install -r requirements.txt

Nota

(CentOS Stream 9/RHEL 9/Rocky 9/AlmaLinux 9.1/Oracle Linux 9.1)If the code does not work, you can use the following code: sudo pip install -r requirements.txt --break-system-packages

Salin fail example.env ke .env dan ubah fail .env:

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

sudo nano /myems-aggregation/.env

Sediakan perkhidmatan systemd:

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

Aktifkan perkhidmatan:

sudo systemctl enable myems-aggregation.service

Mulakan perkhidmatan:

sudo systemctl start myems-aggregation.service

Pantau perkhidmatan:

sudo systemctl status myems-aggregation.service

Lihat log:

cat /myems-aggregation.log

Step 8 myems-web

Dalam langkah ini, anda akan memasang perkhidmatan UI myems-web.

Pasang Pelayan NGINX

rujuk http://nginx.org/en/linux_packages.html#RHEL

Konfigurasi NGINX

Buang fail lalai

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

Tambah fail baharu di bawah /etc/nginx/conf.d/

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

Tambah seksyen 'server' baharu dengan arahan seperti di bawah:

server {
    listen                 80;
    server_name     myems-web;
    location / {
        root    /var/www/myems-web;
        index index.html index.htm;
        # tambah arahan try_files untuk elak ralat 404 semasa menyegar semula halaman
        try_files $uri  /index.html;
    }
    ## Untuk elak isu CORS, gunakan Nginx untuk proksi myems-api ke laluan /api
    ## Tambah satu lagi lokasi /api dalam 'server'
    ## gantikan url myems-api lalai http://127.0.0.1:8000/ dengan url sebenar jika perkhidmatan myems-api dihoskan pada pelayan yang berbeza
    location /api {
        proxy_pass http://127.0.0.1:8000/;
        proxy_connect_timeout 75;
        proxy_read_timeout 600;
        send_timeout 600;
    }
}

Pasang MyEMS Web UI:

Sediakan NodeJS: Keperluan versi:

Node.js 22.22.2, 24.5.0 atau yang lebih baru
npm 10.9.7, 11.5.1 atau yang lebih baru

sudo dnf install nodejs

Ubah fail config.js:

Nota

Dapatkan mapboxToken di https://mapbox.com dan kemudian tetapkan showOnlineMap kepada true. Jika anda ingin mematikan ciri peta dalam talian, tetapkan showOnlineMap kepada false

cd ~/myems/myems-web

sudo nano src/config.js

Bina dan Mampatkan

sudo npm i

sudo npm run build

Pasang Muat naik fail ke pelayan web anda. Perhatikan bahawa laluan berikut mesti sama seperti yang dikonfigurasi dalam nginx.conf.

sudo mv build  /var/www/myems-web

Buka port dan tambah port ke firewall:

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

Mulakan semula perkhidmatan nginx:

sudo systemctl restart nginx.service

Petua

Jika anda menghadapi ralat '500 Internal Server Error' nginx, anda boleh membetulkannya dengan menukar mod SELinux menggunakan arahan 'sudo setenforce 0'

Selepas pemasangan

Tahniah! Anda kini boleh log masuk ke MyEMS Admin UI dan Web UI.

Port Lalai

MyEMS Web UI: 80

MyEMS API: 8000

MyEMS Admin UI: 8001

Kata Laluan Lalai

Admin UI

administrator

!MyEMS1

Web UI

administrator

!MyEMS1

Prasyarat​

Step 1 Database​

Step 2 myems-api​

Step 3 myems-admin​

Step 4 myems-modbus-tcp​

Step 5 myems-cleaning​

Step 6 myems-normalization​

Step 7 myems-aggregation​

Step 8 myems-web​

Selepas pemasangan​

Port Lalai​

Kata Laluan Lalai​

Penyelesaian Masalah​

Prasyarat

Step 1 Database

Step 2 myems-api

Step 3 myems-admin

Step 4 myems-modbus-tcp

Step 5 myems-cleaning

Step 6 myems-normalization

Step 7 myems-aggregation

Step 8 myems-web

Selepas pemasangan

Port Lalai

Kata Laluan Lalai

Penyelesaian Masalah