raspberry-pi

sidebar_position: 7

Raspberry Pi

ในคู่มือนี้ คุณจะติดตั้ง MyEMS ลงบน Raspberry Pi

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

Raspberry Pi 5 หรือ Raspberry Pi 4 Model B
Raspberry Pi OS (64-bit) ระบบปฏิบัติการพอร์ตของ Debian Bookworm พร้อม Raspberry Pi Desktop วันที่เผยแพร่: 2024-07-04

โคลนซอร์สโค้ด

sudo apt install git

sudo apt install pip

sudo apt install ufw

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

ขั้นตอนที่ 1 ฐานข้อมูล

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

sudo apt update

sudo apt upgrade

sudo apt install mariadb-server

โดยค่าเริ่มต้น MySQL ถูกติดตั้งโดยไม่มีรหัสผ่านใด ๆ ตั้งไว้ ซึ่งหมายความว่าคุณสามารถเข้าถึงเซิร์ฟเวอร์ MySQL โดยไม่ต้องยืนยันตัวตนใด ๆ รันคำสั่งต่อไปนี้เพื่อเริ่มกระบวนการรักษาความปลอดภัยของ MySQL

sudo mysql_secure_installation

Enter current password for root (enter for none): [กด Enter หรือ return]
Switch to unix_socket authentication [Y/n] Y
Change the root password? [Y/n] Y
New password: !MyEMS1
Re-enter new password: !MyEMS1
Remove anonymous users? [Y/n] Y
Disallow root login remotely? [Y/n] n
Remove test database and access to it? [Y/n] Y
Reload privilege tables now? [Y/n] Y

ติดตั้งโครงสร้างฐานข้อมูลและสคริปต์สำหรับ MyEMS

ดู ฐานข้อมูล

ขั้นตอนที่ 2 myems-api

ติดตั้งบริการ myems-api:

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

cd /myems-api

เพื่อป้องกันข้อผิดพลาด 'error: externally-managed-environment' ให้สร้างโฟลเดอร์การกำหนดค่าสภาพแวดล้อมเสมือน:

sudo python -m venv venv

เริ่มใช้สภาพแวดล้อมเสมือน

source venv/bin/activate

ติดตั้งแพ็คเกจที่จำเป็น

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

ออกจากสภาพแวดล้อมเสมือน

deactivate

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

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

sudo nano /myems-api/.env

เปลี่ยนเส้นทาง gunicorn ใน myems-api.service:

sudo nano /myems-api/myems-api.service

[Unit]
Description=myems-api daemon
Requires=myems-api.socket
After=network.target

[Service]
PIDFile=/run/myems-api/pid
User=root
Group=root
WorkingDirectory=/myems-api
ExecStart=/myems-api/venv/bin/gunicorn -b 0.0.0.0:8000 --pid /run/myems-api/pid --timeout 600 --workers=4 app:api
ExecReload=/bin/kill -s HUP $MAINPID
ExecStop=/bin/kill -s TERM $MAINPID
PrivateTmp=true

[Install]
WantedBy=multi-user.target

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

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

ขั้นตอนที่ 3 myems-admin

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

ดูข้อมูลได้ที่ http://nginx.org/en/linux_packages.html#Debian

sudo apt install curl gnupg2 ca-certificates lsb-release debian-archive-keyring

curl https://nginx.org/keys/nginx_signing.key | gpg --dearmor | sudo tee /usr/share/keyrings/nginx-archive-keyring.gpg >/dev/null

gpg --dry-run --quiet --no-keyring --import --import-options import-show /usr/share/keyrings/nginx-archive-keyring.gpg

echo "deb [signed-by=/usr/share/keyrings/nginx-archive-keyring.gpg] http://nginx.org/packages/debian `lsb_release -cs` nginx" | sudo tee /etc/apt/sources.list.d/nginx.list

echo -e "Package: *\nPin: origin nginx.org\nPin: release o=nginx\nPin-Priority: 900\n" | sudo tee /etc/apt/preferences.d/99nginx

sudo apt update

sudo apt install nginx

กำหนดค่า 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;

    ...
}

ในส่วน 'http' ให้เพิ่มส่วน 'server' ใหม่พร้อมคำสั่งดังต่อไปนี้:

  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' และแทนที่ที่อยู่ตัวอย่าง 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;
      }
  }

ติดตั้ง myems-admin :

sudo mkdir /var/www

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

sudo chmod 0755 -R /var/www/myems-admin

ระวัง

โฟลเดอร์ 'upload' สำหรับไฟล์ที่ผู้ใช้อัปโหลด ห้ามลบ/ย้าย/เขียนทับโฟลเดอร์ 'upload' เมื่อคุณอัปเกรด myems-admin

 /var/www/myems-admin/upload

เริ่มต้น Nginx:

sudo systemctl start nginx

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

sudo ufw allow 8001

ขั้นตอนที่ 4 myems-modbus-tcp

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

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

cd /myems-modbus-tcp

sudo python -m venv venv

เริ่มใช้สภาพแวดล้อมเสมือน

source venv/bin/activate

ติดตั้งแพ็คเกจที่จำเป็น

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

ออกจากสภาพแวดล้อมเสมือน

deactivate

คัดลอกไฟล์ exmaple.env ไปยัง .env และแก้ไขไฟล์ .env:

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

sudo nano /myems-modbus-tcp/.env

เปลี่ยนเส้นทาง python ใน myems-modbus-tcp.service

sudo nano myems-modbus-tcp.service

[Unit]
Description=myems-modbus-tcp daemon
After=network.target

[Service]
User=root
Group=root
ExecStart=/myems-modbus-tcp/venv/bin/python3 /myems-modbus-tcp/main.py
ExecReload=/bin/kill -s HUP $MAINPID
ExecStop=/bin/kill -s TERM $MAINPID
PrivateTmp=true
Restart=always

[Install]
WantedBy=multi-user.target

ตั้งค่าบริการ 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 python -m venv venv

เริ่มใช้สภาพแวดล้อมเสมือน

source venv/bin/activate

ติดตั้งแพ็คเกจที่จำเป็น

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

ออกจากสภาพแวดล้อมเสมือน

deactivate

คัดลอกไฟล์ exmaple.env ไปยัง .env และแก้ไขไฟล์ .env:

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

nano /myems-cleaning/.env

เปลี่ยนเส้นทาง python ใน myems-cleaning.service

sudo nano myems-cleaning.service

[Unit]
Description=myems-cleaning daemon
After=network.target

[Service]
User=root
Group=root
ExecStart=/myems-cleaning/venv/bin/python3 /myems-cleaning/main.py
ExecReload=/bin/kill -s HUP $MAINPID
ExecStop=/bin/kill -s TERM $MAINPID
PrivateTmp=true
Restart=always

[Install]
WantedBy=multi-user.target

ตั้งค่าบริการ 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 python -m venv venv

เริ่มใช้สภาพแวดล้อมเสมือน

source venv/bin/activate

ติดตั้งแพ็คเกจที่จำเป็น

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

ออกจากสภาพแวดล้อมเสมือน

deactivate

คัดลอกไฟล์ exmaple.env ไปยัง .env และแก้ไขไฟล์ .env:

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

sudo nano /myems-normalization/.env

เปลี่ยนเส้นทาง python ใน myems-normalization.service

sudo nano myems-normalization.service

[Unit]
Description=myems-normalization daemon
After=network.target

[Service]
User=root
Group=root
ExecStart=/myems-normalization/venv/bin/python3 /myems-normalization/main.py
ExecReload=/bin/kill -s HUP $MAINPID
ExecStop=/bin/kill -s TERM $MAINPID
PrivateTmp=true
Restart=always

[Install]
WantedBy=multi-user.target

ตั้งค่าบริการ 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 python -m venv venv

เริ่มใช้สภาพแวดล้อมเสมือน

source venv/bin/activate

ติดตั้งแพ็คเกจที่จำเป็น

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

ออกจากสภาพแวดล้อมเสมือน

deactivate

คัดลอกไฟล์ exmaple.env ไปยัง .env และแก้ไขไฟล์ .env:

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

sudo nano /myems-aggregation/.env

เปลี่ยนเส้นทาง python ใน myems-aggregation.service

sudo nano myems-aggregation.service

[Unit]
Description=myems-aggregation daemon
After=network.target

[Service]
User=root
Group=root
ExecStart=/myems-aggregation/venv/bin/python3 /myems-aggregation/main.py
ExecReload=/bin/kill -s HUP $MAINPID
ExecStop=/bin/kill -s TERM $MAINPID
PrivateTmp=true
Restart=always

[Install]
WantedBy=multi-user.target

ตั้งค่าบริการ 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

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

ติดตั้งเซิร์ฟเวอร์ NGINX (หากติดตั้งแล้วใน myems-admin สามารถข้ามได้) ดูข้อมูลได้ที่ 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;
        # เพิ่มคำสั่ง try_files เพื่อหลีกเลี่ยงข้อผิดพลาด 404 ขณะรีเฟรชหน้า
        try_files $uri  /index.html;
    }
    ## เพื่อหลีกเลี่ยงปัญหา CORS ให้ใช้ Nginx เป็นพร็อกซี่ myems-api ไปยังเส้นทาง /api
    ## เพิ่มตำแหน่ง /api อีกแห่งใน 'server'
    ## หมายเหตุ: แทนที่ที่อยู่เริ่มต้น http://127.0.0.1:8000/ ด้วย IP หรือ URL จริง
    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 หรือใหม่กว่า

curl -fsSL https://deb.nodesource.com/setup_22.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

บิลด์และบีบอัด:

sudo npm i

sudo npm run build

ติดตั้ง

sudo mv build  /var/www/myems-web

เริ่มการทำงานของ NGINX ใหม่:

sudo systemctl restart nginx

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

sudo ufw allow 80

หลังการติดตั้ง

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

sidebar_position: 7​

Raspberry Pi

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

โคลนซอร์สโค้ด​

ขั้นตอนที่ 1 ฐานข้อมูล​

ขั้นตอนที่ 2 myems-api​

ขั้นตอนที่ 3 myems-admin​

ขั้นตอนที่ 4 myems-modbus-tcp​

ขั้นตอนที่ 5 myems-cleaning​

ขั้นตอนที่ 6 myems-normalization​

ขั้นตอนที่ 7 myems-aggregation​

ขั้นตอนที่ 8 myems-web​

หลังการติดตั้ง​

พอร์ตเริ่มต้น​

รหัสผ่านเริ่มต้น​

การแก้ไขปัญหา​

sidebar_position: 7

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

โคลนซอร์สโค้ด

ขั้นตอนที่ 1 ฐานข้อมูล

ขั้นตอนที่ 2 myems-api

ขั้นตอนที่ 3 myems-admin

ขั้นตอนที่ 4 myems-modbus-tcp

ขั้นตอนที่ 5 myems-cleaning

ขั้นตอนที่ 6 myems-normalization

ขั้นตอนที่ 7 myems-aggregation

ขั้นตอนที่ 8 myems-web

หลังการติดตั้ง

พอร์ตเริ่มต้น

รหัสผ่านเริ่มต้น

การแก้ไขปัญหา