Debian/Ubuntu

이 가이드에서는 Debian 또는 Ubuntu 서버에 MyEMS를 배포할 것입니다.

전제 조건

이 가이드는 Ubuntu 24.04 LTS / Ubuntu 22.04 LTS / Ubuntu 20.04 LTS / Ubuntu 18.04 LTS / Debian 12 Bookworm / Debian 11 Bullseye / Debian 10 Buster에 MyEMS를 설치하는 방법을 설명합니다. 하드웨어 요구사항은 선택한 데이터베이스와 시스템에 연결된 장치 수에 따라 다릅니다. 단일 머신에서 MyEMS와 MySQL을 실행하려면 최소 4GB RAM이 필요합니다.

소스 코드 클론:

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

1단계 데이터베이스

데이터베이스 참조

2단계 myems-api

myems-api 서비스 설치:

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

cd /myems-api

sudo apt install python3-pip

sudo pip install -r requirements.txt

참고

(Ubuntu 24.04 LTS) 코드가 작동하지 않으면 다음 코드를 사용할 수 있습니다: sudo pip install -r requirements.txt --break-system-packages

example.env를 기반으로 .env 파일 생성 및 필요시 .env 파일 편집:

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

sudo nano /myems-api/.env

방화벽에 포트 추가:

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

nginx 서비스 활성화:

sudo systemctl start nginx.service

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

}

/etc/nginx/conf.d/ 아래에 새 파일 추가

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

아래와 같이 지시문 작성, myems-api 서비스가 다른 서버에 호스팅된 경우 기본 myems-api URL http://127.0.0.1:8000/을 실제 URL로 변경

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 추가
    ## myems-api 서비스가 다른 서버에 호스팅된 경우 기본 myems-api URL 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 설치: 서버가 인터넷에 연결할 수 없는 경우, 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 nano /var/www/myems-admin/app/api.js

주의

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

 /var/www/myems-admin/upload

방화벽에 포트 추가:

sudo ufw allow 8001

nginx 서비스 재시작:

sudo systemctl restart nginx.service

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

참고

(Ubuntu 24.04 LTS) 코드가 작동하지 않으면 다음 코드를 사용할 수 있습니다: sudo pip install -r requirements.txt --break-system-packages

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

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

sudo nano /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

참고

(Ubuntu 24.04 LTS) 코드가 작동하지 않으면 다음 코드를 사용할 수 있습니다: sudo pip install -r requirements.txt --break-system-packages

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

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

sudo nano /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

참고

(Ubuntu 24.04 LTS) 코드가 작동하지 않으면 다음 코드를 사용할 수 있습니다: sudo pip install -r requirements.txt --break-system-packages

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

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

sudo nano /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

sudo pip install -r requirements.txt

참고

(Ubuntu 24.04 LTS) 코드가 작동하지 않으면 다음 코드를 사용할 수 있습니다: sudo pip install -r requirements.txt --break-system-packages

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

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

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

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;
        # 페이지 새로고침 시 404 오류 방지를 위해 try_files 지시문 추가
        try_files $uri  /index.html;
    }
    ## 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;
    }
}

NGINX 재시작

sudo systemctl restart nginx

MyEMS 웹 UI 설치:

NodeJS 설정:

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

sudo apt-get install -y nodejs

config.js 파일 수정:

참고

https://mapbox.com에서 mapboxToken을 가져온 후 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

설치 다음 경로가 nginx.conf에 구성된 경로와 동일해야 합니다.

sudo rm -r /var/www/myems-web

sudo mv build  /var/www/myems-web

방화벽에 포트 추가:

sudo ufw allow 80

NGINX 재시작

sudo systemctl restart nginx

설치 후

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

문제 해결

'sudo pip install -r requirements.txt' 실행 시 'error: externally-managed-environment' 발생 시

가상 환경 구성 디렉토리 생성:

sudo python -m venv venv

가상 환경 사용 시작

source venv/bin/activate

필요 패키지 설치

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

가상 환경 비활성화

deactivate

전제 조건​

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

설치 후

기본 포트

기본 비밀번호

문제 해결