The Host Container

Host 엘리먼트는 가상호스트(virtual host)를 나타냅니다. 가상호스트는 한 서버의 네트워크 명칭("www.mycompany.com" 같은) 과, Catalina가 구동 중인 그 서버와 결합되어 표현됩니다. 효율적으로 하기 위해서 이 이름은 반드시 당신이 속한 인터넷 도메인을 관리하는 Domain Name Service (DNS) 서버에 등록되어야 합니다. 이에 대한 더 자세한 정보는 당신의 네트워크 관리자에게 문의하십시오.

많은 경우, 시스템 관리자는 여러개의 네트워크 명칭(예를 들어 www.mycompany.com과 company.com 같이)을 같은 가상호스트와 같은 어플리케이션에 결합시키기를 원합니다. 이러한 경우에는 아래에 설명할 호스트명 에일리어스(Host Name Aliases)를 사용하면 됩니다.

Engine 엘리먼트 안에는 하나 이상의 Host 엘리먼트를 중첩시킬 수 있습니다. Host 엘리먼트 안에는 이 가상 호스트에 탑재할 각각의 웹어플리케이션 설정을 위한 Context 엘리먼트를 중첩시킬 수 있습니다. 각 Engine에 연결된 여러 개의 Host 중, 반드시 하나의 Host 만이 그 Engine의 defaultHost 속성에 지정된 값과 같은 이름을 가질 수 있습니다.

이하의 설명에서는 $CATALINA_HOME 변수명을 사용하여 당신이 Tomcat 4를 설치한 디렉토리를 참조하며, 이 디렉토리가 대부분의 상대경로에 대한 기준 디렉토리(base directory)가 됩니다. 그러나 만약 CATALINA_BASE 디렉토리를 설정하여 Tomcat 4를 여러개 설치했다면, 이러한 디렉토리 변수 참조에 대해 $CATALINA_HOME 대신 $CATALINA_BASE 를 사용해야 합니다.

공통속성(Common Attributes)

Host의 모든 구현체는 다음과 같은 속성들을 지원하게 됩니다: 속성 설명 appBase 이 가상호스트에 대한 어플케이션의 기준(Application Base) 디렉토리. 이는 이 가상호스트에 배치될 웹어플리케이션 들을 가지고 있는 디렉토리의 패스명입니다. 이 디렉토리의 절대경로명을 지정할 수도 있으며, 또는 $CATALINA_HOME 디렉토리에 상대적인 경로명을 지정할 수도 있습니다. 자동으로 배치될 웹어플리케이션 들의 자동인식과 자동배치에 대한 자세한 정보는 어플리케이션의 자동배치(Automatic Application Deployment)를 참고하기 바랍니다. autoDeploy 이 플래그 값은 이 호스트의 웹어플리케이션 들은 호스트 설정자(host configurator)에 의해 자동으로 배치(deploy)되어야 함을 나타냅니다. 이 플래그의 디폴트값은 true 입니다. 더 자세한 정보는 어플리케이션의 자동배치(Automatic Application Deployment)를 참고하기 바랍니다. className 사용할 구현체의 Java 클래스명. 이 클래스는 반드시 org.apache.catalina.Host 인터페이스를 구현해야 합니다. 지정하지 않으면 표준값(아래에 정의됨)이 사용될 것입니다. name 당신의 Domain Name Service 서버에 등록된 이 가상호스트의 네트워크 명칭. Engine에 포함된 Host 중 하나는 반드시 그 Engine의 defaultHost 세팅과 일치하는 이름을 가져야 합니다. 하나 이상의 네트워크 명칭을 같은 가상호스트에 할당하는 방법에 대해서는 호스트명 에일리어스(Host Name Aliases)를 참조하십시오.

표준구현체(Standard Implementation)

Host의 표준구현체는 org.apache.catalina.core.StandardHost 클래스입니다. 이 구현체는 위에 나열된 공통속성 외에도 다음과 같은 부가적인 속성을 지원합니다: 속성 설명 debug 이 Host가 해당 로거에 디버깅 로그를 출력하는 상세수준을 의미합니다. 숫자가 높을 수록 더 자세한 출력을 생성합니다. 지정하지 않으면, 디버깅 상세수준의 디폴트 값은 0 입니다. deployXML Context XML 설정 파일을 사용하여 어플리케이션을 배치하는 기능을 끄고 싶다면 false로 지정하십시오. 배치되는 어플리케이션 들은 Catalina의 보안권한(security permissions)가 주어집니다. 만약 신뢰할 수 없는(untrusted) 사용자가 웹어플리케이션에 접근가능한 상황이라면 보안상 false로 할 필요가 있습니다. 디폴트 값은 true입니다. errorReportValveClass 이 Host가 사용할 오류보고밸브(error reporting valve)의 Java 클래스명. 이 밸브의 임무는 에러보고를 출력하는 것입니다. 이 속성을 설정하면 Tomcat이 생성하는 에러페이지의 외관(look)을 커스터마이즈 할 수 있습니다. 이 클래스는 반드시 org.apache.catalina.Valve 인터페이스를 구현해야 합니다. 아무것도 지정하지 않은 경우에는 org.apache.catalina.valves.ErrorReportValve가 디폴트로 사용됩니다. liveDeploy Tomcat 운영 도중에 appBase 디렉토리에 새로운 웹어플리케이션을 추가했을 경우, 이 플래그 값이 true이면 이 웹어플리케이션이 자동으로 배치됩니다. 디폴트 값은 true입니다. 더 자세한 정보는 어플리케이션의 자동배치(Automatic Application Deployment)를 참고하기 바랍니다. unpackWARs 웹어플리케이션이 appBase 디렉토리에 웹어플리케이션 아카이브(WAR) 파일로 존재할 때, WAR 파일을 해당 디스크 디렉토리 구조로 풀어서(unpack) 실행되길 원하는 경우에는 true로 설정하십시오. false로 설정하면 WAR 파일형태로 직접 실행됩니다. 더 자세한 정보는 어플리케이션의 자동배치(Automatic Application Deployment)를 참고하기 바랍니다. workDir 이 Host에서 사용할 임시 디렉토리에 대한 경로명입니다. 이 디렉토리는 관련 웹어플리케이션의 서블릿들이 임시로 읽기-쓰기 작업을 하는 용도로 사용합니다. 웹어플리케이션의 서블릿들은 이름이 javax.servlet.context.tempdir인 서블릿-컨텍스트 속성(타입은 java.io.File)을 통해 이 디렉토리를 볼 수 있으며, 이 내용은 서블릿 스펙에 기술되어 있습니다. 지정하지 않은 경우에는 적절한 디렉토리가 $CATALINA_HOME/work 아래에 제공됩니다.

이 Host 엘리먼트 안에는 하나 이상의 Context를 중첩시킬 수 있습니다. 각 Context는 이 가상호스트에 연관된 각기 다른 웹어플리케이션을 나타냅니다. 또한 향후에 배치될 웹어플리케이션들에 대한 기본 값을 정의하는 DefaultContext를 여기에 포함시킬 수 있습니다.

또한 이 Host 엘리먼트 내에 DefaultContext를 포함시켜서, 자동으로 배치되는 웹어플리케이션의 디폴트 특성을 정의할 수 있습니다.

Host 엘리먼트 내에는 다음과 같은 유틸리티 컴포넌트의 해당 엘리먼트를 각각 하나까지 포함시킬 수 있습니다:

• Logger - 이 Host에 대한 모든 로그 메시지를 받아서 처리할 로거(logger)를 설정합니다. 또 이 로거는 하위에서 Logger 설정을 따로 하지 않는 경우, 이 Host와 연결된 하위의 Context에서의 로그 메시지도 처리합니다.
• Realm - 영역(realm)을 설정하여, 사용자와 사용자의 역할을 저장할 데이터베이스를 이 Host에 포함된 모든 Context에서 공유할 수 있도록 합니다. 하위에서 Realm 설정을 재정의할 수도 있습니다.

액세스 로그(Access Logs)

웹서버를 운영할 때 일반적으로 생성되는 출력 파일중 하나가 액세스 로그(access log)입니다. 이 로그는 서버가 처리하는 각 요청마다 표준 포맷에 따라 한 라인씩 출력합니다. Catalina에서는 Valve 구현체를 사용자가 임의로 선택하여, 웹서버들이 표준 포맷에 따라 생성하는 액세스 로그와 같은 포맷의 로그를 생성할 수도 있고 또는 다양한 커스텀 포맷으로 로그를 생성할 수 있도록 하고 있습니다. 당신은 Catalina에 Engine, Host, 또는 Context가 처리하는 모든 요청에 대한 액세스 로그를 생성하도록 지시할 수 있는데, 이는 다음과 같이 Valve 엘리먼트를 중첩시키면 됩니다: <Host name="localhost" ...> ... <Valve className="org.apache.catalina.valves.AccessLogValve" prefix="localhost_access_log." suffix=".txt" pattern="common"/> ... </Host> 제공되는 설정 속성에 대한 더 많은 정보는 액세스 로그 밸브(Access Log Valve)에서 볼 수 있습니다.

어플리케이션의 자동배치(Automatic Application Deployment)

만약 표준 Host 구현체를 사용하고 있고 동시에 autoDeploy 값이 true(디폴트값)로 설정되어 있다면, Catalina가 처음 기동될 때 다음의 작업들이 자동으로 수행됩니다: 이 디렉토리에 있는 모든 XML 파일은 각각 어떤 웹어플리케이션에 대한 Context 엘리먼트를 포함하고 있다고 가정하게 됩니다. 이 <Context> 엘리먼트의 docBase 속성은 대개 한 웹어플리케이션 디렉토리 또는 웹어플리케이션 아카이브(WAR) 파일(확장되지 않음 - 즉 WAR파일이 풀리지 않음)에 대한 절대경로명이 될 것입니다. unpackWARs 프로퍼티를 false로 지정하지 않고, 웹어플리케이션 아카이브 파일이 ".war" 확장자를 뺀 파일명과 같은 이름의 디렉토리를 아카이브 내에 가지고 있지 않은 경우, 자동으로 언팩(unpack)됩니다. 만약 수정된 WAR 파일을 재배치(redeploy)하는 경우, Tomcat을 재시작할 때는 반드시 확장된 디렉토리(즉 WAR파일이 풀린 디렉토리)를 삭제해야만 합니다. 이렇게 해야 새로운 WAR 파일이 다시 언팩됩니다. 어플리케이션의 기준 디렉토리(application base directory) 안의 어떤 서브디렉토리가 언팩된 웹어플리케이션으로 인식된다면(즉 /WEB-INF/web.xml을 포함한다면) 이 서브디렉토리는 conf/server.xml 파일에서 따로 언급되지 않아도, 자동으로 생성된 Context 엘리먼트를 받을 것입니다. 이 Context 항목은 이 Host 엘리먼트 내에 포함된 DefaultContext 설정의 프로퍼티 설정에 맞춰 설정될 것입니다. 이렇게 배치되는 Context에 대한 컨텍스트경로는 슬래시문자("/") 다음에 디렉토리명이 붙는 형태가 됩니다. 만약 디렉토리명이 ROOT 라면, 이 경우엔 컨텍스트경로가 빈 문자열("")이 됩니다. 기동(startup)시에 벌어지는 자동배치 외에도, Tomcat이 구동중(running)일 때 새 XML 설정파일, WAR 파일, 또는 웹어플리케이션을 담고 있는 서브디렉토리를 appBase에 놓은 다음, 이를 위에 설명된 규칙에 따라 자동으로 배치하라고 Tomcat에 요청할 수 있습니다.

호스트명 에일리어스(Host Name Aliases)

많은 서버 환경에서 네트워크 관리자들은 서버의 IP 주소로 해독(resolve) 되는 하나 이상의 네트워크 명칭(Domain Name Service (DNS) 서버에 있는)을 설정하곤 합니다. 보통 이런 네트워크 명칭은 conf/server.xml 에서 별도로 Host 엘리먼트로 설정됩니다. 이 각각의 Host 엘리먼트는 자신만의 웹어플리케이션 집합을 가지게 됩니다. 그러나 일부 환경에서는 둘 이상의 네트워크 명칭을 같은 가상호스트로 해독되어야 좋은 경우가 있습니다. 이런 경우는 대개 기업의 웹사이트에서 많이 발견됩니다. 즉 사용자가 www.mycompany.com를 써도 company.com를 써도, 정확히 같은 컨텐츠와 어플리케이션에 액세스되어야 되는 경우입니다. 이러한 경우에는 하나 또는 그 이상의 Alias 엘리먼트를 Host 엘리먼트 내에 포함시키면 됩니다. 예를 들면: <Host name="www.mycompany.com" ...> ... <Alias>mycompany.com</Alias> ... </Host> 이러한 방안을 효율적으로 처리하려면 관련된 모든 네트워크 명칭을 당신의 DNS 서버에 등록해서, 모든 네트워크 명칭이 Catalina가 구동중인 바로 그 컴퓨터로 해독되어야 합니다.

생명주기 리스너(Lifecycle Listeners)

만약 이 Host가 언제 시작되고 종료되는지 어떤 Java 객체가 알 필요가 있다면, 이 엘리먼트 안에 Listener 엘리먼트를 포함시켜서 그 Java 클래스명을 선언하면 됩니다. 이 때 지정하는 Java 클래스는 org.apache.catalina.LifecycleListener 인터페이스를 반드시 구현해야 하며, 해당 생명주기 이벤트 발생에 대해 통지를 받게 될 것입니다. 리스너의 설정은 다음과 같습니다: <Host name="localhost" ...> ... <Listener className="com.mycompany.mypackage.MyListener" ... > ... </Host> Listener는 이 엘리먼트에 설정될 추가 프로퍼티를 얼마든지 가질 수 있음을 기억하십시오. 속성명은 표준 프로퍼티 메소드(getter/setter) 명명규칙을 사용하는 해당 JavaBean 속성명에 매칭됩니다.

요청필터(Request Filters)

어떤 Context, 또는 상위의 Engine, Host 엘리먼트에서 수신하는 모든 요청에 대해, IP 주소나 호스트명 등을 Catalina가 검사하도록 지시할 수 있습니다. 원격지 주소나 이름은 설정된 "허가(accept)" 그리고/또는 "거부(deny)" 리스트에 대해 검사하며, 이러한 설정은 Jakarta Regexp 정규표현식(regular expression) 라이브러리에 의해 지원되는 정규표현식 문법에 따라 정의됩니다. 허가되지 않은 위치에서 보낸 요청은 HTTP "Forbidden" 오류와 함께 거부됩니다. 필터 선언의 예는 다음과 같습니다: <Host name="localhost" ...> ... <Valve className="org.apache.catalina.valves.RemoteHostValve" allow="*.mycompany.com,www.yourcompany.com"/> <Valve className="org.apache.catalina.valves.RemoteAddrValve" deny="192.168.1.*"/> ... </Host> 지원되는 설정 옵션에 대한 더 자세한 정보는 원격지 주소 필터(Remote Address Filter)와 원격 호스트 필터(Remote Host Filter)에서 볼 수 있습니다.

단일 인증(Single Sign On)

많은 경우 중에서도 특히 포탈사이트의 경우에는, 어떤 가상호스트의 여러 웹어플리케이션 집합에 대하여 사용자가 인증정보를 한번만 입력하게 하는 것이 바람직합니다. 이런 경우엔 이 가상호스트에 대한 Host 엘리먼트 안에 다음과 같은 엘리먼트를 포함시키면 됩니다: <Host name="localhost" ...> ... <Valve className="org.apache.catalina.authenticator.SingleSignOn" debug="0"/> ... </Host> 단일 인증(Single Sign On) 기능은 다음 규칙들에 따라 작동합니다: 이 가상호스트에 설정된 모든 웹어플리케이션은 같은 Realm을 공유해야 합니다. 실제로 이 말은 이 Host 엘리먼트(또는 이 Host를 포함한 Engine 엘리먼트) 내에 Realm 엘리먼트를 포함시킬 수 있다는 뜻입니다. 하지만 관련된 웹어플리케이션중 하나만을 대상으로 하는 Context 엘리먼트에 이 Realm을 포함시키는 것은 틀립니다. 사용자가 이 가상호스트의 웹어플리케이션 중 보호되지 않는(unprotected) 자원에만 액세스하는 한, 사용자는 인증절차를 거치지 않을 것입니다. 사용자가 이 가상호스트의 어떤 웹어플리케이션이라도 그 웹어플리케이션의 보호된(protected) 자원에 액세스한다면, 그 즉시 사용자는 인증절차를 거치게 됩니다. 인증절차는 현재 액세스하고 있는 웹어플리케이션에 대해 정의된 로그인 방법(login method)을 사용하여 이루어집니다. 한번 인증이 이루어지면, 모든 관련 웹어플리케이션들에 걸쳐서 액세스 제어 결정(access control decisions)에 대해 이 사용자의 역할(roles)이 이용될 것입니다. 사용자는 한번만 인증되면 나머지 웹어플리케이션 각각에 대해 인증절차를 거칠 필요가 없습니다. 사용자가 한 웹어플리케이션에서 로그아웃하면(예를 들어 form 기반 로그인이 사용되는 경우에는 해당 세션을 종료(invalidate)시키거나 세션 타임아웃이 발생함으로써), 그 즉시 모든 웹어플리케이션에서의 사용자 세션이 종료될 것입니다. 그 후에 어떤 웹어플리케이션의 보호된 자원에 액세스하려는 시도가 발생하면, 다시 그 사용자는 인증절차를 거쳐야 합니다. 단일 인증(Single Sign On) 기능은 저장된 사용자 정보(user identity)에 각각의 요청을 연결시키는 토큰을 전송하기 위해서 HTTP 쿠키를 활용합니다. 따라서 이 기능은 클라이언트 환경이 쿠키를 지원할 때에만 이용이 가능합니다.

사용자 웹어플리케이션(User Web Applications)

다수의 웹서버들은 틸드문자("~")로 시작하는 요청 URI와 사용자명을, 서버에 있는 그 사용자 홈디렉토리 안의 어떤 디렉토리(보통 public_html라는 이름을 가집니다)에 자동으로 매핑시킬 수 있습니다. Catalina에서 이와 같은 작업을 하려면, 특별한 Listener 엘리먼트를 아래와 같이(사용자를 인증하기 위해 /etc/passwd 파일을 사용하는 Unix 시스템의 경우입니다) 사용하면 됩니다: <Host name="localhost" ...> ... <Listener className="org.apache.catalina.startup.UserConfig" directoryName="public_html" userClass="org.apache.catalina.startup.PasswdUserDatabase"/> ... </Host> /etc/passwd 파일을 사용하지 않는 서버에서 위와 같은 지시를 하고자 한다면, 지정한 기준 디렉토리(아래 예에서는 c:\Homes) 하위의 모든 디렉토리를 "사용자의 홈디렉토리"로 간주하도록 Catalina에 지시할 수 있습니다: <Host name="localhost" ...> ... <Listener className="org.apache.catalina.startup.UserConfig" directoryName="public_html" homeBase=c:\Homes" userClass="org.apache.catalina.startup.HomesUserDatabase"/> ... </Host> craigmcc라는 이름의 사용자에 대해 사용자 홈디렉토리가 설치되었다면, 클라이언트 브라우저에서 아래와 같은 URL에 대한 요청을 함으로써 그 디렉토리의 내용을 볼 수 있습니다: http://www.mycompany.com:8080/~craigmcc 이 기능을 제대로 활용하려면 다음의 고려사항을 잘 이해해야 합니다: 이 Host에 대해 당신이 설정한 DefaultContext 엘리먼트가 있다면, 각 사용자 웹어플리케이션(user web application)은 이 엘리먼트 설정에 따라 배치됩니다. 하나 이상의 Listener 엘리먼트를 포함시킬 수도 있습니다. 하지만 이는 여러개의 "homeBase" 디렉토리를 설정하고 싶은 경우에만 쓸모가 있습니다. Catalina를 실행한 운영체제 사용자는, 반드시 각 사용자의 웹어플리케이션 디렉토리와 그 하위의 내용에 대해 읽기 권한을 가지고 있어야 합니다.