본문으로 건너뛰기

설치 개요

엣지는 단일 Docker 컨테이너로 배포되고, install.sh 가 OS 준비부터 systemd 등록까지 한 번에 처리합니다. 이 섹션은 그 절차와 주변을 다룹니다.

순서대로 읽으신다면​

대부분의 현장은 이 셋이면 끝납니다.

  1. 설치 (install.sh) — 게이트웨이 한 대를 세웁니다
  2. 설치 직후 점검 — 헬스체크 · 비밀번호 변경 · 백업
  3. 프로덕션 인수 기준 — 운영팀에 넘기기 전 Go/No-Go

상황이 다르다면​

상황볼 곳
양산 라인에서 100대 이상 반복 설치양산 라인 (factory.sh) — ID · 자격증명 · 라벨 · 인벤토리까지
인터넷 차단 · USB 반입폐쇄망 설치
VMware · Hyper-V · KVM · 클라우드 VM가상 머신 · 클라우드 설치 — 네트워크와 자원 차이만
PLC 망 / WAN 망 설계가 먼저네트워크 구성 — NIC 역할 · static IP · 방화벽
비밀번호를 바꿔야 한다초기 비밀번호 변경 — 커미셔닝 필수
설치가 막혔다설치 문제 해결 — 증상별로
systemd 유닛 · 마운트 · OTA 를 알아야 한다Docker 설치 — 레퍼런스

설치가 하는 일​

원라인 설치의 install.sh 는 idempotent 하게 다음 항목을 정렬합니다.

영역처리 내용
OS 준비필수 패키지, Docker, chrony, firewall, sysctl/limits
네트워크선택적 nmcli static IP 설정, WAN/PLC NIC env override
보안박스별 random admin/MQTT/OPC-UA/API key, CERT_PASS 기반 TLS material
런타임/etc/kopens/app.properties, /data1/pp-data, container image pull/load
systemdplantpulse-edge.service, OTA path/service, host action path/service
검증/api/v1/system/version, /api/v1/system/health, tool-based status check

설치 후 초기 자격증명은 /etc/kopens/credentials.txt 에 1회 저장됩니다. 이 파일은 root 전용으로 보관하고 출하/인수 시 안전하게 전달하세요.

설치 전 확인​

항목기준
OSLinux. RHEL/Fedora/Rocky/CentOS 계열 권장, VM 도 가능
권한root 또는 sudo -i
네트워크product.kopens.io · docker.kopens.io 도달 가능
디스크/opt/kopens 3GB+, /data1 데이터용 100GB+ 권장
메모리8GB 최소, 16GB 이상 권장

폐쇄망이면 인터넷 확인 대신 폐쇄망 설치에서 bundle 과 image tar.zst 를 준비합니다.

설치가 끝났다는 기준​

# 한 줄 상태 점검
sudo bash /opt/kopens/install/bin/status.sh

# 버전 / 컨테이너 모드 확인
curl -ks https://127.0.0.1/api/v1/system/version | python3 -m json.tool

# 전체 컴포넌트 health
curl -ks https://127.0.0.1/api/v1/system/health | python3 -m json.tool

정상 기준:

  • plantpulse-edge.service 가 active
  • /api/v1/system/version 의 container_mode=true
  • /api/v1/system/health HTTP 200, 주요 components UP
  • 프로덕션 인수 기준의 Go / No-Go 항목 통과
  • 웹 UI: https://<게이트웨이-IP>/ui/main
  • Node-RED: https://<게이트웨이-IP>/ui/flow/

문제가 있으면 설치 문제 해결 또는 컨테이너 모드 운영를 먼저 확인합니다.

설치가 끝나면 설치 직후 점검로 이어집니다 — 초기 비밀번호 변경이 그 안에 있습니다.