운영 — 한눈에 보기
게이트웨이 서버에 SSH 로 접속한 관리자(root) 가 실행하는 운영 스크립트 모음 입니다. 일반 사용자는 웹 UI 만으로 충분하지만, 시작 / 중지 / 백업 / 업그레이드 / 장애 진단 같은 운영 작업은 이 스크립트들을 통해 수행합니다.
컨테이너 모드 (2026.05+) 는 별도 가이드
systemctl is-active plantpulse-edge.service 가 active 면 컨테이너 모드.
이 페이지의 native 스크립트 (bin/start.sh 등) 대신 컨테이너 모드 페이지의
/opt/kopens/install/bin/*.sh 명령들을 사용하세요. 본 페이지는 native 배포 박스 전용입니다.
설치 경로 (native):
PE_HOME=/opt/kopens/plantpulse-edge
cd $PE_HOME/bin
ls *.sh # 어떤 스크립트가 있는지 확인
한눈에 보기
| 분류 | 스크립트 | 한 줄 설명 | 소요 |
|---|---|---|---|
| 시작 | start.sh | 게이트웨이 전체 스택 부팅 | ~90–120초 |
start-daemon.sh | start.sh 를 nohup 백그라운드로 | 즉시 | |
| 중지 | stop.sh | 모듈별 전체 종료 (각 컴포넌트 max 20초, Cassandra drain 포함) | ~60–90초 |
| 재시작 | restart.sh | Tomcat 만 재시작 — 무중단, 가장 자주 사용 | ~6초 |
reboot.sh | OS 재부팅 | — | |
| 백업 | backup.sh | 설정 + DB snapshot + 도구 데이터 일괄 백업 | 분 단위 |
| 업그레이드 | upgrade.sh | 백업 → 신버전 다운로드 / 설치 | 5–15분 |
firmware.sh | OS 패키지 업데이트 (dnf update) | 분 단위 | |
| 진단 | log-viewer.sh | 7개 컴포넌트 로그 통합 tail -f | 무한 |
ps.sh | 살아있는 plantpulse 프로세스 | 즉시 | |
node-info.sh | nodetool info (Cassandra 상태) | 즉시 | |
node-cql.sh | Cassandra cqlsh 대화형 | — | |
network-speed-test.sh | 외부 망 속도 측정 | 분 단위 | |
| 정리 | clean.sh | 로그 / 임시 파일 일괄 삭제 | 즉시 |
node-cleanup.sh | Cassandra 디스크 회수 | 분 단위 | |
| 시나리오 | — | 신버전 배포 / 장애 진단 / 디스크 부족 / 정기 백업 / 재해 복구 런북 | — |
가장 자주 쓰는 명령
개발 / 배포 사이클에서 거의 매번 사용 하는 건 restart.sh (Tomcat 만 6초). start.sh 는 OS 재부팅 후 한 번, stop.sh 는 점검 · 백업 직전에만 입니다.
서브-컴포넌트의 자체 start.sh / stop.sh
전체 스크립트 (start.sh, stop.sh) 는 순서 조율만 하고 내부 구현은 컴포넌트별 스크립트가 담당합니다. 하나만 재시작 하고 싶을 때 직접 호출:
| 컴포넌트 | 시작 | 중지 |
|---|---|---|
| Redis (cache) | $PE_HOME/cache/bin/start.sh | $PE_HOME/cache/bin/stop.sh |
| Cassandra (DB) | $PE_HOME/db/bin/start.sh | $PE_HOME/db/bin/stop.sh |
| HiveMQ (MQTT) | $PE_HOME/mqtt/bin/start.sh | $PE_HOME/mqtt/bin/stop.sh |
| timeseries-engine | $PE_HOME/timeseries/engine/bin/start.sh | $PE_HOME/timeseries/engine/bin/stop.sh |
| timeseries-dashboard | $PE_HOME/timeseries/dashboard/bin/start.sh | $PE_HOME/timeseries/dashboard/bin/stop.sh |
| Tomcat (server) | $PE_HOME/server/bin/start.sh | $PE_HOME/server/bin/stop.sh |
| Node-RED | $PE_HOME/node/bin/start.sh | $PE_HOME/node/bin/stop.sh |
예 — Node-RED 만 재시작:
$PE_HOME/node/bin/stop.sh
$PE_HOME/node/bin/start.sh
권한 / 위치 참고
- 모든 스크립트는 root 권한이 필요합니다 (포트 80/443 바인드, systemctl, /opt/ 쓰기).
- 디렉토리:
| 용도 | 경로 |
|---|---|
| 게이트웨이 코드 / 산출물 | /opt/kopens/plantpulse-edge/ |
| 사용자 데이터 (sparkplug bdSeq, grafana, node-red, hivemq, apm) | /data1/pp-data/ |
| 백업 산출물 | /data1/pp-backup/ |
| Tomcat 로그 | $PE_HOME/server/logs/catalina.out |
| Cassandra 로그 | $PE_HOME/db/logs/system.log |
| HiveMQ 로그 | $PE_HOME/mqtt/log/hivemq.log |
| Node-RED 로그 | $PE_HOME/node/log/node-red.log |
- 주의:
/opt/kopens/와/data1/pp-data/는 분리된 디스크 에 두기를 권장합니다. 코드 갱신과 데이터 보존이 분리되어 업그레이드 시 데이터 손실 위험 이 줄어듭니다.
더 알아보기
- 각 카테고리의 자세한 절차는 좌측 메뉴의 시작 / 중지 / 재시작 / 백업 / 업그레이드 / 진단 / 정리 / 시나리오 페이지를 보세요.
- 각 스크립트의 사용법은
--help또는 스크립트 상단 주석을 참고하세요.