FreeBSD

본 가이드에서는 FreeBSD 서버에 MyEMS를 배포하는 방법을 설명합니다.

선행 조건

본 가이드는 FreeBSD 13.2에 MyEMS를 설치하는 방법을 다룹니다. 하드웨어 요구사항은 선택한 데이터베이스와 시스템에 연결된 장치 수에 따라 달라집니다. 단일 머신에 MyEMS와 MySQL을 실행하려면 최소 4GB의 RAM이 필요합니다.

시스템 업데이트 및 도구 설치

pkg install git

pkg install python3

pkg install py39-pip-22.3.1

pkg install nginx

pkg install monit

소스 코드 클론:

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

1단계: 데이터베이스

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

2단계: myems-api

myems-api 서비스 설치:

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

cd /myems-api

pip install -r requirements.txt

팁

'Failed building wheel for pillow' 오류가 발생하는 경우 Pillow 설치 가이드를 참조하십시오.

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

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

nano /myems-api/.env

monit 모니터링 서비스를 사용하고 monit 구성 파일 편집:

nano /etc/monit.d/myems-api
check process mymes-api with pidfile /var/run/myems-api/pid
start program = "/usr/local/bin/gunicorn -b 0.0.0.0:8000 --pid /var/run/myems-api/pid --timeout 600 --workers=4 app:api &"
stop program = "/bin/kill -s TERM $MAINPID"
if 3 restarts within 5 cycles then unmonitor

서비스 시작:

monit restart

3단계: myems-admin

NGINX 서버 설치

http://nginx.org/en/docs/install.html 문서 참조

nginx 서비스 활성화:

service nginx enable

NGINX 구성

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/ 아래에 새 파일 추가

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으로 압축을 해제하십시오.

mkdir /var/www

cp -r ~/myems/myems-admin  /var/www/myems-admin

chmod 0755 /var/www/myems-admin

구성 파일 확인 및 필요한 경우 변경:

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

주의

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

 /var/www/myems-admin/upload

nginx 서비스 재시작:

service nginx restart

4단계: myems-modbus-tcp

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

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

cd /myems-modbus-tcp

pip install -r requirements.txt

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

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

nano /myems-modbus-tcp/.env

monit 모니터링 서비스를 사용하고 monit 구성 파일 편집:

nano /etc/monit.d/myems-modbus-tcp
check file myems-modbus-tcp path /myems-modbus-tcp/main.py
start program = "/usr/local/bin/python3 /myems-modbus-tcp/main.py"
stop program = "/bin/kill -s TERM $MAINPID"
if 3 restarts within 5 cycles then unmonitor

서비스 시작:

monit restart

5단계: myems-cleaning

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

cp -r ~/myems/myems-cleaning /myems-cleaning

cd /myems-cleaning

pip install -r requirements.txt

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

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

nano /myems-cleaning/.env

monit 모니터링 서비스를 사용하고 monit 구성 파일 편집:

nano /etc/monit.d/myems-cleaning
check file myems-cleaning path /myems-cleaning/main.py
start program = "/usr/local/bin/python3 /myems-cleaning/main.py"
stop program = "/bin/kill -s TERM $MAINPID"
if 3 restarts within 5 cycles then unmonitor

서비스 시작:

monit restart

6단계: myems-normalization

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

cp -r ~/myems/myems-normalization /myems-normalization

cd /myems-normalization

pip install -r requirements.txt

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

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

nano /myems-normalization/.env

monit 모니터링 서비스를 사용하고 monit 구성 파일 편집:

nano /etc/monit.d/myems-normalization
check file myems-normalization path /myems-normalization/main.py
start program = "/usr/local/bin/python3 /myems-normalization/main.py"
stop program = "/bin/kill -s TERM $MAINPID"
if 3 restarts within 5 cycles then unmonitor

서비스 시작:

monit restart

7단계: myems-aggregation

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

cp -r ~/myems/myems-aggregation /myems-aggregation

cd /myems-aggregation

pip install -r requirements.txt

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

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

nano /myems-aggregation/.env

monit 모니터링 서비스를 사용하고 monit 구성 파일 편집:

nano /etc/monit.d/myems-aggregation
check file myems-aggregation path /myems-aggregation/main.py
start program = "/usr/local/bin/python3 /myems-aggregation/main.py"
stop program = "/bin/kill -s TERM $MAINPID"
if 3 restarts within 5 cycles then unmonitor

서비스 시작:

monit restart

8단계: myems-web

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

NGINX 서버 설치

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를 추가합니다.
    ## 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 Web UI 설치:

NodeJS 설정:

pkg install node-18.16.0

config.js 파일 수정:

참고

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

cd ~/myems/myems-web

nano src/config.js

빌드

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

npm run build

설치 다음 경로는 nginx.conf에서 구성한 경로와 동일해야 합니다.

rm -r /var/www/myems-web

mv build  /var/www/myems-web

nginx 서비스 재시작:

service nginx restart

설치 후 작업

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

설치 후 작업

기본 포트

기본 비밀번호

문제 해결