1. Overview

WLS Proxy Plugin 12cR2 의 주요 옵션들에 대해서 살펴본다.

OHS 제품에 적용될 수 있는 (Applies to: Oracle HTTP Server) 항목만 살펴본다.

또한, 자세한 동작의 알고리즘을 알아야 되는 옵션들 위주로 먼저 문서를 작성하므로

Index는 존재하지만 내용은 Empty 할 수 있다.



2. Connections

Connect 관련 옵션들에 대해서 살펴본다.

해당 부분은, 워낙에 대중적으로 잘 알려져있고 공식 메뉴얼에서 명확하게 설명하므로

추후 필요시에 업데이트한다.



3. Debugging

3.1 DebugConfigInfo

참고, 6. Proxy Plugin



4. FileCaching

POST 데이터 전송 시 (보통 파일업로드),

FileSize가 2048Bytes를 초과하는 경우에 동작을 설정한다.

공식 메뉴얼에 잘 나와 있으나, 실제로 어떻게 동작하는지 Debug Log로 살펴본다.



4.1 FileCaching OFF

Plugin 옵션을 다음과 같이 설정한다.

FileCaching OFF
WLTempDir <path>/WLTempDir

  • 100 Bytes 크기의 파일을 POST 전송

    1
2

    Going to get the post data of size=296 clength=0
Post data length: 296 (in memory)

    File(100 Bytes) + Unknown(196~7) 이 추가된다.

    File뿐만 아니라, POST Header 등과 같은 기타 크기가 추가되었을 것으로 추측을 할뿐이다.

    2048 Bytes 보다 작아 in memory 로 Plugin 에서 처리한다.


  • 1000 Bytes

    ``` Going to get the post data of size=1197 clength=0 Post data length: 1197 (in memory)


  • 1851 Bytes

    1
2

    Going to get the post data of size=2048 clength=0
Post data length: 2048 (in memory)


  • 1852 Bytes

    1
2
3
4

    Going to get the post data of size=2049 clength=0
FileCaching is turned OFF, postponing read of POST data
Post data length: 2049 (not in memory)
FileCache turned off reading and writing POST in chunks

    2048 Bytes를 초과하여, not in memory 로 처리된다.

    다만, Disk에 쓰기를 하지 않도록 FileCaching OFF 되어 있으므로,

    Chunk Size인 8192 Bytes로 나누어서 전송한다. (postponing?)



4.2 FileCaching ON

Plugin 옵션을 다음과 같이 설정한다.

FileCaching ON
WLTempDir <path>/WLTempDir


  • 1852 Bytes

    1
2
3

    Going to get the post data of size=2049 clength=0
getWLFilePath: Complete File name = [.../WLTempDir/_wl_proxy/_post_674040_0]
Read 2049 of expected 2049 bytes of request body

    WLTempDir에 임시로 파일을 쓰기 후, 전송한다.

    674040은 확인 결과, httpd worker의 PID 이다.

    _post_674040_0 파일의 전송과 삭제 주기가 워낙 빨라 파일 확보를 할 수가 없다.


  • 16384 Bytes

    1
2
3

    Going to get the post data of size=16582 clength=0
getWLFilePath: Complete File name = [.../WLTempDir/_wl_proxy/_post_674040_1]
Read 16582 of expected 16582 bytes of request body

    문서에서 Chunk Size는 8192 bytes 이므로

    16384 Bytes POST 전송 시, 최소 2번 으로 나눌 것으로 예상했으나,

    그렇게 동작하지는 않은 것 같다.


  • 10 MB

    1
2
3
4

    Going to get the post data of size=10485952 clength=0
getWLFilePath: Complete File name = [/sw/webtier/12cR2/domains/base_domain/config/fmwconfig/components/OHS/worker1/WLTempDir/_wl_proxy/_post_674040_3]
Read 10485952 of expected 10485952 bytes of request body
Post data length: 10485952 (not in memory)


  • 128 MB

    1
2
3

    Going to get the post data of size=102400193 clength=0
getWLFilePath: Complete File name = [/sw/webtier/12cR2/domains/base_domain/config/fmwconfig/components/OHS/worker1/WLTempDir/_wl_proxy/_post_673765_0]
Read 102400193 of expected 102400193 bytes of request body


FileCaching ON의 경우, WLTempDir에 임시 파일이 생성 된다는 로그만 확인이 된다.

혹은 테스트 방식이 잘못되었을 수 있다.



5. Idemponent

멱등성; 항상 언제든지 결과가 같은 성질을 갖는다는 사전적인 의미가 있다.

WLIOTimeoutSecs 를 초과하는 작업 또는 READ_ERROR_FROM_SERVER 코드를 받게 될 경우,

실패한 작업으로 간주하여 다른 Alive instance로 Failover 할 수 있다.



5.1 Idempotent OFF

Idempotent OFF
WLIOTimeoutSecs 11


  • Thread.sleep(11000) 실행

    1
2
3
4
5
6
7
8

    *******Exception type [READ_TIMEOUT] (no read after 11 seconds) raised at line 284 of Reader.cpp
caught exception in readStatus: READ_TIMEOUT [os error=0,  line 284 of Reader.cpp]: no read after 11 seconds at line 764
PROTOCOL_ERROR: Backend Server not responding - isRecycled:0
Marking 10.65.34.245:8002 as bad
got exception in sendRequest phase: READ_TIMEOUT [os error=0,  line 284 of Reader.cpp]: no read after 11 seconds at line 579
*NOT* failing over after sendRequest() exception: READ_TIMEOUT

    11초 동안 Backend Server가 Not responding 하다는 메시지와, 해당 인스턴스를 bad marked 하였다.

    1

    ap_proxy: trying GET /testApp/sleep.jsp at backend host 10.65.34.245/8002; got exception 'READ_TIMEOUT [os error=0,  line 284 of Reader.cpp]: no read after 11 seconds'; state: reading status line or response headers from WLS (wrote? Y read? N); not failing over

    이후 Failover에 대해서는 Idempotent OFF 이므로 Ignored 되었다.



5.2 Idempotent ON

Idempotent OFF
WLIOTimeoutSecs 11


  • Thread.sleep(11000) 실행

    1
2
3
4
5

    attempt #0 out of a max of 5
created a new connection to preferred server '10.65.34.245/8002' for '/testApp/sleep.jsp?cnt=11', Local port:28622
Marking 10.65.34.245:8002 as bad
Failing over after sendRequest() exception: READ_TIMEOUT as Idempotent is ON, method is idempotent
no read after 11 seconds'; state: reading status line or response headers from WLS (wrote? Y read? N); failing over

    처음(0 of 5) 시도에 TIMEOUT으로 bad marked 및 Failover 동작이 확인됩니다.

    1
2
3
4
5

    attempt #1 out of a max of 5
general list: created a new connection to '10.65.34.245'/8003 for '/testApp/sleep.jsp?cnt=11', Local port:24870
Marking 10.65.34.245:8003 as bad
Failing over after sendRequest() exception: READ_TIMEOUT as Idempotent is ON, method is idempotent
no read after 11 seconds'; state: reading status line or response headers from WLS (wrote? Y read? N); failing over

    다음(1 of 5) 시도도 마찬가지입니다.

    1
2
3
4
5

    attempt #2 out of a max of 5
general list: created a new connection to '10.65.34.245'/8002 for '/testApp/sleep.jsp?cnt=11', Local port:46456
Marking 10.65.34.245:8002 as bad
Failing over after sendRequest() exception: READ_TIMEOUT as Idempotent is ON, method is idempotent
no read after 11 seconds'; state: reading status line or response headers from WLS (wrote? Y read? N); failing over

    세번째(2 of 5) 시도에서도 실패 및 Failover 를 합니다.

    여기서 유의해야 될 점이 있습니다.

    처음(0 of 5) 단계에서 bad marked 한 인스턴스 (8002)에 시도하고 있습니다.

    이는, bad skip time 10초 설정이 되어 있기 때문입니다.

    또한, 0 of 5 의 의미는 ConnectTimeoutSecs 설정과 관련이 있습니다.



6. MaxPostSize

1

MaxPostSize 1048576


  • 1MB Post

    1
2

    $ curl -v -X POST -F "file=@./1MB" http://wls.local:10100/testApp/
HTTP/1.1 100 Continue


  • 10MB Post

    1
2

    $ curl -v -X POST -F "file=@./10MB" http://wls.local:10100/testApp/
HTTP/1.1 413 Request Entity Too Large