Raspberry Pi

Dalam panduan ini, Anda akan melakukan deploy MyEMS ke Raspberry Pi.

Prasyarat

Raspberry Pi 5 atau Raspberry Pi 4 Model B
Raspberry Pi OS (64-bit) Port Debian Bookworm dengan Raspberry Pi Desktop Rilis:2024-07-04

Clone Kode Sumber

sudo apt install git

sudo apt install pip

sudo apt install ufw

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

Langkah 1 Database

Siapkan Server MySQL

sudo apt update

sudo apt upgrade

sudo apt install mariadb-server

Secara default, MySQL diinstal tanpa kata sandi sehingga Anda dapat mengakses server MySQL tanpa autentikasi. Jalankan perintah berikut untuk memulai proses pengamanan MySQL.

sudo mysql_secure_installation

Masukkan kata sandi saat ini untuk root (tekan Enter jika tidak ada): [Enter]
Beralih ke autentikasi unix_socket [Y/n] Y
Ubah kata sandi root? [Y/n] Y
Kata sandi baru: !MyEMS1
Masukkan ulang kata sandi baru: !MyEMS1
Hapus pengguna anonim? [Y/n] Y
Larang login root dari jarak jauh? [Y/n] n
Hapus database uji dan aksesnya? [Y/n] Y
Muat ulang tabel hak istimewa sekarang? [Y/n] Y

Instal skema dan skrip database untuk MyEMS.

Lihat Database

Langkah 2 myems-api

Instal layanan myems-api:

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

cd /myems-api

Untuk mencegah 'error: externally-managed-environment', buat folder konfigurasi virtual environment:

sudo python -m venv venv

Mulai menggunakan virtual environment

source venv/bin/activate

Instal persyaratan

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

Nonaktifkan virtual environment

deactivate

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

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

sudo nano /myems-api/.env

Ubah path gunicorn di 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

Tambahkan port ke firewall:

sudo ufw allow 8000

Siapkan 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 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#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

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;

    ...
}

Pada bagian 'http', tambahkan bagian 'server' baru dengan direktif seperti di bawah ini:

  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' and replace demo address http://127.0.0.1:8000/ with actual url
      location /api {
          proxy_pass http://127.0.0.1:8000/;
          proxy_connect_timeout 75;
          proxy_read_timeout 600;
          send_timeout 600;
      }
  }

Instal 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

Mulai Nginx:

sudo systemctl start nginx

Tambahkan port ke firewall:

sudo ufw allow 8001

Langkah 4 myems-modbus-tcp

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

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

cd /myems-modbus-tcp

Untuk mencegah 'error: externally-managed-environment', buat folder konfigurasi virtual environment:

sudo python -m venv venv

Mulai menggunakan virtual environment

source venv/bin/activate

Instal persyaratan

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

Nonaktifkan virtual environment

deactivate

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

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

sudo nano /myems-modbus-tcp/.env

Ubah path python di 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

Siapkan 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

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 /myems-cleaning

cd /myems-cleaning

Untuk mencegah 'error: externally-managed-environment', buat folder konfigurasi virtual environment:

sudo python -m venv venv

Mulai menggunakan virtual environment

source venv/bin/activate

Instal persyaratan

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

Nonaktifkan virtual environment

deactivate

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

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

nano /myems-cleaning/.env

Ubah path python di 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

Siapkan 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

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 /myems-normalization

cd /myems-normalization

Untuk mencegah 'error: externally-managed-environment', buat folder konfigurasi virtual environment:

sudo python -m venv venv

Mulai menggunakan virtual environment

source venv/bin/activate

Instal persyaratan

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

Nonaktifkan virtual environment

deactivate

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

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

sudo nano /myems-normalization/.env

Ubah path python di 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

Siapkan 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

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 /myems-aggregation

cd /myems-aggregation

Untuk mencegah 'error: externally-managed-environment', buat folder konfigurasi virtual environment:

sudo python -m venv venv

Mulai menggunakan virtual environment

source venv/bin/activate

Instal persyaratan

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

Nonaktifkan virtual environment

deactivate

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

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

sudo nano /myems-aggregation/.env

Ubah path python di 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

Siapkan 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

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 (Jika sudah diinstal di myems-admin, bisa diabaikan) lihat http://nginx.org/en/docs/install.html
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'
    ## NOTE: replace dafault address http://127.0.0.1:8000/ with actual IP or URL
    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:

Instal NodeJS:

curl -fsSL https://deb.nodesource.com/setup_20.x | sudo bash -

sudo apt-get install -y 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

sudo mv build  /var/www/myems-web

Restart NGINX:

sudo systemctl restart nginx

Tambahkan port ke firewall:

sudo ufw allow 80

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​

Clone Kode Sumber​

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

Clone Kode Sumber

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