[ 개요 ]
- 이 메뉴얼은 Tomcat Servlet/JSP 컨테이너의 동작을 구성하기 위해 conf/server.xml 파일에 포함될 수 있는 모든 설정 (옵션)속성에 대한 정보를 제공한다.
- 특정 작업을 수행하기 위해 어떤 설정 속성을 사용해야 하는지 설명하지 않으며, 그러한 내용은 메인페이지의 User Guide 링크 문서를 참고하길 바란다.
- Tomcat 구성 파일은 스키마 없는 XML 형식으로 작성되며, (Element)요소와 (Attribute)속성은 대문자를 구분한다.
- Apache Ant 스타일의 변수 치환을 지원하며, 시스템 속성 이름이 PropName 인경우 설정파일에 ${PropName} 구문을 사용해 해당 속성을 참조할 수 있다.
- (참조 가능한) 시스템 속성에 포함되는 항목은 다음과 같다.
1) -D 구문으로 설정된 속성
2) JVM 에 의해 자동으로 제공되는 속성
3) $CATALINA_BASE/conf/catalina.properties 파일에 설정된 속성
1. conf/server.xml 파일의 구성요소
- 다음과 같은 주요 카테고리로 구성되어 있다.
1) 최상위 구성요소 (Top Level Elements)
- <Server> : server.xml 파일의 최상위 요소
- <Service> : 특정 Engine 과 연결된 Connector 의 그룹을 나타낸다.
2) 커넥터 (Connectors)
- 외부 클라이언트가 보낸 Request 를 특정 Service 로 Response 응답을 받는 인터페이스
3) 컨테이너 (Containers)
- 들어오는 Request 를 처리하고 해당 Response 를 생성하는 기능을 가진 컴포넌트
1. <Engine> : 특정 Service 의 모든 요청을 처리
2. <Host> : 특정 Virtual Host (가상호스트) 의 모든 요청을 처리
3. <Context> : 특정 WEB_Application 의 모든 요청을 처리
4) 중첩 구성 요소 (Nested Components)
- 컨테이너 요소 내부에 (자식요소로) 중첩될 수 있는 요소를 나타내며 일부 요소는 모든 컨테이너 요소에 중첩될 수 있는 반면, 다른 요소는 Context 내부에만 중첩될 수 있다.
- 실제 설정파일은 다음과 같이 되어있다.
1004lucifer
2. 각 요소에 대한 문서 구조 (Server, Context, Engine 등등)
- 각 요소에 대한 문서는 아래와 같은 일반적인 구조를 따른다. (다른 설정 문서를 볼때 참고)
1) 소개 (Introduction)
- 해당 구성 요소에 대한 전체적인 설명이 제공된다.
- org.apache.catalina 패키지 내의 Java 인터페이스에 해당하며, 하나 이상의 표준 구현체에 의해 구현되어있다.
2) 속성 (Attributes)
- 해당 요소에 사용할 수 있는 속성 집합을 나열한다.
- 일반적으로 다음과 같이 세분화 된다.
1. 공통 속성 (Common Attributes) - 해당 Java 인터페이스의 모든 구현체에서 지원되는 속성
2. 표준 구현 속성 (Standard Implementation) - 해당 인터페이스를 구현하는 특정 Java Class 에서만 지원되는 속성
- 필수 속성의 이름은 (bold)굵게 표시된다.
3) 중첩 구성 요소 (Nested Components)
- 해당 요소에 (자식 요소로) 중첩 가능한 구성 요소를 나열한다.
4) 특수 기능 (Special Features)
- 해당 요소의 표준 구현체에서 지원하는 특수 기능(각 요소 유형에 따라 다름)의 구성을 설명한다.
참고
- https://tomcat.apache.org/tomcat-11.0-doc/config/index.html
댓글
댓글 쓰기