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

نصب سرور NGINX مراحل نصب را از آدرس http://nginx.org/en/linux_packages.html#Debian مرور کنید.
پیکربندی 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 استفاده کنید
    ## یک 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:

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 --unsafe-perm=true --allow-root --legacy-peer-deps

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@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

پس از نصب

پورت‌های پیش‌فرض

رمزهای عبور پیش‌فرض

رفع اشکال