웹 서버 플러그인 문제점 해결 팁
다음 주제는 웹 서버 플러그인과 관련된 문제점을 진단하는 데 도움을 줄 수 있습니다.
- plugins_root/logs/web_server_name/http_plugin.log 파일에서 단서를 검토하십시오. 메시지 테이블에서 오류 또는 경고 메시지를 보십시오.
- 웹 서버의 오류 및 액세스 로그를 검토하여 웹 서버에 문제점이 있는지 확인하십시오.
- IBM® HTTP Server 및 Apache: access.log 및 error.log.
- Domino® 웹 서버: httpd-log 및 httpd-error.
- Sun Java™ 시스템: access 및 error.
- Microsoft IIS: timedatestamp.log.
이러한 파일로 문제의 원인이 드러나지 않는 경우, 다음 추가 단계를 따르십시오.
플러그인 문제 판별 단계
참고: 대용량 파일 지원이 사용 가능한
Veritas 파일 시스템을 사용할 경우, 파일 크기가 최대 2테라바이트까지 허용됩니다. 이
경우, plugin-cfg.xml 파일의 LogLevel 속성을 LogLevel=Trace로 설정하면
http_plugin.log 파일이 빠르게 증가하여 파일 시스템에서 사용 가능한 모든 공간을
소모할 수도 있습니다. 따라서 높은 CPU 사용량을 방지하려면 LogLevel 속성의 값을
ERROR 또는 DEBUG로 설정해야 합니다. - 플러그인이 요청을 확보합니다.
- 플러그인이 plugin-cfg.xml 파일에 정의된 라우트를 확인합니다.
- 서버 그룹을 찾습니다.
- 서버를 찾습니다.
- 전송 프로토콜, HTTP 또는 HTTPS를 선택합니다.
- 요청을 전송합니다.
- 응답을 읽습니다.
- 클라이언트에 다시 기록합니다.
- 첫 번째 단계는 플러그인이 웹 서버에 정상적으로 로드되었는지 판별하는 것입니다.
- thehttp_plugin.log 파일이 작성되었는지 확인하십시오.
- 이 파일이 있으면 이 파일에서 오류 메시지가 플러그인 초기화 중에 발생한
어떤 장애 종류를 나타내는지 확인하십시오. 오류가 없을 경우,
플러그인이 정상적으로 시작되었음을 표시하는 다음과 같은 스탠자를
찾으십시오. 메시지의 시간소인이 웹 서버를 시작한 시간과 일치하는지 확인하십시오.
[Thu Jul 11 10:59:15 2002] 0000009e 000000b1 - PLUGIN: ------------System Information---------- [Thu Jul 11 10:59:15 2002] 0000009e 000000b1 - PLUGIN: Bld date: Jul 3 2002, 15:35:09 [Thu Jul 11 10:59:15 2002] 0000009e 000000b1 - PLUGIN: Web server: IIS [Thu Jul 11 10:59:15 2002] 0000009e 000000b1 - PLUGIN: Hostname = SWEETTJ05 [Thu Jul 11 10:59:15 2002] 0000009e 000000b1 - PLUGIN: OS version 4.0, build 1381, 'Service Pack 6' [Thu Jul 11 10:59:15 2002] 0000009e 000000b1 - PLUGIN: --------------------------------------------
- 일부 공통 오류는 다음과 같습니다.
- lib_security: loadSecurityLibrary: gsk 라이브러리 로드 실패
- GSKit를 설치하지 않았거나 GSKit의 버전이 잘못 설치되었습니다.
발생한 상황을 판별하려면 다음을 수행하십시오.
Windows 플랫폼에서
gsk7ssl.dll 파일을 검색합니다.
UNIX 플랫폼에서는
/usr/lib 디렉토리에서 libgsk7*.so 파일을 검색합니다.
해당 파일을 찾을 수 없는 경우, 올바른 GSKit 버전을 사용하여 플러그인을 재설치한 후 문제점이 수정되었는지 확인하십시오.
- ws_transport: transportInitializeSecurity: 키 링이 설정되지 않음
- 구성 파일에 정의된 HTTPS 전송이 조기에 종료되었고 키 링 및 숨겨진 파일에 대한 특성 정의를 포함하지 않습니다. 이 행 뒤에 오는 오류 메시지에 지정된 행 번호의 XML 구문을 검사하여 전송 요소가 종료되기 전 키 링 및 숨겨진 파일에 대한 정의를 포함하는지 확인하십시오.
- http_plugin.log 파일이 작성되지 않은 경우, 웹 서버 오류 로그를 확인하여 플러그인이 로드할 수 없는 이유를 표시하는 플러그인 관련 오류 메시지가 로그되었는지 확인하십시오. 이 오류의 일반적인 원인에는 웹 서버 환경에서 플러그인을 올바르게 구성하지 못한 것이 포함될 수 있습니다. 문서에서 웹 서버 플러그인과 함께 사용할 웹 서버 구성을 확인하십시오.
구성에서 정의된 다양한 Application Server 및 플러그인에 네트워크 연결 문제가 있는지 판별하십시오. 이 경우 다음과 같은 메시지가 표시됩니다.
ws_common: websphereGetStream: Failed to connect to app server, OS err=%d
%d은(는) connect() 호출이 실패한 이유와 관련한 OS 특정 오류 코드입니다. 이것은 다양한 이유로 발생할 수 있습니다.- 시스템을 핑하여 네트워크에 적절하게 연결되었는지 확인하십시오. 시스템에 핑할 수 없는 경우 플러그인이 시스템에 접속할 방법이 없습니다. 이 문제점에 대한 가능한 이유에는 다음이 포함됩니다.
- 플러그인에서 Application Server로 트래픽을 제한하는 방화벽 정책
- 시스템이 동일한 네트워크에 있지 않습니다.
- 시스템을 핑할 수 있으면 문제의 가능한 원인은 포트가 활성화되지 않았기 때문입니다. Application Server 또는 클러스터가 시작되지 않았거나 Application Server가 어떤 이유로 해서 중단되었기 때문에 포트가 활성화되지 않았을 수 있습니다. 이것이 문제점인지 확인하려면 연결에 실패한 포트에 수동으로 Telnet을 시도해 보십시오. 포트에 Telnet을 할 수 없는 경우, Application Server는 시작되지 않으며 플러그인이 연결을 정상적으로 호출할 수 있으려면 먼저 문제를 해결해야 합니다.
- 시스템을 핑하여 네트워크에 적절하게 연결되었는지 확인하십시오. 시스템에 핑할 수 없는 경우 플러그인이 시스템에 접속할 방법이 없습니다. 이 문제점에 대한 가능한 이유에는 다음이 포함됩니다.
- 서버가 설치된 시스템의 다른 활동이 요청을 제공하는 서버의 기능을
손상시키는지 판별하십시오. 태스크 관리자, 프로세서 ID 또는
기타 외부 도구에 의해 측정된 프로세서 활용을 검사하여 다음 사항을 확인하십시오.
- 예상했던 것이 아닙니다.
- 일정하지 않고 변화합니다.
- 새로 추가된 클러스터 멤버가 이용되고 있지 않음을 표시합니다.
- 수정된 실패 멤버가 이용되고 있지 않음을 표시합니다.
- 관리 콘솔에서 서버 상태를 확인하십시오.
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
관리 콘솔을 검사하여 Application Server가
시작되었는지 확인하십시오. 관리 콘솔에서 오류 메시지를 보거나
JVM 로그를 살펴보십시오. - 관리 콘솔에서 문제의 Application Server를 선택하고 설치된 애플리케이션을 살펴 시작되었는지 확인하십시오.
- 웹 페이지와 컨텐츠를 표시되지 않게 하는 특정 문제에 대해서는 Information Center의 웹 자원(JSP 파일, 서블릿, html 파일, 이미지 등)이 표시되지 않음의 내용을 참조하십시오.
- 문제 진단 및 수정: 학습 자원에 있는 링크를 사용하여 문제를 식별하고 문서화했는지 확인하십시오.
- 사용자의 문제점과 유사한 문제점을 찾을 수 없거나 제공된 정보로 문제점을 해결할 수 없는 경우 추가 지원에 대해 IBM 지원 센터에 문의하십시오.
웹 서버가 비보안 전송 사용 시 동작의 변화
보안 및 비보안 전송이 정의되어 있고 시스템 장애로 인해 보안 전송을 수행할 수 없는 경우 웹 서버 플러그인은 비보안 전송을 사용합니다. 이는 기본 동작입니다.
이 동작은 WebSphere Application Server 버전 8.5.5에서 변경되었습니다. 보안 연결 시도 시 시스템 장애가 발생하고 비보안 전송이 있을 경우 웹 서버 플러그인은 이 전송을 사용하지 않습니다. 관리자는 문제점을 인지하게 되고 보안 연결을 사용하여 이를 해결할 수 있습니다.
- HTTPS 전송을 사용할 수 있도록 SSL 문제를 정정하십시오(권장 옵션임).
- SSL이 사용되지 않는 경우 HTTPS 전송을 제거하고 플러그인을 다시 생성하십시오.
- plugin-cfg.xml 파일에서 UseInsecure=true를 설정하여 이전 기본 동작으로 되돌리십시오.
이전 기본 동작으로 되돌리려는 경우 관리 콘솔에서 사용자 정의 특성을 설정하여 이를 사용할 수 있습니다. webserver-><webserver_name>->plugin properties->custom properties를 선택한 후 UseInsecure를 true로 설정하십시오.
이전 기본 동작으로 되돌리려는 경우 관리 콘솔에서 사용자 정의 특성을 설정하여 이를 사용할 수 있습니다. webserver-><webserver_name>->plugin properties->custom properties를 선택한 후 UseInsecure를 true로 설정하십시오.
알려진 문제점 및 해결책에 대해 IBM 지원에서 현재 사용 가능한 정보는 IBM 지원 페이지를 참조하십시오. 또한 이 페이지에는 문제점 해결에 필요한 정보 수집 시간을 줄일 수 있는 문서가 포함되므로 PMR을 열기 전에 이 페이지를 참조해야 합니다.
참조 주제