기본 콘텐츠로 건너뛰기

[ 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<b>instance1 < 인스턴스 1로 사용할 폴더 D:\WORKS<b>instance2 < 인스턴스 2로 사용할 폴더

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


> D:\WORKS\instance1\conf\server.xml 파일
...
port="8006" shutdown="SHUTDOWN">
...
port="8091" protocol="HTTP/1.1" redirectPort="8444" useBodyEncodingForURI="true"/>
...
port="8444" protocol="HTTP/1.1" scheme="https" secure="true" sslProtocol="TLS"/>
...
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 연동과 같이 정책적으로 운영이 되어야 한다는 점을 명심해야 한다.

댓글

이 블로그의 인기 게시물

OData 에 대해서 알아보자.

얼마 전에 어떤 회사에 인터뷰를 하러 간 적이 있었다. 당시 그 회사는 자체 솔루션을 개발할 기술인력을 찾고 있었고 내부적으로 OData를 사용한다고 했다. 좀 창피한 이야기일 수도 있지만 나름 기술적인 부분에서는 많은 정보를 가지고 있다고 했던 것이 무색하게 OData란 단어를 그 회사 사장님에게서 처음 들었다. 작고, 단순한 사이트들만을 계속해서 작업을 하다 보니 어느덧 큰 줄기들을 잃어버린 것을 느끼기 시작했다. 명색이 개발이 좋고, 기술적인 기반을 만들려고 하는 인간이 단어조차도 모른다는 것은 있을 수 없는 것이라서 다시 새로운 단어들과 개념들을 알아보는 시간을 가지려고 한다. OData (Open Data Protocol) 란? 간단히 정리하면 웹 상에서 손쉽게 데이터를 조회하거나 수정할 수 있도록 주고 받는 웹(프로토콜)을 말한다. 서비스 제공자 입장에서는 웹으로 데이터를 제공하는 방식으로 각 포탈 사이트들이 제공하는 OPEN API 포맷을 독자적인 형식이 아니라 오픈된 공통규약으로 제공 가능하며, 개발자는 이 정보를 다양한 언어의 클라이언트 라이브러리로 어플리케이션에서 소비할 수 있도록 사용하면 된다. 공식 사이트는 www.odata.org 이며 많은 언어들을 지원하고 있다. 좀더 상세하게 정의를 해 보면 OData는 Atom Publishing Protocol  (RFC4287) 의 확장 형식이고 REST (REpresentational State Transfer) Protocol 이다. 따라서 웹 브라우저에서 OData 서비스로 노출된 데이터를 볼 수 있다. 그리고 AtomPub 의 확장이라고 했듯이 데이터의 조회만으로 한정되는 것이 아니라 CRUD 작업이 모두 가능하다. Example 웹 브라우저에서 http://services.odata.org/website/odata.svc 를 열어 보도록 하자. This XML file does not appear to have any style in...

C# 에서 Timer 사용할 때 주의할 점.

예전에 알고 지내시던 분의 질문을 받았다. Windows Forms 개발을 하는데, 주기적 (대략 1분)으로 데이터 요청을 하는 프로그램을 작성하기 위해서 Timer 를 사용하는데, 어떤 기능을 처리해야 하기 때문에 Sleep 을 같이 사용했다고 한다. 여기서 발생하는 문제는 Sleep 5초를 주었더니, Timer 까지 5초 동안 멈춘다는 것이다. Timer 라는 것은 기본적으로 시간의 흐름을 측정하는 기능이기 때문에 Sleep 을 했다고 해서 Timer 가 멈추는 일은 생겨서는 안된다. 그러나 실제 샘플을 만들어 보면 ... Timer 가 Sleep 만큼 동작이 멈추는 것을 확인할 수 있다. Windows Forms 는 UI Thread 를 사용하는 것으로 최적화 되어 있으며 여기서 Timer 를 쓰면 UI Thread 에 최적화된 System.Windows.Forms.Timer 가 사용된다. 여기서 문제의 발생이 시작되는 것이다. Sleep 을 사용하게 되면 UI Thread 가 Sleep 이 걸리기 때문에 여기에 속한 Timer 까지도 멈추는 것이다. 이런 문제를 해결하기 위해서는 System.Threading.Timer 를 사용해야 한다. 이 Timer 는 별도의 Thread 에서 동작하기 때문에 Sleep 의 영향을 받지 않는다. 언뜻 보면 쉬운 해결 방법인 것 같지만 Thread 가 분리되었기 때문에 Timer 가 돌아가는 Thread 에서 UI Thread 의 메서드나 컨트롤에 접근하기 위해서는 별도의 명령을 사용해야 하는 문제가 존재한다. 자~ 그럼 여기서 Timer 에 대해서 다시 한번 정리해 보도록 하자. .NET 에서 제공하는 Timer 들 .NET 에서는 기본적으로 3가지 Timer를 제공하고 있다. (MSDN) System.Windows.Forms.Timer - 사용자가 지정한 간격마다 이벤트를 발생시키며 Windows Forms 응용 프로그램에서 사용할 수 있도록 최적화 되어 있다. System...

[Logging] NLog 사용법 정리...

SCSF 에는 기본적으로 Enterprise Library가 사용된다. 예전에도 그랬지만 기능은 훌륭하고 많은 부분에서 최적화(?)된 것일지도 모르지만, 역시나 사용하기에는 뭔가 모르게 무겁고, 사용하지 않는 기능이 더 많다라는 느낌을 지울수가 없다. 이번 프로젝트도 SCSF를 기반으로 하고 있지만, Enterprise Library를 걷어내고 각 부분에 전문화된 오픈 소스를 사용하기로 하였다. 예전에는 Log4Net을 사용했지만, 대량 사용자 환경에서는 메모리 누수와 기타 문제점이 존재한다는 MS 컨설턴트(?)의 전해진 말을 들은 후로는 사용하지 않는다. 대안으로 사용하는 것이 NLog 이다. 조금 후에는 3.0 버전도 나온다고 홈 페이지에 기재되어 있지만, 그 때가 되면 프로젝트는 끝나기 때문에 현재 2.1.0 버전을 사용하기로 했다. [원본 출처] http://cloverink.net/most-useful-nlog-configurations-closed/ 위의 참조 자료에는 다양한 정보들이 존재하므로 꼭 링크를 통해서 관련된 정보를 확인하고 이해하는 것이 좋을 듯 하다. 여기서는 당장 필요한 부분만을 정리하도록 한다. [ Logger 찾기 ] 기본적으로 Logger가 존재하는 클래스를 기반으로 Logger 정보를 구성한다. Logger logger = LogManager.GetCurrentClassLogger(); 주로 Namespace 기반으로 Logger를 설정하는 경우에 유연하게 사용할 수 있다. 또 다른 방법으로는 지정한 문자열로 특정 Logger를 직접 선택하는 방법도 제공된다. 이를 혼용해서 Namespace와 직접 지정 방식을 같이 사용할 수도 있다. 물론 Logger 환경 설정에서 Wildcard (*)를 지정할 수도 있다. Logger logger = LogManager.GetLogger("Database.Connect"); Logger logger = LogManager.Get...