Fedora CoreOS

Dalam panduan ini, Anda akan melakukan deploy MyEMS pada server Fedora CoreOS.

Prasyarat

Panduan ini menjelaskan cara menginstal MyEMS pada Fedora CoreOS 37. Persyaratan perangkat keras tergantung pada database yang dipilih dan jumlah perangkat yang terhubung ke sistem. Untuk menjalankan MyEMS dan MySQL pada satu mesin, Anda memerlukan setidaknya 4GB RAM.

Perbarui sistem dan instal alat

rpm-ostree install git

rpm-ostree install python3

rpm-ostree install python3-pip

rpm-ostree install nginx

Clone kode sumber:

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

Langkah 1 Database

Lihat Database

Langkah 2 myems-api

Instal layanan myems-api:

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

cd /var/myems-api

sudo pip install -r requirements.txt

Buat file .env berdasarkan example.env dan edit file .env jika diperlukan:

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

sudo nano /var/myems-api/.env

Tambahkan port ke firewall:

sudo firewall-cmd --add-service=http --permanent

sudo firewall-cmd --add-port=8000/tcp --permanent

sudo firewall-cmd --reload

Siapkan file konfigurasi systemd:

sudo cp /var/myems-api/myems-api.service /etc/systemd/system/

sudo cp /var/myems-api/myems-api.socket /etc/systemd/system/

sudo cp /var/myems-api/myems-api.conf /usr/lib/tmpfiles.d/

Selanjutnya aktifkan layanan agar otomatis berjalan saat boot:

sudo systemctl enable myems-api.socket

sudo systemctl enable myems-api.service

Mulai layanan:

sudo systemctl start myems-api.socket

sudo systemctl start myems-api.service

Langkah 3 myems-admin

Instal Server NGINX

lihat http://nginx.org/en/linux_packages.html#RHEL

Aktifkan layanan nginx:

sudo systemctl start nginx.service

Konfigurasi NGINX

sudo nano /etc/nginx/nginx.conf

Pada bagian 'http', tambahkan beberapa direktif:

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;
    ...

}

Tambahkan file baru di bawah /etc/nginx/conf.d/

sudo nano /etc/nginx/conf.d/myems-admin.conf

Tulis dengan direktif seperti di bawah ini, dan ganti url default myems-api http://127.0.0.1:8000/ dengan url sebenarnya jika layanan myems-api dihosting di server yang berbeda

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;
    }
}

Instal myems-admin: Jika server tidak dapat terhubung ke internet, silakan kompres folder myems/myems-admin dan unggah ke server lalu ekstrak ke ~/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

Periksa file konfigurasi dan ubah jika perlu:

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

Peringatan

Folder 'upload' digunakan untuk file yang diunggah pengguna. JANGAN hapus/pindahkan/timpa folder 'upload' saat Anda memperbarui myems-admin.

 /var/www/myems-admin/upload

Buka port dan tambahkan port ke firewall:

sudo firewall-cmd --add-service=http --permanent

sudo firewall-cmd --add-port=8001/tcp --permanent

sudo firewall-cmd --reload

Restart layanan nginx:

sudo systemctl restart nginx.service

Tips

Jika Anda mengalami error '403 Forbidden' pada nginx, Anda dapat memperbaikinya dengan mengubah mode SELinux menggunakan perintah 'sudo setenforce 0'

Langkah 4 myems-modbus-tcp

Pada langkah ini, Anda akan menginstal layanan myems-modbus-tcp.

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

cd /var/myems-modbus-tcp

sudo pip install -r requirements.txt

Salin file example.env ke .env dan modifikasi file .env:

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

sudo nano /var/myems-modbus-tcp/.env

Modify the file main.py:

fh = RotatingFileHandler('/var/myems-modbus-tcp.log', maxBytes=1024*1024, backupCount=1)

Siapkan layanan systemd:

sudo cp myems-modbus-tcp.service /etc/systemd/system/

Aktifkan layanan:

sudo systemctl enable myems-modbus-tcp.service

Mulai layanan:

sudo systemctl start myems-modbus-tcp.service

Pantau layanan:

sudo systemctl status myems-modbus-tcp.service

Lihat log:

cat /myems-modbus-tcp.log

Langkah 5 myems-cleaning

Pada langkah ini, Anda akan menginstal layanan myems-cleaning.

sudo cp -r ~/myems/myems-cleaning /var/myems-cleaning

cd /var/myems-cleaning

sudo pip install -r requirements.txt

Salin file example.env ke .env dan modifikasi file .env:

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

sudo nano /var/myems-cleaning/.env

Modify the file main.py:

fh = RotatingFileHandler('/var/myems-cleaning.log', maxBytes=1024*1024, backupCount=1)

Siapkan layanan systemd:

sudo cp /var/myems-cleaning/myems-cleaning.service /etc/systemd/system/

Aktifkan layanan:

sudo systemctl enable myems-cleaning.service

Mulai layanan:

sudo systemctl start myems-cleaning.service

Pantau layanan:

sudo systemctl status myems-cleaning.service

Lihat log:

cat /myems-cleaning.log

Langkah 6 myems-normalization

Pada langkah ini, Anda akan menginstal layanan myems-normalization.

sudo cp -r ~/myems/myems-normalization /var/myems-normalization

cd /var/myems-normalization

sudo pip install -r requirements.txt

Salin file example.env ke .env dan modifikasi file .env:

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

sudo nano /var/myems-normalization/.env

Modify the file main.py:

fh = RotatingFileHandler('/var/myems-normalization.log', maxBytes=1024*1024, backupCount=1)

Siapkan layanan systemd:

sudo cp /var/myems-normalization/myems-normalization.service /etc/systemd/system/

Aktifkan layanan:

sudo systemctl enable myems-normalization.service

Mulai layanan:

sudo systemctl start myems-normalization.service

Pantau layanan:

sudo systemctl status myems-normalization.service

Lihat log:

cat /myems-normalization.log

Langkah 7 myems-aggregation

Pada langkah ini, Anda akan menginstal layanan myems-aggregation.

sudo cp -r ~/myems/myems-aggregation /var/myems-aggregation

cd /var/myems-aggregation

sudo pip install -r requirements.txt

Salin file example.env ke .env dan modifikasi file .env:

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

nano /var/myems-aggregation/.env

Modify the file main.py:

fh = RotatingFileHandler('/var/myems-aggregation.log', maxBytes=1024*1024, backupCount=1)

Siapkan layanan systemd:

sudo cp /var/myems-aggregation/myems-aggregation.service /etc/systemd/system/

Aktifkan layanan:

sudo systemctl enable myems-aggregation.service

Mulai layanan:

sudo systemctl start myems-aggregation.service

Pantau layanan:

sudo systemctl status myems-aggregation.service

Lihat log:

cat /myems-aggregation.log

Langkah 8 myems-web

Pada langkah ini, Anda akan menginstal layanan UI myems-web.

Instal Server NGINX

lihat http://nginx.org/en/linux_packages.html#RHEL

Konfigurasi NGINX

Hapus file default

sudo rm /etc/nginx/sites-enabled/default
sudo rm /etc/nginx/conf.d/default.conf

Tambahkan file baru di bawah /etc/nginx/conf.d/

sudo nano /etc/nginx/conf.d/myems-web.conf

Tambahkan bagian 'server' baru dengan direktif seperti di bawah ini:

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;
    }
    ## 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;
    }
}

Instal MyEMS Web UI:

Siapkan NodeJS:

sudo dnf install nodejs

Modifikasi file config.js:

Catatan

Dapatkan mapboxToken di https://mapbox.com lalu atur showOnlineMap ke true. Jika Anda ingin mematikan fitur peta online, atur showOnlineMap ke false

cd ~/myems/myems-web

sudo nano src/config.js

Build dan Kompres

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

sudo npm run build

Instal Unggah file ke server web Anda. Perhatikan bahwa path berikut harus sama seperti yang dikonfigurasi di nginx.conf.

sudo mv build  /var/www/myems-web

Buka port dan tambahkan port ke firewall:

sudo firewall-cmd --add-service=http --permanent

sudo firewall-cmd --add-port=80/tcp --permanent

sudo firewall-cmd --reload

Restart layanan nginx:

sudo systemctl restart nginx.service

Tips

Jika Anda mengalami error '500 Internal Server Error' pada nginx, Anda dapat memperbaikinya dengan mengubah mode SELinux menggunakan perintah 'sudo setenforce 0'

Setelah Instalasi

Selamat! Anda sekarang dapat masuk ke MyEMS Admin UI dan Web UI.

Port Default

MyEMS Web UI: 80

MyEMS API: 8000

MyEMS Admin UI: 8001

Misalkan alamat server adalah 192.168.1.8 (ganti dengan alamat server yang sebenarnya) Akses MyEMS Web UI di http://192.168.1.8 (port 80 dapat diabaikan) Akses MyEMS Admin UI di http://192.168.1.8:8001

Password Default

MyEMS Admin UI

Nama Pengguna:

administrator

Kata Sandi:

!MyEMS1

MyEMS Web UI

Nama Pengguna:

administrator@myems.io

Kata Sandi:

!MyEMS1

Prasyarat​

Langkah 1 Database​

Langkah 2 myems-api​

Langkah 3 myems-admin​

Langkah 4 myems-modbus-tcp​

Langkah 5 myems-cleaning​

Langkah 6 myems-normalization​

Langkah 7 myems-aggregation​

Langkah 8 myems-web​

Setelah Instalasi​

Port Default​

Password Default​

Pemecahan Masalah​

Prasyarat

Langkah 1 Database

Langkah 2 myems-api

Langkah 3 myems-admin

Langkah 4 myems-modbus-tcp

Langkah 5 myems-cleaning

Langkah 6 myems-normalization

Langkah 7 myems-aggregation

Langkah 8 myems-web

Setelah Instalasi

Port Default

Password Default

Pemecahan Masalah