Pergi ke konten utama

SUSE

Dalam panduan ini, Anda akan melakukan deploy MyEMS di SUSE Linux Enterprise Server.

Prasyarat​

Panduan ini menjelaskan cara menginstal MyEMS di SUSE Linux Enterprise Server 15. Persyaratan perangkat keras bergantung pada basis data yang dipilih dan jumlah perangkat yang terhubung ke sistem. Untuk menjalankan MyEMS dan MySQL pada satu mesin, Anda memerlukan setidaknya 4GB RAM.

Clone kode sumber:

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

Langkah 1 Basis Data (Database)​

Lihat Database

Langkah 2 myems-api​

  • Instal layanan myems-api:
sudo cp -r ~/myems/myems-api /myems-api
cd /myems-api
sudo pip install -r requirements.txt

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

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

Tambahkan port ke firewall:

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

Setup file konfigurasi 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/

Selanjutnya aktifkan layanan agar dimulai secara otomatis 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

refer ke http://nginx.org/en/linux_packages.html#Debian

Aktifkan layanan nginx:

sudo systemctl start nginx.service
  • Konfigurasi NGINX
sudo vi /etc/nginx/nginx.conf

Di 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 /etc/nginx/conf.d/

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

Tulis dengan direktif seperti di bawah, 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;
    }
    ## Untuk menghindari masalah CORS, gunakan Nginx untuk memproksi myems-api ke path /api
    ## Tambahkan lokasi lain /api di 'server'
    ## Ganti URL default myems-api http://127.0.0.1:8000/ dengan URL sebenarnya jika layanan myems-api dihosting di server yang berbeda
    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 vi /var/www/myems-admin/app/api.js
Peringatan

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

 /var/www/myems-admin/upload

Tambahkan port ke firewall:

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

Langkah 4 myems-modbus-tcp​

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

sudo cp -r ~/myems/myems-modbus-tcp /myems-modbus-tcp
cd /myems-modbus-tcp
sudo pip install -r requirements.txt

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

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

Setup layanan systemd:

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

Aktifkan layanan:

sudo systemctl enable myems-modbus-tcp.service

Mulai layanan:

sudo systemctl start myems-modbus-tcp.service

Monitor layanan:

sudo systemctl status myems-modbus-tcp.service

Lihat log:

cat /myems-modbus-tcp.log

Langkah 5 myems-cleaning​

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

sudo cp -r ~/myems/myems-cleaning /myems-cleaning
cd /myems-cleaning
sudo pip install -r requirements.txt

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

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

Setup layanan systemd:

sudo cp /myems-cleaning/myems-cleaning.service /lib/systemd/system/

Aktifkan layanan:

sudo systemctl enable myems-cleaning.service

Mulai layanan:

sudo systemctl start myems-cleaning.service

Monitor layanan:

sudo systemctl status myems-cleaning.service

Lihat log:

cat /myems-cleaning.log

Langkah 6 myems-normalization​

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

sudo cp -r ~/myems/myems-normalization /myems-normalization
cd /myems-normalization
sudo pip install -r requirements.txt

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

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

Setup layanan systemd:

sudo cp /myems-normalization/myems-normalization.service /lib/systemd/system/

Aktifkan layanan:

sudo systemctl enable myems-normalization.service

Mulai layanan:

sudo systemctl start myems-normalization.service

Monitor layanan:

sudo systemctl status myems-normalization.service

Lihat log:

cat /myems-normalization.log

Langkah 7 myems-aggregation​

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

sudo cp -r ~/myems/myems-aggregation /myems-aggregation
cd /myems-aggregation
pip install -r requirements.txt

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

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

Setup layanan systemd:

sudo cp /myems-aggregation/myems-aggregation.service /lib/systemd/system/

Aktifkan layanan:

sudo systemctl enable myems-aggregation.service

Mulai layanan:

sudo systemctl start myems-aggregation.service

Monitor layanan:

sudo systemctl status myems-aggregation.service

Lihat log:

cat /myems-aggregation.log

Langkah 8 myems-web​

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

Hapus file default

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

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

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

Tambahkan bagian 'server' baru dengan direktif sebagai berikut:

server {
    listen                 80;
    server_name     myems-web;
    location / {
        root    /var/www/myems-web;
        index index.html index.htm;
        # tambahkan direktif try_files untuk menghindari error 404 saat me-refresh halaman
        try_files $uri  /index.html;
    }
    ## Untuk menghindari masalah CORS, gunakan Nginx untuk memproksi myems-api ke path /api
    ## Tambahkan lokasi lain /api di 'server' dan ganti alamat demo http://127.0.0.1:8000/ dengan URL sebenarnya
    location /api {
        proxy_pass http://127.0.0.1:8000/;
        proxy_connect_timeout 75;
        proxy_read_timeout 600;
        send_timeout 600;
    }
}

Restart NGINX

sudo systemctl restart nginx
  • Instal MyEMS Web UI:

Setup NodeJS:

sudo zypper install -y nodejs
  • Modifikasi file config.js:
Catatan

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

cd myems/myems-web
sudo vi 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 jalur berikut harus sama dengan yang dikonfigurasi di nginx.conf.

sudo mv build  /var/www/myems-web

Tambahkan port ke firewall:

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

Pasca Instalasi​

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

Port Default​

MyEMS Web UI: 80

MyEMS API: 8000

MyEMS Admin UI: 8001

Asumsikan alamat server adalah 192.168.1.8 (ganti dengan alamat server sebenarnya) Akses MyEMS Web UI di http://192.168.1.8 (80 dapat dihilangkan) Akses MyEMS Admin UI di http://192.168.1.8:8001

Kata Sandi Default​

MyEMS Admin UI

Username:

administrator

Password:

!MyEMS1

MyEMS Web UI

Username:

administrator@myems.io

Password:

!MyEMS1

Pemecahan Masalah (Troubleshooting)​