WebLogic Plugin parameter

## WLS Plug-in Parameter에 대한 설명

WebLogicHost : WLS Listen Address

WebLogicPort : WLS Listen Port

WebLogicCluster : WLS의 여러 인스턴스로 load balancing을 할 때 사용하며 여러 인스턴스를 콤마를 사용해서 구분한다.

 

 

PathTrim : URL에 설정한 값을 추가하여 찾게 된다.

- 예를 들어 PathTrim 값을 /aaa 으로 설정하였다.

- WLS로 접근 가능한 URL => http://localhost:7001/test/index.jsp

- 웹서버로 접근 가능한 URL => http://localhost/aaa/test/index.jsp

- 즉 설정된 PathTrim값이 URL에 추가된다.

PathPrepend : URL에 설정한 값을 제거하고 찾게 된다. PathTrim과 반대되는 개념으로 생각하면 된다.

- 예를 들어 PathPrepend 값을 /test 로 설정하였다.

- WLS로 접근 가능한 URL => http://localhost:7001/test/index.jsp

- 웹서버로 접근 가능한 URL => http://localhost/index.jsp

ConnectTimeoutSecs : WLS에 Connection을 시도하는 시간 

- Defalut => 10초

- ConnectTimeoutSecs에 설정된 시간동안 WLS와 연결이 되지 않으면

  "HTTP 503/Service Unavailable" 메시지를 보여주게 된다.

- WLS와 연결하기 위한 Total Time으로 생각하면 된다.

- ConnectRetrySecs 보다 큰 값을 설정해야 한다.

ConnectRetrySecs : WLS와 Connection이 실패했을 때 Connection을 재시도 하기 전에 대기하는 시간

- Default => 2초

WLSocketTimeoutSecs : WLS서버 하나에 대해 연결을 시도하는 timeout 값

- Default => 2 (0보다는 커야 한다)

WLIOTimeoutSecs (HungServerRecoverSecs) : 한번의 읽기/쓰기 동작에 대한 timeout 시간

- Default => 300

- Minimum => 10 & Maximum => Unlimited

- WLS로 request를 보내고 response를 받기 위해 대기하는 시간

- post 방식으로 대량의 데이터를 WLS로 보낼 때 timeout이 발생하면 plug-in에  “POST_TIMEOUT” 에러가 발생

- Transaction time < JTA timeout < WLIOTimeoutSecs 로 설정이 필요

Idempotent : WLS로부터 WLIOTimeoutSecs시간동안 응답이 없을 경우 다른 WLS 서버에 요청을 보낼것인지 결정한다.

- Default => ON

- 특별한 경우가 아니면 “OFF”로 설정하여 사용하는 것을 권장함

KeepAliveSecs : KeepAliveEnabled값이 true일 경우 얼마 동안 연결을 유지할 것인지 설정한다.

- firewall의 idle timeout보다 플러그인의 KeepAliveSecs 시간을 짧게 주도록 한다.

- Default => 20초

- Apache 1.3.x에서는 지원이 되지 않습니다.

KeepAliveEnabled : Plug-in과 WLS의 연결을 지속할 것인지 여부를 결정

- client request를 처리한 후 WLS와의 연결을 닫아버릴 것인지 연결된 상태로 두었다가 다음 요청이 들어왔을 때 재사용할 것인지 설정

- 이 기능을 true로 설정하였을 경우 WLS의 KeepAlive 설정도 enable시켜주어야 하며 plug-in에서 지정한 시간보다 같거나 조금 길게 주도록 한다.

- Default => true(Netscape and Microsoft IIS) & ON (Apache)

- Apache 1.3.x에서는 지원이 되지 않습니다.

MaxSkipTime : WLS와의 연결이 실패하였다가 MaxSkipTime 시간이 지난 후 다시 연결을 시도하게 된다.

- Default : 10초

WLDNSRefreshInterval : 지정한 시간이 지나면 Plug-in이 알고 있던 IP 주소를 지워버리고 새로 IP주소를 찾는다.

- WebLogicCluster에 IP가 아닌 이름(“www.dongwoo.co.kr” 형식)으로 지정했을 경우 사용된다.

- Default => 0 (구동될 때 한번만 주소를 찾는다)

Debug : WLS Plug-in에 대한 디버깅에 대한 처리

- Default => OFF

- ON : Plug-in 정보와 에러메시지를 기록한다.

         WLLogFile를 따로  설정하지 않는다면 다음과 같은 위치에 파일이 생성되어 로그가 쌓이게 된다.

         UNIX => /tmp/wlproxy.log

         NT => C:\TEMP\wlproxy.log

- OFF : Debugging 정보를 기록하지 않는다.

- HFC : Plug-in 정보와 에러메시지, Client에서 받은 header 정보를 기록한다.

- HTC : Plug-in 정보와 에러메시지, Client로 보내는 header 정보를 기록한다.

- HFW : Plug-in 정보와 에러메시지, WLS에서 받은 header 정보를 기록한다.

- HTW : Plug-in 정보와 에러메시지, WLS로 보내는 header 정보를 기록한다.

- ERR : Plug-in 에러메시지를 기록한다.

- ALL : Plug-in 정보와 에러메시지, 모든 header 정보를 기록한다.

- HFC, HTC, HFW, HTW 는 동시 적용이 가능하다. 예) Debug HFC,HTC

DebugConfigInfo : Plug-in parameter 정보에 대하여 자세하게 보여준다.

- Default => OFF

- http://localhost/?__WebLogicBridgeConfig

WLLogFile : Debug값을 ON으로 설정하였을 때 설정한 위치의 파일로 로그가 쌓이게 된다.

WLTempDir : Debug값을 ON으로 설정하였을 때 설정한 위치의 파일로 로그가 쌓이게 된다.

StatPath :

- Default => false (IIS에서는 쓸모없는 옵션)

ErrorPage : 503 Error가 발생하였을 때 redirection할 page를 지정한다.

- 예) ErrorPage http://localhost/error.html

- Default => nune

CookieName : Web App의 “session-descriptor”에서 CookieName을 지정해주었다면 동일한 이름으로 Plug-in에 설정하여 client의 request에 대한 전달을 해줄 수 있도록 해야 한다.

- Default => JSESSIONID

DefaultFileName : WLS로 Client의 request를 보내는 welcome page를 정의한다.

MaxPostSize : POST Data의 size를 결정한다.

- Default => -1

- -1로 설정했을 때는 POST Data값을 체크하지 않는다.

- 이 설정은 Denial Of Service (DoS) 공격을 받았을 경우 WLS로 부하를 보내는 경우를 예방할 때 유용하게 사용된다.

MatchExpression : 설정한 특정 값에 대해 서 WLS로 forwarding 하도록 한다.

- 예) MatchExpression *.jsp

- Apache HTTP Server only

FileCaching : FileCaching을 사용할 것인지 여부를 결정한다.

- Default => ON

FilterPriorityLevel : This priority should be put in iisforward.ini file. This property is used to set the priority level for the iisforward.dll filter in IIS. Priority level is used by IIS to decide which filter will be invoked first, in case multiple filters match the incoming request.

- Default : 2

- value : 0(low) & 1(medium) & 2(high)

- IIS Server Only

WLExcludePathOrMimeType : Plug-in 구성에서 특정 URL 패턴을 갖는 요청을 WLS로 보내도록 구성한 경우 해당 URL 패턴에 대한 특정 확장자에 대해서는 웹서버에서 처리하도록 할 때 사용한다.

- Plug-in에서 사용하는 URL패턴 중에서 특정한 패턴을 제거하기 위해 사용된다.

- web => was => web 으로 forwarding하는 것으로 Performance 측면에서 보면 성능이 떨어질 것으로 보여진다.

WlForwardPath : Plug-in 구성에서 특정 URL 패턴을 갖는 요청을 WLS로 forwarding한다.

- IIS Server Only

QueryFromRequest :

- Default => OFF

- Apache HTTP Server only

DynamicServerList :

- Cluster환경에서 사용하게 된다.

- Default값은 ON으로 설정되는데 ON일 경우 DownTime 없이 서버 추가가 가능하다.

  즉 웹서버를 재구동 하지 않아도 된다. 웹서버가 한대만 있을 경우 ON으로 설정한다.

- Cluster환경이 아니거나 웹서버가 여러대 있을 경우 또는 Cluster환경에서 DownTime을 감수 할 수 있을 경우

  OFF로 설정하여 사용한다.

- OFF로 설정하고 사용할 경우 모든 서버에 대해 Connection을 체크하므로 리스트상에 죽어있는 서버가 많은 만큼

  체크 시간에 낭비가 발생하여 성능 저하의 원인이 될 수 있다.

- BMT를 수행하거나 운영환경에서 부하분산이 제대로 되지 않는 경우가 발생할 수 있는데 이는 서버가 살아있음에도

  죽어있다고 인지할 수 있는 경우가 있기 때문이다. 따라서 이럴 경우는 DynamicServerList를 OFF로 설정하여

  사용한다.

WLProxySSL : Plug-in과 WLS가 SSL을 사용할 때 설정한다.

- Default => OFF

WLLocalIP : Defines the IP address to bind to when the plug-in connects to a WebLogic Server instance running on a multihomed machine. If WLLocalIP is not set, a random IP address on the multi-homed machine is used.

※ multi-homed machine는 NAS처럼 여러 IP구간을 사용하는 것을 설명하는 것으로 생각 된다.

WLSendHdrSeparately : When this parameter is set to ON, header and body of the response are sent in separate packets.

- Default => ON

- IIS Server Only