FreeBSD

ในคู่มือนี้ คุณจะได้เรียนรู้วิธีติดตั้ง MyEMS บนเซิร์ฟเวอร์ FreeBSD

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

คู่มือนี้อธิบายวิธีการติดตั้ง MyEMS บน FreeBSD 13.2 ข้อกำหนดของฮาร์ดแวร์ขึ้นอยู่กับฐานข้อมูลที่เลือกและจำนวนอุปกรณ์ที่เชื่อมต่อกับระบบ หากต้องการรัน MyEMS และ MySQL บนเครื่องเดียวกัน คุณต้องมี RAM อย่างน้อย 8GB

อัปเดตระบบและติดตั้งเครื่องมือ

pkg install git

pkg install python3

pkg install py39-pip-22.3.1

pkg install nginx

pkg install monit

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

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

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

ดู ฐานข้อมูล

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

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

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

cd /myems-api

pip install -r requirements.txt

เคล็ดลับ

หากคุณพบข้อผิดพลาด 'Failed building wheel for pillow' คุณต้อง ติดตั้ง Pillow

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

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

nano /myems-api/.env

ใช้บริการ monit เพื่อตรวจสอบและแก้ไขไฟล์คอนฟิก monit:

nano /etc/monit.d/myems-api
check process mymes-api with pidfile /var/run/myems-api/pid
start program = "/usr/local/bin/gunicorn -b 0.0.0.0:8000 --pid /var/run/myems-api/pid --timeout 600 --workers=4 app:api &"
stop program = "/bin/kill -s TERM $MAINPID"
if 3 restarts within 5 cycles then unmonitor

เริ่มบริการ :

monit restart

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

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

ดูข้อมูลที่ http://nginx.org/en/docs/install.html

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

service nginx enable

กำหนดค่า NGINX

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/

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;
    }
    ## 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 : หากเซิร์ฟเวอร์ไม่สามารถเชื่อมต่ออินเทอร์เน็ตได้ กรุณาบีบอัดโฟลเดอร์ myems/myems-admin แล้วอัปโหลดไปยังเซิร์ฟเวอร์และแตกไฟล์ไปที่ ~/myems/myems-admin

mkdir /var/www

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

chmod 0755 /var/www/myems-admin

ระวัง

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

 /var/www/myems-admin/upload

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

service nginx restart

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

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

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

cd /myems-modbus-tcp

pip install -r requirements.txt

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

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

nano /myems-modbus-tcp/.env

ใช้บริการ monit เพื่อตรวจสอบและแก้ไขไฟล์คอนฟิก monit:

nano /etc/monit.d/myems-modbus-tcp
check file myems-modbus-tcp path /myems-modbus-tcp/main.py
start program = "/usr/local/bin/python3 /myems-modbus-tcp/main.py"
stop program = "/bin/kill -s TERM $MAINPID"
if 3 restarts within 5 cycles then unmonitor

เริ่มบริการ:

monit restart

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

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

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

cd /myems-cleaning

pip install -r requirements.txt

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

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

nano /myems-cleaning/.env

ใช้บริการ monit เพื่อตรวจสอบและแก้ไขไฟล์คอนฟิก monit:

nano /etc/monit.d/myems-cleaning
check file myems-cleaning path /myems-cleaning/main.py
start program = "/usr/local/bin/python3 /myems-cleaning/main.py"
stop program = "/bin/kill -s TERM $MAINPID"
if 3 restarts within 5 cycles then unmonitor

เริ่มบริการ:

monit restart

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

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

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

cd /myems-normalization

pip install -r requirements.txt

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

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

nano /myems-normalization/.env

ใช้บริการ monit เพื่อตรวจสอบและแก้ไขไฟล์คอนฟิก monit:

nano /etc/monit.d/myems-normalization
check file myems-normalization path /myems-normalization/main.py
start program = "/usr/local/bin/python3 /myems-normalization/main.py"
stop program = "/bin/kill -s TERM $MAINPID"
if 3 restarts within 5 cycles then unmonitor

เริ่มบริการ:

monit restart

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

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

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

cd /myems-aggregation

pip install -r requirements.txt

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

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

nano /myems-aggregation/.env

ใช้บริการ monit เพื่อตรวจสอบและแก้ไขไฟล์คอนฟิก monit:

nano /etc/monit.d/myems-aggregation
check file myems-aggregation path /myems-aggregation/main.py
start program = "/usr/local/bin/python3 /myems-aggregation/main.py"
stop program = "/bin/kill -s TERM $MAINPID"
if 3 restarts within 5 cycles then unmonitor

เริ่มบริการ:

monit restart

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

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

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

ดูข้อมูลที่ 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;
        # add try_files directive to avoid 404 error while refreshing pages
        try_files $uri  /index.html;
    }
    ## เพื่อหลีกเลี่ยงปัญหา CORS ให้ใช้ Nginx proxy myems-api ไปที่ path /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 Web UI:

ติดตั้ง NodeJS:

pkg install node-18.16.0

แก้ไขไฟล์ config.js:

หมายเหตุ

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

cd ~/myems/myems-web

nano src/config.js

สร้าง

npm i --unsafe-perm=true --allow-root --legacy-peer-deps

npm run build

ติดตั้ง โปรดตรวจสอบว่า path ต่อไปนี้ตรงกับที่กำหนดไว้ใน nginx.conf

rm -r /var/www/myems-web

mv build  /var/www/myems-web

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

service nginx restart

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

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

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

ขั้นตอนที่ 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

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

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

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

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