WebLogic Plugin Parameter 모음

참고)

https://velog.io/@kimsw3445/modwl-parameter

---

WLIOTimeoutSec(HungServerRecoverSecs)

• Default : 300
• 플러그인이 weblogic 응답을 기다리는 시간. 너무 적을경우 정상적으로 연동이 되지 않을 수 있습니다. 최소 10
• OHS,iPlanet,Apache,IIS

WebLogicCluster

• Default : none
• 부하분산시 사용하는 서버 목록. non cluster 서버와 cluster 서버를 같이 올렸을때, cluster 서버만 지원. SSL 사용시 SSL 포트를 기재 후, SecurityProxy 를 On으로 설정플러그인이 모든 서버에 라운드로빈 작업, 서버의 상태들을 모니터링DynamicServerList 를 OFF 하여 클러스터 목록을 모니터링하지 않을 수 있다.
• OHS,iPlanet,Apache,IIS

WebLogicHost

• Default : none
• HTTP 통신을 보낼 Host
• OHS,iPlanet,Apache,IIS

WebLogicPort

• Default : none
• HTTP 통신을 보낼 Port
• OHS,iPlanet,Apache,IIS

WLCookieName  

• Default : JSESSIONID
• weblogic.xml 의 session_cookie_name 변경시 같이 변경
• OHS,iPlanet,Apache,IIS
• 해당 옵션과 weblogic.xml 의 session_cookie_name이 다른 경우 세션이 유지되지 않음

ConnectRetrySecs

• Default : 2
• Host에 연결시도 사이의 간격. ConnectionTimeoutSecs 보다 작게 설정하여야 한다. 503 error 전 시도횟수는 ConnectionTimeoutSecs/ConnectionRetrySecs연결 재시도를 원하지 않는다면 같게 설정하면 된다. 하지만 총 2번의 연결시도를 하게된다.
• OHS,iPlanet,Apache,IIS

ConnectTimeoutSecs

• Default : 10
• WLS 에 접근하기 위한 Timeout. 실패시 503/Service UnavaliableErrorPage 지정자를 통해 지정가능
• OHS,iPlanet,Apache,IIS

Debug(DEPRECATED)

• Default : OFF
• 디버깅 유형 지정.(ON/OFF/HFC/HTW/HFW/HTC/ERR/ALL)
• IIS

DebugConfigInfo

• Default : OFF
• _WeblogicBridgeConfig 설정 활성화
• OHS,iPlanet,Apache,IIS

DefaultFileName

• Default : none
• 특정 URI로 들어갔을때, plugin은 다음 동작을 수행합니다.Apache Stronghold 버젼 또는 Raven 버젼 사용시, IfModule 이 아닌 Location에 위치
• • PathTrim 에 지정된 값으로 경로를 Trim.
  • DeaultFileName 값을 추가
• OHS,iPlanet,Apache,IIS

DynamicServerList

• Default : ON
• OFF 일때 WeblogicCluster 매개변수로 지정된 목록만 사용. OFF일때, 특정 서버가 끊겼을때, 그 서버로 들어가려는 낭비를 하게 됩니다. 클러스터에 새 서버 추가시, 이 옵션을 재정의해야합니다.
• OHS,iPlanet,Apache,IIS
• 이 옵션은 보통 OFF로 해둔다.

ErrorPagenone

• 503/Service Unvaliable 메세지 대신, 해당 페이지를 보여줍니다.
• OHS,iPlanet,Apache,IIS

FileCaching

• Default : ON
• ON 일때, POST 데이터가 2048 byte 이상일때, File을 임시로 읽고 8192 byte의 청크로 보내게 된다. 장애조치중 POST 데이터가 유지됨. OFF일 경우, 클러스터 멤버가 식별될때까지 데이터 읽기가 연기
• max_post_size는 tomcat은 2mb이나, wls는 4mb이다.
  임시 데이터는 보통 /tmp/_wl_proxy 안에 저장된다.
• 이 옵션은 프로세스를 올리는 계정에 따라 변동 될 수 있음. 만약 디렉토리 소유 계정과 프로세스를 기동한 계정에 차이가 있는 경우, 해당 경로를 참조할 수 없게되어 서비스에 문제가 발생할 수 있다.
• OHS,iPlanet,Apache,IIS

Idempotent

• Default : ON
• Server가 응답하지 않고, method가 멱등적이면 failover 한다. READ_ERROR_FROM_SERVER 경우에도 failover 한다.
• OHS,iPlanet,Apache,IIS

KeepAliveEnabled

• Default : true(IIS)/ON(OHS,Apache,iPlanet)
• plugin 과 weblogic 간 pooling 을 지원합니다.
• prefork mpm 사용시에 OFF 해야합니다.
• OHS,iPlanet,Apache,IIS

KeepAliveSecs

• Default : 20
• plugin, wls 간 pooling 이 끊기는 시간
• OHS,iPlanet,Apache,IIS

MatchExpression

• Default : none
• 기존 매개변수값 수정, 새 매개변수값 추가 * 와 ? 를 통한 정규식을 지원
• MatchExpression <file_extension> <param=value> |<param=value> | …
  MatchExpression <path> <param=value>|<param=value>|…
• 이 옵션은 <IfModule weblogic_module> 태그 내부에만 작성해야한다.
• OHS,Apache

MaxPostSize

• Default : -1
• Post data의 최대 size -1이면 체크하지 않음
• OHS,iPlanet,Apache,IIS

MaxSkipTime

• Default : 10
• WLS 에 접속이 실패할 경우, 다음 서버로 시도하기 까지의 시간
• OHS,iPlanet,Apache,IIS

PathPrepend

• Default : null
• [PROTOCOL]://[HOSTNAME]:{PORT}/{PATH}/{FILENAME};{PATH_PARAMS}/{QUERY_STRING}...위와 같은 구조로 RFC 표준 URL이 구성되어있다. plugin이 PathTrim 으로 잘린 후, 요청의 PATH 에 값을 추가하기 위해 사용DefaultFileName 과 잘 구분하여 사용하자.
• OHS,iPlanet,Apache,IIS

PathTrim

• Default : null
• PathTrim /weblogic 이라고 설정된 경우 http://[HOST]/weblogic/foo => http://[HOST]/foo 의 URI로 weblogic에 요청한다.
• OHS,iPlanet,Apache,IIS

QueryFromRequest

• Default : OFF
• OFF 일때는 (request_rec *)r->args ON 일떄는 (request_rec *)r->the_request로 weblogic에 쿼리를 전달한다
• OHS,Apache

WLDNSRefreshInterval

• Default : 0
• DNS 이름과 IP mapping을 고치는 간격0이면 시작시 한 번만 확인합니다.
• OHS,iPlanet,Apache

WLExcludePathOrMimeType

• Default : none
• proxy 에서 특정 요청을 제외 가능. Global 뿐 아니라 Local 태그 안에서도 적용 가능이때 override 하지않고 결합하여 적용된다
• OHS,iPlanet,Apache,IIS

WLFlushChunks

• Default : False
• False. 청크 전송 인코딩 응답을 버퍼링.
• True. 청크를 수신하는 즉시 Flush
• IIS

WLForwardUriUnparsed

• Default : OFF
• ON 이면 원래 URI 를 WLS 에 그대로 송신합니다. OFF 일때는 다른 web module(mod_write 와 같은)에 의해 수정됩니다.
• OHS,Apache

WLLocalIP

• Default : none
• 다중 홈시스템의 WLS 에 접근시 사용.
• OHS,iPlanet,Apache,IIS

WLLogFile(DEPRECATED)

• DEBUG 를 통해 생성되는 로그파일 이름 및 경로IIS

WLProxyPassThrough

• Default : OFF
• proxy plugin 사용시 다른 proxy loadbalancer 이용시 ON으로 설정.헤더가 proxy chain을 통과가능.
• OHS,iPlanet,Apache,IIS

WLProxySSL

• Default : OFF
• • HTTP client 가 HTTPS 를 요청할때
  • request 가 proxy 서버를 통해 요청할때
  • plugin 과 WLS 가 HTTP로 통신할때
• 위 조건들을 모두 충족하는 상황일때 ON으로 바꿔주어야한다.
• OHS,iPlanet,Apache,IIS

WLProxySSLPassThrough

• Default : OFF
• 웹서버 앞 제품이 loadbalancer 또는 SSL종단일시, SSL 사용이 WLS 에 전달되게 하는 것. 웹서버가 종단이거나, WL_PROXY_SSL 이 아닌경우, 기본값을 OFF로 설정
• OHS,iPlanet,Apache,IIS

WLRetryAfterDroppedConnection

• Default : ALL
• WLS 와의 연결이 끊겼을때, 재시작 할 Apache plugin을 알려준다.
• • ALL : 모든 request 재시도
  • IDEMPOTENT : idempotent method 만 재시도
  • NONE : 재시도 하지 않음
• OHS,iPlanet,Apache,IIS

WLSendHdrSeparately

• Default : ON
• ON 일때 header 와 본문이 별도로 전송된다. 다른 ISAPI 필터 또는 프로그래밍 클라이언트가 있는 경우 사용
• IIS

WLServerInitiatedFailover

• Default : ON
• 503 에러 수신시, 다른 서버로 응답을 트리거 합니다. OFF일시 바로 503 에러를 띄웁니다.
• OHS,iPlanet,Apache,IIS

WLSocketTimeoutSecs

• Default : 2(0 초과)
• 소켓의 Timeout 설정ConnectTimeoutSecs 과 ConnectRetrySecs 참고
• OHS,iPlanet,Apache,IIS

WLSRequest

• Default : OFF
  WLSRequest ON 메커니즘의 대체.SetHandler 에 비해 아래와 같은 장점이 있다.
• • web server overhead 감소
  • web server DocumentRoot 가 느린 FileSystem 에 존재시 성능개선
  • FileSystem 길이 제한으로 인한 403 에러 개선
• OHS,Apache

WLTempDir

• post type 의 wl_proxy 위치를 지정IIS 경우 wlproxy.log 위치를 지정
• OHS,iPlanet,Apache,IIS