본문으로 건너뛰기

재시작 (restart.sh / reboot.sh)

Legacy native 페이지

이 페이지는 2026.05 미만 native 배포 박스 전용. 컨테이너 모드 (2026.05+) 박스의 재시작:

sudo systemctl restart plantpulse-edge.service

UI 의 "재시작" 버튼은 signal file (/etc/kopens/host-action.request) 를 통해 host 의 kopens-host-action.path 가 처리. 컨테이너 모드 운영 가이드 참조.

1. restart.sh — Tomcat 만 재시작 (가장 자주)

$PE_HOME/bin/restart.sh
  • 재시작 대상: Tomcat (서버) + FENetClient(LS) + GEClient
  • 그대로 유지: Cassandra, HiveMQ, Redis, timeseries-engine, Node-RED — 데이터 무손실

정상 출력:

--------------------------------------------------------------------
PLANTPULSE EDGE RESTART APPLICATION ...
--------------------------------------------------------------------
[1] SERVER STOP ... java killed (pid 12567)
[2] SERVER START ...
--------------------------------------------------------------------
RESTART COMPLETED.
--------------------------------------------------------------------

소요 ~6초. 코드 / JSP / app.properties / 클래스 파일을 배포로 올린 직후, 또는 왠지 Tomcat 만 답답할 때 가장 자주 사용.

재시작 직후 1–2초 대기

restart.sh 직후 같은 ssh 세션에서 curl http://localhost/... 을 바로 치면 Connection refused 가 보일 수 있습니다. 1–2 초만 기다리세요.

드물게 발생하는 race — 같은 명령 1회 더 호출

restart.sh 후 매우 드물게 내부 시작 리스너 가 silently 실패해 OPC 가 0/N (10 중 0) 으로 보일 때가 있습니다. 그 경우 ./restart.sh 한 번 더 호출하면 회복 됩니다.


2. reboot.sh — OS 재부팅

$PE_HOME/bin/reboot.sh

OS 자체를 재부팅 합니다. 커널 / firmware 갱신 후 또는 다른 방법으로 풀리지 않는 시스템 행 상태일 때 사용.

호출 전 권장 순서:

$PE_HOME/bin/stop.sh # 1. 정식 종료 (Cassandra drain)
$PE_HOME/bin/reboot.sh # 2. OS 재부팅
# 부팅 후 (자동 시작 안 되어 있으면)
$PE_HOME/bin/start.sh # 3. 게이트웨이 다시 시작

3. 검증

restart.sh 후:

$PE_HOME/bin/ps.sh # Tomcat 만 PID 가 새 값
curl -s http://127.0.0.1/api/v1/edge | jq # 응답 정상
curl -s http://127.0.0.1/ui/opcua/tree | jq '.data.tree | length'

reboot.sh 후 (OS 재부팅 끝나고 ssh 다시 들어가서):

$PE_HOME/bin/ps.sh
# 모든 컴포넌트 (cassandra, hivemq, timeseries, tomcat, node-red) 가 모두 보여야 함

4. 더 알아보기