$Id: readme,v 1.13 2001/05/15 18:52:32 clucas Exp $ 발표 노트: ==================== TOMCAT 버전 3.3m3 ==================== 0. 목차: 1. Introduction 2. Tomcat 설치와 실행 3. Tomcat 으로 어플리케이션 개발 4. Tomcat: 과거, 현재, 미래 5. 새로운 기능 6. 알려진 버그와 이슈 ============================================================================= 1. INTRODUCTION 톰캣은 서블릿 컨테이너이면서 JSP(tm) 구현제품입니다. 독립적으로 사용될 수 있으며, 다른 유명한 여러 웹서버들과 함께 연결해서 사용할 수 있습니다: - Apache, version 1.3 또는 이후 버전 - Microsoft Internet Information Server, version 4.0 또는 이후 버전 - Microsoft Personal Web Server, version 4.0 또는 이후 버전 - Netscape Enterprise Server, version 3.0 또는 이후 버전 라이센스 계약을 반드시 읽으십시오(LISENSE 파일 참조). 이 배포판의 모든 소프트웨어 에 적용됩니다. ============================================================================= 2. 톰캣 설치 및 구동 톰캣은 자바런타임환경 JRE1.1 또는 이후 버전이 필요합니다. 즉 Java2 플랫폼입니다. 어플리케이션을 개발하려면 Java 컴파일러가 있어야 합니다. JDK1.1 이후 버전 JAVA2 에 준하는 JDK들을 사용하면 됩니다. 설치과 구동에 관한 자세한 정보는 이 파일과 같은 디렉토리에 있는 "tomcat_ug.html" 파일을 열어보십시오. 주의: 함께 배포되는 문서에 기재가 아직 안된 몇 가지 중요한 Tomcat 3.3m3 의 변화 가 최근에 추가되었습니다. 여러면에서 3.3m3가 3.2와 완전히 구별되는 특징입니다. 다음과 같습니다: - 클래스 로딩: Tomcat 3.3m3 은 현재 클래스 로더의 새로운 구조를 사용합니다. Tomcat컨테이너에서 사용되는 클래스들과 웹 어플리케이션에서 사용되는 클래스들의 분리가 가능해졌습니다. 이 때문에 모든 웹 어플리케이션이 Tomcat의 XML 파서와 공유를 해야하는 중요한 Tomcat 3.2에서의 문제가 해결되었습니다. 각각의 웹 어플리케이션이 따로 XML 파서 를 갖고 있습니다. 만일 원한다면 모든 웹 어플리케이션은 Tomcat이 사용하는 것이 아닌 다른 XML 파서를 공유할 수 있습니다. 부가적으로 Tomcat 3.3m3의 웹어플리케이션은 기본적으로 XML 파서가 지원되기 않습 니다. XML 파서가 필요하다면 따로 설치를 하셔야 합니다. jar 파일을 어디에 두어야 할지에 대한 자세한 정보는 Tomcat 설치된 곳의 "lib/container", "lib/common", "lib/apps" 디렉토리 안에 있는 각각의 README 파일을 읽어보시기 바랍니다. - Tomcat 환경설정: Tomcat의 설정은 분리된 설정파일들로 재구성되었습니다. conf/modules.xml 파일은 3.3m3 버전에서 가능한 모듈들(a.k.a Interceptios)에 대한 모듈 정의를 포함하고 있습 니다. conf/server.xml 파일은 어느 모듈과 커넥터가 그 설정하에서 사용할 것인지 명 확히 합니다. 웹 어플리케이션 설정은 conf/apps.xml 파일이나 name에 따라서 conf/apps-[name].xml 에서 담당합니다. 예를 들면, conf/apps-examples.xml 은 examples 웹어플리케이션을 위한 환경설정파일이 됩니다. tomcat.policy 파일은 "conf"디렉토리에 남아있습니다. 그러나 다른 환경파일들은 "conf"아래 있는 디렉토리로 옮겨졌습니다. Tomcat의 환경설정과 관련된 다른 변화는 자동 생성되는 웹서버 설정 파일들입니다. 대표적인 예로 tomcat-apache.conf 를 들 수 있는데, 이제는 기본적으로 생성되지 않음 이 default 입니다. 이 기능을 사용하시려면, server.xml 파일에 모듈 뒤에 다음 모듈들을 추가해 주시면 됩니다: Apache configs: IIS config: Netscape config: Note: Tomcat 3.2 에서 쓰던 구형 설정법은 Tomcat 3.3m3 에서도 통용됩니다. - Tomcat 테스팅: "test" 웹 어플리케인션은 test-tomcat.xml 파일과 관련된 지원파일 몇가지가 있는데, Tomcat 3.3m3 배포판의 구성요소는 아닙니다. "test" 웹 어플리케이션은 "test.war" 로 분리되어 제공됩니다. 이 파일은 Tomcat 3.3m3의 "v3.3-m3/apps" 에서 다운로드 받을 수 있고 "webapps" 디렉토리에 위치하게 됩니다. test를 기동하는 것은 Tomcat 3.3m3 배포판의 부분인 Admin 웹 어플리케이션에 통합됩니다. 테스트 전에 먼저 해야할 단계는 Admin 웹 어플리케이션에 "trust"를 주는 것입니다. 기본 값은 "untrusted" 로 설정되어있습니다. 바꾸는 법은 TOMCAT_HOME 에서 JAVA_HOME 값이 설정된 상태로 다음 명령을 실행하기 입니다: ./bin/tomcat.sh run -enableAdmin <-- Unix bin\tomcat run -enableAdmin <-- Windows Tomcat 3.3m3 를 시작 또는 재시작하면 브라우저에서 다음 URL이 실행가능합니다:r: http://localhost:8080/admin/test/test.jsp "쿼리 전송"을 클릭하십시오. test 스크립트에 기반한 Ant 의 빌드타겟이 목록화되고, tests가 실행됩니다. tests가 완료된 후에, 결과는 "Failed Tests" 에 먼저 나타나고, 뒤이어 "PASSES Tests"에 나타납니다. 보안상의 이유로, 테스트가 완료한 뒤에, Admin 웹 어플리케이션을 기본 값인 "untrusted" 상태로 되돌리시거나, "admin" 의 password 를 바꾸십시오. Admin 웹 어플리케이션을 "untrusted" 상태로 되돌리려면 Tomcat의 "conf" 디렉토리에 "apps-admin.xml" 에서 trusted="true" 를 trusted="false" 로 바꿔주십시오. Admin 웹 어플리케이션을 "trusted" 로 남겨두시려면 Tomcat의 "conf/users" 디렉토리 에 있는 "admin-users.xml" 파일에 있는 "admin" 의 password를 바꿔야합니다. Watchdog servlet-test.war 와 jsp-test.war 웹 어플리케이션도 "webapps"에 다운받 을 수 있습니다. 이 테스트들은 "test"웹 어플리케이션과 같은 방식으로 구동됩니다. 시작 URL은 다음과 같습니다: http://localhost:8080/admin/test/watchdog-servlet.jsp http://localhost:8080/admin/test/watchdog-jsp.jsp Note: 어떤 경우 watchdog-jsp test 가 실행된 테스트를 목록화하지 못할 수 있습니다. 이 문제를 피하기 위해서 watchdog-servlet.jsp test를 먼저 실행하십시오. ============================================================================= 3. 톰캣으로 어플리케이션 개발 톰캣으로 서블릿/JSP 기반의 어플리케이션을 개발하는 것에 대한 예비 정보는 이 배 포판에 포함된 Application Developer's Guide를 보시면 됩니다. 위치는 "doc/appdev/index.html" 입니다. ============================================================================= 4. Tomcat: 과거, 현재, 미래 - 3.0 버전 (released 12/1999) 최초 배포 버전. Java Servlet 과 Server Pages 설명 과, 이 버전은 최소 아파치 커넥터로 특징질 수 있습니다. - 3.1 버전 (released 4/2000) 아파치 연동을 향상시켰고 Netscape 와 IIS 웹서버 지 원하게 되었습니다. WAR 파일을 지원하고, 자동 서블릿 리로딩, JSP pages 들을 미리 컴파일 하는 command line tool (jspc) 이 추가되었습니다. 마침내 톰캣 3.1 은 코드 재형성에 중점을 두었습니다.(모듈, 클린업, 리팩터링, 죽은코드 제거, J2EE코드의 분리) - 3.2 버전은 처음으로 성능이 향상되었고, 몇 가지 기능이 추가되었습니다. - 3.3 버전은 3.1버전에서 시작된 모듈화, 클린업, 리팩터링의 완결판입니다. 이 작업 은 몇 가지 특징을 가져왔습니다.(다음 섹션을 보십시오.) - 4.0 버전은 3.x 버전과 다르게 개발됩니다. 카탈리나 설계 기반이며, 톰캣 3.x 버 전과는 완전히 다른 설계기반입니다. 아울러 Servlet 2.3 과 JSP 1.2 사양을 지원합 니다. ============================================================================= 5. NEW FEATURES IN THIS RELEASE Tomcat 3.2.x 버전 이후로 많은 새로운 특징들이 추가되었습니다. 그중 가장 중요한 것 은: - 리팩터링의 노력의 결과로 코드의 가독성, 용이성, 성능이 향상되었습니다. - 태그 핸들러 풀링이 추가되었습니다. (기본값은 사용안함으로 되었음) 만약 많은 커스 텀 태그를 사용한다면 성능향상을 위해 태그 풀링을 사용하시면 될 것입니다. 사용하 려면 어플리케이션 Context 섹션에 TagPoolManagerInterceptor 모듈을 추가해줍니다. conf/server.xml 에 더 자세한 안내가 있습니다. - (추가 예정) ============================================================================= 6. 알려진 버그와 이슈 6.1 윈도우에서는 Document Root 지정에 절대경로 사용하기 TOMCAT_HOME/conf/server.xml 파일에서 docRoot 속성에 대한 상대, 절대 경로 디렉토리 를 선언할 수 있습니다. 만일 윈도우 시스템에서 절대 경로를 사용하고 싶다면, 이 플랫폼 의 절대경로에 대한 Java 의 선언과 일치해야 하기 때문에 드라이브명을 포함해야 합니다: GOOD: c:\mydirectory\mydocroot GOOD: c:/mydirectory/mydocroot BAD: \mydirectory\mydocroot BAD: /mydirectory/mydocroot Unix에서는, 절대 경로명은 슬래시 문자('/') 로 시작해야 합니다. 6.2 컨테이너가 보안을 관리합니다. Tomcat 3.2 와 이후의 버전은 Servlet API 2.2 스펙, section 11 에 기술된 대로, 컨테이 너가 관리하는 보안이 구현되어있습니다. 이 구현에 대해서 다음 정보를 알아두시기 바랍니 다: - BASIC 과 FORM 기반의 인증은 옳게 작동합니다. 다른 버그를 발견하신다면 에 알려주시기 바랍니다. 예제 어플리케이션은 다음 주소에 선언된 보호영역이 있습니다: http://localhost:8080/examples/jsp/security/protected 접근하는 법은 $TOMCAT_HOME/conf/tomcat-users.xml 설정파일에 정의된 사용자입니다. 적절한 역할이 주어지게 됩니다. Form-based 인증은 기본적으로 사용됩니다. 그러나 Basic 인증을 사용해 보시고 싶다면 주석표시를 지워서 사용하시기 바랍니다. WARNING: Basic 인증은 인터넷이나 다른 보안이 취약한 네트웍상에서 일반적인 보안 사용 으로 적합하지 않습니다. 왜냐하면 사용자명과 암호가 인코드되어있지만 암호화 되지는 않았기 때문입니다. - DIGEST 인증과 HTTPS client 인증(예 SSL) 은 이 버전에서는 지원되지 않습니다. 6.3 Welcome File에서 RequestDispatcher.include() 사용하기 다음과 같은 테크닉을 사용하면 잘못된 내용을 응답하게 됩니다: - Document 루트 아래 서브디렉토리가 있습니다. (예를 들면 "subdir/"). - 이 서브디렉토리는 URL에서 이 서브디렉토리가 호출될 때 보여지도록 설정해 놓은 welcome 파일을 갖고 있습니다(예를 들면 "index.html"). - "/subdir"나 "/subdir/" 경로에 대한 RequestDispatcher 를 요청합니다. 그리고 그것에 대해 include()를 호출합니다. "/subdir" 이나 "/subdir/" 을 할 때 똑같이 문제가 발생합니다. 해결법은 보여주기 원하는 "/subdir/index.html" 와 같은 파일의 문맥에따른 완전 한 경로에 대해 RequestDisptcher를 요청하는 것입니다. 6.4 자동 서블릿 리로딩 Tomcat 3.2와 이후 버전은 변경된 servlet 클래스(WEB-INF/classes directory 나 WEB-INF/lib directory 에 있는 JAR 파일)를 자동적으로 리로드하는 특징을 갖고 있습니다. 이 특징은 실험적이며, 완전히 동작하지 않을 수도 있습니다. 특히, 요청한 서블릿 이외의 클래스에 관한 변화 때문에 class를 다시 불러오지 않습니다. 이 것을 적용하려면 Tomcat을 재시동할 필요가 있습니다. 리로딩을 가능하게 하려면 "conf/server.xml" 파일에 있는 엘리먼트의 속성에 reloadable="true"을 넣어주면 됩니다. 기억할 것은 개발이 완료된 어플리 케이션의 경우 이 기능은 실험적인 것이기 때문에 추천하지 않습니다. 요청 때마다 필요한 체크를 해야하기 때문에 쓸데없는 과부하가 걸릴 수 있기 때문입니다. 6.5 getRequestURI() 에서 반환되는 String 2000년 4월 27일자 Servlet 2.2 정오표에 보면 HttpServletRequest 의 메소드 getServletPath, getPathInfo, getPathTranslated 는 디코드된 스트링을 반환 해야 합니다. 반면에 getRequestURI() 과 getContextPath()은 인코드된 채로 남아있습니다. 현재, Tomcat 3.3 은 getRequestURI 를 인코드된 상태가 아닌 디코드된 값으로 반환합니다. 이것은 Tomcat 3.3 정식판이 나오기 전에 수정될 것입니다. 6.6 Windows 95/98 에서 "환경변수 저장공간이 부족합니다." error 해결법 이 에러는 Tomcat을 실행하기에는 전형적으로 부족한 환경변수 저장공간 기본값으로 정해져 있을 때 쉽게 일어납니다. 해결법은 다음 두가지가 있습니다. A. 만일 MS-DOS 프롬프트 창에서 Tomcat을 실행한다면, 프로그램 -> MS-DOS 창을 실행합니다. 창의 제목줄의 왼쪽에 MS-DOS 아이콘을 마우스 오른 버튼으로 클릭해서 메뉴의 맨 아래 있는 등록정보를 선택합니다. MS-DOS 프롬프트 등록정보 창에서 메모리 탭을 선택합니다. "초기 환경:" 의 값을 충분히 높은 값으로 설정합니다. 대략 3072 정도면 충분합니다. 확인버튼을 클릭해서 창을 닫습니다. 다시 프로그램 -> MS-DOS 창을 띄우고, Tomcat이 설치된 디렉토리로 이동합니다. JAVA_HOME 환경 변수값을 정해주지 않았다면 설정해줍니다. "bin\startup" 과 "bin\shutdown" 을 실행할 수 있습니다. "환경변수 저장공간이 부족합니다." 라는 에러는 나오지 않 을 것입니다. B. startup.bat 파일과 같은 batch파일을 더블클릭해서 톰캣을 실행하려고 한다면, 윈도우 탐색기에서 해당파일을 오른버튼 클릭으로 등록정보창을 엽니다. 메모리 탭 을 선택하고 "초기 환경:" 값을 위와 같이 설정합니다. 프로그램 탭을 클릭해서 "종료후 창닫기"를 체크합니다. 확인 버튼을 클릭합니다. 이 설정값을 갖고 있는 바로가기 아이콘이 패치파일과 같은 같은 디렉토리에 생깁니다. "환경변수 저장 공간이 부족합니다." 에러는 나오지 않을 것입니다. 이같은 방식으로 startup.bat 파일과 shutdown.bat 파일을 실행하려면 모두 위와 같이 설정해주어야 합니다. 덧붙여서, JAVA_HOME 세팅도 필요합니다. "SET JAVA_HOME=jdk경로" 를 autoexec.bat 파일이나 startup.bat, shutdown.bat 파일에 넣어주어야 합니다. 6.7 URL은 현재 모든 OS 에서 대소문자구별을 합니다. Tomcat 3.2에서, URL은 모든 OS에서 대소문자 구분을 합니다. windows 같이 대소문자 구분을 하지 않는 File 시스템을 갖고 있는 os에서도 마찬가지로 구분을 해줍니다. Tomcat 3.1 과 다른 점입니다. Tomcat 3.1은 대소문자 구별하지 않는 OS에서는 대소 문자 구분을 하지 않았습니다. 보안과 이식성등 여러가지 이유로 구분을 하게 되었습니다. 대소문자 구분하지 않는 OS와 Tomcat 3.1에서 돌아가던, 대소문자가 일치하지 않는 "이동이 안되는(non-protable)" 웹 어플리케이션을 Tomcat 3.2 이후의 버전에서 돌려 보면 확실히 안된다는 것을 확인할 수 있습니다. 올바로 보이는 URL 이 실제로는 틀릴 수도 있게 됩니다. 윈도우 탐색기에서는 이름이 MS-DOS 의 8.3 형식에 적합한 경우 "형식에 맞는" 이름을 사용하면 보여질 수도 있습니다. 예를 들어, "MYDIR"인 디렉토리명이 "Mydir"로 표시될 수 있습니다. 주소가 "http:// localhost/mysite/Mydir/index.jsp" 와 같다면 "File Not Found" 가 나타납니다. 왜냐 하면 URL의 올바른 값은 "http://localhost/mysite/MYDIR/index.jsp"이기 때문이죠. 맞는 URL인 것 같은데 "not found"가 나온다면 대소문자가 일치하는지 확인해보십시오. 윈도우 탐색기 등록정보나 MS-DOS 창을 사용해서 파일과 디렉토리의 실제 대소문자가 어떻게 되는지 확인하십시오. 이 때문에 정적인 컨텐츠의 웹서버 역할을 하는 IIS 같은 대소문자를 구분하지 않는 웹서버에서 부가적인 문제가 생길 수 있습니다. 이 IIS는 주소줄에 있는 대소문자 구분 없이 정적인 페이지들을 전송합니다. 만일 정적인 페이지에 Tomcat에 의해 처리되는 페이지가 대소문자가 구분되지 않은 채로 링크되어 Tomcat에 보내진다면 resource 가 없다는 에러를 유발할 수 있습니다. 6.8 웹 커넥터에 대한 자동 생성 설정 파일들 시작할 때, Tomcat은 정상적으로 "tomcat-apache.conf" 와 같은 설정파일들을 선언된 컨텍스트를 반역하기 위해 생성합니다. 그러나 생성된 파일들은 웹 어플리케이션 설치 설명 파일 내부(web.xml)에 있는 세팅환경은 아무것도 반영하지 않습니다. 따라서 웹서 버 설정파일들에 직접적으로 필요한 설정들을 셋업해 줄 필요가 있습니다. 이것은 Tomcat 3.2 와 이후 버전에서 웹 커넥터 설계의 알려진 한계입니다. 그리고 Tomcat 4.x 에서는 MOD_WARP 커넥터의 소개부분에 다시 한번 언급될 것입니다. 6.9 Limitation on Form Based Login 만일 또는 의 지정한 페이지가 보안에 걸린 곳에 위치한다면, Tomcat 3.3 은 보여주지 않습니다. 이런 문제 때문에 form 기반 login을 사용할 때 "/*" URL 패턴으로 전체 웹 어플리케이션을 보호할 수 없습니다. 돌아가는 법은 웹어플리케이션 셋업 시 form login 페이지와 form error 페이지를 Document Root 디렉토리에 있게 하는 것이고, 다른 페이지들은 서브 디렉토리 하나 이상 만들어 그 안에 위치시킨 후에, 그 하부 디렉토리들에 보안을 거는 것입니다. 6.10 Limitation on Document Base Paths Tomcat 3.3 은 다음과 같이 지시자에 있는 윈도우의 SMB 경로를 지원하지 않습니다(network 공유폴더): 그러나 이 기능은 Tomcat 3.1에서 지원되었었고, 4.x버전에서도 지원될 것입니다. "\\machine\share" 가 네트웍드라이브가 설정이 된 다음에는 다음과 같이 선언할 수 있습니다: "r:"은 매핑된 드라이브 명입니다.