안녕하세요 고객사의 필터서버 로그에 특정 일자부터 동일한 로그가 발생하며 기안기 불러오기 등 정상적인 사용이 불가능하다 합니다. 해당 로그 첨부하오니 확인 부탁드립니다.
사용 버전은 V1 버전 사용 중입니다.
감사합니다.
안녕하세요.
첨부하신 이미지의 화질이 좋지 않아 직접 확인이 어렵습니다.
로그 내용을 텍스트로 공유해 주시면 보다 정확한 분석이 가능합니다.
다만, 문의 내용을 바탕으로 아래 사항들을 우선 확인 부탁드립니다.
필터서버 로그에서 주로 발생하는 에러 유형과 관련하여, 특정 일자부터 동일 에러가 반복된다면 아래 원인을 먼저 점검해 주세요.
- 필터서버 자체의 문제
- 필터서버 프로세스가 정상 기동 중인지 확인해 주세요.
- 필터서버의 라이선스 만료 여부를 확인해 주세요. 특정 일자부터 에러가 발생한 경우 라이선스 만료와 시점이 겹치는 경우가 많습니다.
- 네트워크/방화벽 설정 변경
- 특정 일자에 서버 환경(방화벽, 포트, 네트워크 정책 등)이 변경되었는지 확인해 주세요.
- 기안기 서버와 필터서버 간 통신이 차단되었을 가능성이 있습니다.
- 파일 변환 실패
- 불러오기 시 변환 대상 파일 형식이 필터서버가 지원하는 형식인지 확인해 주세요.
정확한 원인 파악을 위해 아래 정보를 추가로 제공해 주시면 감사하겠습니다.
- 필터서버 로그 텍스트 전문 (이미지가 아닌 텍스트 형식)
- 에러 발생 시작 일자 및 해당 일자 전후 서버 환경 변경 이력
- 사용 중인 필터서버 버전
감사합니다.
안녕하세요.
확인 결과 서버 환경이 변경된 것은 없으며 해당 로그 텍스트 파일 첨부하였으니 확인 부탁드립니다.
7월 12일부터 동일한 로그 발생 중으로 특정 일자 파일만 전달드립니다.
사용 중인 필터서버 버전 : 10.80.0.1171 입니다.
감사합니다.
filter-service.log.2026-07-14.txt (5.7 MB)
filter-service.log.2026-07-13.txt (5.7 MB)
filter-service.log.2026-07-12.txt (3.6 MB)
filter-service.log.2026-07-15.txt (5.7 MB)
안녕하세요.
전달해 주신 필터서버 로그를 분석한 결과를 아래와 같이 안내드립니다.
- 현상 요약
아래 3가지 로그가 약 7초 간격으로 무한 반복되고 있는 상태입니다.
INFO - Not responding child: port => 19501, 19601
ERROR - java.lang.NullPointerException
INFO - JAR COMMAND: [/usr/lib/jvm/java-1.8.0-openjdk-...]
이는 필터서버의 자식 프로세스(포트 19501, 19601)가 정상적으로 기동되지 못하고 있는 상태이며,
부모 프로세스가 자식 프로세스의 비정상 상태를 감지한 후 재기동을 시도하지만,
재기동 역시 실패하여 동일한 패턴이 반복되는 것으로 확인됩니다.
- 원인 분석
7월 12일부터 서버 환경 변경 없이 갑자기 발생한 점을 고려하면, 아래 원인들이 가능합니다.
(1) 이전 프로세스 미종료로 인한 포트 충돌 (가장 유력)
필터서버 자식 프로세스가 특정 시점에 비정상 종료(메모리 부족, 시스템 장애 등)되었으나,
운영체제 레벨에서 해당 프로세스가 완전히 정리되지 않아 포트 19501, 19601을 여전히 점유하고 있을 수 있습니다.
이 경우 새로운 자식 프로세스가 같은 포트에 바인딩을 시도하면 실패하게 되어, 기동 → 실패 → 재시도의 무한 루프에 빠지게 됩니다.
(2) 시스템 리소스 부족
디스크 공간 부족, 메모리 부족, 파일 디스크립터 제한 초과 등으로 인해 자식 프로세스가 정상 기동되지 못할 수 있습니다.
- 조치 방법
아래 순서대로 확인 및 조치를 진행해 주시기 바랍니다.
【STEP 1】 기존 프로세스 완전 종료
현재 떠 있는 필터서버 관련 Java 프로세스를 모두 확인하고 종료합니다.
# 1-1. 필터서버 관련 프로세스 확인
ps -ef | grep webhwp-filter-service
# 1-2. 포트 19501, 19601을 점유하고 있는 프로세스 확인
netstat -tlnp | grep -E "19501|19601"
위 명령어 결과에 프로세스가 남아 있다면, 해당 프로세스를 강제 종료합니다.
# 1-3. 필터서버 관련 프로세스 전체 강제 종료
kill -9 $(pgrep -f webhwp-filter-service)
# 1-4. 종료 후 포트가 해제되었는지 재확인
netstat -tlnp | grep -E "19501|19601"
포트를 점유하는 프로세스가 없는 상태를 확인한 후 STEP 2로 진행합니다.
【STEP 2】 시스템 리소스 확인
# 2-1. 디스크 사용량 확인 (사용률 100%인 파티션이 있는지 확인)
df -h
# 2-2. 메모리 사용량 확인
free -m
# 2-3. OOM(Out of Memory) 발생 이력 확인
dmesg | grep -i "oom\|out of memory" | tail -20
# 2-4. 파일 디스크립터 제한 확인
ulimit -n
- 디스크 사용률이 90% 이상인 파티션이 있다면, 불필요한 로그 파일 등을 정리하여 공간을 확보해 주세요.
- 메모리가 부족한 경우, 다른 불필요한 프로세스를 종료하거나 메모리 증설을 검토해 주세요.
- ulimit -n 값이 1024 이하로 너무 낮다면, 시스템 관리자에게 증설을 요청해 주세요.
【STEP 3】 필터서버 재시작
STEP 1~2의 점검이 완료된 후, 필터서버를 재시작합니다.
# 필터서버 시작 (기존 실행 방식과 동일하게 실행)
cd /home/weditor/hancom/webhwpctrl/webhwp-filter-service/
./start.sh
실행 스크립트 경로는 고객사 설치 환경에 따라 다를 수 있습니다.
기존에 필터서버를 시작하시던 방식대로 실행해 주시면 됩니다.
【STEP 4】 정상 동작 확인
재시작 후 아래 사항을 확인합니다.
# 4-1. 필터서버 프로세스 정상 기동 확인
ps -ef | grep webhwp-filter-service
# 4-2. 포트 정상 바인딩 확인
netstat -tlnp | grep -E "19501|19601"
# 4-3. 로그에 "Not responding child" 반복 여부 확인 (약 1분간 관찰)
tail -f /home/weditor/hancom/webhwpctrl/webhwp-filter-service/logs/*.log
프로세스가 정상 기동되고, 포트 19501/19601이 LISTEN 상태이며, 로그에 에러 반복이 없다면 정상 복구된 것입니다.
재시작 후 기안기에서 불러오기 기능이 정상 동작하는지도 함께 확인해 주세요.
- 추가 요청 사항
위 조치 후에도 동일 증상이 계속될 경우, 고객 지원을 통해 아래 정보를 추가로 전달해 주시면 보다 정확한 원인 분석이 가능합니다.
- STEP 1~2의 명령어 실행 결과 (화면 캡처 또는 텍스트)
- 자식 프로세스 로그 파일 — 부모 프로세스 로그(전달해 주신 로그)와 별도로, 자식 프로세스가 기동 시 남기는 로그 파일이 있습니다.
로그 디렉토리 내 filter-service.{숫자}.out 형식의 파일이 있다면 함께 전달 부탁드립니다. - 7월 12일 이전의 로그 파일 — 정상 동작 시의 로그와 비교 분석이 필요합니다.
고객 지원: 문의하기
조치 완료 후 어떤 단계에서 문제가 해결되었는지를 함께 알려주시면,
향후 동일 증상 발생 시 보다 빠른 대응이 가능하오니 참고 부탁드립니다.
감사합니다.
안녕하세요.
안내해 주신 STEP 별 실행 결과 및 로그 파일 전달드립니다.
다만 말씀하신 자식 프로세스 로그 파일 filter-service.{숫자}.out 는 정체 경로로 find 하여도 서치되지 않았습니다.
감사합니다.
웹기안기필터_조치사항_실행.txt (7.8 KB)
filter-service.log.2026-07-28.txt (5.7 MB)
filter-service.log.txt (3.0 MB)
filter-service.log.2026-07-07.txt (3.5 KB)
filter-service.log.2026-07-03.txt (4.4 KB)
filter-service.log.2026-07-02.txt (1.4 KB)
filter-service.log.2026-07-01.txt (5.5 KB)
filter-service.log.2026-07-09.txt (15.4 KB)
안녕하세요
웹한글기안기 서버의 hostname을 /etc/hosts 파일에 등록처리 후 재확인 부탁드립니다.
ex) 10.x.x.x {hostname}
등록 후 동일한 증상 발생 시 /etc/hosts 파일의 권한 644 설정 후 확인 부탁드립니다.
child 로그 파일의 권한이 없으면 필터서버가 기동이 되지 않습니다. 그리고 필터 서버 실행 시 root 권한이 아니라, filterserver 의 계정으로 실행 해야합니다.
조치방법
- 해당 폴더 이하 필터서버 권한으로 변경 /home/weditor/hancom/webhwpctrl/webhwp-filter-service/
- 필터서버 계정으로 was 및 filterserver 실행 (weditor)