웹 서버 플러그인 문제점 해결 팁
다음 주제는 웹 서버 플러그인과 관련된 문제점을 진단하는 데 도움을 줄 수 있습니다.
- 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.
이러한 파일로 문제의 원인이 드러나지 않는 경우, 다음 추가 단계를 따르십시오.
플러그인 문제 판별 단계
![[HP-UX]](../images/hpux.gif)
- 플러그인이 요청을 확보합니다.
- 플러그인이 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 또는
기타 외부 도구에 의해 측정된 프로세서 활용을 검사하여 다음 사항을 확인하십시오.
- 예상했던 것이 아닙니다.
- 일정하지 않고 변화합니다.
- 새로 추가된 클러스터 멤버가 이용되고 있지 않음을 표시합니다.
- 수정된 실패 멤버가 이용되고 있지 않음을 표시합니다.
- 관리 콘솔에서 서버 상태를 확인하십시오.
관리 콘솔을 검사하여 Application Server가 시작되었는지 확인하십시오. 관리 콘솔에서 오류 메시지를 보거나 JVM 로그를 살펴보십시오.
관리 콘솔을 검사하여 Application Server가 시작되었는지 확인하십시오. 오류 메시지에 대한 관리 콘솔을 보십시오.
- 관리 콘솔에서 문제의 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로 설정하십시오.
HTTP 서버가 관리 서버가 아닌 경우(관리 콘솔에
표시되지 않음) plugin-cfg.xml 파일을 수동으로
편집해야 합니다. 자세한 정보는 z/OS용 V5.3 HTTP Server의
플러그인 설치 및 구성 주제를 읽으십시오.
이전 기본 동작으로 되돌리려는 경우 관리 콘솔에서 사용자 정의 특성을 설정하여 이를 사용할 수 있습니다. webserver-><webserver_name>->plugin properties->custom properties를 선택한 후 UseInsecure를 true로 설정하십시오.
알려진 문제점 및 해결책에 대해 IBM 지원에서 현재 사용 가능한 정보는 IBM 지원 페이지를 참조하십시오. 또한 이 페이지에는 문제점 해결에 필요한 정보 수집 시간을 줄일 수 있는 문서가 포함되므로 PMR을 열기 전에 이 페이지를 참조해야 합니다.