برو به محتوای اصلی

SUSE

در این راهنما، یاد خواهید گرفت که چگونه MyEMS را روی سرور SUSE Linux Enterprise Server مستقر کنید.

پیش‌نیازها​

این راهنما توضیح می‌دهد که چگونه MyEMS را روی SUSE Linux Enterprise Server 15 نصب کنید. الزامات سخت‌افزاری بسته به پایگاه داده انتخاب شده و تعداد دستگاه‌های متصل به سیستم متغیر است. برای اجرای MyEMS و MySQL روی یک ماشین واحد، حداقل 4 گیگابایت رم نیاز دارید.

کلون کردن کد منبع:

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

گام 1: پایگاه داده​

مراحل نصب پایگاه داده را از بخش Database مرور کنید.

گام 2: myems-api​

  • نصب سرویس myems-api:
sudo cp -r ~/myems/myems-api /myems-api
cd /myems-api
sudo pip install -r requirements.txt

ایجاد فایل .env بر اساس فایل example.env و ویرایش فایل .env در صورت نیاز:

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

اضافه کردن پورت به آتش‌نگار (firewall):

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

تنظیم فایل‌های پیکربندی 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 مرور کنید.

فعال کردن سرویس nginx:

sudo systemctl start nginx.service
  • پیکربندی NGINX
sudo vi /etc/nginx/nginx.conf

در بخش 'http'، چندین دستور (directive) اضافه کنید:

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 vi /etc/nginx/conf.d/myems-admin.conf

محتوای زیر را در فایل بنویسید و در صورت размещение سرویس myems-api روی سرور متفاوتی، آدرس پیش‌فرض myems-api (http://127.0.0.1:8000/) را با آدرس واقعی جایگزین کنید:

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' اضافه کنید
    ## در صورت размещение سرویس myems-api روی سرور متفاوتی، آدرس پیش‌فرض myems-api (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: اگر سرور قادر به اتصال به اینترنت نباشد، لطفاً پوشه 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 vi /var/www/myems-admin/app/api.js
احتیاط

پوشه 'upload' برای فایل‌های بارگذاری شده توسط کاربر است. هنگام به روزرسانی myems-admin، این پوشه را حذف/جابجا/پوشش‌دهی نکنید:

 /var/www/myems-admin/upload

اضافه کردن پورت به آتش‌نگار:

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

گام 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

کپی کردن فایل example.env به .env و ویرایش فایل .env:

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

تنظیم سرویس 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 pip install -r requirements.txt

کپی کردن فایل example.env به .env و ویرایش فایل .env:

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

تنظیم سرویس 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 pip install -r requirements.txt

کپی کردن فایل example.env به .env و ویرایش فایل .env:

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

تنظیم سرویس 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
pip install -r requirements.txt

کپی کردن فایل example.env به .env و ویرایش فایل .env:

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

تنظیم سرویس 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 را نصب خواهید کرد.

حذف فایل‌های پیش‌فرض:

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/ را با آدرس واقعی جایگزین کنید
    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:

تنظیم NodeJS: الزامات نسخه:

  • Node.js 22.22.2, 24.5.0 یا جدیدتر
  • npm 10.9.7, 11.5.1 یا جدیدتر
sudo zypper install -y nodejs
  • ویرایش فایل config.js:
نکته

توکن mapboxToken را از آدرس https://mapbox.com دریافت کرده و سپس showOnlineMap را برابر true تنظیم کنید. اگر می‌خواهید قابلیت نقشه آنلاین را خاموش کنید، showOnlineMap را برابر false قرار دهید.

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

ساخت و فشرده‌سازی:

sudo npm i
sudo npm run build

نصب: فایل‌ها را روی سرور وب خود آپلود کنید. توجه داشته باشید که مسیر زیر باید با مسیری که در nginx.conf پیکربندی شده، یکسان باشد:

sudo mv build  /var/www/myems-web

اضافه کردن پورت به آتش‌نگار:

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

پس از نصب​

تبریک! اکنون می‌توانید به رابط کاربری مدیریت MyEMS (Admin UI) و رابط کاربری وب MyEMS (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

رفع اشکال​