웹 서버 플러그인 특성

이 페이지에서 웹 서버 플러그인 구성 파일의 설정을 보거나 변경할 수 있습니다. 플러그인 구성 파일 plugin_cfg.xml은 웹 서버와 애플리케이션 서버 간에 통신을 설정하기 위해 특성을 제공합니다.

이 관리 콘솔 페이지를 보려면 서버 > 서버 유형 > 웹 서버 > web_server_name > 플러그인 특성을 클릭하십시오.

구성 탭에서 필드를 편집할 수 있습니다. 런타임 탭에서 읽기 전용 정보를 찾을 수 있습니다.

런타임 탭은 이 웹 서버가 애플리케이션 서버에서 실행 중인 애플리케이션에 액세스했으며 http_plugin.log 파일이 있는 경우에만 사용 가능합니다.

참고: 이 주제는 하나 이상의 애플리케이션 서버 로그 파일을 참조합니다. 권장되는 대안은 분배 및 IBM® i 시스템에서 SystemOut.log, SystemErr.log, trace.logactivity.log 파일을 사용하는 대신 HPEL(High Performance Extensible Logging) 로그를 사용하고 인프라를 추적하도록 서버를 구성하는 것입니다. 원시 z/OS® 로깅 기능과 연계하여 HPEL을 사용할 수도 있습니다. HPEL을 사용하는 경우 서버 프로파일 바이너리 디렉토리의 LogViewer 명령행 도구를 사용하여 모든 로그에 액세스하고 정보를 추적할 수 있습니다. HPEL 사용에 대한 자세한 정보는 HPEL을 사용한 애플리케이션 문제점 해결 정보를 참조하십시오.

웹 서버 시작 중 DNS 장애 무시

시작 시, 하나의 구성 내에서 플러그인이 DNS 장애를 무시하는지 여부를 합니다.

이 필드는 plugin-cfg.xml 파일의 IgnoreDNSFailures 요소에 해당됩니다.

값을 true로 설정한 경우, 각 ServerCluster에서 최소한 한 개의 서버가 호스트 이름을 분석한 경우에는 플러그인이 하나의 구성에서 DNS 장애를 무시하고 정상적으로 시작합니다. 서버 호스트 이름을 해석할 수 없는 경우 이후 구성에서 사용 불가능으로 계속 표시됩니다. 요청의 라우팅 중에는 호스트 이름 분석을 시도하지 않습니다. DNS 장애가 발생하면, 메시지가 플러그인 로그 파일에 기록되고 플러그인 초기화 프로세스는 계속됩니다.

기본적으로 값이 false인 경우 DNS 장애는 플러그인이 초기화되지 않고 요청이 실패하는 원인이 됩니다. 그러나 웹 서버가 시작됩니다.

Information
데이터 유형 String
Default false

구성 간격 새로 고치기

업데이트 또는 변경사항이 발생했는지 여부를 알아보기 위해 플러그인이 구성 파일을 검사해야 하는 시간 간격(초)을 지정합니다. 플러그인은 플러그인 구성이 마지막으로 로드된 이후로 발생한 모든 수정사항에 대해 파일을 검사합니다.

자주 변경되는 개발 환경에서는 기본 설정인 60초보다 작은 값으로 설정하는 것이 좋습니다. 생성 시 구성 업데이트가 자주 발생하지 않으므로 기본값보다 큰 값을 사용하는 것이 좋습니다. 플러그인 다시 로드가 어떤 이유로든 실패하면 메시지는 플러그인 로그 파일에 기록되며 플러그인 구성 파일 다시 로드가 정상적으로 수행될 때까지 이전 구성이 사용됩니다. 플러그인 구성에서 수행된 변경사항이 표시되지 않은 경우, 문제를 표시하는 플러그인 로그 파일을 검사하십시오.

Information
데이터 유형 정수
Default 60초.

플러그인 구성 파일 이름

플러그인용 구성 파일의 파일 이름을 지정합니다. 애플리케이션 서버는 기본값으로 plugin-cfg.xml 파일을 생성합니다. 구성 파일은 웹 서버용 애플리케이션, 애플리케이션 서버, 클러스터 및 HTTP 포트를 식별합니다. 웹 서버는 파일을 사용하여 다양한 애플리케이션 서버에서 배치된 애플리케이션에 액세스합니다.

문제점 방지 문제점 방지: 이 필드가 사용 불가능하면 변경할 수 없지만 값은 정보 목적으로만 표시됩니다.gotcha

다른 위치를 원하는 경우, 플러그인 구성 도구(pct)를 다시 실행하여 새 위치를 정의한 후 WebSphere Application Server 시스템에 설치하는 중에 생성된 새 configureWebserver 스크립트를 실행해야 합니다.

설치 도중 웹 서버 플러그인을 선택하면, 설치 프로그램이 plugin-cfg.xml 파일의 위치를 식별할 수 있도록 웹 서버를 구성합니다. 기본적으로, 플러그인 구성 파일은 plugins_root/config/web_server_name 디렉토리에 설치되어 있습니다.

설치 프로그램은 plugin-cfg.xml 파일의 위치를 지정하는 웹 서버 구성에 지시문을 추가합니다.

원격 웹 서버의 경우, 파일을 애플리케이션 서버가 설치된 로컬 디렉토리에서 원격 시스템으로 복사해야 합니다. 이 작업은 플러그인 구성 파일의 전달로 알려져 있습니다. 웹 서버로 IBM HTTP Server V6.1 이상을 사용하는 경우, WebSphere® Application Server는 파일 전달을 위해 작동하는 HTTP 전송 메커니즘이 있는 원격 시스템으로 플러그인 구성 파일을 자동으로 전달합니다.

보기를 클릭하여 현재 플러그인 구성 파일의 사본을 표시할 수 있습니다.

Information
데이터 유형 String
Default plugin-cfg.xml

자동으로 플러그인 구성 파일 생성

원격 웹 서버에 플러그인 구성 파일을 자동으로 생성하려면 다음을 수행하십시오.
  • 이 필드는 확인해야 합니다.
  • 플러그인 구성 서비스는 사용 가능해야 합니다.
플러그인 구성 서비스를 사용 가능으로 설정하면, 다음의 경우 웹 서버에 대해 플러그인 구성 파일이 자동으로 생성됩니다.
  • WebSphere Application Server 관리자가 새 웹 서버 정의
  • 애플리케이션이 애플리케이션 서버에 배치됨
  • 애플리케이션이 설치 제거됨
  • 가상 호스트 정의가 업데이트 및 저장됨

기본적으로, 이 파일은 선택되었습니다. 이 웹 서버에 대한 플러그인 구성 파일을 수동으로 생성하려면 선택란을 지우십시오.

[AIX Solaris HP-UX Linux Windows]중요사항: 플러그인 구성 파일이 생성될 때 가상 호스트 목록에 admin_host가 포함되지 않습니다. Information Center 문서, Allowing web servers to access the administrative console에서는 가상 호스트 목록에 admin_host를 추가하는 방법을 설명합니다.

자동으로 플러그인 구성 파일 전파

애플리케이션 서버가, 변경된 플러그인 구성 파일의 사본을 웹 서버로 자동으로 전달할 것인지 여부를 지정합니다.
  • 이 필드는 확인해야 합니다.
  • 플러그인 구성 서비스는 사용 가능해야 합니다.
  • Network Deployment 환경에서 WebSphere Application Server 노드 에이전트는 변경된 플러그인 구성 파일과 연관된 웹 서버를 호스트하는 노드에 있어야 합니다.
기본적으로, 이 파일은 선택되었습니다.
참고: 해당 웹 서버가 IBM HTTP Server V6.1 이상의 웹 서버이고 해당 관리 서버가 실행 중일 경우에는 플러그인 구성 파일을 원격 웹 서버에 자동으로만 전달할 수 있습니다.

플러그인 구성 서비스는 백그라운드에서 실행하며 관리 콘솔과 결합되지 않으므로, 관리 콘솔은 자동 전달 결과를 표시할 수 없습니다.

[AIX Solaris HP-UX Linux Windows]분산 플랫폼의 경우, 배치 관리자 SystemOut.log 파일에서 관련 메시지를 검사하여 자동 전달이 정상적으로 완료되었는지 확인할 수 있습니다.

[z/OS]z/OS 플랫폼의 경우, TSO JOB 로그에서 관련 메시지를 검사하여 자동 전달이 정상적으로 완료되었는지 확인할 수 있습니다.

플러그인 키 저장소 파일 이름

웹 서버 플러그인이 HTTPS 요청에 사용하는 보안 키 링이 포함된 데이터베이스 파일의 완전한 디렉토리 경로 및 파일 이름을 지정합니다. 이 파일은 이 웹 서버 플러그인과 연관된 웹 서버에 상주합니다. 데이터베이스 파일의 완전한 디렉토리 경로 및 파일 이름을 지정한 뒤에는 다음을 수행할 수 있습니다.
  • 키 및 인증 관리를 클릭하여 이 파일을 업데이트합니다.
  • 웹 서버 키 저장소 디렉토리로 복사를 클릭하여 이 파일의 사본을 웹 서버의 키 저장소 디렉토리에 추가합니다.
Information
데이터 유형 String
기본값 없음

플러그인 구성 디렉토리 및 파일 이름

웹 서버 플러그인 구성 파일의 웹 서버 사본에 대한 완전한 경로를 지정합니다. 이 경로는 웹 서버가 실행되고 있는 시스템의 파일 이름 및 위치입니다.

문제점 방지 문제점 방지: 이 필드가 사용 불가능하면 변경할 수 없지만 값은 정보 목적으로만 표시됩니다.gotcha

플러그인 키 저장소 디렉토리 및 파일 이름

보안 키 링을 포함하는 데이터베이스 파일의 웹 서버 사본에 대한 완전한 경로를 지정합니다. 이 경로는 웹 서버가 실행되고 있는 시스템의 파일 이름 및 위치입니다.

문제점 방지 문제점 방지: 이 필드가 사용 불가능하면 변경할 수 없지만 값은 정보 목적으로만 표시됩니다.gotcha

플러그인 로깅

http_plugin.log 파일의 위치 및 이름을 지정합니다. 로그에서 메시지의 범위를 지정합니다.

로그는 플러그인이 기록하는 로그 메시지의 위치와 레벨을 설명합니다. 로그가 구성 파일 내에 지정되지 않으면, 일부 경우에는 로그 메시지가 웹 서버 오류 로그에 기록됩니다.

분산 플랫폼에서 로그 파일이 없으면 파일이 작성됩니다. 로그 파일이 이미 있는 경우, 파일은 추가 모드에서 열리며 이전 플러그인 로그 메시지는 유지됩니다.

로그 파일 이름: 플러그인이 오류 메시지를 작성할 로그 파일에 대한 완전한 경로입니다.

Information
데이터 유형 String
Default plugins_root/logs/web_server_name/http_plugin.log

http_plugin.log 파일의 파일 경로를 지정합니다.

로그 레벨: 플러그인이 로그에 써야 하는 로그 메시지에 대한 디테일 레벨입니다. 이 속성에 대해 다음 값 중 하나를 지정할 수 있습니다.
  • Trace. 요청 프로세스의 모든 단계가 자세하게 로그되어 있습니다.
  • Stats. 각 요청에 대해 선택된 서버와 요청 처리와 관련된 다른 로드 밸런스 정보가 로그되어 있습니다.
  • Warn. 비정상적인 요청 처리의 결과인 경고 및 오류 메시지가 로그되어 있습니다.
  • Error. 비정상적인 요청 처리의 결과인 오류 메시지만 로그되어 있습니다.
  • Debug. All of the critical steps performed in processing requests are logged.
  • Detail. All of the information about requests and responses are logged.

로그 레벨이 지정되지 않은 경우, 기본값 오류가 사용됩니다.

레벨을 추적으로 설정할 때에는 주의를 기울이십시오. 이 레벨에서는 많은 메시지가 로그되어 디스크 공간/파일 시스템을 매우 빠르게 채우게 됩니다. 추적 설정 값은 성능에 영향을 미치기 때문에 정상적으로 작동하는 환경에서는 사용하지 말아야 합니다.

[AIX Solaris HP-UX Linux Windows][IBM i][z/OS]중요사항: 웹 서버 및 웹 서버 플러그인이 AIX®, HP-UX, Linux 또는 Solaris 시스템에서 실행될 때 plugin-cfg.xml 파일에서 로그 레벨을 변경한 경우, 이 변경사항이 동적으로 적용되지 않습니다. 변경사항을 적용하려면 웹 서버를 다시 시작해야 합니다. Solaris의 예제의 경우, 웹 서버를 다시 시작하지 않으면 Plugin_Home/logs/http_plugin.log 파일에 다음 오류 메시지가 나타납니다.
ERROR: ws_config_parser:handleLogEnd: Failed to open log file 
'/opt/IBM/WebSphere/Plugin/logs/sunwebserver/http_plugin.log', OS
Information
데이터 유형 String
Default 오류

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



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