[WEB-WAS] mod_wl conf 속성 값 정리

 

 

1.WebLogicCluster
Default 값:X
대상: Oracle HTTP Server, Apache HTTP Server, Microsoft IIS
WebLogic Server 클러스터 또는 여러 서버에 프록시 할 때 필요함
클러스터 된 백엔드 서버 목록을 프록시하거나 클러스터되지 않은 Managed Server 인스턴스간 로드 밸런싱을 수행하는 데 필요.

로드 밸런싱에 사용할 수 있는 WebLogic Server 목록이고 서버 또는 클러스터 목록은 host:port 형식으로 작성해야 함
만약 클러스터들과 단일 서버들을 섞어서 지정하는 경우 클러스터 서버만 리턴 함
 
 
2.WLCookieName:
Default 값: JSESSIONID
대상: Oracle HTTP Server, Apache HTTP Server, Microsoft IIS
WebLogic Server 웹 애플리케이션의 session cookie 이름을 변경할 때 사용
이 때 플러그인의 WLCookieName을 동일한 값으로 설정하고,  WebLogic 세션 쿠키의 이름은 WebLogic의 weblogic.xml의 <session-descriptor> elements에 설정
 
 
3.SetHandler weblogic-handler:
SetHandler 파라미터는 Apache HTTP Server 플러그인 모듈의 handler를 지정
 
4.WLExcludePathOrMimeType:
Default 값: X
대상: Oracle HTTP Server, Apache HTTP Server, Microsoft IIS
이 파라미터를 사용하면 특정 요청을 프록시에서 제외할 수 있음
이 파라미터는 태그 level에서 로컬이나 전역적으로 정의 할 수 있음
속성이 로컬로 정의되면 전역 속성을 재정의하지 않고 두 파라미터의 합을 정의 함
 
 
5.ConnectRetrySecs:
Default 값:2(초)
대상: Oracle HTTP Server, Apache HTTP Server, Microsoft IIS
WebLogic Server 호스트에 연결을 시도하는 사이 플러그인이 sleep하는 간격
이 값은 ConnectTimeoutSecs 값보다 낮아야 함
HTTP 503/Service Unavailable 응답을 클라이언트에 반환하기 전에 플러그인이 연결을 시도하는 횟수는 ConnectTimeOutSecs를 ConnectRetrySecs로 나누어 계산 함
재시도를 하지 않으려면 ConnectRetrySecs 와 ConnectTimeoutSecs의 값을 동일하게 설정해야 함
하지만, 플러그인은 적어도 두 번은 연결을 시도함
ErrorPage 파라미터로 에러 시 응답을 설정할 수 있음
 
 
6.ConnectTimeoutSecs:
Default 값:10(초)
대상: Oracle HTTP Server, Apache HTTP Server, Microsoft IIS
플러그인이 WebLogic Server 호스트에 연결을 시도해야 하는 최대 시간
이 값은 ConnectRetrySecs 값보다 커야 하며 ConnectTimeOutSecs가 적절한 재시도 후에도 연결을 성공하지 못하고 만료되면 HTTP 503/Service Unavailable 응답이 클라이언트에 전송됨
ErrorPage 파라미터로 에러 시 응답을 설정할 수 있음
 
재시도 횟수 = ConnectTimeoutSecs / ConnectRetrySecs 
 
 
7.Idempotent:
Default 값:ON
대상: Oracle HTTP Server, Apache HTTP Server, Microsoft IIS
WebLogic Server로 request를 전송하다가 에러가 나거나 서버로부터 결과를 기다리다가 WLIOTimeoutSecs 시간이 초과되어서 에러가 났을 경우 다시 요청을 보낼 것인가를 설정.
즉 서버와 연결은 되었는데 그 이후에 에러가 났을 때 ON으로 설정되어 있으면 다시 연결을 시도하고 요청을 보내게 됨
재시도 횟수는 ConnectRetrySecs 와 CoonectTimeoutSecs에 의해 적용
 
 
8.DynamicServerList:
Default 값:ON
대상: Oracle HTTP Server, Apache HTTP Server, Microsoft IIS
설정이 OFF면 플러그인은 플러그인에서 프록시 된 로드 밸런싱 요청에 사용되는 동적 클러스터 목록을 무시하고,
WebLogicCluster 파라미터에 지정된 정적 목록만을 사용. 보통 이 값은 ON으로 설정
 
설정이 OFF일 때 주의사항
정적 목록에 있는 하나 이상의 서버가 실패하면 플러그인이 종료 된 서버에 연결하는 데 시간을 낭비하여 성능이 저하될 수 있음.

클러스터에 새 서버를 추가하는 경우 파라미터를 다시 정의하지 않는 한 플러그인은 새 서버에 대한 요청을 프록 할 수 없음
WebLogic Server는 새 서버가 클러스터의 일부가 되면 자동으로 동적 서버 목록에 추가
 
 
9.FileCaching:
Default 값:ON
대상: Oracle HTTP Server, Apache HTTP Server, Microsoft IIS
설정이 ON이고 POST 데이터 리퀘스트가 2048 bytes보다 큰 경우, POST 데이터는 먼저 디스크의 임시 파일로 읽혀진 다음 8192 bytes 단위로 WebLogic Server에 전달됨
이렇게 하면 failover 중에 POST 데이터가 보존되므로 기본 데이터가 중단 된 경우 필요한 모든 데이터가 보조 데이터로 repeat
 
설정이 OFF이고 POST 데이터 리퀘스트가 2048 bytes보다 큰 경우, POST 데이터 reading은 WebLogic Server 클러스터 구성원이 식별 될 때까지 요청이 연기
그런 다음 플러그인은 POST 데이터를 읽고 즉시 8192 bytes 단위로 WebLogic Server에 전송 함
 
설정이 OFF이면 failover가 제한됩니다. Request를 처리하는 동안 WebLogic Server 주 서버가 다운되면, 이미 주 서버로 전송된 POST 데이터를 보조 서버로 repeat 할 수 없음
마지막으로, FileCashing 설정에 상관없이, POST 데이터 크기가 2048 bytes 이하인 경우는 플러그인은 데이터를 메모리로 읽어 들이고 필요한 경우 이를 사용하여 보조 데이터로 repeat 
 
 
10.WLIOTimeoutSecs:
Default 값:120(초)
최소 값:10(초)
최대 값:2147483647(초)
대상: Oracle HTTP Server, Apache HTTP Server, Microsoft IIS
HungServerRecoverSecs의 새 이름
플러그인이 WebLogic Server의 요청에 대한 응답을 기다리는 시간을 정의
플러그인은 서버가 응답할 때까지 WLIOTimeoutSecs를 기다린 후 해당 서버가 작동하지 않음을 선언하고 다음 서버로 failover됨
이 값을 큰 값으로 설정해야 합니다. 값이 서블릿이 프로세스를 처리하는 데 걸리는 시간보다 작으면 예기치 않은 결과가 나타날 수 있음
 
 
11.KeepAliveEnabled:
Default 값:true(Microsoft IIS plug-in), ON(Oracle HTTP Server and Apache HTTP Server)
대상: Oracle HTTP Server, Apache HTTP Server, Microsoft IIS
플러그인과 WebLogic Server 사이의 connection pooling을 활성화
 
Microsoft IIS plug-in 유효값: true and fals
Apache HTTP Server 유효값: ON and OFF
 
Apache prefork mpm을 사용하는 동안 Apache Web Server가 실패할 수 있음
Apache prefork mpm을 사용하거나 worker mpm을 사용하는 경우 KeepAliveEnabled를 OFF로 설정