기본 콘텐츠로 건너뛰기

[ TOMCAT ] 하나의 웹 어플리케이션을 여러 개의 인스턴스로 구동해 보기 (테스트용)

  이전 게시글에서 Tomcat 수동 배포에 대해서 검토를 해 보았으니 이번에는 하나의 웹 어플리케이션을 하나의 Tomcat Engine 으로 Instance 만 여러 개를 만들어 구동하는 방법에 대해서 알아 보도록 한다.

Tomcat Multiple Instance 개념

  하나의 Tomcat 으로 여러 개의 인스턴스를 만들어서 사용하기 위해서는 약간의 개념(?)을 이해해야 한다. 제일 먼저 Tomcat 의 구조를 이행해야 하므로 간단하게 알아보도록 하자.


  위의 그림은 Tomcat 의 기본 폴더 구조를 나타내는 것이다. 각 폴더의 의미는 다음과 같다.

  • lib - Tomcat Engine 이 사용하는 외부 라이브러리 (*.jar) 관리 폴더
  • bin - Tomcat 실행/종료와 관계되는 스크립트 관리 폴더
  • conf - Tomcat 에 올라갈 웹 어플리케이션에 대한 설정 파일 관리 폴더
  • logs - Tomcat 의 로그 관리 폴더
  • temp - Tomcat Engine 에서 사용하는 임시 파일 폴더
  • webapps - 웹 어플리케이션이 배포되는 어플리케이션 관리 폴더
  • work - JSP 파일이 Servlet 으로 컴파일된 클래스 (*.class) 관리 폴더

  폴더들이 상당히 많이 존재하지만 정작 Tomcat 만을 위해서 존재하는 폴더는 "lib" 와 "bin" 폴더 뿐이다. 따라서 웹 어플리케이션의 서비스를 운영하는데 사용되는 폴더들은 나머지 "conf", "logs", "temp", "webapps", "work" 폴더가 된다. 

  여기서 헷갈리지 않아야 하는 것은 어플리케이션이 하나의 인스턴스이고 인스턴스가 생성되어 실행이 되려면 하나의 JVM 에서 처리가 되어야 한다. 따라서 Multiple Instance 라고 하는 것은 결국 여러 개의 JVM을 운영하겠다는 것이고 여기에 각각 웹 어플리케이션을 돌리겠다는 의미가 된다. 

그럼 Tomcat 이 실행되면 어떻게 운영이 되는 것일까? 아래의 그림을 보고 확인해 보도록 하자.


  위의 그림과 같이 Tomcat Engine 과 Instance 는 분리될 수 있는 기본 구조를 가지고 있다. 아마도 관심이 있었다면 Startup.bat 파일과 Catalina.bat 파일을 열어서 확인해 본 적이 있을 것이다. 파일의 내용을 보면 여러 가지 환경 변수들을 사용하고 있다. Multiple Instance 을 이용하기 위해서는 아래의 2 가지 변수가 가장 중요하다.(자세한 설명은 Catalina.bat 파일에 주석으로 상세하게 적혀 있다. 단, 영어로 -_-)

  • CATALINA_HOME - 실제 Tomcat Engine 이 존재하는 경로를 나타낸다. (ex. D:\Tomcat7)
  • CATALINA_BASE - 옵션으로 설정할 수 있으며 Tomcat Engine 에 의해서 인스턴싱이 될 어플리케이션의 경로를 나타낸다. 기본 값은 CATALINA_HOME 과 동일한 곳을 지정한다. (ex. D:\TOMCAT7)

  위의 그림과 지금까지의 내용으로 판단을 하면 하나의 Tomcat Engine 을 고정해 놓고, Instance 로 사용할 수 있는 것들을 각기 다른 이름으로 여러 개 만들어 놓은 후에 Startup / Shutdown / server.xml 의 내용을 각각 조정을 하면 이론적으로 다음의 그림과 같이 처리할 수 있다.


그럼 이제 하나씩 만들어 보도록 하자.

멀티 인스턴스 만들기

  제일 먼저 각 인스턴스를 관리하기 위한 CATALINA_BASE 용 폴더를 만들어야 한다. 이해하기 쉽도록 다음과 같이 구성을 한다고 가정하자.


> Tomcat 경로
D:\Tomcat7

> Instance 관리 폴더 경로
D:\WORKS\instance1     < 인스턴스 1로 사용할 폴더
D:\WORKS\instance2     < 인스턴스 2로 사용할 폴더
  위와 같은 폴더를 구성하고 각 인스턴스에 필요한 서브 폴더들을 모두 동일하게 복사해서 넣도록 한다. 기본 폴더 구성이 완성이 되었으므로 이제는 각 인스턴스가 동작할 수 있도록 server.xml 파일을 구성해 주어야 한다. 이 부분은 웹 어플리케이션이 사용할 Port 정보이므로 중복되지 않도록 잘 조정해야 한다. 각 인스턴스 폴더의 conf 에서 server.xml 을 열고 Connector 에 대한 Port 정보를 변경해 주도록 한다.


> D:\WORKS\instance1\conf\server.xml 파일
...
<Server port="8006" shutdown="SHUTDOWN">
...
<Connector URIEncoding="UTF-8" connectionTimeout="20000" port="8091" protocol="HTTP/1.1" redirectPort="8444" useBodyEncodingForURI="true"/>
...
<Connector SSLEnabled="true" URIEncoding="utf-8" clientAuth="false" keystoreFile="SSL 키 파일 경로" keystorePass="키 비밀번호" keystoreType="pkcs12" maxThreads="150" port="8444" protocol="HTTP/1.1" scheme="https" secure="true" sslProtocol="TLS"/>
...
<Connector port="8011" protocol="AJP/1.3" redirectPort="8444"/>
  이제 마지막으로 시작 / 종료를 위한 배치 파일을 구성하면 된다. 이제는 Tomcat Engine 의 startup.bat / shutdown.bat 을 직접 사용하지 않고 각각 instance 별로 필요한 정보를 설정한 후에 호출이 될 수 있도록 해얗 하기 때문에 생성할 인스턴스 별로 각각 startup1.bat, shutdown1.bat 과 같이 쌍으로 파일을 만들어 주면 된다. (DOS 스크립트를 잘 쓴다면 범용 스크립트를 만들어 쓸 수도 있을 것이다. 여기서는 패스...)

> D:\WORKS\startup1.bat

@echo off
set "CATALINA_HOME=D:\Tomcat7"
set "CATALINA_BASE=D:\WORKS\instance1"
set "JAVA_OPTS=-javaagent:에이전트 jar 경로 -Djava.net.preferIPv4Stack=true"
set "CATALINA_OPTS=-Denv=product -Denv.servername=instance1"
call %CATALINA_HOME%\bin\catalina.bat start %CATALINA_OPTS%

> D:\WORKS\shutdown1.bat

@echo off
set "CATALINA_HOME=D:\Tomcat7"
set "CATALINA_BASE=D:\WORKS\instance1"
call %CATALINA_HOME%\bin\shutdown.bat
  위의 배치 파일을 생성할 인스턴스에 맞도록 생성한 후에 각각 실행하여 정상적으로 동작하는지를 확인해 보면 된다. 여기서 중요한 것은 CATALINA_BASE에 설정된 정보를 기준으로 Start / Shutdown 이 운영된다는 것이다.

  지금까지 정리한 것은 단지 테스트를 위한 내용일 뿐이다. 실제 이렇게 사용하면 관리도 안되고 오히려 문제를 다 만들게 되므로 테스트 이외의 용도로 사용하는 것을 권장하지 않는다. 실제 운영을 위한 것이라면 관리 정책을 수립하고 이에 따라서 개발/테스트/배포도 CI 연동과 같이 정책적으로 운영이 되어야 한다는 점을 명심해야 한다.

댓글