09 · 라이센스 관리
라이센스 관리
라이센스는 16자리 키이며, 키에는 허용 receiver 수(Device Limit)가 할당되어 있습니다. 라이센스를 활성화하면 이 Device Limit이 Master 기기에 주입되어, Master가 그 수만큼의 Receiver를 운영할 수 있습니다. 이 문서는 활성화와 연결 진단만을 다룹니다.
라이센스 개요#
| 항목 | 설명 |
|---|---|
| 라이센스 키 | 16자리 키 (tally-node.com에서 발급) |
| Device Limit | 해당 라이센스에 할당된 허용 Receiver 수 |
| 주입 대상 | Master 기기 (Master만 라이센스 처리를 담당) |
| 결과 | 활성화 시 Device Limit이 Master에 주입 → 제한 내 Receiver 운영 |
Master 1대당 1개 라이센스
Master 1대당 1개 라이센스를 활성화합니다. Receiver는 자체 라이센스가 필요 없습니다.
Free 버전은 Device Limit 없음
Free 버전(v3.2.0+)은 LoRa 수신기가 없어 Device Limit이 적용되지 않습니다(무제한). /flash/free 에서 로그인 없이 펌웨어를 설치할 수 있으며, 폰 Web Tally 연결 수와는 무관합니다.
라이센스가 활성화되지 않았거나 Device Limit이 주입되지 않은 상태에서는 TX/RX 통신이 제한되며, Receiver는 STOP 상태가 됩니다. (→ 라이센스 무효 시 동작 참조)
라이센스 활성화 (Device Limit 주입)#
활성화 절차#
- 1License 메뉴 진입Master 웹 UI에서 License 메뉴 클릭
- 2라이센스 키 입력16자리 라이센스 키 입력
- 3Activate 클릭Master가 tally-node.com 서버에서 해당 라이센스의 Device Limit을 조회
- 4Device Limit 주입Device Limit이 Master에 주입됨 → 제한 내 Receiver 운영 가능
인터넷 연결 필요
인터넷 연결이 필요합니다. 서버에 연결되지 않으면 인터넷 진단을 진행하세요.
활성화 실패#
| 오류 | 원인 | 해결 |
|---|---|---|
| Invalid key | 키 오타 또는 미발급 키 | 키 재확인 후 재입력 |
| Connection failed | 인터넷/서버 연결 문제 | 인터넷 진단 실행 |
| Server error | 라이센스 서버 장애 | 잠시 후 재시도 |
라이센스 서버 연결 실패 → 인터넷 진단#
라이센스 서버에 연결되지 않으면(활성화 실패, Connection failed), License 페이지의 Internet Connection Test로 원인을 단계적으로 좁힙니다.
3단계 진단#
| 단계 | 테스트 | 확인 대상 |
|---|---|---|
| 1 | DNS (8.8.8.8) | 인터넷 연결 자체 |
| 2 | License Server (tally-node.com) | 라이센스 서버 도달성 |
| 3 | DB | 라이센스 데이터베이스 정상 여부 + 응답 지연(latency) |
실패 시 조치#
| 실패 단계 | 원인 | 해결 |
|---|---|---|
| DNS 실패 | 인터넷 연결 안 됨 / DNS 차단 | 네트워크 케이블·WiFi 확인, 라우터 DNS(8.8.8.8) 허용, 방화벽 포트 53(UDP) 개방 |
| License Server 실패 | tally-node.com 차단 / 프록시·방화벽 | tally-node.com 화이트리스트 추가, 포트 443(HTTPS) 개방 |
| DB 실패 | 서버 DB 점검 / 과부하 | 잠시 후 재시도 |
진단 흐름
흐름: 활성화 실패 → Internet Connection Test → 1단계(DNS)부터 순차 확인 → 실패한 단계의 조치 적용 → 활성화 재시도.
라이센스 무효 시 동작 (Receiver STOP & 복구)#
라이센스가 무효이거나 Device Limit이 주입되지 않은 경우, Receiver는 STOP 상태로 전환됩니다.
Receiver STOP 동작#
- 1무효/미주입 상태 감지Master에서 무효/미주입 상태 감지 → LoRa로 STOP 전송
- 2무선 송수신 중단Receiver 무선 송수신 중단 (radio-silent)
- 3OLED 오버레이 표시OLED에 "STOPPED / LICENSE REQUIRED" 오버레이 표시
- 4LED 소등LED 모두 소등(all-OFF)
- 5버튼 입력 차단Receiver 버튼 입력 차단
자동 해제 안 됨
중요: STOP 상태는 자동으로 해제되지 않습니다. 아래 복구 절차를 따르세요.
복구 절차#
- 라이센스 재활성화: Master 웹 UI License 페이지에서 라이센스 재활성화 → Device Limit 주입 확인
- Receiver 물리 재부팅: Receiver를 물리적으로 재부팅 (전원 분리 → 재연결)
- 정상 동작 확인: Receiver가 정상 부팅 후 tally 동작 재개 확인 (리시버 운영 참조)
재부팅 필수
Receiver 재부팅 없이는 STOP 상태가 유지됩니다.
최종 수정 —