목적
단말기·게이트웨이 조회가 안 될 때 서버에 직접 붙어 WAS 로그에서 원인을 찾음. grafana로 안 잡히는 경우에 씀.
사전 준비
- MobaXterm
- 운영 서버 접속 계정
- 확인할 단지 ID, 날짜, 시각
보는 순서는 LMW → APW → 홈넷 순임. LMW보다 APW에 로그가 남아 있을 확률이 높음. 상태만 빠르게 보려면 SCW 쪽을 먼저 볼 것. 1시간마다 핑을 보내기 때문임.
절차
- MobaXterm으로
was01또는was02에 접속할 것(운영 환경). - 로그 디렉터리로 이동할 것.
cd /app/logs/was/tomcat-lmw- 또는
cd /app/logs/was/tomcat-apw
less -R catalina.out으로 열 것. APW는apw.log,apw_error.log(일별 롤링, 30일 보관)에도 남으므로 catalina.out에 없으면 여기를 볼 것.- 로그 안에서 검색할 것.
shift + g: 맨 끝으로 이동/: 위에서 아래로 검색?: 아래에서 위로 검색shift + ins: 붙여넣기
- 오류 문구를 찾아 원인을 가를 것.
Connection timed out→ 응답이 오지 않는 것. 방화벽 확인 요청 메일을 보낼 것SSL 인증서 확인 실패→ 인증서 만료. 기본매뉴얼/운영/홈넷 서버 연동 (인증서 발급)의 재발급 절차를 따를 것PKIX path building failed→ 홈넷사가 우리 인증서를 등록하지 않음수집된 데이터가 없습니다/total_count:0→ 홈넷 서버가 빈 목록 응답. 홈넷사에 전달할 것홈넷연동상태코드를 확인해주세요/LH플랫폼 인증정보가 없습니다/홈넷 서버 도메인 정보 없음→ 우리 DB의 홈넷서버 설정 문제. 토큰 요청 전 검증에서 막힌 것. 공개노트/기능/홈넷 서버 연동
확인
- 오류 문구를 찾았고 어느 쪽 문제인지 판정했음
- 관리자 시스템의 최종 내역 생성 일시를 함께 확인했음. 홈넷사가 1시간마다 heart beat를 보내므로, 이 값이 최근이면 “서버 상태 알림은 잘 오고 있다”는 사실을 홈넷사 메일에 같이 적을 것
- 홈넷사에 보낼 request/response를 떴음
로그를 밖으로 내보낼 때는 Authorization: Bearer ... 줄, 공인 IP, 사용자 아이디를 지우고 씀. 위키에는 검색 키워드만 남김.
관련
기본매뉴얼/운영/grafana로 로그 보기 기본매뉴얼/운영/홈넷 서버 연동 (인증서 발급) 기본매뉴얼/관리사무소/세대 단말기 조회가 안 돼요 기본매뉴얼/관리사무소/새로 연동한 단지의 단말기 조회가 안 돼요