문제 해결과 인수 테스트
증상별 진단 순서와 파트너가 확인할 테스트 항목입니다.
증상별 확인 순서
| 증상 | 확인 방법 |
|---|---|
| 장비가 나타나지 않음 | 시간·DNS·외부 443·등록 키 권한·계정 한도를 확인. 동일 이름이 아니라 UUID로 구분. |
| Private state directory is unavailable or already in use | state 경로와 소유권/0700 권한 확인. start.sh와 SDK가 동시에 실행 중인지 확인. |
| Private enrollment configuration, entropy or identity failed | 키/시드/식별 상태 파일의 소유권·0600·내용 확인. 다른 기기의 상태로 대체하지 않기. |
| Invalid configuration, CA bundle or entropy source | 배포 CA 파일과 시드·엔진 설정 확인. 인증서 검증을 끄지 않기. |
| start 성공 후 바로 종료 | poll의 자식 종료 상태와 stderr를 확인. start는 spawn 성공만 의미. |
| 명령이 대기 중 | 장비 온라인 여부·소유 계정·약 30초 큐 주기를 확인. |
| 터미널이 이미 사용 중 | 기존 세션에서 정상 종료. 다른 운영자의 세션을 강제로 덮어쓰지 않기. |
| 대시보드 버튼이 없음 | 온라인 상태와 기기별 인증서 핀/대시보드 활성화 여부를 담당자에게 확인. |
| 대시보드 401/만료 | StreamZet의 버튼으로 새 연결 생성. OEM 인증 요청이면 OEM 자격정보 사용. |
| 대시보드 연결 오류 | OEM 9000 서비스와 인증서 교체 여부 확인. 업데이트된 지문은 신뢰 경로로 전달. |
포그라운드 진단
start.sh는 출력을 버립니다. 필요하면 실행 중인 StreamZet을 먼저 종료하고 종료를 확인한 뒤, 승인된 장비 셸에서 아래 명령으로 stderr를 확인합니다. Ctrl+C로 종료한 후 원래 운영 시작 방식을 복원하세요.
sh
cd /mnt/spp/streamzet-jci
./streamzet-embedded --production \
streamzet-embedded.plitsoft.workers.dev \
/mnt/spp/streamzet-jci/registration.key \
/mnt/spp/streamzet-jci/cacert.pem \
/mnt/spp/streamzet-jci/state 'xSpan R660 001'파트너 인수 체크리스트
- 첫 시작 후 자동 등록되고 운영 계정에서 장비가 보이는가.
- 실제 장비의 터미널 출력과 Fleet 성공/실패 결과를 확인했는가.
- 앱/엔진 재시작 후 같은 UUID를 유지하고, 네트워크 단절 후 복구하는가.
- SDK 시작·poll·정상 종료·자식 회수가 OEM 앱에서 동작하는가.
- 승인된 정비 시간에 전체 장비 재부팅과 CAP/펌웨어 업데이트 후 자동 시작을 확인했는가.
- 실제 운영 부하에서 CPU·메모리·RFID 처리와 다수 장비 일괄 실행을 확인했는가.
- 대시보드 핀 등록·로그인·실시간 이벤트·터미널 동시 사용을 확인했는가.
문의 시 SDK 버전, 장비 모델/펌웨어, UUID, 발생 시각과 시간대, 재현 단계, 비밀정보를 제거한 종료 코드/로그를 전달하세요. 키·비밀번호·state/identity는 보내지 마세요.