콘텐츠로 이동

Trouble Shooting

Agent 설치 문제 해결 (Troubleshooting)

"httpd / nginx / JAVA Not Found" 오류 발생 시

Agent 설치 스크립트는 실행 중인 웹 서버 프로세스를 자동으로 탐지합니다. 웹 서버가 중지된 상태에서는 위와 같은 오류가 발생하며, 이 경우 웹 서버를 먼저 기동한 후 설치를 재시도하거나 관련 설정을 수동으로 진행해야 합니다.

설치 오류 예시

[root@localhost DeepFinder]# ./setup.sh 1.1.1.1 1***
SERVER IP : 1.1.1.1
AGENT ID : 1***
SYSTEM KERNEL : 2.6
CHECK OS : Linux
CHECK OS BIT : x86_64 (64 bit)

HTTPD Not found


 

Apache-Tomcat 연동 환경에서 대용량 파일 업로드 실패 시

Apache mod_proxy를 통해 Tomcat으로 요청을 전달하는 환경에서 DeepFinder 모듈이 적용되면, 파일 전송 방식이 chunked transfer encoding으로 변경될 수 있습니다.
이로 인해 대용량 파일 업로드 시 문제가 발생하는 경우, Apache 설정 파일(httpd.conf)에 아래 옵션을 추가한 후 서비스를 재시작(graceful)하십시오.

# It allows request bodies to be sent to the backend using chunked transfer encoding.
SetEnv proxy-sendchunked 1


안티 바이러스(백신) 프로그램이 DeepFinder를 차단하는 경우

일부 안티 바이러스 프로그램이 DeepFinder Agent의 주요 파일이나 프로세스를 위협으로 오진하여 격리하거나 차단할 수 있습니다.
설치 전에 안티 바이러스 프로그램의 예외(신뢰) 처리 설정에서 아래 항목들을 추가하여 Agent가 정상적으로 동작할 수 있도록 조치하십시오. * 설치 경로: C:\DeepFinder (하위 폴더 포함) * 주요 프로세스: agent.exe, starter.exe, updater.exe 등


WAS 설치 후 한글 파라미터가 깨지는 경우

Agent 적용 후 웹 애플리케이션의 파라미터 등 한글이 깨지는 현상은 JVM과 웹 서비스 간의 인코딩 방식이 일치하지 않아 발생할 수 있습니다.
이 경우, config.xml 파일의 filter_encoding 값을 웹 서비스 환경에 맞게 변경하여 문제를 해결합니다.

config.xml Filter_Encoding 값
<Filter
 localhost="127.0.0.1"
 filter_alive_check_time="1800"
 policy_update_time="30"
 filter_encoding=”UTF-8”
 bypass="0"
/>		 1) filter_encoding="utf-8"
2) filter_encoding=”_utf-8”
3) filter_encoding=”euc-kr”
4) filter_encoding=”_euc-kr”
5) filter_encoding=”ms949”


WAS 설치 후 페이지가 중복 출력되거나 깨지는 경우

일부 WAS는 응답(Response) 데이터를 처리하는 방식의 차이로 인해, Agent 필터 적용 후 페이지가 깨지거나 중복으로 출력되는 현상이 발생할 수 있습니다.
이 경우, config.xml 파일의 res_type 값을 변경하여(0 또는 1) 문제를 해결할 수 있습니다.

config.xml res_type 설정 가능 값
<Filter
 ...
 filter_encoding=”UTF-8”
 res_type="0"
/>		 1) 0 (기본값)
2) 1


Agent 설치 후 Manager 서버와 통신 불가 시

  • 방화벽 확인: Agent가 설치된 서버에서 Manager 서버로의 아웃바운드(Outbound) 통신이 방화벽에서 허용되었는지 확인합니다.
    (확인 명령어 예: telnet {Manager IP} 10012)

  • 설정 파일 확인: Agent 설정 파일(conf/config.xml)을 열어 Manager 접속 정보(aid, authdata, svrip 등)가 올바르게 입력되었는지 확인하고, 잘못된 경우 수정한 뒤 Agent 서비스를 재시작합니다.

<?xml version="1.0" encoding="UTF-8" standalone="yes" ?>
<Agent
*aid=""                                     // Agent ID
*authdata=""                                    // Auth Key(도메인 그룹 키)
    ssl_pemfile="deepfinder.pem"                // ssl pem file name (certs 디렉토리)
    ssl_password="isdwsx"                       // pem file password
*svrip=""                                   // 매니저 서버 IP
    svrproto="tcp"                              // protocol  tcp/ssl
    svrport="10012"                             // server port
    filter_check_url="http://localhost/"        //filtercheck url : default http://localhost/
    debug="0"
    logfilesize="2"                             // log file 개당 사이즈 (default 2메가)
/>

Note

라이선스에 허용된 Agent 수를 초과하여 Agent를 연결 시도할 경우, Manager의 server.log에 License MaxAgent over 오류가 기록되며 연결이 거부됩니다.
이 경우, 필요한 Agent 수에 맞게 라이선스를 갱신한 후 적용하십시오.


Agent 설치 후 웹 사이트 장애 발생 시

Agent 설치 후 웹 사이트 접속 불가 등 문제가 발생하는 경우, 정확한 원인 분석을 위해 아래 절차에 따라 조치 후 기술 지원팀에 문의하십시오.
1. DeepFinder 설치 디렉토리 전체 백업
2. DeepFinder Agent 언인스톨 또는 관련 서비스 중지

WAS Agent 적용 후 "404 Not Found" 응답 시

Agent 필터 적용 후 404 Not Found 오류가 발생한다면, WAS가 DfFilter.jar 파일을 찾지 못하는 것이 원인일 수 있습니다.
아래 두 경로가 올바르게 설정되었는지 다시 확인하십시오.
1. DfFilter.jar 파일이 실제 WAS 라이브러리 경로에 복사되었는지 확인
2. config.xml 파일 내 <Filter> 섹션의 jarfile 경로가 올바른지 확인

Manager 로그인 후 "Server Process Alert" 팝업 발생 시

Manager 로그인 시 프로세스 다운(Process Down) 알림 팝업이 나타나는 것은 Manager를 구성하는 일부 서비스가 중지되었음을 의미합니다.
먼저 [환경설정] > [서버 재시작] 탭에서 'Down' 상태인 프로세스를 재시작하여 정상화되는지 확인합니다.


재시작 후에도 문제가 지속되면 기술 지원팀에 문의하십시오.


Tomcat 내 Filter를 삽입했음에도 필터가 동작 안할 시

Tomcat/lib 디렉토리에 DfFilter.jar를 삽입하고 Tomcat을 재시작했음에도 필터가 동작하지 않는다면, ProtectSystem=strict 로 인해 DfFilter.jar 파일을 정상적으로 참조하지 못하는 경우일 수 있습니다.
이러한 경우 Tomcat 서비스 설정 파일(tomcat9.service 등)에 DeepFinder 참조 경로를 직접 추가해야 합니다.

cat /etc/systemd/tomcat9.service
...
# Security
User=tomcat
Group=tomcat
PrivateTmp=yes
AmbientCapabilities=CAP_NET_BIND_SERVICE
NoNewPrivileges=true
CacheDirectory=tomcat9
CacheDirectoryMode=750
ProtectSystem=strict
ReadWritePaths=/etc/tomcat9/Catalina/
ReadWritePaths=/var/lib/tomcat9/webapps/
ReadWritePaths=/var/log/tomcat9/
ReadWritePaths=/usr/local/deepfinder/log
ReadWritePaths=/usr/local/deepfinder/tmp

설정 후에도 Filter 동작이 원활하지 않을 경우 DeepFinder 기술지원팀에 문의하시기 바랍니다.