Raspberry Pi

본 가이드에서는 라즈베리 파이에 MyEMS를 배포하는 방법을 설명합니다.

선행 조건

Raspberry Pi 5 또는 Raspberry Pi 4 Model B
Raspberry Pi OS (64비트) - Debian Bookworm 기반의 Raspberry Pi 데스크톱 버전 (출시일:2024-07-04)

소스 코드 클론

sudo apt install git

sudo apt install pip

sudo apt install ufw

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

1단계: 데이터베이스

MySQL 서버 설정

sudo apt update

sudo apt upgrade

sudo apt install mariadb-server

기본적으로 MySQL은 비밀번호 없이 설치되므로 인증 없이 MySQL 서버에 접근할 수 있습니다. 다음 명령을 실행하여 MySQL 보안 설정 과정을 시작합니다.

sudo mysql_secure_installation

Enter current password for root (enter for none): [Enter 키 또는 리턴 키 누르기]
Switch to unix_socket authentication [Y/n] Y
Change the root password? [Y/n] Y
New password: !MyEMS1
Re-enter new password: !MyEMS1
Remove anonymous users? [Y/n] Y
Disallow root login remotely? [Y/n] n
Remove test database and access to it? [Y/n] Y
Reload privilege tables now? [Y/n] Y

MyEMS에 대한 데이터베이스 스키마와 스크립트 설치

데이터베이스 문서를 참조하십시오.

2단계: myems-api

myems-api 서비스 설치:

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

cd /myems-api

'externally-managed-environment' 오류를 방지하기 위해 가상 환경 구성 폴더 생성:

sudo python -m venv venv

가상 환경 사용 시작

source venv/bin/activate

필수 패키지 설치

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

가상 환경 비활성화

deactivate

example.env를 기반으로 .env 파일 생성하고 필요한 경우 수정:

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

sudo nano /myems-api/.env

myems-api.service에서 gunicorn 경로 변경:

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

방화벽에 포트 추가:

sudo ufw allow 8000

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 문서 참조

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

NGINX 구성

sudo nano /etc/nginx/nginx.conf

'http' 섹션에 다음 지시어 추가:

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;

    ...
}

'http' 섹션에 다음 지시어가 포함된 새 'server' 섹션 추가:

  server {
      listen                 8001;
      server_name     myems-admin;
      location / {
          root    /var/www/myems-admin;
          index index.html index.htm;
      }
      ## CORS 문제를 피하기 위해 Nginx를 사용하여 myems-api를 /api 경로로 프록시합니다.
      ## 'server'에 다른 location /api를 추가하고 데모 주소 http://127.0.0.1:8000/을 실제 URL로 교체합니다.
      location /api {
          proxy_pass http://127.0.0.1:8000/;
          proxy_connect_timeout 75;
          proxy_read_timeout 600;
          send_timeout 600;
      }
  }

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 nano /var/www/myems-admin/app/api.js

주의

'upload' 폴더는 사용자가 업로드한 파일용 폴더입니다. myems-admin을 업그레이드할 때 'upload' 폴더를 삭제/이동/덮어쓰지 마십시오.

 /var/www/myems-admin/upload

Nginx 시작:

sudo systemctl start nginx

방화벽에 포트 추가:

sudo ufw allow 8001

4단계: myems-modbus-tcp

이 단계에서는 myems-modbus-tcp 서비스를 설치합니다.

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

cd /myems-modbus-tcp

'externally-managed-environment' 오류를 방지하기 위해 가상 환경 구성 폴더 생성:

sudo python -m venv venv

가상 환경 사용 시작

source venv/bin/activate

필수 패키지 설치

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

가상 환경 비활성화

deactivate

example.env 파일을 .env로 복사하고 .env 파일 수정:

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

sudo nano /myems-modbus-tcp/.env

myems-modbus-tcp.service에서 python 경로 변경

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

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

'externally-managed-environment' 오류를 방지하기 위해 가상 환경 구성 폴더 생성:

sudo python -m venv venv

가상 환경 사용 시작

source venv/bin/activate

필수 패키지 설치

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

가상 환경 비활성화

deactivate

example.env 파일을 .env로 복사하고 .env 파일 수정:

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

nano /myems-cleaning/.env

myems-cleaning.service에서 python 경로 변경

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

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

'externally-managed-environment' 오류를 방지하기 위해 가상 환경 구성 폴더 생성:

sudo python -m venv venv

가상 환경 사용 시작

source venv/bin/activate

필수 패키지 설치

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

가상 환경 비활성화

deactivate

example.env 파일을 .env로 복사하고 .env 파일 수정:

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

sudo nano /myems-normalization/.env

myems-normalization.service에서 python 경로 변경

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

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

'externally-managed-environment' 오류를 방지하기 위해 가상 환경 구성 폴더 생성:

sudo python -m venv venv

가상 환경 사용 시작

source venv/bin/activate

필수 패키지 설치

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

가상 환경 비활성화

deactivate

example.env 파일을 .env로 복사하고 .env 파일 수정:

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

sudo nano /myems-aggregation/.env

myems-aggregation.service에서 python 경로 변경

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

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 UI 서비스를 설치합니다.

NGINX 서버 설치 (myems-admin에서 이미 설치한 경우 생략 가능) http://nginx.org/en/docs/install.html 문서 참조
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;
        # 페이지 새로고침 시 404 오류를 피하기 위해 try_files 지시어 추가
        try_files $uri  /index.html;
    }
    ## CORS 문제를 피하기 위해 Nginx를 사용하여 myems-api를 /api 경로로 프록시합니다.
    ## 'server'에 다른 location /api를 추가합니다.
    ## 참고: 기본 주소 http://127.0.0.1:8000/을 실제 IP 또는 URL로 교체하십시오.
    location /api {
        proxy_pass http://127.0.0.1:8000/;
        proxy_connect_timeout 75;
        proxy_read_timeout 600;
        send_timeout 600;
    }
}

MyEMS Web UI 설치:

NodeJS 설치:

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

sudo apt-get install -y nodejs

config.js 파일 수정:

참고

mapboxToken은 https://mapbox.com에서 획득한 후 showOnlineMap을 true로 설정하십시오. 온라인 맵 기능을 끄려면 showOnlineMap을 false로 설정하십시오.

cd ~/myems/myems-web

sudo nano src/config.js

빌드 및 압축:

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

sudo npm run build

설치

sudo mv build  /var/www/myems-web

NGINX 재시작:

sudo systemctl restart nginx

방화벽에 포트 추가:

sudo ufw allow 80

설치 후 작업

축하합니다! 이제 MyEMS Admin UI와 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

설치 후 작업

기본 포트

기본 비밀번호