톱바와 빠른 액션
게이트웨이 웹 UI 는 어느 화면에 있든 상단 톱바와 본문 맨 아래 빠른 액션 줄이 따라다닙니다. 이 쪽은 「그 아이콘이 어디로 가는가」를 한눈에 보는 색인입니다.
톱바 — 왼쪽은 집, 오른쪽은 이동

| 번호 | 아이콘 | 이름 (마우스를 올리면 뜹니다) | 무엇을 하는 곳인가 | 자세히 |
|---|---|---|---|---|
| ① | 로고 | — | 누르면 홈(/ui/main)으로. 옆의 글자는 이 게이트웨이의 이름이라 박스를 구분하는 표시입니다 | 홈 화면 |
| ② | fa-plug | 프로토콜 연결하기 | 새 PLC·OPC-UA·MQTT 를 등록합니다. 프로토콜 카드에서 고르는 것이 시작입니다 | 프로토콜 선택 · 새 PLC 연결 추가 |
| ③ | fa-list | 연결된 목록 | 등록된 연결과 그 태그를 한 화면에서 시작·중지·편집 | 연결 목록과 태그 목록 |
| ④ | fa-cubes | 애플리케이션 | 게이트웨이에 얹은 도커 앱을 띄우고 내리고 로그를 봅니다 | 애플리케이션 관리 |
| ⑤ | fa-sitemap | OPC UA 서버 | 게이트웨이가 내주는 OPC-UA 트리 — 외부 SCADA 가 보는 그대로 | OPC UA 서버 |
| ⑥ | fa-database | 포인트 검색 | 쌓인 시계열 값을 기간·연결·태그로 찾고 CSV 로 내립니다 | 포인트 검색 |
| ⑦ | fa-exclamation-triangle | 로그 | 시스템 로그. 아이콘 위 빨간 숫자가 오늘의 오류 건수입니다 | 시스템 로그 |
| ⑧ | fa-project-diagram | 노-코드 플로우 | Node-RED — 태그를 읽어 가공하고 밖으로 보냅니다 | 플로우 |
| ⑨ | fa-tachometer-alt | 고급 대시보드 | 새 창으로 게이트웨이의 :3000(Grafana)을 엽니다 | — |
| ⑩ | fa-cog | 설정 | app.properties 를 브라우저에서 고칩니다 | 웹 UI 환경 설정 |
| ⑪ | fa-book-open | 매뉴얼 | 새 창으로 이 문서 사이트(docs.kopens.io)를 엽니다 | — |
| ⑫ | fa-sign-out-alt | 로그아웃 | 세션을 끊습니다 | 로그인 |
⑨ 와 ⑪ 은 새 창입니다
나머지는 같은 창에서 넘어갑니다. ⑨ 는 게이트웨이 바깥의 도구(기본 Grafana)라
사이트마다 다를 수 있고, 방화벽에서 3000 이 막혀 있으면 열리지 않습니다 →
방화벽 — 노출 포트
처음이라면 이 순서로
- ② 프로토콜 연결하기 — 쓸 PLC 종류를 고르고 등록합니다
- ③ 연결된 목록 — 수집을 시작하고 값이 들어오는지 봅니다
- ⑤ OPC UA 서버 — 외부 SCADA 에 어떻게 보이는지 확인합니다
- ⑧ 노-코드 플로우 — 들어온 값을 가공하거나 밖으로 보냅니다
- ⑩ 설정 — MQTT·Sparkplug·보관 주기 같은 정책을 다듬습니다
빠른 액션 — 본문 맨 아래
톱바가 아니라 본문 맨 아래에 있습니다. 화면을 끝까지 내리면 왼쪽 밑에 붙어 있고, 오른쪽 끝에는 현재 S/W 버전과 「업그레이드 가능」 배지가 함께 뜹니다.
| 번호 | 아이콘 | 하는 일 | 무게 |
|---|---|---|---|
| ① | fa-projector | 시스템 리부트 | 🔴 OS 를 내렸다 올립니다 — 수집이 그동안 멈춥니다 |
| ② | fa-repeat-1-alt | 애플리케이션 재시작 | 게이트웨이 앱만 다시 뜹니다 |
| ③ | fa-trash | 임시파일 청소 | 디스크가 모자랄 때 |
| ④ | fa-stopwatch | 백업 | 설정과 데이터를 묶습니다 |
| ⑤ | fa-file-alt | 로그 다운로드 | 문의할 때 첨부할 묶음 |
| ⑥ | fa-microchip | O/S 및 펌웨어 업그레이드 | 🔴 가장 위험합니다 |
| ⑦ | fa-cloud-download | S/W 업그레이드 | 다운로드 서버에서 새 빌드를 받습니다 |
① 과 ⑥ 은 현장에 영향을 줍니다
리부트와 펌웨어 업그레이드는 수집이 멈추는 시간을 만듭니다. 누르기 전에 언제 멈춰도 되는지부터 정하십시오. 각 액션의 소요 시간과 주의점은 상태바 빠른 액션에 있습니다.
화면마다 더 있는 이동 경로
| 화면 | 거기서만 되는 것 |
|---|---|
홈 (/ui/main) | 카드를 누르면 그 화면으로. 「시스템 오류」의 빨간 숫자를 누르면 로그로 |
| 연결 목록 | 카드의 ▶ ◼ 로 수집을 켜고 끕니다. 태그 행에서 값을 바로 씁니다 |
| OPC UA 서버 | 트리에서 노드를 고르면 오른쪽에 상세와 차트. NodeId 를 복사할 수 있습니다 |
| 애플리케이션 | 카드의 포트를 누르면 그 앱이 새 창으로 |
| 시스템 로그 | 왼쪽 검색 조건으로 좁히고, 오른쪽 위에서 모두 지웁니다 |
| 설정 | 고친 뒤 저장하면 재시작 안내가 뜹니다 |
하려는 일에서 되짚기
| 하려는 일 | 빠른 길 |
|---|---|
| 오늘 난 오류만 보고 싶다 | 톱바 ⑦ 의 빨간 숫자 · 또는 홈의 「시스템 오류」 |
| PLC 가 지금 붙어 있나 | 톱바 ③ → 카드의 연결 아이콘(초록 = 연결) |
| 어제 그 시각의 값 | 톱바 ⑥ → 기간·연결·태그로 찾고 CSV |
| 외부 SCADA 에 어떻게 보이나 | 톱바 ⑤ |
| 지금 도는 컨테이너 | 톱바 ④ |
| 설정 한 줄만 고치기 | 톱바 ⑩ → 고치고 저장 → 빠른 액션 ② 로 재시작 |
| 새 빌드 적용 | 빠른 액션 ⑦ (배지가 빨갈 때만) |