IIS와 자카르타

글: 최종명

이것 저것 바쁜일들이 많아서 5월 1일에 올리겠다던 글을 오늘(10일)에서야 올리게 되었네요. 혹시 자카르타를 사용하시는 분들에게 도움이 될까해서 올립니다.

IIS 웹서버와 자카르타를 결합하는 방법에 대해서 알아보자. 이 설정은 윈도우즈 NT, 자카르타 3.1, IIS 4.0 서버에서 테스트한 내용이다. 현재 자카르타는 D:\jakarta-tomcat 디렉토리에 설치되어 있다고 가정한다. 앞으로 <jakarta-tomcat>은 자카르타가 설치되어 있는 디렉토리를 의미한다.

자카르타와 IIS를 결합하기 위해서는 isapi_redirect.dll 파일이 필요하다. 이 파일은 http://jakarta.apache.org/ 사이트에서 다운로드 받을 수 있다. <jakarta-tomcat>에 iis라는 디렉토리를 생성하고, isapi_redirect.dll 파일을 이곳에 복사한다.

다음 작업은 NT의 레지스트리를 새로 생성해주어야 한다. 시작 메뉴의 "실행" 부분을 선택해서 레지스트리 편집기(regedit)를 실행시킨다.

 

 

 

 

레지스트리 편집기가 나타나면 SOFTWARE 부분을 클릭하고, 편집기의 오른쪽 부분에서 마우스 오른쪽 버튼을 클릭하면 "새로 만들기" 메뉴가 나타난다. 이곳에서 "키(K)"를 선택한다. 레지스터리 키를 다음과 같은 계층 구조로 작성한다.

 

 

예:

"HKEY_LOCAL_MACHINE\SOFTWARE\Apache Software Foundation\Jakarta Isapi Redirector\1.0"

 

 

 

 

레지스터리 키를 모두 생성하면 다음 그림의 왼쪽과 같은 형태의 트리로 나타난다. 키를 모두 생성하였으면 그림의 오른쪽과 같은 형태로 문자열 값을 등록해야 한다. 문자열 값을 등록하기 위해서는 레지스터 편집기의 오른쪽 부분에서 마우스 오른쪽 버튼을 클릭해서 "문자열 값(S)"를 선택한다. 새로운 문자열이 나타나면 이름을 변경하고, 다시 마우스 버튼을 클릭하면, 값을 수정할 수 있는 메뉴가 나타난다.

 

 

 

 

문자열 값에서 등록해야 하는 값들은 다음과 같다. <jakarta-tomcat>는 자카르타가 설치되어 있는 디렉토리이다. 이 값을 자카르타가 실제로 설치되어 있는 디렉토리에 맞게 고쳐주어야 한다.

 

 

이름

데이터

extension_uri

/jakarta/isapi_redirect.dll

log_file

<jakarta-tomcat>\logs\isapi.log

log_level

debug

worker_file

<jakarta-tomcat>\conf\workers.properties

worker_mount_file

<jakarta-tomcat>\conf\uriworkermap.properties

 

 

레지스터리 편집이 완료되었으면, IIS 서버의 세팅을 변경해주어야 한다. 시작 메뉴에서 IIS 서버의 Management Console 프로그램을 실행시킨다. 이 프로그램은 다음 그림과 같은 형태로 실행된다.

 

 

 

 

Default Web Site에서 마우스 오른쪽 버튼을 클릭하면 New에서 가상 디렉토리를 만들 수 있다. 가상 디렉토리 메뉴를 선택하면 다음 그림과 같은 다이얼로그가 나타난다. 처음에 가상 디렉토리의 이름을 물어보는데, 가상디렉토리의 이름은 "jakarta"로 설정한다.

 

 

 

 

다음 단계에서 가상 디렉토리의 실제 디렉토리를 물어보면 "D:\jakarta-tomcat\iis" 값을 입력한다. 이 단계는 다음 그림과 같은 형태로 보여진다.

 

 

 

 

다음에는 IIS 서버에 필터를 설정하는 작업이 필요하다. IIS에 필터를 설정하기 위해서는 Default Web Site에서 마우스 오른쪽 버튼을 클릭하면 "Properties" 메뉴가 나타난다. 이 메뉴를 선택하면 다음 그림과 같은 다이얼로그가 화면에 나타난다. 이 화면에서 "ISAPI 필터"를 선택한다.

 

 

 

 

"ISAPI 필터"를 선택하면 필터를 추가하기 위한 메뉴가 나타난다. 추가 메뉴를 선택하면 다음 그림과 같은 다이얼로그가 나타난다. 이때 필터 이름은 "jakarta", 실행 파일은 "D:\jakarta-tomcat\iis\isapi_redirect.dll"로 설정한다.

 

 

 

 

이로서 모든 작업은 완료되었다. 이제 IIS 서버를 중지시켰다가 다시 시작시킨다. IIS 서버가 다시 시작한 다음에 ISAPI 필터 부분을 다시 방문해보면 다음 그림과 같이 jakarta 필터의 상태가 녹색으로 화살표가 위로 향하고 있으면 정상적으로 작동하는 것이다.

 

 

 

 

이제 자카르타를 실행시키고 http://localhost/example/ 디렉토리를 방문한다. IIS와 자카르타를 결합해도 자카르타는 실행시켜야 정상적으로 작동한다.