목적

단말기·게이트웨이 조회가 안 될 때 서버에 직접 붙어 WAS 로그에서 원인을 찾음. grafana로 안 잡히는 경우에 씀.

사전 준비

  • MobaXterm
  • 운영 서버 접속 계정
  • 확인할 단지 ID, 날짜, 시각

보는 순서는 LMW → APW → 홈넷 순임. LMW보다 APW에 로그가 남아 있을 확률이 높음. 상태만 빠르게 보려면 SCW 쪽을 먼저 볼 것. 1시간마다 핑을 보내기 때문임.

절차

  1. MobaXterm으로 was01 또는 was02에 접속할 것(운영 환경).
  2. 로그 디렉터리로 이동할 것.
    • cd /app/logs/was/tomcat-lmw
    • 또는 cd /app/logs/was/tomcat-apw
  3. less -R catalina.out으로 열 것. APW는 apw.log, apw_error.log(일별 롤링, 30일 보관)에도 남으므로 catalina.out에 없으면 여기를 볼 것.
  4. 로그 안에서 검색할 것.
    • shift + g : 맨 끝으로 이동
    • / : 위에서 아래로 검색
    • ? : 아래에서 위로 검색
    • shift + ins : 붙여넣기
  5. 오류 문구를 찾아 원인을 가를 것.
    • Connection timed out → 응답이 오지 않는 것. 방화벽 확인 요청 메일을 보낼 것
    • SSL 인증서 확인 실패 → 인증서 만료. 기본매뉴얼/운영/홈넷 서버 연동 (인증서 발급)의 재발급 절차를 따를 것
    • PKIX path building failed → 홈넷사가 우리 인증서를 등록하지 않음
    • 수집된 데이터가 없습니다 / total_count:0 → 홈넷 서버가 빈 목록 응답. 홈넷사에 전달할 것
    • 홈넷연동상태코드를 확인해주세요 / LH플랫폼 인증정보가 없습니다 / 홈넷 서버 도메인 정보 없음 → 우리 DB의 홈넷서버 설정 문제. 토큰 요청 전 검증에서 막힌 것. 공개노트/기능/홈넷 서버 연동

확인

  • 오류 문구를 찾았고 어느 쪽 문제인지 판정했음
  • 관리자 시스템의 최종 내역 생성 일시를 함께 확인했음. 홈넷사가 1시간마다 heart beat를 보내므로, 이 값이 최근이면 “서버 상태 알림은 잘 오고 있다”는 사실을 홈넷사 메일에 같이 적을 것
  • 홈넷사에 보낼 request/response를 떴음

로그를 밖으로 내보낼 때는 Authorization: Bearer ... 줄, 공인 IP, 사용자 아이디를 지우고 씀. 위키에는 검색 키워드만 남김.

관련

기본매뉴얼/운영/grafana로 로그 보기 기본매뉴얼/운영/홈넷 서버 연동 (인증서 발급) 기본매뉴얼/관리사무소/세대 단말기 조회가 안 돼요 기본매뉴얼/관리사무소/새로 연동한 단지의 단말기 조회가 안 돼요