웹 서버 플러그인 문제점 해결 팁

다음 주제는 웹 서버 플러그인과 관련된 문제점을 진단하는 데 도움을 줄 수 있습니다.

웹 서버 플러그인을 사용하는 데 문제점이 있는 경우, 다음 단계를 시도하십시오.
  • plugins_root/logs/web_server_name/http_plugin.log 파일에서 단서를 검토하십시오. 메시지 테이블에서 오류 또는 경고 메시지를 보십시오.
  • 웹 서버의 오류 및 액세스 로그를 검토하여 웹 서버에 문제점이 있는지 확인하십시오.
    • IBM® HTTP Server 및 Apache: access.logerror.log.
    • Domino® 웹 서버: httpd-loghttpd-error.
    • Sun Java™ 시스템: accesserror.
    • Microsoft IIS: timedatestamp.log.

이러한 파일로 문제의 원인이 드러나지 않는 경우, 다음 추가 단계를 따르십시오.

플러그인 문제 판별 단계

플러그인은 문제를 알아내는 데 유익한 매우 읽기 쉬운 추적 기능을 제공합니다. config/plugin-cfg.xml 파일에서 LogLevel 속성을 Trace로 설정하여 요청 처리에 따라 잘못된 것이 무엇인지 알아낼 수 있습니다.
[HP-UX]참고: 대용량 파일 지원이 사용 가능한 Veritas 파일 시스템을 사용할 경우, 파일 크기가 최대 2테라바이트까지 허용됩니다. 이 경우, plugin-cfg.xml 파일의 LogLevel 속성을 LogLevel=Trace로 설정하면 http_plugin.log 파일이 빠르게 증가하여 파일 시스템에서 사용 가능한 모든 공간을 소모할 수도 있습니다. 따라서 높은 CPU 사용량을 방지하려면 LogLevel 속성의 값을 ERROR 또는 DEBUG로 설정해야 합니다.
상위 레벨에서 다음 단계를 완료하십시오.
  1. 플러그인이 요청을 확보합니다.
  2. 플러그인이 plugin-cfg.xml 파일에 정의된 라우트를 확인합니다.
  3. 서버 그룹을 찾습니다.
  4. 서버를 찾습니다.
  5. 전송 프로토콜, HTTP 또는 HTTPS를 선택합니다.
  6. 요청을 전송합니다.
  7. 응답을 읽습니다.
  8. 클라이언트에 다시 기록합니다.
단일 요청의 추적을 훑어보면서 매우 분명하게 이를 확인할 수 있습니다.
  • 첫 번째 단계는 플러그인이 웹 서버에 정상적으로 로드되었는지 판별하는 것입니다.
    • 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]Windows 플랫폼에서 gsk7ssl.dll 파일을 검색합니다.
      • [AIX HP-UX Solaris]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][IBM i]관리 콘솔을 검사하여 Application Server가 시작되었는지 확인하십시오. 관리 콘솔에서 오류 메시지를 보거나 JVM 로그를 살펴보십시오.

    [z/OS]관리 콘솔을 검사하여 Application Server가 시작되었는지 확인하십시오. 오류 메시지에 대한 관리 콘솔을 보십시오.

  • 관리 콘솔에서 문제의 Application Server를 선택하고 설치된 애플리케이션을 살펴 시작되었는지 확인하십시오.
이러한 단계로도 문제가 전혀 해결되지 않은 경우, 다음을 수행하십시오.

웹 서버가 비보안 전송 사용 시 동작의 변화

보안 및 비보안 전송이 정의되어 있고 시스템 장애로 인해 보안 전송을 수행할 수 없는 경우 웹 서버 플러그인은 비보안 전송을 사용합니다. 이는 기본 동작입니다.

이 동작은 WebSphere Application Server 버전 8.5.5에서 변경되었습니다. 보안 연결 시도 시 시스템 장애가 발생하고 비보안 전송이 있을 경우 웹 서버 플러그인은 이 전송을 사용하지 않습니다. 관리자는 문제점을 인지하게 되고 보안 연결을 사용하여 이를 해결할 수 있습니다.

관리자가 이 문제점을 해결하도록 세 가지 옵션을 사용할 수 있습니다.
  1. HTTPS 전송을 사용할 수 있도록 SSL 문제를 정정하십시오(권장 옵션임).
  2. SSL이 사용되지 않는 경우 HTTPS 전송을 제거하고 플러그인을 다시 생성하십시오.
  3. plugin-cfg.xml 파일에서 UseInsecure=true를 설정하여 이전 기본 동작으로 되돌리십시오.

이전 기본 동작으로 되돌리려는 경우 관리 콘솔에서 사용자 정의 특성을 설정하여 이를 사용할 수 있습니다. webserver-><webserver_name>->plugin properties->custom properties를 선택한 후 UseInsecure를 true로 설정하십시오.

[z/OS]HTTP 서버가 관리 서버가 아닌 경우(관리 콘솔에 표시되지 않음) plugin-cfg.xml 파일을 수동으로 편집해야 합니다. 자세한 정보는 z/OS용 V5.3 HTTP Server의 플러그인 설치 및 구성 주제를 읽으십시오.

이전 기본 동작으로 되돌리려는 경우 관리 콘솔에서 사용자 정의 특성을 설정하여 이를 사용할 수 있습니다. webserver-><webserver_name>->plugin properties->custom properties를 선택한 후 UseInsecure를 true로 설정하십시오.

IBM Support에서 제공하는 알려진 문제점과 해결책에 대한 최신 정보는 IBM Support 페이지에서 다음 주제를 참조하십시오.

알려진 문제점 및 해결책에 대해 IBM 지원에서 현재 사용 가능한 정보는 IBM 지원 페이지를 참조하십시오. 또한 이 페이지에는 문제점 해결에 필요한 정보 수집 시간을 줄일 수 있는 문서가 포함되므로 PMR을 열기 전에 이 페이지를 참조해야 합니다.

IBM 지원 센터의 다음 주제가 도움이 될 수 있습니다.

주제 유형을 표시하는 아이콘 참조 주제



시간소인 아이콘 마지막 업데이트 날짜: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rtrb_plugincomp
파일 이름:rtrb_plugincomp.html