본문으로 건너뛰기

설치 직후 점검

설치 (원라인 설치, 양산 라인 설치, 폐쇄망 설치) 가 끝났다면 다음 순서로 게이트웨이를 운영 준비 상태 로 전환합니다.

1. 1분 헬스체크​

sudo bash /opt/kopens/install/bin/status.sh
curl -ks https://127.0.0.1/api/v1/system/version | python3 -m json.tool
curl -ks https://127.0.0.1/api/v1/system/health | python3 -m json.tool

기대:

  • container running + healthy
  • 9개 포트 listening (80, 443, 1883, 1884, 6379, 9042, 1880, 12000, 12443) — 7799(Tomcat JMX)는 127.0.0.1 에서만 듣습니다
  • /api/v1/system/version → build_date / image_tag / container_mode=true
  • /api/v1/system/health → 200, components 모두 UP

pe-status 모든 항목 ✓ 면 다음 절. 일부 ✗ 면 컨테이너 모드 운영 의 "장애 대응" 섹션을 참조.

운영 투입 전에는 프로덕션 인수 기준의 acceptance log 도 남깁니다.

2. 초기 비밀번호를 바꿉니다 — 먼저​

설치가 만든 자격증명을 그대로 두고 운영에 넣지 마십시오. 무엇을 어떻게 바꾸는지는 초기 비밀번호 변경에 있습니다 — 커미셔닝 필수 항목이고, 아래 백업·미러링보다 먼저 합니다.

3. 자동 백업 걸기​

sudo tee /etc/cron.d/plantpulse-edge-backup > /dev/null << 'EOF'
# 매일 새벽 3시 백업 + 일요일 새벽 4시 30일 초과 백업 삭제
0 3 * * * root /opt/kopens/install/bin/backup.sh > /dev/null 2>&1
0 4 * * 0 root find /data1/pp-backups -name 'pe-backup-*.tar.zst' -mtime +30 -delete
EOF

sudo bash /opt/kopens/install/bin/backup.sh
ls -lh /data1/pp-backups/

상세: 백업 및 복구

4. 외부 NAS / S3 미러링 (재해 복구)​

백업이 게이트웨이와 같은 디스크에만 있으면 재해 복구 효과 없음. 외부 미러 강력 권장:

# 컨테이너 백업 예시
LATEST=$(ls -t /data1/pp-backups/pe-backup-*.tar.zst | head -1)
rsync -av "$LATEST" "$LATEST.sha256" nas:/backup/edge/

5. 사용자 · 권한 설정 (선택)​

기본 admin 외에 사용자별 계정 이 필요하면:

게이트웨이에는 사용자 · 역할 · 메뉴 접근 권한 화면이 있습니다.

화면주소하는 일
사용자 관리/system/user계정을 만들고 역할을 붙입니다
역할 관리/system/role역할을 정의합니다
메뉴 접근 권한/system/menu_access역할별로 볼 수 있는 메뉴를 정합니다
시나리오권합니다
1인 운영기본 계정으로 쓰고 비밀번호만 바꿉니다
다인 운영계정을 나누고 역할을 붙여 누가 무엇을 했는지 남깁니다
외부 협력사아래 확인을 먼저 하십시오
협력사에게 열어 주기 전에 «실제로 막히는지» 확인하십시오

역할과 메뉴 접근 권한을 저장하는 화면과 테이블은 있지만, 그것이 요청마다 실제로 적용되는지는 설치본에서 직접 확인하시는 편이 안전합니다.

확인하는 법 — 제한된 역할로 계정을 하나 만들고 그 계정으로 로그인해, 막았어야 할 메뉴(예: 연결 삭제)가 정말 안 되는지 눌러 보십시오. 「메뉴가 안 보이는 것」과 「주소를 직접 쳐도 막히는 것」은 다릅니다.

외부에 보여 줄 것이 정해져 있다면, 게이트웨이 화면 대신 플랫폼 권한 그룹 으로 필요한 것만 여는 편이 확실합니다.

6. 다음에 읽을 것​

  1. 홈 화면 카드 / 액션 가이드 — 30 카드 의미
  2. 새 PLC 연결 추가
  3. 태그 등록 + PLC 주소 입력 (44개 드라이버 완전 가이드)
  4. Sparkplug B 발행 — 외부 SCADA 연동 시
  5. 플로우 (Node-RED) — 자동화 / 알람 / 외부 통합
  6. 운영 개요 — 시작/중지/재시작/백업/업그레이드/진단

7. 인수 테스트 체크리스트 (납품 · SI 파트너용)​

신규 사이트 인수 시 다음 항목 모두 통과:

  • 컨테이너 모드면 status.sh 전체 OK, native 면 bin/ps.sh 5 자바/Node 프로세스 확인
  • /api/v1/system/version HTTP 200 + 의도한 edge_id/site_id/container_mode 반환
  • /api/v1/system/health HTTP 200 + components UP
  • 프로덕션 인수 기준의 acceptance log 생성 + sha256 기록
  • /api/v1/monitoring HTTP 200 + cpu_used_percent < 30%, memory_used_percent < 60%
  • 홈 카드 30개 모두 표시 + 1초 갱신 동작
  • 시뮬레이터 OPC 1 개 등록 → 시작 → /ui/opcua 트리에서 차트 정상
  • 실제 PLC 1 대 등록 → 수집 상태 🟢 정상 + 마지막 값 갱신
  • 컨테이너 systemctl restart plantpulse-edge.service 또는 native bin/restart.sh 후 PLC 재연결 자동 (auto_collect=true)
  • 백업 cron 등록 + 첫 백업 파일/디렉토리 생성 확인
  • 첫 백업 .tar.zst 와 .sha256 를 외부 백업 위치로 복사
  • 외부 SCADA / Sparkplug 수신측 메시지 도착 확인
  • 비밀번호 변경 완료 (admin 기본 비밀번호 변경)
  • /etc/kopens/credentials.txt 권한 0600 root 확인 + 비밀번호 전달 절차 완료
  • log-viewer 로 30초 모니터링 — SEVERE / ERROR 급 로그 없음
  • 디스크 여유 30%+ (df -h /data1)
  • OS NTP 동기 (timedatectl) 정상
  • 운영팀에 게이트웨이 IP / 접근 정보 전달 + 인수인계서 서명

더 알아보기​