[weblogic] IIS - Weblogic iisproxy.ini parameter

2019. 7. 26. 18:49 Server, WAS/Weblogic

[weblogic] IIS - Weblogic iisproxy.ini parameter




webLogic Server 11g release(10.3.5) iisproxy.ini


iisproxy.ini Parameter 정리


출처 : 오라클 weblogic iis plugin_parameter



 Parameter

Default 

Remarks 

WeblogicHost 

NONE 

 Web 서버에서 연결하는 Weblogic IP

 WebLogicPort

 NONE

Web 서버에서 연결하는 인스턴스 IP 

 WebLogicCluster

 NONE

 Web 서버에서 바라보는 Cluster 묶음

 PathTrim

 null

 IIS에서 WebLogic으로 요청이 넘어갈때, URL에 해당 지정 경로가 제외되어 넘어간다.

 PathPrepend

 null

 IIS에서 WebLogic으로 요청이 넘어갈때, PathTrim으로 URL이 다듬어 지고 PathPrepend를 포함하여 전송한다.

 ConnectTimeoutSecs

 10

 WebLogic에 연결을 시도하는 최대 시간

 ConnectRetrySecs

 2

 WebLogic에 연결을 시도하는 간격

 Debug

 OFF

 WebLogic Plugin에 대한 처리 상세정보를 보기 위한 설정 default : c:\TEMP\wlproxy.log

ON : 플러그인 정보 및 오류 메시지 로그

OFF : 디버깅 정보 기록 않함.

HFC : 클라이언트, 정보, 에러메시지로 부터 나온 헤더 로그 기록

HTW : 웹로직 서버와 정보, 에러메시지에 보낸 헤더 로그 기록

HFW : 웹로직 서버와 정보, 에러메시지로부터 헤더 로그 기록

HTC : 클라이언트, 정보 메시지, 에러 메시지에 보낸 헤더 로그 기록

ERR : 에러메시지만 기록

ALL : 클라이언트에 보낸 헤더, 웹로직 서버, 정보, 메시지, 에러메시지를 보낸 헤더 로그 기록

 WLLogFile

 Debug parameter

 로그를 기록할 경로 및 파일이름 지정.(Debug가 On 일때) 해당 경로 지정전에 해당 폴더를 생성해야 한다.

 WLTempDir

 Debug parameter

 wlproxy.log 저장 파일 지정. 해당 경로를 못찾으면 C:\temp\tmp에 기록. WLLogFile과 같이 지정될 경우 WLLogFile은 무시된다.

 DebugConfigInfo

 OFF

 run-time시 plug-in 구성 정보를 확인. Http://웹서버IP:port/a.jsp?__WebLogicBridgeConfig

 ErrorPage

 NONE

 웹 서버가 웹로직 서버에 요청을 보낼 수 없을때, 보여줄 에러 페이지 설정

 WLSocketTimeoutSecs

 2

 접속중 socket 타임아웃 시간 설정 (초) 

 WLIOTimeoutSecs

 300

 WEB서버에서 웹로직에 요청하고 처리 대기하는 시간 (최소값: 10)

 Idempotent

 ON

 ON으로 설정시 WLIOTimeoutSecs에 응답하지 않으면 fail-over 합니다. OFF로 설정시 fail-over 하지 않는다.

 WLCookieName

 JSESSIONID

 웹로직 서버 세션 쿠키의 값과 같게 설정해야 한다.

 DefaultFileName

 NONE

 설정된 페이지로 시작페이지(welcome page) 설정. 순서: PathTrim -> DefaultFileName -> PathPrepend.

(웹로직 서버에서 리다이렉션 방지)

 MaxPostSize

 -1

 POST 데이터의 Byte 최대 허용 크기. 해당 크기를 초과할 경우 에러 페이지를 반환한다.

POST DATA 과부하를 시도 공격을 방어하는데 유용하다.

 FileCaching

 ON

 ON : POST data가 2048 bytes보다 크면 POST data는 디스크의 임시파일을 먼저 읽고 웹로직 서버에 8192bytes 덩어리를 전송한다. 기본 서버가 다운되면 Fail-over 동안 보조 서버가 필요한 데이터를 사용할 수 있도록 POST data를 보존한다.  화면에 Progress Bar를 사용할 경우 ON 설정은 좋지 않다. (웹서버에서 웹로직 서버에 전송중에 클라이언트에 전송이 완료될 수 있다.)


OFF : POST data가 2048 bytes보다 크면 웹로직 서버에서 POST date 요청을 받을때 까지 연기된다. 읽기가 완료되면 즉시 POST data를 8192 bytes 덩어리로 웹로직 서버에 데이터를 전송한다. fail-over는 제한된다. 요청 진행중 기본 서버가 다운되면  POST data를 보조 서버로 전송하지 못한다. 값에 상관없이 POST data가 2048 bytes 보다 적으면 플러그인은 데이터를 읽고 메모리에 저장한 후 fail-over시 보조 서버에서 사용한다.

 FilterPriorityLevel

 2

 iisforward.dll 필더의 우선순위를 설정 하는데 사용. 0:저, 1:중, 2:고

 WLExcludePathOrMimeType

 NONE

 프록시에서 특정 요청을 제외 할 수 있다. 로컬 Location tag level(요청)을 지정할 수 있다. Global 요청 대체

 WlForwardPath

 NULL

 웹로직 서버로 요청을 보낼 때, 해당 문자열을 요청 시작점에 셋팅한다.

 KeepAliveSecs

 20

 KeepAlive 상태를 유지하는 시간

 KeepAliveEnabled

 TRUE

 세션 연결 후 응담이 끝나도 일정시간동안 세션을 유지하여 재 전송시 접속을 위한 오버헤드를 감소시켜주기 위한 설정

 MaxSkipTime

 10

 연결 서버가 "bad" 일 경우 해당 시간 이후 클러스터된 새로운 서버에 접속을 시도한다. (쿠키 제외하고 요청)

 DynamicServerList

 ON

 OFF로 설정한 경우 Proxy를 설정한 클러스터에 대해서만 WebLogicCluster로 사용함.

ON으로 설정시, 동적으로 클러스터에 추가된 서버를 등록한다.

 WLProxySSL

 OFF

 ON으로 지정할 경우 : HTTPS 프로토콜을 사용할 때, 웹로직에서 클라이언트에 위치 헤더는 HTTPS를 반환한다.

 WLProxyPassThrough

 OFF

 신뢰할 수 있는 플러그인을 명시적으로 설정하면, 네트워크가 신뢰하는 가정하에 먼저 적용될 수 있다. chained 프록시 설정이 되어 있을때, 프록시 플러그인이나 HttpClusterServlet이 다른 프록시 뒤어서 실행하거나 로드 밸런싱 된다. 이 값을 설정해야 한다.

 WLLocalIP

 NONE

 웹로직 서버 인스턴스의 multihome machine중 입력한 IP 주소에 바인딩 한다. 입력하지 않을 경우 임의의 IP 주소를 사용한다.

 WLSendHdrSeparately

 ON

 ON으로 설정하면, 헤더와 본문 응답이 별도의 패킷으로 전송된다.




iisproxy.ini 


WebLogicCluster=XXX.XXX.XXX.XX:XXXX , YYY.YYY.YYY.YY:YYYY   // 클러스터 대상

ConnectTimeoutSecs=10     // weblogic에 연결을 시도하는 최대 시간 :  10초

ConnectRetrySecs=2                    // weblogic에 연결을 시도하는 간격 : 2초

WlForwardPath=/servlet,/weblogic

PathTrim=/servlet,/weblogic

WLIOTimeoutSecs=600    // 웹로직에 요청을 보내고 처리를 기다리는 시간 : 10분

Debug=OFF                             // Debugging 정보 기록 안함

DebugConfigInfo=ON                // Plug-in 구성정보 확인

DynamicServerList=OFF              // Proxy를 설정한 클러스터에 대해서만 적용

Idempotent=OFF                         // WLIOTimeoutSecs 이후에 fail-over 하지 않는다.

WLLogFile=C:\Temp\wlproxy.log  // log 기록 폴더

WLCookieName=JSESSIONID          // Cookie Name



출처: https://hyeonstorage.tistory.com/28?category=549784 [개발이 하고 싶어요]