Apache와 WebLogic 연동을 위한 WebLogic Plugin 설정 방법

Apache와 WebLogic 연동을 위한 WebLogic Plugin 설정 방법

Apache HTTP Server와 Oracle WebLogic Server를 연동할 때는 Oracle에서 제공하는 WebLogic Plugin(mod_wl_ohs.so) 을 사용합니다. 이 글에서는 해당 플러그인 설치 방법과 httpd.conf 내 설정 방법, 주요 파라미터를 소개합니다.

---

1. WebLogic Plugin 개요

• Apache → WebLogic 간의 프록시 요청 처리를 위한 Oracle 공식 모듈
• 모듈 파일 이름: mod_wl_ohs.so
• 주로 AJP가 아닌 HTTP/HTTPS 통신 기반
• WebLogic이 설치된 디렉토리에 포함되어 있음

---

2. mod_wl_ohs.so 설치 위치

WebLogic 설치 디렉토리 예시:

/Oracle/Middleware/Oracle_Home/wlserver/server/plugin/linux/x86_64/12.2.1.4/

해당 경로에서 mod_wl_ohs.so 파일을 Apache의 modules/ 디렉토리로 복사하거나 직접 경로 지정해서 사용 가능합니다.

---

3. Apache 설정 예시 (httpd.conf 또는 별도 conf 파일)

# WebLogic Plugin 모듈 로드
LoadModule weblogic_module /etc/httpd/modules/mod_wl_ohs.so

# WebLogic 연동 설정
<Location /weblogic-app>
    SetHandler weblogic-handler
    WebLogicHost 192.168.0.10
    WebLogicPort 7001
    WLIOTimeoutSecs 300
    Debug All
    DebugConfigInfo On
</Location>

---

4. 주요 디렉티브 설명

디렉티브	설명
WebLogicHost	WebLogic 서버의 IP 또는 호스트명
WebLogicPort	WebLogic의 HTTP 포트 (기본 7001)
WLIOTimeoutSecs	응답 대기 시간 (초). 대기 시간이 긴 서비스일수록 늘려야 함
ConnectTimeoutSecs	연결 타임아웃 (초). 기본 10초
KeepAliveEnabled	WebLogic과의 연결에 KeepAlive를 사용할지 여부 (On/Off)
SecureProxy	Apache → WebLogic 간 HTTPS 사용 시 On 설정
Debug	디버깅 로그 레벨 (None, Error, Info, All)
DebugConfigInfo	Apache 기동 시 설정 정보 출력 (On 추천)

---

5. 클러스터 연동 예시

<Location /cluster-app>
    SetHandler weblogic-handler
    WebLogicCluster 192.168.0.10:7001,192.168.0.11:7001
    WLIOTimeoutSecs 300
    Debug All
    DebugConfigInfo On
</Location>

• WebLogicCluster는 콤마(,)로 구분된 호스트:포트 리스트입니다.
• 클러스터 설정 시에는 반드시 각 WebLogic 서버에 동일한 어플리케이션이 배포되어 있어야 합니다.

---

6. 로그 확인 위치

기본적으로 Apache 로그 외에도 다음 로그에서 상세 분석이 가능합니다:

• Apache error_log
• access_log
• WebLogic Plugin 자체 로그 (설정 시 별도 출력 가능)

---

마무리

WebLogic Plugin을 사용한 Apache 연동은 고성능 HTTP 연결을 제공하면서도 Oracle 공식 모듈을 활용하므로 안정성이 뛰어납니다.
설정 시 타임아웃, 클러스터 구성, HTTPS 여부, 디버깅 로그 등을 세심히 설정하면 장애 대응에도 효과적입니다.