개요


이번 글에서는 Apache HTTPD와 Tomcat 간의 세션 클러스터링 방법에 대해서 설명한다.

 

세션 클러스터링은 Web과 연동된 여러대의 Tomcat을 클러스터링하여 세션을 공유하는 기법이다. 

세션 클러스터링 시, Tomcat A의 사용자가 Tomcat B로 연결되어도 A에서 생성한 세션을 그대로 이어받을 수 있다.

 

L4 장비가 없는 로컬 환경에서 진행되므로 이번 글에서는 하나의 Apache에 2대의 톰캣을 연결한다.

 

연동 환경은 다음과 같다.

 

- OS : CentOS 6.7

- Apache Version : Apache 2.4.41

- Tomcat Version : Apache Tomcat 9.0.30

- Connector Version : JK 1.2.48

 

 

연동 전 준비사항


설정 방법은 이전 로드밸런싱 글에 나온 세팅을 그대로 사용한다.

 

https://itwarehouses.tistory.com/12?category=727632

 

Apache HTTPD to Tomcat, 로드 밸런싱(Load Balancing)

개요 이번 글에서는 Apache HTTPD와 Tomcat 간의 로드밸런싱 방법에 대해서 설명한다. 로드밸런싱은 고가용성을 위해 Apache와 Tomcat을 1:N 또는 N:N 방식으로 연결하여 Request를 분산 처리하며, 하나의 톰�

itwarehouses.tistory.com

 

 

Tomcat 설정 전 준비사항


1. Tomcat Session Clustering 간 Multicast를 위한 라우팅 설정이 필요하다.

 

위와 같이 라우팅 설정이 되어있지 않으면 해당 명령어로 주소를 추가하자.

route add -net 224.0.0.0 netmask 240.0.0.0 dev eth0(디바이스명)

 

 

 

2. Session Clustering에 사용되는 포트를 방화벽에서 허가해줘야 한다.

 

CentOS 6의 경우에는 vi /etc/sysconfig/iptables 로 아래의 내용을 추가하고 service iptables restart 실행

-A INPUT -m state --state NEW -m tcp -p tcp --dport 45564 -j ACCEPT
-A INPUT -m state --state NEW -m udp -p udp --dport 45564 -j ACCEPT
-A INPUT -m state --state NEW -m tcp -p tcp --dport 4000:4100 -j ACCEPT

 

CentOS 7의 경우에는 아래의 명령어를 실행한다.

firewall-cmd --permanent --zone=public --add-port=45564/tcp
firewall-cmd --permanent --zone=public --add-port=45564/udp
firewall-cmd --permanent --zone=public --add-port=4000-4100/tcp
firewall-cmd --reload

 

 

 

3. Apache workers.properties 파일에서 Sticky Session이 활성 되어있는지 확인한다.

 

기본값이 TRUE이기 때문에 아래와 같이 반드시 명시할 필요는 없다. 

 

false 또는 0 으로 되어있을 경우 true 또는 1로 변경한다.

 

 

 

 

Tomcat 관련 설정


Tomcat에서 설정해야할 부분은 총 3곳이다.

 

1. server.xml <Engine> 내 jvmRoute 요소 설정

 

위의 workers.properties 파일에서 로드밸런싱할 톰캣의 이름을 각각 worker1, worker2로 설정했었다.

 

각각의 Tomcat 서버에 jvmRoute 값을 worker1, worker2로 설정한다.

 

jvmRoute 값은 각 Tomcat 인스턴스의 라우팅 식별자로 사용되며, 설정 시 아래와 같이 세션 ID 값에 xxxxxx.${jvmRoute} 로 추가되어 표시된다.

 

 

2. server.xml <Host> 하위에 <Cluster> 설정

 

<Cluster className="org.apache.catalina.ha.tcp.SimpleTcpCluster"
                 channelSendOptions="8">

          <Manager className="org.apache.catalina.ha.session.DeltaManager"
                   expireSessionsOnShutdown="false"
                   notifyListenersOnReplication="true"/>

          <Channel className="org.apache.catalina.tribes.group.GroupChannel">
            <Membership className="org.apache.catalina.tribes.membership.McastService"
                        address="228.0.0.4"
                        port="45564"
                        frequency="500"
                        dropTime="3000"/>
            <Receiver className="org.apache.catalina.tribes.transport.nio.NioReceiver"
                      address="auto"
                      port="4000"
                      autoBind="100"
                      selectorTimeout="5000"
                      maxThreads="6"/>

            <Sender className="org.apache.catalina.tribes.transport.ReplicationTransmitter">
              <Transport className="org.apache.catalina.tribes.transport.nio.PooledParallelSender"/>
            </Sender>
            <Interceptor className="org.apache.catalina.tribes.group.interceptors.TcpFailureDetector"/>
            <Interceptor className="org.apache.catalina.tribes.group.interceptors.MessageDispatchInterceptor"/>
          </Channel>

          <Valve className="org.apache.catalina.ha.tcp.ReplicationValve"
                 filter=""/>
          <Valve className="org.apache.catalina.ha.session.JvmRouteBinderValve"/>

          <Deployer className="org.apache.catalina.ha.deploy.FarmWarDeployer"
                    tempDir="/tmp/war-temp/"
                    deployDir="/tmp/war-deploy/"
                    watchDir="/tmp/war-listen/"
                    watchEnabled="false"/>

          <ClusterListener className="org.apache.catalina.ha.session.ClusterSessionListener"/>
        </Cluster>

 

<Receiver> 내의 address 값에 ip 값을 입력하고, 같은 서버에서 여러대의 Tomcat이 동작할 경우 port의 값도 각각 다르게 설정해야 한다.

 

 

 

3. 어플리케이션 디렉터리 WEB-INF/web.xml에 <distributable /> 태그를 삽입한다.

 

 

Tomcat Documentation에 따르면 <distrubutable />이 하는 역할은 다음과 같다.

 

The <Manager> element defined inside the <Cluster> element is the template defined for all web applications that are marked <distributable/> in their web.xml file. However, you can still override the manager implementation on a per web application basis, by putting the <Manager> inside the <Context> element either in the context.xml file or the server.xml file.

 

web.xml에 <distrubutable />이 설정된 모든 어플리케이션이 server.xml에 설정한 <Manager> 설정대로 관리되는 듯 하다.

 

 

 

테스트


정상적으로 세션 클러스터링이 설정되었을 경우 테스트 방법은 아래와 같다.

 

1. Tomcat A, B 기동

2. Tomcat A 또는 B에서 처음으로 세션이 생성됨

3. 세션이 생성된 서버를 Shutdown

4. 나머지 서버의 세션 값이 처음 생성된 세션 값과 동일하면 설정 완료

 

 

1. Tomcat A, B 기동

 

 

 

2. Tomcat A 또는 B에서 세션 생성 확인 (Tomcat A에서 세션이 생성)

 

세션 값을 확인하는 방법은 여러가지가 있으나 여기서는 Chrome 브라우저의 개발자도구를 사용하였음.

 

 

3. 세션이 생성된 서버를 Shutdown(Tomcat A)

 

 

 

4. 나머지 서버(Tomcat B)의 세션 값이 처음 생성된 세션 값과 동일한지 확인

 

세션 값이 1EF398C1540F9380C4163C2F6062171F.worker1 으로 동일한 것을 확인할 수 있다.

 

만약 Session Clustering이 설정되지 않았다면 xxxxxxxx.worker2로 세션 값이 설정되었을 것이다.

 

 

 

개요


이번 글에서는 Apache HTTPD와 Tomcat 간의 로드밸런싱 방법에 대해서 설명한다.

 

로드밸런싱은 고가용성을 위해 Apache와 Tomcat을 1:N 또는 N:N 방식으로 연결하여 Request를 분산 처리하며,

하나의 톰캣이 서비스를 중단해도 다른 톰캣이 바로 연결을 이어받을 수 있다.

 

L4 장비가 없는 로컬 환경에서 진행되므로 이번 글에서는 하나의 Apache에 2대의 톰캣을 연결한다.

 

연동 환경은 다음과 같다.

 

- OS : CentOS 6.7

- Apache Version : Apache 2.4.41

- Tomcat Version : Apache Tomcat 9.0.30

- Connector Version : JK 1.2.48

 

 

 

연동 전 준비사항


설정 방법은 이전 글에 나온 세팅을 그대로 사용한다.

 

https://itwarehouses.tistory.com/11?category=727632

 

Apache HTTPD to Tomcat , WEB/WAS 연동

개요 이번 글에서는 오픈소스 WEB/WAS의 대표 주자인 Apache HTTPD와 Apache Tomcat을 연동하는 방법을 설명한다. Apache와 Tomcat이 설치되어있다는 전제 하에 진행되므로 미리 설치를 해놓자. 연동 환경은 �

itwarehouses.tistory.com

 

workers.properties 파일 수정


또다른 Tomcat의 정보를 추가해야 하므로 workers.properties 파일의 내용을 아래와 같이 수정한다.

 

 

worker.list=worker1,worker2,lb worker 목록에 worker2와 lb(로드 밸런서)를 추가
worker.worker1.lbfactor=1 각 worker가 처리할 부하량을 지정.
현재 설정으로는 1:1 이므로 반반씩 처리한다.
worker.lb.type=lb lb worker는 로드 밸런서이므로 lb로 지정.
worker.lb.balance_workers=worker1,worker2 로드 밸런싱할 worker 목록을 지정.

 

httpd.conf 파일 수정


요청을 workers.properties에서 설정한 로드 밸런서의 별칭으로 전송하기 위해 httpd.conf 파일의 아래 내용을 수정한다.

 

 

 

테스트


테스트를 위해 Tomcat1의 화면에는 This is Tomcat 1,

                   Tomcat2의 화면에는 This is Tomcat 2 가 표시되도록 설정하였다.

 

브라우저 창에 서버 IP를 입력하고 계속 새로고침을 눌러보자.

 

 

 

위와 같이 Tomcat1, Tomcat2의 인덱스 화면이 바뀌면서 출력되는 것을 확인할 수 있다.

 

httpd.conf 파일의 mod_jk 설정 부분에 아래의 설정을 추가하면 로그로도 확인할 수 있다.

 

JkRequestLogFormat "%w %R %V %T %U %q"

 

Apache logs 디렉터리의 mod_jk.log 파일 내용에 request 처리 내역이 추가된다.

이로써 Apache HTTPD와 Tomcat을 연동하고 로드 밸런싱 하는 방법에 대해서 알아보았다.

 

다음 글에는 Apache HTTPD - Tomcat 간의 세션 클러스터링 방법에 대해서 작성하겠다.

'WebServer | WAS > Apache' 카테고리의 다른 글

Apache HTTPD to Tomcat , WEB/WAS 연동  (0) 2020.06.04
Apache 메인 설정 파일 httpd.conf의 설정 요소  (0) 2019.09.20
httpd 옵션  (0) 2019.09.18
apachectl 옵션  (0) 2019.09.18
[CentOS 6] 아파치(Apache) 컴파일 설치  (0) 2019.09.18

개요


이번 글에서는 오픈소스 WEB/WAS의 대표 주자인 Apache HTTPD와 Apache Tomcat을 연동하는 방법을 설명한다.

 

Apache와 Tomcat이 설치되어있다는 전제 하에 진행되므로 미리 설치를 해놓자.

 

연동 환경은 다음과 같다.

 

- OS : CentOS 6.7

- Apache Version : Apache 2.4.41

- Tomcat Version : Apache Tomcat 9.0.30

- Connector Version : JK 1.2.48

 

연동 전 준비사항


Apache와 Tomcat을 연동하기 위해서는 전용 모듈인 mod_jk 모듈이 필요하다.

 

해당 모듈은 아래의 경로에서 받을 수 있다.

 

리눅스 기반에서 진행되므로 tar.gz로 압축된 파일을 받자.

 

https://tomcat.apache.org/download-connectors.cgi

 

Apache Tomcat® - Tomcat Connectors (mod_jk) Downloads

You must verify the integrity of the downloaded files. We provide OpenPGP signatures for every release file. This signature should be matched against the KEYS file which contains the OpenPGP keys of Tomcat's Release Managers. We also provide SHA512 checksu

tomcat.apache.org

 

 

mod_jk 컴파일


다운로드한 tomcat connector 1.2.48 파일의 압축을 해제하고 생성된 디렉터리안의 native 디렉터리로 이동한다.

 

해당 위치에서 아래의 명령을 실행한다.

 

./configure --with-apxs=아파치설치경로/bin/apxs

 

필자의 경우에는 ./configure --with-apxs=/apache24/bin/apxs 였다.

 

Configure 후 make && make install 명령을 통해 컴파일을 마무리한다.

 

컴파일 후 mod_jk.so 모듈이 생성되었는지 확인하려면 Apache 설치 경로의 modules 디렉터리를 확인한다.

 

 

workers.properties 파일 생성


httpd.conf를 설정하기 전에 먼저 workers.properties 파일을 생성해야 한다.

 

workers.properties는 Apache와 연동할 Tomcat의 정보 및 관련 파라미터 값을 설정하는 파일이다.

 

아파치설치경로/conf 디렉터리에 vi workers.properties 명령으로 파일을 생성하고 아래의 내용을 입력한다.

 

 

 

worker.list=worker1 연동할 Tomcat의 별칭
worker.worker1.type=ajp13 worker1에서 사용할 프로토콜 (ajp13 프로토콜이 기본값)
worker.worker1.host=localhost worker1의 IP 주소 또는 호스트명 (WEB/WAS가 같은 서버에 있으므로 loclahost)
worker.worker1.port=8009 worker1의 AJP 포트번호 (8009번 포트가 기본값)

 

httpd.conf 설정 추가


httpd.conf 파일 하단에 아래의 내용을 추가한다.

 

 

LoadModule jk_module modules/mod_jk.so

-> mod_jk.so 모듈을 사용하기위해 적재

 

<IfModule jk_module>

</IfModule>

->  jk_module이 적재되어 있는 동안에만 해당 설정을 적용

 

JkWorkersFile conf/workers.properties

위에서 생성한 workers.properties 파일의 경로를 설정

 

JkLogFile logs/mod_jk.log

연동에 관련된 로그파일이 생성될 경로를 설정

 

JkLogLevel info

로그 파일의 레벨을 설정

 

JkLogStampFormat "[%a %b %d %H:%M:%S %Y]"

로그 내용의 각 라인 앞에 찍히는 스탬프의 형식을 설정

 

JkMount /* worker1

Apache HTTPD로 들어오는 요청을 worker1로 전송

 

 

연동 테스트


현재 Apache HTTPD는 80, Tomcat은 8080 포트를 사용 중이다.

 

정상적으로 연동되었다면 80번 포트로 접속 시 Apache가 8009번 포트를 통해 Tomcat으로 Request를 전달한다.

 

웹브라우저에 서버 IP를 입력하여 접속해보자.

 

 

IP에 :8080을 붙이지 않고 80번 포트로 접속했을 때 Tomcat의 기본 인덱스 화면이 표시되는 것을 볼 수 있다.

 

이로써 Apache HTTPD와 Apache Tomcat을 연동하는 방법에 대해서 알아보았다.

 

개요


이번 글에서는 Apache Tomcat의 디렉토리 구조와 각 디렉토리 안의 파일들이 어떤 기능을 수행하는지 알아보고자 한다.

본 글은 Apache Tomcat 9 버전을 기준으로 작성되었다.

 

 

Tomcat 디렉토리 구조


/bin

startup, shutdown, 기타 스크립트가 존재한다. sh 파일(유닉스 시스템) bat 파일(윈도우 시스템) 기능적으로 동일하다.

/conf

설정 파일과 DTD 연관된 파일이 존재한다. 가장 중요한 파일인 server.xml 있으며 파일은 컨테이너의 주요 설정 파일이다.

/logs

기본적으로 디렉토리에 로그 파일이 생성된다.

/webapps

기본 webapps 위치하는 디렉토리이다.

/lib

classpath 추가되는 리소스가 위치한 디렉토리이다.

/work

Jsp 파일을 서블릿 형태로 변환한 java 파일과 class 파일이 저장되는 디렉토리이다.

/temp

JVM 사용되는 임시 디렉토리이다.

 

bin 디렉토리 파일


bat 파일은 윈도우에서 실행하는 batch 파일, sh 파일은 유닉스 계열에서 실행하는 shell script 파일이다.

 

bootstrap.jar

Tomcat 서버가 구동될 때 사용되는 main() 메소드가 포함되어 있으며 클래스 로더가 클래스를 구현하는데에 필수적이다.

tomcat-juil.jar

로깅을 구현하는 java.util.logging API를 포함하고 있는 클래스이다.

common-daemon.jar

Apache Commons Daemon 프로젝트에 필요한 클래스이다.

Catalina.sh 파일에 의해 빌드되지 않으며 bootstrap.jar 파일에 의해 참조된다.

catalina.sh

CATALINA 서버의 제어 스크립트이다.

ciphers.sh

지정된 알고리즘을 사용하는 다이제스트 암호를 설정하는 스크립트이다.

configtest.sh

CATALINA 서버의 설정 스크립트이다.

daemon.sh

Common Daemon에 사용되는 스크립트이다.

digest.sh

지정된 알고리즘을 사용하는 다이제스트 암호를 설정하는 스크립트이다.

makebase.sh

Tomcat 실행에 필요한 분산 디렉토리 구조를 생성하는 스크립트이다.

setclasspath.sh

JAVA_HOME 또는 JRE_HOME이 세팅되지 않았을 경우 세팅한다.

shutdown.sh

CATALINA 서버를 중지하는 스크립트이다.

startup.sh

CATALINA 서버를 시작하는 스크립트이다.

tool-wrapper.sh

커맨드 라인 도구에서 사용되는 Wrapper 스크립트이다.

version.sh

Tomcat의 정보를 표시해주는 스크립트이다.

 

conf 디렉토리 파일


catalina.policy

Tomcat의 보안 정책을 설정하는 파일이다.

Catlinasecurity 옵션으로 실행될 때 시행되는 보안 정책을 설정할 수 있다.

catalina.properties

서버를 시작할 때 검색하는 서버, 공유 로더, JAR 등의 정보를 포함한다.

context.xml

세션, 쿠키 저장 경로등을 지정하는 설정 파일이다.

jaspic-providers.xml

사용자 인증 제공 방법에 대해 정의한 파일

logging.properties

Tomcat 인스턴스의 로깅 설정 파일이다.

tomcat-juli.jar 라이브러리를 활용하여 로깅 서비스를 제공한다.

server.xml

Tomcat 설정에서 가장 중요한 파일이다.

Service, Connector, Host 등과 같은 주요 기능을 설정할 수 있다.

tomcat-users.xml

Tomcat manager 기능을 사용하기 위해 사용자 권한을 설청하는 파일이다.

web.xml

Tomcat의 환경설정 파일이며 서블릿, 필터, 인코딩 등을 설정할 수 있다.

lib 디렉토리 파일


annotations-api.jar

자바EE 어노테이션 클래스 파일

catalina.jar

Tomcat Catalina 서블릿 컨테이너를 구현하는 파일

catalina-ant.jar

Tomcat Catalina Ant 작업 파일

catalina-ha.jar

고가용성 패키지 파일

catalina-storeconfig.jar

서버 상태의 흐름을 XML 설정파일로 생성한다.

catalina-tribes.jar

그룹 커뮤니케이션 패키지 파일

ecj-*.jar

이클립스 JDT 자바 컴파일러 파일

el-api.jar

EL 3.0 API 파일

jasper.jar

Tomcat Jasper JSP 컴파일러와 런타임 파일

jasper-el.jar

Tomcat Jasper EL 구현 파일

jsp-api.jap

JSP 2.3 API 파일

servlet-api.jar

Servlet 4.0 API 파일

tomcat-api.jar

Tomcat에 의해 정의되는 몇몇 인터페이스 파일

tomcat-coyote.jar

Tomcat connector와 유틸리티 클래스 파일

tomcat-dpcp.jar

데이터베이스 커넥션 풀을 구현하는 파일

tomcat-i18n-**.jar

Tomcat 언어 패키지 파일

tomcat-jdbc.jar

Tomcat JDBC pool로 알려진 대체 데이터베이스 커넥션 풀을 구현하는 파일

tomcat-util.jar

Apache Tomcat의 다양한 컴포넌트에서 사용되는 일반 클래스 파일

tomcat-websocket.jar

WebSocket 1.1 구현 파일

websocket-api.jar

Websocket 1.1 API 파일

 

 

참조


Apache Tomcat 9 Docs : https://tomcat.apache.org/tomcat-9.0-doc/index.html

+ Recent posts