Raspberry Pi

في هذا الدليل، ستقوم بنشر MyEMS على Raspberry Pi.

المتطلبات الأساسية

Raspberry Pi 5 أو Raspberry Pi 4 Model B
نظام تشغيل Raspberry Pi (64 بت) وهو نسخة من Debian Bookworm مع سطح مكتب Raspberry Pi، الإصدار: 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): [اضغط مفتاح الإدخال أو مفتاح الإرجاع]
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/ بالرابط الفعلي
      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

تحقق من ملف التكوين وقم بتغييره إذا لزم الأمر:

sudo nano /var/www/myems-admin/app/api.js

احذر

مجلد '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

لمنع خطأ 'error: externally-managed-environment'، قم بإنشاء مجلد تهيئة بيئة افتراضية:

sudo python -m venv venv

ابدأ استخدام البيئة الافتراضية

source venv/bin/activate

قم بتثبيت المتطلبات

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

اخرج من البيئة الافتراضية

deactivate

انسخ ملف example.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

لمنع خطأ 'error: externally-managed-environment'، قم بإنشاء مجلد تهيئة بيئة افتراضية:

sudo python -m venv venv

ابدأ استخدام البيئة الافتراضية

source venv/bin/activate

قم بتثبيت المتطلبات

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

اخرج من البيئة الافتراضية

deactivate

انسخ ملف example.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

لمنع خطأ 'error: externally-managed-environment'، قم بإنشاء مجلد تهيئة بيئة افتراضية:

sudo python -m venv venv

ابدأ استخدام البيئة الافتراضية

source venv/bin/activate

قم بتثبيت المتطلبات

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

اخرج من البيئة الافتراضية

deactivate

انسخ ملف example.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

لمنع خطأ 'error: externally-managed-environment'، قم بإنشاء مجلد تهيئة بيئة افتراضية:

sudo python -m venv venv

ابدأ استخدام البيئة الافتراضية

source venv/bin/activate

قم بتثبيت المتطلبات

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

اخرج من البيئة الافتراضية

deactivate

انسخ ملف example.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

في هذه الخطوة، ستقوم بتثبيت واجهة خدمة 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 الويب:

تثبيت 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

بناء وضغط:

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

sudo npm run build

التثبيت

sudo mv build  /var/www/myems-web

أعد تشغيل NGINX:

sudo systemctl restart nginx

أضف المنفذ إلى جدار الحماية:

sudo ufw allow 80

ما بعد التثبيت

مبروك! يمكنك الآن تسجيل الدخول إلى واجهة MyEMS الإدارية والويب.

المنافذ الافتراضية

واجهة MyEMS الويب: 80

MyEMS API: 8000

واجهة MyEMS الإدارية: 8001

بافتراض أن عنوان الخادم هو 192.168.1.8 (استبدل بعنوان الخادم الفعلي) الوصول إلى واجهة MyEMS الويب على http://192.168.1.8 (يمكن حذف 80) الوصول إلى واجهة MyEMS الإدارية على http://192.168.1.8:8001

كلمات المرور الافتراضية

واجهة MyEMS الإدارية

اسم المستخدم:

administrator

كلمة المرور:

!MyEMS1

واجهة MyEMS الويب

اسم المستخدم:

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

ما بعد التثبيت

المنافذ الافتراضية

كلمات المرور الافتراضية

استكشاف الأخطاء وإصلاحها