설정 백업 / 복구
게이트웨이의 PLC 등록 정보 / 태그 / 환경 설정을 안전한 곳에 보관하고, 필요 시 복원하는 방법입니다.
컨테이너 모드 박스는 OTA 업그레이드 시 자동 pre-snapshot 이 생성됩니다
(/data1/pp-backups/pe-backup-<ts>.tar.zst). UI 의 "백업" 버튼은 host 의 backup.sh
를 signal file 로 호출 — Cassandra drain + Redis AOF + HiveMQ + Node-RED + /etc/kopens 일괄 스냅샷.
복구는 SSH 로 restore.sh <archive> (현재 상태도 자동 백업 후 복원).
수동: sudo bash /opt/kopens/install/bin/backup.sh. 자세한 내용은
컨테이너 모드 백업/복구.
언제 백업해야 하나요
| 상황 | 추천 |
|---|---|
| 처음 모든 PLC / 태그 등록을 마쳤을 때 | 1 차 백업 |
| 큰 변경 (수십 개 태그 추가 / 수정) 후 | 변경 직후 백업 |
| 정기적으로 (매주 / 매월) | 운영 표준 |
| 업그레이드 / 재설치 직전 | 반드시 |
1. 화면에서 백업
우측 상단의 [설정] 톱니바퀴 아이콘 → 백업 (시계 모양 아이콘) 을 클릭합니다.
- 백업 파일이 자동으로 생성됩니다.
- 다운로드 위치 / 파일명은 환경에 따라 다릅니다.
- 보통 PC 내부 백업 디렉토리에 저장되거나 즉시 다운로드 됩니다.
생성된 파일을 별도의 안전한 저장소 (사내 NAS, 클라우드 드라이브 등) 에 옮겨 두세요. 게이트웨이 PC 자체가 망가지면 그 위에 있는 백업도 같이 잃습니다.
2. CSV 로 PLC / 태그 내보내기
전체 백업 외에 PLC / 태그 목록만 엑셀에서 보고 관리하고 싶다면 CSV 내보내기 기능을 사용할 수 있습니다.
- [연결] 메뉴 → [CSV 일괄 업로드] 화면 안에 “현재 등록 내용 다운로드” 같은 옵션이 있습니다.
- 다운로드한 CSV 를 엑셀에서 편집한 뒤 다시 일괄 업로드하면 됩니다.
CSV 는 편집 가능한 백업 으로도 활용할 수 있습니다.
3. 복원 (Restore)
복원이 필요한 상황 (PC 교체 / 재설치 / 잘못된 변경 되돌리기) 은 보통 시스템 관리자의 도움이 필요합니다.
대략적인 절차:
- 새 게이트웨이를 설치 / 부팅
- 동일한 시스템 관리자 계정으로 접속
- 백업 파일을 게이트웨이 호스트에 업로드
- 시스템 관리자가 복원 스크립트 실행 (또는 Cassandra 데이터 복원)
- 게이트웨이 재시작
CSV 백업으로 복원하는 경우는 [연결] → [CSV 일괄 업로드] 로 다시 일괄 등록할 수 있습니다.
자주 묻는 질문
Q. 백업이 보통 어느 정도 크기인가요?
PLC / 태그가 100 ~ 1000 개 수준이면 보통 수 MB ~ 수십 MB 입니다. 시계열 데이터까지 함께 백업한다면 훨씬 커질 수 있습니다 (관리자에게 별도 계획 요청).
Q. 시계열 (이력 데이터) 도 백업되나요?
기본 백업은 설정만 포함합니다. 시계열은 별도 저장소 (Cassandra 등) 에서 관리되며 별도의 백업 정책이 필요합니다. 시스템 관리자에게 시계열 백업 / 보존 기간을 함께 확인해주세요.
Q. 비밀번호도 백업에 포함되나요?
관리자 비밀번호 / MQTT 비밀번호 등이 포함됩니다. 백업 파일을 함부로 공유하지 마세요. 가능하면 암호화 저장을 권장합니다.
Q. 자동 백업은 어떻게 설정하나요?
운영체제의 cron / 작업 스케줄러로 정기적으로 백업 명령을 실행하도록 설정할 수 있습니다. 시스템 관리자에게 자동 백업 도입을 요청하세요.