ข้ามไปยังเนื้อหาหลัก

Debian/Ubuntu

ในคู่มือนี้ คุณจะได้เรียนรู้วิธีปรับใช้ MyEMS บนเซิร์ฟเวอร์ Debian หรือ Ubuntu

ข้อกำหนดเบื้องต้น​

คู่มือนี้อธิบายวิธีการติดตั้ง MyEMS บน Ubuntu 24.04 LTS / Ubuntu 22.04 LTS / Ubuntu 20.04 LTS / Ubuntu 18.04 LTS / Debian 12 Bookworm / Debian 11 Bullseye / Debian 10 Buster ข้อกำหนดด้านฮาร์ดแวร์ขึ้นอยู่กับฐานข้อมูลที่เลือกและจำนวนอุปกรณ์ที่เชื่อมต่อกับระบบ หากต้องการรัน MyEMS และ MySQL บนเครื่องเดียว คุณจะต้องมีหน่วยความจำ (RAM) อย่างน้อย 4GB

Clone source code:

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

Step 1 Database​

ดูที่ Database

Step 2 myems-api​

  • ติดตั้งบริการ myems-api:
sudo cp -r ~/myems/myems-api /myems-api
cd /myems-api
sudo apt install python3-pip
sudo pip install -r requirements.txt
หมายเหตุ

(Ubuntu 24.04 LTS) หากโค้ดไม่ทำงาน คุณสามารถใช้โค้ดต่อไปนี้: sudo pip install -r requirements.txt --break-system-packages

สร้างไฟล์ .env จาก example.env และแก้ไขไฟล์ .env หากจำเป็น:

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

เพิ่มพอร์ตในไฟร์วอลล์:

sudo ufw allow 8000

ตั้งค่าไฟล์การกำหนดค่า 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

Step 3 myems-admin​

  • ติดตั้งเซิร์ฟเวอร์ NGINX

อ้างอิง http://nginx.org/en/linux_packages.html#Debian

เปิดใช้งานบริการ nginx:

sudo systemctl start nginx.service
  • กำหนดค่า NGINX
sudo 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/

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

เขียนด้วยคำสั่งดังต่อไปนี้ แทนที่ URL myems-api เริ่มต้น http://127.0.0.1:8000/ ด้วย URL จริง หากบริการ 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/ ด้วย 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 ufw allow 8001

รีสตาร์ทบริการ nginx:

sudo systemctl restart nginx.service

Step 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
หมายเหตุ

(Ubuntu 24.04 LTS) หากโค้ดไม่ทำงาน คุณสามารถใช้โค้ดต่อไปนี้: sudo pip install -r requirements.txt --break-system-packages

คัดลอกไฟล์ exmaple.env ไปเป็น .env และแก้ไขไฟล์ .env:

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

ตั้งค่า systemd service:

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

Step 5 myems-cleaning​

ในขั้นตอนนี้ คุณจะติดตั้งบริการ myems-cleaning

sudo cp -r ~/myems/myems-cleaning /myems-cleaning
cd /myems-cleaning
sudo pip install -r requirements.txt
หมายเหตุ

(Ubuntu 24.04 LTS) หากโค้ดไม่ทำงาน คุณสามารถใช้โค้ดต่อไปนี้: sudo pip install -r requirements.txt --break-system-packages

คัดลอกไฟล์ exmaple.env ไปเป็น .env และแก้ไขไฟล์ .env:

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

ตั้งค่า systemd service:

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

Step 6 myems-normalization​

ในขั้นตอนนี้ คุณจะติดตั้งบริการ myems-normalization

sudo cp -r ~/myems/myems-normalization /myems-normalization
cd /myems-normalization
sudo pip install -r requirements.txt
หมายเหตุ

(Ubuntu 24.04 LTS) หากโค้ดไม่ทำงาน คุณสามารถใช้โค้ดต่อไปนี้: sudo pip install -r requirements.txt --break-system-packages

คัดลอกไฟล์ exmaple.env ไปเป็น .env และแก้ไขไฟล์ .env:

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

ตั้งค่า systemd service:

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

Step 7 myems-aggregation​

ในขั้นตอนนี้ คุณจะติดตั้งบริการ myems-aggregation

sudo cp -r ~/myems/myems-aggregation /myems-aggregation
cd /myems-aggregation
sudo pip install -r requirements.txt
หมายเหตุ

(Ubuntu 24.04 LTS) หากโค้ดไม่ทำงาน คุณสามารถใช้โค้ดต่อไปนี้: sudo pip install -r requirements.txt --break-system-packages

คัดลอกไฟล์ exmaple.env ไปเป็น .env และแก้ไขไฟล์ .env:

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

ตั้งค่า systemd service:

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

Step 8 myems-web​

ในขั้นตอนนี้ คุณจะติดตั้งบริการ UI 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/ ด้วย URL จริง
    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 Web UI:

ตั้งค่า NodeJS:

curl -fsSL https://deb.nodesource.com/setup_20.x | sudo bash -
sudo apt-get install -y nodejs
  • แก้ไขไฟล์ config.js:
หมายเหตุ

รับ mapboxToken ที่ https://mapbox.com และตั้ง showOnlineMap เป็น true หากคุณต้องการปิดฟีเจอร์แผนที่ออนไลน์ ให้ตั้ง showOnlineMap เป็น false

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

สร้าง (Build)

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 ufw allow 80

รีสตาร์ท NGINX

sudo systemctl restart nginx

Post-installation (หลังติดตั้ง)​

ยินดีด้วย! คุณสามารถเข้าสู่ระบบ 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

Troubleshooting (การแก้ปัญหา)​

หากเกิดข้อผิดพลาด 'error: externally-managed-environment' เมื่อเรียกใช้คำสั่ง 'sudo pip install -r requirements.txt'

สร้างไดเรกทอรีการกำหนดค่า virtual environment:

sudo python -m venv venv

เริ่มใช้ virtual environment

source venv/bin/activate

ติดตั้งข้อกำหนด (requirements)

sudo venv/bin/pip install -r requirements.txt

ปิดการใช้ virtual environment

deactivate