웹 서버 플러그인 구성 파일을 생성할 때 사용되는 특성
Name | Type | Default | Description |
---|---|---|---|
pluginInstallRoot | string | /opt/IBM/WebSphere/Plugins | 웹 서버 호스트의 파일 시스템에서 웹 서버 플러그인 설치 위치 |
webserverName | string | webserver1 | 이 구성이 사용될 웹 서버의 이름입니다. 로그 파일 이름 또는 디렉토리에 의해 명시적으로 지정되지 않은 경우, 플러그인 로그 파일 위치를 생성하는 데 사용됩니다. |
webserverPort | int Min: -1 Max: 65535 | 80 | 웹 서버 HTTP 포트 |
webserverSecurePort | int Min: -1 Max: 65535 | 443 | 웹 서버 HTTPS 포트 |
sslKeyringLocation | string | ${pluginInstallRoot}/config/${webserverName}/plugin-key.kdb | 웹 서버 호스트의 SSL 키 링 파일에 대한 완전한 경로 |
sslStashfileLocation | string | ${pluginInstallRoot}/config/${webserverName}/plugin-key.sth | 웹 서버 호스트의 SSL 숨김 파일에 대한 완전한 경로 |
sslCertlabel | string | 웹 컨테이너가 플러그인에서 클라이언트 인증서를 요청할 때 플러그인이 사용할 키 링 내 인증서의 레이블을 지정합니다. | |
ipv6Preferred | boolean | false | 가능하면 이 주소 유형을 권장하기 위해 {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초와 동등합니다. | |
extendedHandshake | boolean | false | true이면 웹 서버 플러그인이 확장된 핸드쉐이크를 사용하여 애플리케이션 서버가 실행 중인지를 판별합니다. |
waitForContinue | boolean | false | false(기본값)이면 웹 서버 플러그인이 메시지 본문이 있는 HTTP 요청에서 "Expect: 100-continue" 헤더를 보냅니다. true로 설정되면 웹 서버 플러그인이 모든 HTTP 요청에서 "Expect: 100-continue" 헤더를 보냅니다. 웹 서버와 애플리케이션 서버 사이에 방화벽이 있거나 요청 본문이 없는 요청 재시도에 민감한 경우 이 값을 true로 설정할 것을 고려하십시오. |
logFileName | 파일에 대한 경로 | 웹 서버 플러그인 로그 파일에 대한 완전한 경로입니다. 디렉토리 컴포넌트는 이미 존재해야 합니다. Apache 기반 웹 서버의 경우, 파이프 문자로 시작하는 경로는 외부 파이프 로거로서 해석됩니다. 지정된 경우, 경로는 logDirLocation을 대체합니다. | |
logDirLocation | 디렉토리에 대한 경로 | ${pluginInstallRoot}/logs/${webserverName} | 더 이상 사용되지 않음: http_plugin.log 파일이 있는 디렉토리를 식별합니다. 로그 파일 이름을 확인하십시오. |
serverIOTimeoutRetry | int Min: -1 Max: 65535 | -1 | 읽기 또는 쓰기 제한시간 초과 이후 요청 재시도의 횟수를 제한합니다. 기본값 {-1}은 추가 제한을 적용하지 않습니다. 따라서 재시도는 클러스터에서 사용 가능한 서버의 수에 의해 제한됩니다. {0} 값은 재시도가 없어야 함을 표시합니다. 이 값의 범위는 서버 클러스터로 한정되며, HTTP 플러그인 연결 제한시간이나 웹 소켓 제한시간으로 인한 제한시간 초과 또는 연결 실패에는 적용되지 않습니다. |
loadBalanceWeight | int | 20 | 이 값은 런타임 중에 동적으로 변경됩니다. 해당 서버에 요청이 지정될 때마다 해당 서버의 가중치가 낮아집니다. 모든 서버의 가중치가 0 이하로 떨어지면 웹 서버 플러그인은 모든 가중치가 0을 초과하도록 재조정합니다. |
serverRole |
| PRIMARY | 서버 역할은 서버를 기본 또는 백업으로 식별합니다. 기본 서버를 사용할 수 있는 경우 웹 서버 플러그인은 로드 밸런싱 및 장애 복구를 위해 해당 서버를 사용합니다. 하지만 기본 서버를 하나도 사용할 수 없는 경우 웹 서버 플러그인은 로드 밸런싱 및 장애 복구를 위해 백업 서버만을 사용합니다. BACKUP 백업 PRIMARY 기본 |
ESIEnable | boolean | true | ESIEnable 특성을 통해 Edge Side Include 처리에서 응답을 캐시할 수 있습니다. 이 특성은 웹 서버 플러그인 구성 파일의 ESI를 사용 안함으로 설정하는 옵션을 제공합니다. |
ESIMaxCacheSize | int | 1024 | ESIMaxCacheSize는 기본값이 1MB인 캐시의 최대 크기입니다. 이 특성은 웹 서버 플러그인 구성 파일의 값을 대체하는 옵션을 제공합니다. |
ESIInvalidationMonitor | boolean | false | ESIInvalidationMonitor는 ESI 프로세서가 애플리케이션 서버에서 무효화를 수신해야 하는지 여부를 지정합니다. 이 특성은 웹 서버 플러그인 구성 파일의 값을 대체하는 옵션을 제공합니다. |
ESIEnableToPassCookies | boolean | false | ESIEnableToPassCookies는 WebSphere Application Server에 대한 세션 쿠키의 전달을 허용합니다. 이 특성은 웹 서버 플러그인 구성 파일의 값을 대체하는 옵션을 제공합니다. |
trustedProxyEnable | boolean | 신뢰된 프록시가 사용되도록 설정합니다. 지정되면, 이 특성이 웹 서버 플러그인 구성 파일의 값을 대체합니다. | |
trustedProxyGroup | string | 신뢰된 프록시의 쉼표로 분리된 목록입니다. 지정되면, 이 특성이 웹 서버 플러그인 구성 파일의 값을 대체합니다. |
생성된 plugin-cfg.xml 파일에 포함되는 http 엔드포인트의 ID를 지정하십시오. 엔드포인트가 클러스터에서 서버를 정의합니다. 기본값은 'defaultHttpEndpoint'입니다.
Name | Type | Default | Description |
---|---|---|---|
onError |
| WARN | 엔드포인트 시작에 실패한 후 수행하는 조치입니다. IGNORE 구성 오류가 발생한 경우 서버가 경고 및 오류 메시지를 발행하지 않습니다. WARN 구성 오류가 발생한 경우 서버는 경고 및 오류 메시지를 발행합니다. FAIL 첫 번째 오류가 발생한 경우 서버는 경고 또는 오류 메시지를 발행하고 서버를 중지시킵니다. |
enabled | boolean | true | 엔드포인트의 가용성을 토글하십시오. True일 때는 이 엔드포인트가 디스패처에 의해 활성화되어 HTTP 요청을 처리합니다. |
host | string | localhost | 클라이언트가 자원을 요청하는 데 사용하는 IP 주소, 도메인 이름 접미부를 갖는 도메인 이름 서버(DNS) 호스트 이름 또는 DNS 호스트 이름만입니다. 모든 사용 가능한 네트워크 인터페이스에 대해서는 '*'를 사용하십시오. |
httpPort | int Min: -1 Max: 65535 | 클라이언트 HTTP 요청에 사용되는 포트입니다. 이 포트를 사용 안 하려면 -1을 사용하십시오. | |
httpsPort | int Min: -1 Max: 65535 | SSL(https)로 보안되는 클라이언트 HTTP 요청에 사용되는 포트입니다. 이 포트를 사용 안 하려면 -1을 사용하십시오. | |
httpOptionsRef | 최상위 레벨 httpOptions 요소에 대한 참조입니다(문자열). | defaultHttpOptions | 엔드포인트에 대한 HTTP 프로토콜 옵션입니다. |
sslOptionsRef | 최상위 레벨 sslOptions 요소에 대한 참조입니다(문자열). | 엔드포인트에 대한 SSL 프로토콜 옵션입니다. | |
tcpOptionsRef | 최상위 레벨 tcpOptions 요소에 대한 참조입니다(문자열). | defaultTCPOptions | 엔드포인트에 대한 TCP 프로토콜 옵션입니다. |
accessLoggingRef | 최상위 레벨 httpAccessLogging 요소에 대한 참조입니다(문자열). | 엔드포인트에 대한 HTTP 액세스 로깅 구성입니다. |
엔드포인트에 대한 HTTP 프로토콜 옵션입니다.
Name | Type | Default | Description |
---|---|---|---|
keepAliveEnabled | boolean | true | 지속적 연결을 사용합니다(HTTP KeepAlive). True인 경우 연결은 다중 순차 요청 및 응답이 재사용하도록 유지됩니다. False인 경우 연결은 응답이 전송된 후에 닫힙니다. |
maxKeepAliveRequests | int 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초와 동등합니다. |
removeServerHeader | boolean | false | HTTP 헤더에서 서버 구현 정보를 제거하고 기본 Liberty 프로파일 환영 페이지도 사용하지 않도록 설정하십시오. |
NoCacheCookiesControl | boolean | true | 사용자가 쿠키 설정 헤더의 존재가 캐시 없음 값이 일치하는 캐시 제어 헤더를 업데이트해야 하는지 여부를 제어할 수 있도록 허용합니다. 이는 또한 만기 헤더를 추가합니다. |
AutoDecompression | boolean | true | HTTP 채널이 수신 요청 본문 데이터를 자동으로 압축 해제하는지 여부를 지정합니다. |
엔드포인트에 대한 SSL 프로토콜 옵션입니다.
Name | Type | Default | Description |
---|---|---|---|
sessionTimeout | 초 정밀도를 사용하는 기간 | 1d | 소켓에서 읽기 또는 쓰기 요청이 완료되기를 기다리는 시간입니다. 이 값은 프로토콜별 제한시간으로 대체됩니다. 시간 단위가 뒤따르는 양수를 지정하십시오. 이는 시간(h), 분(m) 또는 초(s)일 수 있습니다. 예를 들어, 30초를 30s로 지정하십시오. 하나의 항목에 여러 값을 포함할 수 있습니다. 예를 들어, 1m30s는 90초와 동등합니다. |
suppressHandshakeErrors | boolean | false | SSL 핸드쉐이크 오류 로깅을 사용하지 않습니다. 일반 조작 중에 SSL 핸드쉐이크 오류가 발생할 수 있습니다. 그러나 SSL이 예상치 못한 방식으로 작동할 때 이 메시지가 유용할 수 있습니다. |
sslRef | 최상위 레벨 ssl 요소에 대한 참조입니다(문자열). | 기본 SSL 구성 레퍼토리입니다. 기본값은 defaultSSLSettings입니다. | |
sslSessionTimeout | 밀리초 정밀도를 사용하는 기간 | 8640ms | SSL 채널을 통해 설정되는 SSL 세션의 제한시간 한계입니다. 시간 단위가 뒤따르는 양수를 지정하십시오. 이는 시간(h), 분(m), 초(s) 또는 밀리초(ms)일 수 있습니다. 예를 들어, 500밀리초를 500ms로 지정하십시오. 하나의 항목에 여러 값을 포함할 수 있습니다. 예를 들어, 1s500ms는 1.5초와 동등합니다. |
엔드포인트에 대한 TCP 프로토콜 옵션입니다.
Name | Type | Default | Description |
---|---|---|---|
inactivityTimeout | 밀리초 정밀도를 사용하는 기간 | 60s | 소켓에서 읽기 또는 쓰기 요청이 완료되기를 기다리는 시간입니다. 이 값은 프로토콜별 제한시간으로 대체됩니다. 시간 단위가 뒤따르는 양수를 지정하십시오. 이는 시간(h), 분(m), 초(s) 또는 밀리초(ms)일 수 있습니다. 예를 들어, 500밀리초를 500ms로 지정하십시오. 하나의 항목에 여러 값을 포함할 수 있습니다. 예를 들어, 1s500ms는 1.5초와 동등합니다. |
soReuseAddr | boolean | true | 활성 리스너 없이 포트에 대한 즉각적 리바인드를 사용합니다. |
addressIncludeList | string | 이 엔드포인트에서 인바운드 연결을 허용하는 쉼표로 구분된 주소 목록입니다. IPv4 또는 IPv6 주소를 지정할 수 있습니다. IPv4 또는 IPv6 주소의 모든 값은 숫자 또는 별표(*) 와일드카드 문자로 나타내야 합니다. | |
addressExcludeList | string | 이 엔드포인트에서 인바운드 연결을 허용하지 않는 쉼표로 구분된 주소 목록입니다. IPv4 또는 IPv6 주소를 지정할 수 있습니다. IPv4 또는 IPv6 주소의 모든 값은 숫자 또는 별표(*) 와일드카드 문자로 나타내야 합니다. | |
hostNameIncludeList | string | 이 엔드포인트에서 인바운드 연결을 허용하는 쉼표로 구분된 호스트 이름 목록입니다. 호스트 이름은 대소문자를 구분하지 않고 와일드카드 문자로 사용되는 별표(*)로 시작될 수 있습니다. 그러나 별표(*)는 호스트 이름의 다른 위치에 올 수 없습니다. 예를 들어, *.abc.com은 유효하지만 *.abc.*는 유효하지 않습니다. | |
hostNameExcludeList | string | 이 엔드포인트에서 인바운드 연결을 허용하지 않는 쉼표로 구분된 호스트 이름 목록입니다. 호스트 이름은 대소문자를 구분하지 않고 와일드카드 문자로 사용되는 별표(*)로 시작될 수 있습니다. 그러나 별표(*)는 호스트 이름의 다른 위치에 올 수 없습니다. 예를 들어, *.abc.com은 유효하지만 *.abc.*는 유효하지 않습니다. |
엔드포인트에 대한 HTTP 액세스 로깅 구성입니다.
Name | Type | Default | Description |
---|---|---|---|
enabled | boolean | true | 액세스 로깅을 사용합니다. |
filePath | 파일에 대한 경로 | ${server.output.dir}/logs/http_access.log | 액세스 로그 파일의 이름 및 디렉토리 경로입니다. 디렉토리 경로를 지정할 때 ${server.output.dir} 같은 표준 변수 대체를 사용할 수 있습니다. |
logFormat | string | %h %u %{t}W "%r" %s %b | 클라이언트 액세스 정보를 로깅할 때 사용하는 로그 형식을 지정합니다. |
maxFileSize | int Min: 0 | 20 | 로그 파일이 롤오버되기 전에 MB 단위의 최대 크기입니다. 값 0은 무제한을 의미합니다. |
maxFiles | int Min: 0 | 2 | 가장 오래된 파일이 제거되기 전에 유지될 최대 로그 파일 수입니다. 값 0은 무제한을 의미합니다. |
생성된 플러그인 구성 파일의 구성 요소에 추가될 추가 특성입니다. IBM 지원 센터에서 이 특성을 지정하여 웹 서버 플러그인의 작동을 수정할 수 있습니다.