pluginConfiguration - 웹 서버 플러그인 (pluginConfiguration)

웹 서버 플러그인 구성 파일을 생성할 때 사용되는 특성

NameTypeDefaultDescription
pluginInstallRootstring/opt/IBM/WebSphere/Plugins웹 서버 호스트의 파일 시스템에서 웹 서버 플러그인 설치 위치
webserverNamestringwebserver1이 구성이 사용될 웹 서버의 이름입니다. 로그 파일 이름 또는 디렉토리에 의해 명시적으로 지정되지 않은 경우, 플러그인 로그 파일 위치를 생성하는 데 사용됩니다.
webserverPortint
Min: -1

Max: 65535
80웹 서버 HTTP 포트
webserverSecurePortint
Min: -1

Max: 65535
443웹 서버 HTTPS 포트
sslKeyringLocationstring${pluginInstallRoot}/config/${webserverName}/plugin-key.kdb웹 서버 호스트의 SSL 키 링 파일에 대한 완전한 경로
sslStashfileLocationstring${pluginInstallRoot}/config/${webserverName}/plugin-key.sth웹 서버 호스트의 SSL 숨김 파일에 대한 완전한 경로
sslCertlabelstring웹 컨테이너가 플러그인에서 클라이언트 인증서를 요청할 때 플러그인이 사용할 키 링 내 인증서의 레이블을 지정합니다.
ipv6Preferredbooleanfalse가능하면 이 주소 유형을 권장하기 위해 {null} 또는 {0}의 애플리케이션 서버 호스트 이름을 분석할 때 사용됨
httpEndpointRef최상위 레벨 httpEndpoint 요소에 대한 참조입니다(문자열).defaultHttpEndpoint생성된 plugin-cfg.xml 파일에 포함되는 http 엔드포인트의 ID를 지정하십시오. 엔드포인트가 클러스터에서 서버를 정의합니다. 기본값은 'defaultHttpEndpoint'입니다.
connectTimeout초 정밀도를 사용하는 기간5s애플리케이션 서버가 웹 서버와의 연결을 유지해야 하는 최대 시간을 식별합니다. 시간 단위가 뒤따르는 양수를 지정하십시오. 이는 시간(h), 분(m) 또는 초(s)일 수 있습니다. 예를 들어, 30초를 30s로 지정하십시오. 하나의 항목에 여러 값을 포함할 수 있습니다. 예를 들어, 1m30s는 90초와 동등합니다.
serverIOTimeout초 정밀도를 사용하는 기간900s웹 서버 플러그인이 요청을 보내거나 애플리케이션 서버에서 응답을 받을 때까지 대기하는 최대 시간을 식별합니다. 시간 단위가 뒤따르는 양수를 지정하십시오. 이는 시간(h), 분(m) 또는 초(s)일 수 있습니다. 예를 들어, 30초를 30s로 지정하십시오. 하나의 항목에 여러 값을 포함할 수 있습니다. 예를 들어, 1m30s는 90초와 동등합니다.
wsServerIOTimeout초 정밀도를 사용하는 기간웹 서버 플러그인이 요청을 보내거나 애플리케이션 서버에서 websocket 응답을 받을 때까지 대기하는 최대 시간을 식별합니다. 시간 단위가 뒤따르는 양수를 지정하십시오. 이는 시간(h), 분(m) 또는 초(s)일 수 있습니다. 예를 들어, 30초를 30s로 지정하십시오. 하나의 항목에 여러 값을 포함할 수 있습니다. 예를 들어, 1m30s는 90초와 동등합니다.
wsServerIdleTimeout초 정밀도를 사용하는 기간웹 서버 플러그인이 유휴 websocket 연결을 종료할 때까지 대기하는 최대 시간을 식별합니다. 시간 단위가 뒤따르는 양수를 지정하십시오. 이는 시간(h), 분(m) 또는 초(s)일 수 있습니다. 예를 들어, 30초를 30s로 지정하십시오. 하나의 항목에 여러 값을 포함할 수 있습니다. 예를 들어, 1m30s는 90초와 동등합니다.
extendedHandshakebooleanfalsetrue이면 웹 서버 플러그인이 확장된 핸드쉐이크를 사용하여 애플리케이션 서버가 실행 중인지를 판별합니다.
waitForContinuebooleanfalsefalse(기본값)이면 웹 서버 플러그인이 메시지 본문이 있는 HTTP 요청에서 "Expect: 100-continue" 헤더를 보냅니다. true로 설정되면 웹 서버 플러그인이 모든 HTTP 요청에서 "Expect: 100-continue" 헤더를 보냅니다. 웹 서버와 애플리케이션 서버 사이에 방화벽이 있거나 요청 본문이 없는 요청 재시도에 민감한 경우 이 값을 true로 설정할 것을 고려하십시오.
logFileName파일에 대한 경로웹 서버 플러그인 로그 파일에 대한 완전한 경로입니다. 디렉토리 컴포넌트는 이미 존재해야 합니다. Apache 기반 웹 서버의 경우, 파이프 문자로 시작하는 경로는 외부 파이프 로거로서 해석됩니다. 지정된 경우, 경로는 logDirLocation을 대체합니다.
logDirLocation디렉토리에 대한 경로${pluginInstallRoot}/logs/${webserverName}더 이상 사용되지 않음: http_plugin.log 파일이 있는 디렉토리를 식별합니다. 로그 파일 이름을 확인하십시오.
serverIOTimeoutRetryint
Min: -1

Max: 65535
-1읽기 또는 쓰기 제한시간 초과 이후 요청 재시도의 횟수를 제한합니다. 기본값 {-1}은 추가 제한을 적용하지 않습니다. 따라서 재시도는 클러스터에서 사용 가능한 서버의 수에 의해 제한됩니다. {0} 값은 재시도가 없어야 함을 표시합니다. 이 값의 범위는 서버 클러스터로 한정되며, HTTP 플러그인 연결 제한시간이나 웹 소켓 제한시간으로 인한 제한시간 초과 또는 연결 실패에는 적용되지 않습니다.
loadBalanceWeightint20이 값은 런타임 중에 동적으로 변경됩니다. 해당 서버에 요청이 지정될 때마다 해당 서버의 가중치가 낮아집니다. 모든 서버의 가중치가 0 이하로 떨어지면 웹 서버 플러그인은 모든 가중치가 0을 초과하도록 재조정합니다.
serverRole
  • BACKUP
  • PRIMARY
PRIMARY서버 역할은 서버를 기본 또는 백업으로 식별합니다. 기본 서버를 사용할 수 있는 경우 웹 서버 플러그인은 로드 밸런싱 및 장애 복구를 위해 해당 서버를 사용합니다. 하지만 기본 서버를 하나도 사용할 수 없는 경우 웹 서버 플러그인은 로드 밸런싱 및 장애 복구를 위해 백업 서버만을 사용합니다.
BACKUP
백업
PRIMARY
기본
ESIEnablebooleantrueESIEnable 특성을 통해 Edge Side Include 처리에서 응답을 캐시할 수 있습니다. 이 특성은 웹 서버 플러그인 구성 파일의 ESI를 사용 안함으로 설정하는 옵션을 제공합니다.
ESIMaxCacheSizeint1024ESIMaxCacheSize는 기본값이 1MB인 캐시의 최대 크기입니다. 이 특성은 웹 서버 플러그인 구성 파일의 값을 대체하는 옵션을 제공합니다.
ESIInvalidationMonitorbooleanfalseESIInvalidationMonitor는 ESI 프로세서가 애플리케이션 서버에서 무효화를 수신해야 하는지 여부를 지정합니다. 이 특성은 웹 서버 플러그인 구성 파일의 값을 대체하는 옵션을 제공합니다.
ESIEnableToPassCookiesbooleanfalseESIEnableToPassCookies는 WebSphere Application Server에 대한 세션 쿠키의 전달을 허용합니다. 이 특성은 웹 서버 플러그인 구성 파일의 값을 대체하는 옵션을 제공합니다.
trustedProxyEnableboolean신뢰된 프록시가 사용되도록 설정합니다. 지정되면, 이 특성이 웹 서버 플러그인 구성 파일의 값을 대체합니다.
trustedProxyGroupstring신뢰된 프록시의 쉼표로 분리된 목록입니다. 지정되면, 이 특성이 웹 서버 플러그인 구성 파일의 값을 대체합니다.

httpEndpoint

생성된 plugin-cfg.xml 파일에 포함되는 http 엔드포인트의 ID를 지정하십시오. 엔드포인트가 클러스터에서 서버를 정의합니다. 기본값은 'defaultHttpEndpoint'입니다.

NameTypeDefaultDescription
onError
  • IGNORE
  • WARN
  • FAIL
WARN엔드포인트 시작에 실패한 후 수행하는 조치입니다.
IGNORE
구성 오류가 발생한 경우 서버가 경고 및 오류 메시지를 발행하지 않습니다.
WARN
구성 오류가 발생한 경우 서버는 경고 및 오류 메시지를 발행합니다.
FAIL
첫 번째 오류가 발생한 경우 서버는 경고 또는 오류 메시지를 발행하고 서버를 중지시킵니다.
enabledbooleantrue엔드포인트의 가용성을 토글하십시오. True일 때는 이 엔드포인트가 디스패처에 의해 활성화되어 HTTP 요청을 처리합니다.
hoststringlocalhost클라이언트가 자원을 요청하는 데 사용하는 IP 주소, 도메인 이름 접미부를 갖는 도메인 이름 서버(DNS) 호스트 이름 또는 DNS 호스트 이름만입니다. 모든 사용 가능한 네트워크 인터페이스에 대해서는 '*'를 사용하십시오.
httpPortint
Min: -1

Max: 65535
클라이언트 HTTP 요청에 사용되는 포트입니다. 이 포트를 사용 안 하려면 -1을 사용하십시오.
httpsPortint
Min: -1

Max: 65535
SSL(https)로 보안되는 클라이언트 HTTP 요청에 사용되는 포트입니다. 이 포트를 사용 안 하려면 -1을 사용하십시오.
httpOptionsRef최상위 레벨 httpOptions 요소에 대한 참조입니다(문자열).defaultHttpOptions엔드포인트에 대한 HTTP 프로토콜 옵션입니다.
sslOptionsRef최상위 레벨 sslOptions 요소에 대한 참조입니다(문자열).엔드포인트에 대한 SSL 프로토콜 옵션입니다.
tcpOptionsRef최상위 레벨 tcpOptions 요소에 대한 참조입니다(문자열).defaultTCPOptions엔드포인트에 대한 TCP 프로토콜 옵션입니다.
accessLoggingRef최상위 레벨 httpAccessLogging 요소에 대한 참조입니다(문자열).엔드포인트에 대한 HTTP 액세스 로깅 구성입니다.

httpEndpoint > httpOptions

엔드포인트에 대한 HTTP 프로토콜 옵션입니다.

NameTypeDefaultDescription
keepAliveEnabledbooleantrue지속적 연결을 사용합니다(HTTP KeepAlive). True인 경우 연결은 다중 순차 요청 및 응답이 재사용하도록 유지됩니다. False인 경우 연결은 응답이 전송된 후에 닫힙니다.
maxKeepAliveRequestsint
Min: -1
100지속적 연결이 사용 가능한 경우 단일 HTTP 연결에서 허용되는 최대 지속적 요청 수입니다. -1의 값은 무제한을 의미합니다.
persistTimeout초 정밀도를 사용하는 기간30s소켓이 요청 사이에 유휴 상태로 남도록 허용되는 시간입니다. 이 설정은 지속적 연결이 사용 가능한 경우에만 적용됩니다. 시간 단위가 뒤따르는 양수를 지정하십시오. 이는 시간(h), 분(m) 또는 초(s)일 수 있습니다. 예를 들어, 30초를 30s로 지정하십시오. 하나의 항목에 여러 값을 포함할 수 있습니다. 예를 들어, 1m30s는 90초와 동등합니다.
readTimeout초 정밀도를 사용하는 기간60s읽기 요청이 첫 번째 읽기가 발생한 후 소켓에서 완료하기를 대기하는 시간입니다. 시간 단위가 뒤따르는 양수를 지정하십시오. 이는 시간(h), 분(m) 또는 초(s)일 수 있습니다. 예를 들어, 30초를 30s로 지정하십시오. 하나의 항목에 여러 값을 포함할 수 있습니다. 예를 들어, 1m30s는 90초와 동등합니다.
writeTimeout초 정밀도를 사용하는 기간60s응답 데이터의 각 부분이 전송되기를 소켓에서 대기하는 시간입니다. 시간 단위가 뒤따르는 양수를 지정하십시오. 이는 시간(h), 분(m) 또는 초(s)일 수 있습니다. 예를 들어, 30초를 30s로 지정하십시오. 하나의 항목에 여러 값을 포함할 수 있습니다. 예를 들어, 1m30s는 90초와 동등합니다.
removeServerHeaderbooleanfalseHTTP 헤더에서 서버 구현 정보를 제거하고 기본 Liberty 프로파일 환영 페이지도 사용하지 않도록 설정하십시오.
NoCacheCookiesControlbooleantrue사용자가 쿠키 설정 헤더의 존재가 캐시 없음 값이 일치하는 캐시 제어 헤더를 업데이트해야 하는지 여부를 제어할 수 있도록 허용합니다. 이는 또한 만기 헤더를 추가합니다.
AutoDecompressionbooleantrueHTTP 채널이 수신 요청 본문 데이터를 자동으로 압축 해제하는지 여부를 지정합니다.

httpEndpoint > sslOptions

엔드포인트에 대한 SSL 프로토콜 옵션입니다.

NameTypeDefaultDescription
sessionTimeout초 정밀도를 사용하는 기간1d소켓에서 읽기 또는 쓰기 요청이 완료되기를 기다리는 시간입니다. 이 값은 프로토콜별 제한시간으로 대체됩니다. 시간 단위가 뒤따르는 양수를 지정하십시오. 이는 시간(h), 분(m) 또는 초(s)일 수 있습니다. 예를 들어, 30초를 30s로 지정하십시오. 하나의 항목에 여러 값을 포함할 수 있습니다. 예를 들어, 1m30s는 90초와 동등합니다.
suppressHandshakeErrorsbooleanfalseSSL 핸드쉐이크 오류 로깅을 사용하지 않습니다. 일반 조작 중에 SSL 핸드쉐이크 오류가 발생할 수 있습니다. 그러나 SSL이 예상치 못한 방식으로 작동할 때 이 메시지가 유용할 수 있습니다.
sslRef최상위 레벨 ssl 요소에 대한 참조입니다(문자열).기본 SSL 구성 레퍼토리입니다. 기본값은 defaultSSLSettings입니다.
sslSessionTimeout밀리초 정밀도를 사용하는 기간8640msSSL 채널을 통해 설정되는 SSL 세션의 제한시간 한계입니다. 시간 단위가 뒤따르는 양수를 지정하십시오. 이는 시간(h), 분(m), 초(s) 또는 밀리초(ms)일 수 있습니다. 예를 들어, 500밀리초를 500ms로 지정하십시오. 하나의 항목에 여러 값을 포함할 수 있습니다. 예를 들어, 1s500ms는 1.5초와 동등합니다.

httpEndpoint > tcpOptions

엔드포인트에 대한 TCP 프로토콜 옵션입니다.

NameTypeDefaultDescription
inactivityTimeout밀리초 정밀도를 사용하는 기간60s소켓에서 읽기 또는 쓰기 요청이 완료되기를 기다리는 시간입니다. 이 값은 프로토콜별 제한시간으로 대체됩니다. 시간 단위가 뒤따르는 양수를 지정하십시오. 이는 시간(h), 분(m), 초(s) 또는 밀리초(ms)일 수 있습니다. 예를 들어, 500밀리초를 500ms로 지정하십시오. 하나의 항목에 여러 값을 포함할 수 있습니다. 예를 들어, 1s500ms는 1.5초와 동등합니다.
soReuseAddrbooleantrue활성 리스너 없이 포트에 대한 즉각적 리바인드를 사용합니다.
addressIncludeListstring이 엔드포인트에서 인바운드 연결을 허용하는 쉼표로 구분된 주소 목록입니다. IPv4 또는 IPv6 주소를 지정할 수 있습니다. IPv4 또는 IPv6 주소의 모든 값은 숫자 또는 별표(*) 와일드카드 문자로 나타내야 합니다.
addressExcludeListstring이 엔드포인트에서 인바운드 연결을 허용하지 않는 쉼표로 구분된 주소 목록입니다. IPv4 또는 IPv6 주소를 지정할 수 있습니다. IPv4 또는 IPv6 주소의 모든 값은 숫자 또는 별표(*) 와일드카드 문자로 나타내야 합니다.
hostNameIncludeListstring이 엔드포인트에서 인바운드 연결을 허용하는 쉼표로 구분된 호스트 이름 목록입니다. 호스트 이름은 대소문자를 구분하지 않고 와일드카드 문자로 사용되는 별표(*)로 시작될 수 있습니다. 그러나 별표(*)는 호스트 이름의 다른 위치에 올 수 없습니다. 예를 들어, *.abc.com은 유효하지만 *.abc.*는 유효하지 않습니다.
hostNameExcludeListstring이 엔드포인트에서 인바운드 연결을 허용하지 않는 쉼표로 구분된 호스트 이름 목록입니다. 호스트 이름은 대소문자를 구분하지 않고 와일드카드 문자로 사용되는 별표(*)로 시작될 수 있습니다. 그러나 별표(*)는 호스트 이름의 다른 위치에 올 수 없습니다. 예를 들어, *.abc.com은 유효하지만 *.abc.*는 유효하지 않습니다.

httpEndpoint > accessLogging

엔드포인트에 대한 HTTP 액세스 로깅 구성입니다.

NameTypeDefaultDescription
enabledbooleantrue액세스 로깅을 사용합니다.
filePath파일에 대한 경로${server.output.dir}/logs/http_access.log액세스 로그 파일의 이름 및 디렉토리 경로입니다. 디렉토리 경로를 지정할 때 ${server.output.dir} 같은 표준 변수 대체를 사용할 수 있습니다.
logFormatstring%h %u %{t}W "%r" %s %b클라이언트 액세스 정보를 로깅할 때 사용하는 로그 형식을 지정합니다.
maxFileSizeint
Min: 0
20로그 파일이 롤오버되기 전에 MB 단위의 최대 크기입니다. 값 0은 무제한을 의미합니다.
maxFilesint
Min: 0
2가장 오래된 파일이 제거되기 전에 유지될 최대 로그 파일 수입니다. 값 0은 무제한을 의미합니다.

extraConfigProperties

생성된 플러그인 구성 파일의 구성 요소에 추가될 추가 특성입니다. IBM 지원 센터에서 이 특성을 지정하여 웹 서버 플러그인의 작동을 수정할 수 있습니다.