웹 서버 플러그인 (pluginConfiguration)
웹 서버 플러그인 구성 파일을 생성할 때 사용되는 특성
속성 이름 | 데이터 유형 | 기본값 | 설명 |
---|---|---|---|
connectTimeout | 초 정밀도를 사용하는 기간 | 5s | 애플리케이션 서버가 웹 서버와의 연결을 유지해야 하는 최대 시간을 식별합니다. 시간 단위가 뒤따르는 양수를 지정하십시오. 이는 시간(h), 분(m) 또는 초(s)일 수 있습니다. 예를 들어, 30초를 30s로 지정하십시오. 하나의 항목에 여러 값을 포함할 수 있습니다. 예를 들어, 1m30s는 90초와 동등합니다. |
extendedHandshake | boolean | false | true이면 웹 서버 플러그인이 확장된 핸드쉐이크를 사용하여 애플리케이션 서버가 실행 중인지를 판별합니다. |
httpEndpointRef | 최상위 레벨 httpEndpoint 요소에 대한 참조입니다(문자열). | defaultHttpEndpoint | 생성된 plugin-cfg.xml 파일에 포함되는 http 엔드포인트의 ID를 지정하십시오. 엔드포인트가 클러스터에서 서버를 정의합니다. 기본값은 'defaultHttpEndpoint'입니다. |
ipv6Preferred | boolean | false | 가능하면 이 주소 유형을 권장하기 위해 {null} 또는 {0}의 애플리케이션 서버 호스트 이름을 분석할 때 사용됨 |
loadBalanceWeight | int | 20 | %plugin.loadBalanceWeight.desc |
logDirLocation | 디렉토리에 대한 경로 | ${pluginInstallRoot}/logs/${webserverName} | 더 이상 사용되지 않음: http_plugin.log 파일이 있는 디렉토리를 식별합니다. 로그 파일 이름을 확인하십시오. |
logFileName | 파일에 대한 경로 | 웹 서버 플러그인 로그 파일에 대한 완전한 경로입니다. 디렉토리 컴포넌트는 이미 존재해야 합니다. Apache 기반 웹 서버의 경우, 파이프 문자로 시작하는 경로는 외부 파이프 로거로서 해석됩니다. 지정된 경우, 경로는 logDirLocation을 대체합니다. | |
pluginInstallRoot | string | /opt/IBM/WebSphere/Plugins | 웹 서버 호스트의 파일 시스템에서 웹 서버 플러그인 설치 위치 |
serverIOTimeout | 초 정밀도를 사용하는 기간 | 900s | 웹 서버 플러그인이 요청을 보내거나 애플리케이션 서버에서 응답을 받을 때까지 대기하는 최대 시간을 식별합니다. 시간 단위가 뒤따르는 양수를 지정하십시오. 이는 시간(h), 분(m) 또는 초(s)일 수 있습니다. 예를 들어, 30초를 30s로 지정하십시오. 하나의 항목에 여러 값을 포함할 수 있습니다. 예를 들어, 1m30s는 90초와 동등합니다. |
serverIOTimeoutRetry | int
최소값: -1 최대값: 65535 |
-1 | 읽기 또는 쓰기 제한시간 초과 이후 요청 재시도의 횟수를 제한합니다. 기본값 {-1}은 추가 제한을 적용하지 않습니다. 따라서 재시도는 클러스터에서 사용 가능한 서버의 수에 의해 제한됩니다. {0} 값은 재시도가 없어야 함을 표시합니다. 이 값의 범위는 서버 클러스터로 한정되며, HTTP 플러그인 연결 제한시간이나 웹 소켓 제한시간으로 인한 제한시간 초과 또는 연결 실패에는 적용되지 않습니다. |
serverRole |
|
PRIMARY | %plugin.serverRole.desc
|
sslCertlabel | string | 웹 컨테이너가 플러그인에서 클라이언트 인증서를 요청할 때 플러그인이 사용할 키 링 내 인증서의 레이블을 지정합니다. | |
sslKeyringLocation | string | ${pluginInstallRoot}/config/${webserverName}/plugin-key.kdb | 웹 서버 호스트의 SSL 키 링 파일에 대한 완전한 경로 |
sslStashfileLocation | string | ${pluginInstallRoot}/config/${webserverName}/plugin-key.sth | 웹 서버 호스트의 SSL 숨김 파일에 대한 완전한 경로 |
waitForContinue | boolean | false | false(기본값)이면 웹 서버 플러그인이 메시지 본문이 있는 HTTP 요청에서 "Expect: 100-continue" 헤더를 보냅니다. true로 설정되면 웹 서버 플러그인이 모든 HTTP 요청에서 "Expect: 100-continue" 헤더를 보냅니다. 웹 서버와 애플리케이션 서버 사이에 방화벽이 있거나 요청 본문이 없는 요청 재시도에 민감한 경우 이 값을 true로 설정할 것을 고려하십시오. |
webserverName | string | webserver1 | 이 구성이 사용될 웹 서버의 이름입니다. 로그 파일 이름 또는 디렉토리에 의해 명시적으로 지정되지 않은 경우, 플러그인 로그 파일 위치를 생성하는 데 사용됩니다. |
webserverPort | int
최소값: -1 최대값: 65535 |
80 | 웹 서버 HTTP 포트 |
webserverSecurePort | int
최소값: -1 최대값: 65535 |
443 | 웹 서버 HTTPS 포트 |
wsServerIOTimeout | 초 정밀도를 사용하는 기간 | 웹 서버 플러그인이 요청을 보내거나 애플리케이션 서버에서 websocket 응답을 받을 때까지 대기하는 최대 시간을 식별합니다. 시간 단위가 뒤따르는 양수를 지정하십시오. 이는 시간(h), 분(m) 또는 초(s)일 수 있습니다. 예를 들어, 30초를 30s로 지정하십시오. 하나의 항목에 여러 값을 포함할 수 있습니다. 예를 들어, 1m30s는 90초와 동등합니다. | |
wsServerIdleTimeout | 초 정밀도를 사용하는 기간 | 웹 서버 플러그인이 유휴 websocket 연결을 종료할 때까지 대기하는 최대 시간을 식별합니다. 시간 단위가 뒤따르는 양수를 지정하십시오. 이는 시간(h), 분(m) 또는 초(s)일 수 있습니다. 예를 들어, 30초를 30s로 지정하십시오. 하나의 항목에 여러 값을 포함할 수 있습니다. 예를 들어, 1m30s는 90초와 동등합니다. |
- extraConfigProperties
설명: 생성된 플러그인 구성 파일의 구성 요소에 추가될 추가 특성입니다. IBM 지원 센터에서 이 특성을 지정하여 웹 서버 플러그인의 작동을 수정할 수 있습니다.필수: false데이터 유형:
- httpEndpoint
설명: 생성된 plugin-cfg.xml 파일에 포함되는 http 엔드포인트의 ID를 지정하십시오. 엔드포인트가 클러스터에서 서버를 정의합니다. 기본값은 'defaultHttpEndpoint'입니다.필수: false데이터 유형: 속성 이름 데이터 유형 기본값 설명 accessLoggingRef 최상위 레벨 httpAccessLogging 요소에 대한 참조입니다(문자열). 엔드포인트에 대한 HTTP 액세스 로깅 구성입니다. enabled boolean true 엔드포인트의 가용성을 토글하십시오. True일 때는 이 엔드포인트가 디스패처에 의해 활성화되어 HTTP 요청을 처리합니다. host string localhost 클라이언트가 자원을 요청하는 데 사용하는 IP 주소, 도메인 이름 접미부를 갖는 도메인 이름 서버(DNS) 호스트 이름 또는 DNS 호스트 이름만입니다. 모든 사용 가능한 네트워크 인터페이스에 대해서는 '*'를 사용하십시오. httpOptionsRef 최상위 레벨 httpOptions 요소에 대한 참조입니다(문자열). defaultHttpOptions 엔드포인트에 대한 HTTP 프로토콜 옵션입니다. httpPort int 최소값: -1
최대값: 65535
클라이언트 HTTP 요청에 사용되는 포트입니다. 이 포트를 사용 안 하려면 -1을 사용하십시오. httpsPort int 최소값: -1
최대값: 65535
SSL(https)로 보안되는 클라이언트 HTTP 요청에 사용되는 포트입니다. 이 포트를 사용 안 하려면 -1을 사용하십시오. onError - IGNORE
- FAIL
- WARN
WARN 엔드포인트 시작에 실패한 후 수행하는 조치입니다. - IGNORE
- 구성 오류가 발생한 경우 서버가 경고 및 오류 메시지를 발행하지 않습니다.
- FAIL
- 첫 번째 오류가 발생한 경우 서버는 경고 또는 오류 메시지를 발행하고 서버를 중지시킵니다.
- WARN
- 구성 오류가 발생한 경우 서버는 경고 및 오류 메시지를 발행합니다.
sslOptionsRef 최상위 레벨 sslOptions 요소에 대한 참조입니다(문자열). 엔드포인트에 대한 SSL 프로토콜 옵션입니다. tcpOptionsRef 최상위 레벨 tcpOptions 요소에 대한 참조입니다(문자열). defaultTCPOptions 엔드포인트에 대한 TCP 프로토콜 옵션입니다. - httpEndpoint > accessLogging
설명: 엔드포인트에 대한 HTTP 액세스 로깅 구성입니다.필수: false데이터 유형: 속성 이름 데이터 유형 기본값 설명 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 최소값: 0
20 로그 파일이 롤오버되기 전에 MB 단위의 최대 크기입니다. 값 0은 무제한을 의미합니다. maxFiles int 최소값: 0
2 가장 오래된 파일이 제거되기 전에 유지될 최대 로그 파일 수입니다. 값 0은 무제한을 의미합니다.
- httpEndpoint > httpOptions
설명: 엔드포인트에 대한 HTTP 프로토콜 옵션입니다.필수: false데이터 유형: 속성 이름 데이터 유형 기본값 설명 keepAliveEnabled boolean true 지속적 연결을 사용합니다(HTTP KeepAlive). True인 경우 연결은 다중 순차 요청 및 응답이 재사용하도록 유지됩니다. False인 경우 연결은 응답이 전송된 후에 닫힙니다. maxKeepAliveRequests int 최소값: -1
100 지속적 연결이 사용 가능한 경우 단일 HTTP 연결에서 허용되는 최대 지속적 요청 수입니다. -1의 값은 무제한을 의미합니다. persistTimeout 초 정밀도를 사용하는 기간 30s 소켓이 요청 사이에 유휴 상태로 남도록 허용되는 시간입니다. 이 설정은 지속적 연결이 사용 가능한 경우에만 적용됩니다. 시간 단위가 뒤따르는 양수를 지정하십시오. 이는 시간(h), 분(m) 또는 초(s)일 수 있습니다. 예를 들어, 30초를 30s로 지정하십시오. 하나의 항목에 여러 값을 포함할 수 있습니다. 예를 들어, 1m30s는 90초와 동등합니다. readTimeout 초 정밀도를 사용하는 기간 60s 읽기 요청이 첫 번째 읽기가 발생한 후 소켓에서 완료하기를 대기하는 시간입니다. 시간 단위가 뒤따르는 양수를 지정하십시오. 이는 시간(h), 분(m) 또는 초(s)일 수 있습니다. 예를 들어, 30초를 30s로 지정하십시오. 하나의 항목에 여러 값을 포함할 수 있습니다. 예를 들어, 1m30s는 90초와 동등합니다. removeServerHeader boolean false HTTP 헤더에서 서버 구현 정보를 제거하고 기본 Liberty 프로파일 환영 페이지도 사용하지 않도록 설정하십시오. writeTimeout 초 정밀도를 사용하는 기간 60s 응답 데이터의 각 부분이 전송되기를 소켓에서 대기하는 시간입니다. 시간 단위가 뒤따르는 양수를 지정하십시오. 이는 시간(h), 분(m) 또는 초(s)일 수 있습니다. 예를 들어, 30초를 30s로 지정하십시오. 하나의 항목에 여러 값을 포함할 수 있습니다. 예를 들어, 1m30s는 90초와 동등합니다.
- httpEndpoint > sslOptions
설명: 엔드포인트에 대한 SSL 프로토콜 옵션입니다.필수: false데이터 유형: 속성 이름 데이터 유형 기본값 설명 sessionTimeout 초 정밀도를 사용하는 기간 1d 소켓에서 읽기 또는 쓰기 요청이 완료되기를 기다리는 시간입니다. 이 값은 프로토콜별 제한시간으로 대체됩니다. 시간 단위가 뒤따르는 양수를 지정하십시오. 이는 시간(h), 분(m) 또는 초(s)일 수 있습니다. 예를 들어, 30초를 30s로 지정하십시오. 하나의 항목에 여러 값을 포함할 수 있습니다. 예를 들어, 1m30s는 90초와 동등합니다. sslRef 최상위 레벨 ssl 요소에 대한 참조입니다(문자열). 기본 SSL 구성 레퍼토리입니다. 기본값은 defaultSSLSettings입니다. sslSessionTimeout 밀리초 정밀도를 사용하는 기간 8640ms %ssl.sslSessionTimeout.desc. 시간 단위가 뒤따르는 양수를 지정하십시오. 이는 시간(h), 분(m), 초(s) 또는 밀리초(ms)일 수 있습니다. 예를 들어, 500밀리초를 500ms로 지정하십시오. 하나의 항목에 여러 값을 포함할 수 있습니다. 예를 들어, 1s500ms는 1.5초와 동등합니다. suppressHandshakeErrors boolean false SSL 핸드쉐이크 오류 로깅을 사용하지 않습니다. 일반 조작 중에 SSL 핸드쉐이크 오류가 발생할 수 있습니다. 그러나 SSL이 예상치 못한 방식으로 작동할 때 이 메시지가 유용할 수 있습니다.
- httpEndpoint > tcpOptions
설명: 엔드포인트에 대한 TCP 프로토콜 옵션입니다.필수: false데이터 유형: 속성 이름 데이터 유형 기본값 설명 inactivityTimeout 밀리초 정밀도를 사용하는 기간 60s 소켓에서 읽기 또는 쓰기 요청이 완료되기를 기다리는 시간입니다. 이 값은 프로토콜별 제한시간으로 대체됩니다. 시간 단위가 뒤따르는 양수를 지정하십시오. 이는 시간(h), 분(m), 초(s) 또는 밀리초(ms)일 수 있습니다. 예를 들어, 500밀리초를 500ms로 지정하십시오. 하나의 항목에 여러 값을 포함할 수 있습니다. 예를 들어, 1s500ms는 1.5초와 동등합니다. soReuseAddr boolean true 활성 리스너 없이 포트에 대한 즉각적 리바인드를 사용합니다.