증상

관리자 시스템에서 세대 단말기(게이트웨이)를 조회했는데 0건으로 나옴. 이미 연동이 끝난 단지인데 어느 날부터 안 나오는 경우임. 2026-08-12 부천원종5단지 503동 309호, 2026-08-13 괴산미니·부천원종5에서 접수됨.

먼저 확인

  • 단지 전체가 0건인지, 특정 세대만 0건인지 확인할 것.
  • 단지 관리 > 홈넷 서버 관리에서 홈넷 서버 상태와 최종 내역 생성 일시를 볼 것. 홈넷사가 1시간마다 heart beat를 보내므로 이 값이 최근이면 서버는 살아 있음.
  • 같은 홈넷사의 다른 단지는 정상인지 확인할 것.
  • 이 단지가 처음 연동하는 단지라면 기본매뉴얼/관리사무소/새로 연동한 단지의 단말기 조회가 안 돼요를 먼저 볼 것.
  • 입주민이 “앱에 가전제어 메뉴가 안 보인다”고 함께 문의했다면 단말기 문제가 아님. 스마트홈 단지 상세의 가전제어 사용 여부 설정을 확인할 것. 꺼져 있으면 단지 전체에서 메뉴가 안 보임.
  • 세대 하나만 0건이면 그 세대의 단말기 등록이 지워졌거나 매핑이 빠진 것임. 이 경우 입주민 앱에서도 우리집제어와 AutoDR 대상 기기가 통째로 안 나옴. 세대 단위인지 단지 단위인지 먼저 가를 것.

조치

  1. WAS 로그 확인. 절차는 기본매뉴얼/운영/WAS 로그 확인을 따를 것.
  2. 로그에서 SSL 인증서 확인 실패를 찾을 것. 나오면 TLS 인증서 문제임. 기본매뉴얼/운영/홈넷 서버 연동 (인증서 발급)의 인증서 재발급 절차를 따를 것.
  3. 로그 응답이 "result_code":"2000"인데 "total_count":0, "gateways":[]로 오면 홈넷 서버가 정상 응답으로 빈 목록을 돌려준 것임. 우리 쪽에서 고칠 수 없음.
  4. was01에 있는 x_hnsvr_check.sh를 열 것.
  5. 해당 단지 아이디와 토큰을 입력하고 실행할 것.
  6. 요청(request)과 응답(response)을 그대로 떠서 홈넷사에 메일로 전달할 것.
  7. 홈넷사 회신을 기다릴 것. 2026-08-13 괴산미니·부천원종5 건은 홈넷사가 처리해 해결됨.

그래도 안 되면

홈넷사에 전달할 때 다음을 함께 보낼 것.

  • 단지명과 단지 아이디
  • 조회 시각과 traceId
  • 요청 URL과 응답 본문

토큰과 인증서 내용은 메일 본문에 남기지 않음. 위키에도 기록하지 않음.

관련

기본매뉴얼/운영/WAS 로그 확인 기본매뉴얼/운영/홈넷 서버 연동 (인증서 발급) 기본매뉴얼/운영/단지 연동 점검 공개노트/기능/홈넷 서버 연동 기본매뉴얼/입주민/검색된 IoT 기기가 없다고 떠요