Tomcat的配置文件

Tomcat的配置文件詳解

一.Tomcat的配置文件

Tomcat的配置文件默認存放在$CATALINA_HOME/conf目錄中，主要有以下幾個：

1.server.xml:

Tomcat的主配置文件，包含Service, Connector, Engine, Realm, Valve, Hosts主組件的相關配置信息；

2.web.xml：

遵循Servlet規范標準的配置文件，用于配置servlet，并為所有的Web應用程序提供包括MIME映射等默認配置信息；
3.tomcat-user.xml：

Realm認證時用到的相關角色、用戶和密碼等信息；Tomcat自帶的manager默認情況下會用到此文件；在Tomcat中添加/刪除用戶，為用戶指定角色等將通過編輯此文件實現；

4.catalina.policy：

Java相關的安全策略配置文件，在系統資源級別上提供訪問控制的能力；

5>.catalina.properties：

Tomcat內部package的定義及訪問相關的控制，也包括對通過類裝載器裝載的內容的控制；Tomcat6在啟動時會事先讀取此文件的相關設置；

6.logging.properties:

Tomcat6通過自己內部實現的JAVA日志記錄器來記錄操作相關的日志，此文件即為日志記錄器相關的配置信息，可以用來定義日志記錄的組件級別以及日志文件的存在位置等；

7.context.xml：

所有host的默認配置信息；

二.server.xml 配置文件詳解

server.xml中定義的每個主元素都會被創建為對象，并以某特定的層次結構將這些對象組織在一起。下面是個樣樣例配置：

<Server port="8005" shutdown="SHUTDOWN"><Listener className="org.apache.catalina.core.JasperListener" /><Listener className="org.apache.catalina.mbeans.ServerLifecycleListener" /><Listener className="org.apache.catalina.mbeans.GlobalResourcesLifecycleListener" /><GlobalNamingResources><Resource name="UserDatabase" auth="Container"type="org.apache.catalina.UserDatabase"description="User database that can be updated and saved"factory="org.apache.catalina.users.MemoryUserDatabaseFactory"pathname="conf/tomcat-users.xml"/></GlobalNamingResources><Service name="Catalina"><Connector port="8080" protocol="HTTP/1.1"maxThreads="150" connectionTimeout="20000"redirectPort="8443"/><Engine name="Catalina" defaultHost="localhost"><Host name="localhost" appBase="webapps"unpackWARs="true" autoDeploy="true"xmlValidation="false" xmlNamespaceAware="false"></Host></Engine></Service>
</Server><Server port="8005" shutdown="SHUTDOWN"><Listener className="org.apache.catalina.core.AprLifecycleListener" SSLEngine="on" /><Listener className="org.apache.catalina.core.JasperListener" /><Listener className="org.apache.catalina.core.JreMemoryLeakPreventionListener" /><Listener className="org.apache.catalina.mbeans.GlobalResourcesLifecycleListener" /><Listener className="org.apache.catalina.core.ThreadLocalLeakPreventionListener" /><GlobalNamingResources><Resource name="UserDatabase" auth="Container"type="org.apache.catalina.UserDatabase"description="User database that can be updated and saved"factory="org.apache.catalina.users.MemoryUserDatabaseFactory"pathname="conf/tomcat-users.xml" /></GlobalNamingResources><Service name="Catalina"><Connector port="8080" protocol="HTTP/1.1"connectionTimeout="20000"redirectPort="8443" /><Connector port="8009" protocol="AJP/1.3" redirectPort="8443" /><Engine name="Catalina" defaultHost="localhost"><Realm className="org.apache.catalina.realm.LockOutRealm"><Realm className="org.apache.catalina.realm.UserDatabaseRealm"resourceName="UserDatabase"/></Realm><Host name="localhost"  appBase="webapps"unpackWARs="true" autoDeploy="true"><Valve className="org.apache.catalina.valves.AccessLogValve" directory="logs"prefix="localhost_access_log." suffix=".txt"pattern="%h %l %u %t &quot;%r&quot; %s %b" /></Host></Engine></Service>
</Server>

server.xml文件中可定義的元素非常多，包括Server, Service, Connector, Engine, Cluster, Host, Alias, Context, Realm, Valve, Manager, Listener, Resources, Resource, ResourceEnvRef, ResourceLink, WatchedResource, GlobalNameingResources, Store, Transaction, Channel, Membership, Transport, Member, ClusterListener等。下面簡單介紹幾個常用組件：

1.Server組件

如上面示例文件中定義的：

<Server port=”8005” shutdown=”SHUTDOWN”>

這會讓Tomcat啟動一個server實例（即一個JVM），它監聽在8005端口以接收shutdown命令。各Server的定義不能使用同一個端口，這意味著如果在同一個物理機上啟動了多個Server實例，必須配置它們使用不同的端口。這個端口的定義用于為管理員提供一個關閉此實例的便捷途徑，因此，管理員可以直接telnet至此端口使用SHUTDOWN命令關閉此實例。不過，基于安全角度的考慮，這通常不允許遠程進行。

Server的相關屬性：

className: 用于實現此Server容器的完全限定類的名稱，默認為org.apache.catalina.core.StandardServer；
port: 接收shutdown指令的端口，默認僅允許通過本機訪問，默認為8005；
shutdown：發往此Server用于實現關閉tomcat實例的命令字符串，默認為SHUTDOWN；

2.Service組件

Service主要用于關聯一個引擎和與此引擎相關的連接器，每個連接器通過一個特定的端口和協議接收入站請求交將其轉發至關聯的引擎進行處理。困此，Service要包含一個引擎（Engine）、一個或多個連接器。

如上面示例中的定義：

<Service name=”Catalina”>

這定義了一個名為Catalina的Service，此名字也會在產生相關的日志信息時記錄在日志文件當中。

Service相關的屬性：

className：用于實現service的類名，一般都是org.apache.catalina.core.StandardService。
name：此服務的名稱，默認為Catalina；
復制代碼

3.Connector組件

進入Tomcat的請求可以根據Tomcat的工作模式分為如下兩類：
Tomcat作為應用程序服務器：請求來自于前端的web服務器，這可能是Apache, IIS, Nginx等；
Tomcat作為獨立服務器：請求來自于web瀏覽器；

Tomcat應該考慮工作情形并為相應情形下的請求分別定義好需要的連接器才能正確接收來自于客戶端的請求。一個引擎可以有一個或多個連接器，以適應多種請求方式。

定義連接器可以使用多種屬性，有些屬性也只適用于某特定的連接器類型。一般說來，常見于server.xml中的連接器類型通常有4種：

HTTP連接器
SSL連接器
AJP 1.3連接器
proxy連接器

如上面示例server.xml中定義的HTTP連接器：

<Connector port="8080" protocol="HTTP/1.1"maxThreads="150" connectionTimeout="20000"redirectPort="8443"/>

定義連接器時可以配置的屬性非常多，但通常定義HTTP連接器時必須定義的屬性只有“port”，定義AJP連接器時必須定義的屬性只有"protocol"，因為默認的協議為HTTP。以下為常用屬性的

說明：

address：指定連接器監聽的地址，默認為所有地址，即0.0.0.0；
maxThreads：支持的最大并發連接數，默認為200；
port：監聽的端口，默認為0；
protocol：連接器使用的協議，默認為HTTP/1.1，定義AJP協議時通常為AJP/1.3；
redirectPort：如果某連接器支持的協議是HTTP，當接收客戶端發來的HTTPS請求時，則轉發至此屬性定義的端口；
connectionTimeout：等待客戶端發送請求的超時時間，單位為毫秒，默認為60000，即1分鐘；
enableLookups：是否通過request.getRemoteHost()進行DNS查詢以獲取客戶端的主機名；默認為true；
acceptCount：設置等待隊列的最大長度；通常在tomcat所有處理線程均處于繁忙狀態時，新發來的請求將被放置于等待隊列中；

下面是一個定義了多個屬性的SSL連接器：

<Connector port="8443"maxThreads="150" minSpareThreads="25" maxSpareThreads="75"enableLookups="false" acceptCount="100" debug="0" scheme="https" secure="true"clientAuth="false" sslProtocol="TLS" />

4.Engine組件

Engine是Servlet處理器的一個實例，即servlet引擎，默認為定義在server.xml中的Catalina。Engine需要defaultHost屬性來為其定義一個接收所有發往非明確定義虛擬主機的請求的host組件。如前面示例中定義的：

<Engine name="Catalina" defaultHost="localhost">

常用的屬性定義：

defaultHost：Tomcat支持基于FQDN的虛擬主機，這些虛擬主機可以通過在Engine容器中定義多個不同的Host組件來實現；但如果此引擎的連接器收到一個發往非非明確定義虛擬主機的請求時則需要將此請求發往一個默認的虛擬主機進行處理，因此，在Engine中定義的多個虛擬主機的主機名稱中至少要有一個跟defaultHost定義的主機名稱同名；
name：Engine組件的名稱，用于日志和錯誤信息記錄時區別不同的引擎；

Engine容器中可以包含Realm、Host、Listener和Valve子容器。

5.Host組件

位于Engine容器中用于接收請求并進行相應處理的主機或虛擬主機（可以理解為一個虛擬主機），如前面示例中的定義：

常用屬性說明：

name : 主機名(FQDN)
appBase：此Host的webapps目錄，即存放非歸檔的web應用程序的目錄或歸檔后的WAR文件的目錄路徑；可以使用基于$CATALINA_HOME的相對路徑；
autoDeploy：在Tomcat處于運行狀態時放置于appBase目錄中的應用程序文件是否自動進行deploy；默認為true；
unpackWars：在啟用此webapps時是否對WAR格式的歸檔文件先進行展開；默認為true；

虛擬主機定義示例：

<Engine name="Catalina" defaultHost="localhost"><Host name="localhost" appBase="webapps"><Context path="" docBase="ROOT"/><Context path="/bbs" docBase="/web/bss"reloadable="true" crossContext="true"/></Host><Host name="mail.yinzhengjie.org.cn" appBase="/web/mail"><Context path="" docBase="ROOT"/></Host>
</Engine>

主機別名定義：
如果一個主機有兩個或兩個以上的主機名，額外的名稱均可以以別名的形式進行定義，如下：

<Host name="www.yinzhengjie.org.cn" appBase="webapps" unpackWARs="true"><Alias>magedu.com</Alias>
</Host>

6.Context組件

Context在某些意義上類似于apache中的路徑別名**，一個Context定義用于標識tomcat實例中的一個Web應用程序**；如下面的定義：

 <!-- Tomcat Root Context --><Context path="" docBase="/web/webapps"/><!-- buzzin webapp --><Context path="/bbs"docBase="/web/threads/bbs"reloadable="true"></Context><!-- chat server --><Context path="/chat" docBase="/web/chat"/><!-- darian web --><Context path="/darian" docBase="darian"/>

在Tomcat6中，每一個context定義也可以使用一個單獨的XML文件進行，其文件的目錄為$CATALINA_HOME/conf//。可以用于Context中的XML元素有Loader，Manager，Realm，Resources和WatchedResource。

常用的屬性定義有：

docBase：相應的Web應用程序的存放位置；也可以使用相對路徑，起始路徑為此Context所屬Host中appBase定義的路徑；切記，docBase的路徑名不能與相應的Host中appBase中定義的路徑名有包含關系，比如，如果appBase為deploy，而docBase絕不能為deploy-bbs類的名字；
path：相對于Web服務器根路徑而言的URI；如果為空“”，則表示為此webapp的根路徑；如果context定義在一個單獨的xml文件中，此屬性不需要定義；
reloadable：是否允許重新加載此context相關的Web應用程序的類；默認為false；
復制代碼

7.Realm組件

一個Realm表示一個安全上下文，它是一個授權訪問某個給定Context的用戶列表和某用戶所允許切換的角色相關定義的列表。因此，Realm就像是一個用戶和組相關的數據庫。定義Realm時惟一必須要提供的屬性是classname，它是Realm的多個不同實現，用于表示此Realm認證的用戶及角色等認證信息的存放位置。
JAASRealm：基于Java Authintication and Authorization Service實現用戶認證；
JDBCRealm：通過JDBC訪問某關系型數據庫表實現用戶認證；
JNDIRealm：基于JNDI使用目錄服務實現認證信息的獲取；
MemoryRealm：查找tomcat-user.xml文件實現用戶信息的獲取；
UserDatabaseRealm：基于UserDatabase文件(通常是tomcat-user.xml)實現用戶認證，它實現是一個完全可更新和持久有效的MemoryRealm，因此能夠跟標準的MemoryRealm兼容；它通過JNDI實現；

下面是一個常見的使用UserDatabase的配置：

 <Realm className=”org.apache.catalina.realm.UserDatabaseRealm”resourceName=”UserDatabase”/>

下面是一個使用JDBC方式獲取用戶認證信息的配置：

 <Realm className="org.apache.catalina.realm.JDBCRealm" debug="99"driverName="org.gjt.mm.mysql.Driver"connectionURL="jdbc:mysql://localhost/authority"connectionName="test" connectionPassword="test"userTable="users" userNameCol="user_name"userCredCol="user_pass"userRoleTable="user_roles" roleNameCol="role_name" />

8.Valve組件（閥門）

Valve類似于過濾器，它可以工作于Engine和Host/Context之間、Host和Context之間以及Context和Web應用程序的某資源之間。一個容器內可以建立多個Valve，而且Valve定義的次序也決定了它們生效的次序。Tomcat6中實現了多種不同的Valve：
AccessLogValve：訪問日志Valve
ExtendedAccessValve：擴展功能的訪問日志Valve
JDBCAccessLogValve：通過JDBC將訪問日志信息發送到數據庫中；
RequestDumperValve：請求轉儲Valve；
RemoteAddrValve：基于遠程地址的訪問控制；
RemoteHostValve：基于遠程主機名稱的訪問控制；
SemaphoreValve：用于控制Tomcat主機上任何容器上的并發訪問數量；
JvmRouteBinderValve：在配置多個Tomcat為以Apache通過mod_proxy或mod_jk作為前端的集群架構中，當期望停止某節點時，可以通過此Valve將用記請求定向至備用節點；使用此Valve，必須使用JvmRouteSessionIDBinderListener；
ReplicationValve：專用于Tomcat集群架構中，可以在某個請求的session信息發生更改時觸發session數據在各節點間進行復制；
SingleSignOn：將兩個或多個需要對用戶進行認證webapp在認證用戶時連接在一起，即一次認證即可訪問所有連接在一起的webapp；
ClusterSingleSingOn：對SingleSignOn的擴展，專用于Tomcat集群當中，需要結合ClusterSingleSignOnListener進行工作；

RemoteHostValve和RemoteAddrValve可以分別用來實現基于主機名稱和基于IP地址的訪問控制，控制本身可以通過allow或deny來進行定義，這有點類似于Apache的訪問控制功能；如下面的Valve則實現了僅允許本機訪問/probe：

<Context path="/probe" docBase="probe"><Valve className="org.apache.catalina.valves.RemoteAddrValve"allow="127\.0\.0\.1"/></Context>

其中相關屬性定義有:

className：相關的java實現的類名，相應于分別應該為org.apache.catalina.valves.RemoteHostValve或org.apache.catalina.valves.RemoteAddrValve；
allow：以逗號分開的允許訪問的IP地址列表，支持正則表達式，因此，點號“.”用于IP地址時需要轉義；僅定義allow項時，非明確allow的地址均被deny；
deny: 以逗號分開的禁止訪問的IP地址列表，支持正則表達式；使用方式同allow；
復制代碼

9.GlobalNamingResources

應用于整個服務器的JNDI映射，此可以避免每個Web應用程序都需要在各自的web.xml創建，這在web應用程序以WAR的形式存在時尤為有用。它通常可以包含三個子元素：

Environment;
Resource;
ResourceEnvRef;

10.WatchedResource

WatchedResource可以用于Context中監視指定的webapp程序文件的改變，并且能夠在監視到文件內容發生改變時重新裝載此文件。

11.Listener

Listener用于創建和配置LifecycleListener對象，而LifecycleListener通常被開發人員用來創建和刪除容器。

12>.Loader

Java的動態裝載功能是其語言功能強大表現之一，Servlet容器使用此功能在運行時動態裝載servlet和它們所依賴的類。Loader可以用于Context中控制java類的加載。

13.Manager

Manger對象用于實現HTTP會話管理的功能，Tomcat6中有5種Manger的實現：

StandardManager
Tomcat6的默認會話管理器，用于非集群環境中對單個處于運行狀態的Tomcat實例會話進行管理。當Tomcat關閉時，這些會話相關的數據會被寫入磁盤上的一個名叫SESSION.ser的文件，并在Tomcat下次啟動時讀取此文件。
PersistentManager
當一個會話長時間處于空閑狀態時會被寫入到swap會話對象，這對于內存資源比較吃緊的應用環境來說比較有用。
3)DeltaManager
用于Tomcat集群的會話管理器，它通過將改變了會話數據同步給集群中的其它節點實現會話復制。這種實現會將所有會話的改變同步給集群中的每一個節點，也是在集群環境中用得最多的一種實現方式。
4)BackupManager
用于Tomcat集群的會話管理器，與DeltaManager不同的是，某節點會話的改變只會同步給集群中的另一個而非所有節點。
5)SimpleTcpReplicationManager
Tomcat4時用到的版本，過于老舊了。
復制代碼

14.Stores

PersistentManager必須包含一個Store元素以指定將會話數據存儲至何處。這通常有兩種實現方式：FileStore和JDBCStore。

15.Resources

經常用于實現在Context中指定需要裝載的但不在Tomcat本地磁盤上的應用資源，如Java類，HTML頁面，JSP文件等。

16.Cluster

專用于配置Tomcat集群的元素，可用于Engine和Host容器中。在用于Engine容器中時，Engine中的所有Host均支持集群功能。在Cluster元素中，需要直接定義一個Manager元素，這個Manager元素有一個其值為org.apache.catalina.ha.session.DeltaManager或org.apache.catalina.ha.session.BackupManager的className屬性。同時，Cluster中還需要分別定義一個Channel和ClusterListener元素。

16.1、Channel

用于Cluster中給集群中同一組中的節點定義通信“信道”。Channel中需要至少定義Membership、Receiver和Sender三個元素，此外還有一個可選元素Interceptor。

16.2、Membership

用于Channel中配置同一通信信道上節點集群組中的成員情況，即監控加入當前集群組中的節點并在各節點間傳遞心跳信息，而且可以在接收不到某成員的心跳信息時將其從集群節點中移除。Tomcat6中Membership的實現是org.apache.catalina.tribes.membership.McastService。