상태바 빠른 액션 (모든 페이지 공통)
게이트웨이 웹 UI 의 모든 페이지 좌하단 상태바 에 7개 빠른 액션 아이콘이 있습니다. OS/애플리케이션을 다시 띄우거나, 디스크 청소 / 백업 / 업그레이드 등 운영자가 자주 쓰는 동작을 한 클릭으로 처리합니다.
재시작 / 리부트 / 임시정리 / 업그레이드 / firmware 버튼은 컨테이너 모드에서 signal 파일 로 동작합니다.
UI 가 직접 bash 스크립트 호출하지 않고 /etc/kopens/upgrade.request 또는
/etc/kopens/host-action.request 를 작성하면, 호스트의 kopens-upgrade.path /
kopens-host-action.path (inotify) 가 감지해 해당 액션을 실행합니다 (Pattern B 보안 — 컨테이너가
host root 등가가 되지 않도록). 실행 결과는 /etc/kopens/upgrade.status / host-action.status
JSON 에 기록되어 UI 가 polling 으로 표시.
┌──────────────────────────────────────────────────────────────┐
│ … 페이지 컨텐츠 … │
├──────────────────────────────────────────────────────────────┤
│ KOPENS Edge | 🎬 🔁 🗑 ⏱ 📄 🔌 ☁ | 버전 V2026.05.10 │
└──────────────────────────────────────────────────────────────┘
각 아이콘은 누르면 확인 모달 이 한 번 뜨고 [확인] 을 한 번 더 눌러야 실행됩니다 (오작동 방지). 일부 액션은 빨강 〈주의〉 뱃지 를 함께 띄워 위험도를 알려줍니다.
1. 🎬 시스템 리부트 (fa-projector)
OS 자체 를 재부팅합니다. 가장 강한 액션 — 평소엔 사용하지 마세요.
| 항목 | 값 |
|---|---|
| 호출 | bootbox.confirm → 백엔드 reboot 엔드포인트 |
| 실 동작 | 운영체제 reboot |
| 소요 시간 | 3 ~ 5 분 (BIOS POST + OS 부팅 + Tomcat 부팅 + Cassandra) |
| PLC 수집 | 그동안 완전 중단 |
| 외부 접속 | 게이트웨이 IP 핑이 안 잡힐 때까지 끊어졌다가 부팅 후 복귀 |
| 사용 시점 | OS 패치 후 / 커널 모듈 로딩 / 하드웨어 점검 후 |
| 주의 라벨 | 🔴 주의 (빨강 뱃지) |
2. 🔁 애플리케이션 재시작 (fa-repeat-1-alt)
Tomcat (게이트웨이 SW) 만 재시작합니다. OS 는 그대로.
| 항목 | 값 |
|---|---|
| 실 동작 | restart.sh (/opt/kopens/plantpulse-edge/bin/restart.sh) |
| 소요 시간 | 약 30 ~ 60 초 |
| PLC 수집 | 그동안 일시 중단 — 부팅 후 자동 복구 |
| 사용 시점 | app.properties 변경 적용 / OPC-UA 서버 재바인딩 / 메모리 누적 정리 |
재시작 race: 일부 환경에서 ServerStartListener 가 silently 실패해 모니터=null 이 되는 경우 — 이때는 한 번 더 ./restart.sh 호출(또는 이 버튼을 한 번 더 클릭)하면 정상 부팅됩니다.
3. 🗑 임시 파일 청소 (fa-trash)
로그/캐시/업로드 잔여물을 지워 디스크 여유 를 확보합니다.
| 항목 | 값 |
|---|---|
| 실 동작 | clean.sh (디스크 사용량이 높은 게이트웨이 작업 디렉토리 prefix 한정 정리) |
| 소요 시간 | 수 초 ~ 수십 초 |
| PLC 수집 | 영향 없음 (파일 정리만) |
| 사용 시점 | 메인 화면 디스크 카드가 90% 넘을 때 / 업그레이드 직전 / 장기간 가동 후 |
홈 화면 디스크 카드 가 빨강일 때 이 버튼이 1차 대처입니다.
4. ⏱ 백업 (fa-stopwatch)
게이트웨이 설정 + 운영 데이터 를 백업 파일로 저장합니다.
| 항목 | 값 |
|---|---|
| 실 동작 | backup.sh |
| 산출물 | /opt/kopens/.../backup/<timestamp>.tar.gz |
| 포함 범위 | app.properties, Cassandra 일부 키스페이스, Node-RED userDir, OPC/태그 정의 |
| 복구 방법 | 백업 / 복구 — 별도 절차 |
| 사용 시점 | 업그레이드 직전 / 환경 이관 / 정기 백업 |
5. 📄 로그 다운로드 (fa-file-alt)
진단용 로그 묶음을 즉시 다운로드합니다.
| 항목 | 값 |
|---|---|
| 호출 | location.href = "/log-download" (GET 요청, 서버에서 zip 스트리밍) |
| 산출물 | 최근 게이트웨이 로그 + 진단 정보 zip |
| 사용 시점 | 시스템 관리자에 문제 보고 시 첨부 / 원인 분석 의뢰 |
로그 본문 검색은 시스템 로그 보기 (
/system/log/list) 가 더 편리합니다 — 특정 기간/레벨/검색어 필터 가능.
6. 🔌 O/S 및 펌웨어 업그레이드 (fa-microchip)
운영체제 / BIOS / 디바이스 펌웨어를 업그레이드합니다. 가장 위험도 높은 액션.
| 항목 | 값 |
|---|---|
| 실 동작 | OS 패키지 매니저 + 벤더 펌웨어 업데이트 스크립트 |
| 소요 시간 | 수 분 ~ 수십 분 |
| PLC 수집 | 그동안 완전 중단 |
| 외부 접속 | 일부 단계에서 끊김 |
| 주의 라벨 | 🔴 주의 (빨강 뱃지) |
| 사용 시점 | 보안 패치 / 벤더 권고 / KOPENS 안내 |
펌웨어 업그레이드는 롤백 불가능한 단계 가 포함될 수 있습니다. 반드시 운영 시간 외에 진행하시고, 백업 (4 번) 을 먼저 받아 두세요.
7. ☁ S/W 업그레이드 (fa-cloud-download)
게이트웨이 SW (이 웹 UI) 를 다운로드 서버에서 받아 업그레이드합니다.
| 항목 | 값 |
|---|---|
| 다운로드 서버 | product.kopens.io (또는 사내 미러) |
| 실 동작 | upgrade.sh — 새 빌드 다운로드 → SHA256 검증 → swap → restart |
| 소요 시간 | 1 ~ 3 분 (다운로드 속도 + restart) |
| PLC 수집 | 1 분 이내 일시 중단 |
| 우상단 뱃지 | 빨강 업그레이드 가능! = 다운로드 서버에 새 버전 있음 / 회색 연결 안됨 = 다운로드 서버 접근 실패 / 뱃지 없음 = 최신 |
| 사용 시점 | 새 빌드 배포 / 버그 픽스 적용 / 신규 드라이버 추가 |
AVA_VERSION 이 비어있으면 (= 다운로드 서버에 못 닿음) 버튼 클릭 시 다운로드 서버에 연결할 수 없습니다 모달이 떠 강제 종료합니다 — 신규 다운로드를 시도하지 않으니 안전.
8. 정리: 어떤 상황에 어떤 버튼?
| 증상 / 의도 | 추천 |
|---|---|
app.properties 만 바꿨다 | 🔁 애플리케이션 재시작 |
| OS 패치 후 / 펌웨어 적용 후 | 🎬 시스템 리부트 |
| 디스크 90% 빨강 | 🗑 임시 파일 청소 |
| 환경 이관 / 업그레이드 직전 | ⏱ 백업 |
| 문제 분석 의뢰 | 📄 로그 다운로드 |
| 신규 빌드 배포 | ☁ S/W 업그레이드 |
| 운영체제 보안 패치 | 🔌 O/S 및 펌웨어 업그레이드 |
9. 관련 문서
- 홈 화면 카드 / 액션 가이드 — 카드 색이 빨강일 때 빠른 액션과의 매핑
- 백업 / 복구 절차 — 백업 결과 복구하는 방법
- 시스템 로그 보기 (
/system/log/list) — 로그 다운로드 대신 화면에서 검색 - 운영 — 한눈에 보기 — CLI (
bin/*.sh) 측면에서 본 운영 스크립트 - 운영 스크립트 상세: start.sh / stop.sh / restart.sh / backup.sh / upgrade.sh / clean.sh