2. 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 port="8005" shutdown="SHUTDOWN" debug="0">
1>className: 指定实现org.apache.catalina.Server接口的完全限定类的名称.默认值为org.apache.catalina.core.StandardServer
2>port: 服务器等待关机命令的TCP/IP端口号。设置为-1以禁用关闭端口。默认仅允许通过本机访问，默认为8005；
3>shutdown: 必须通过TCP/IP连接接收到指定端口号的命令字符串，以关闭Tomcat。默认为SHUTDOWN4>address: 服务器等待关机命令的TCP/IP地址。如果没有指定地址，则使用localhost。

测试：telnet localhost 8005输入：SHUTDOWN结果：关闭tomcat

**<Service name="Catalina"\>**
**<Service name="Apache"\>**
第一个<Service>处理所有直接由Tomcat服务器接收的web客户请求.
第二个<Service>处理所有由Apahce服务器转发过来的Web客户请求 .
1>className 指定实现org.apahce.catalina.Service接口的类.默认为org.apahce.catalina.core.StandardService
2>name: 定义此服务的名称，此名字也会在产生相关的日志信息时记录在日志文件当中。与特定服务器关联的每个服务的名称必须是唯一的。

(1) BIO HTTP/1.1 Connector配置一个典型的配置如下：　　
<Connector  port=”8080”  protocol=”HTTP/1.1”  maxThreads=”150”  conn ectionTimeout=”20000”   redirectPort=”8443” />
其它一些重要属性如下：
acceptCount : 接受连接request的最大连接数目，默认值是10
address : 绑定IP地址，如果不绑定，默认将绑定任何IP地址
allowTrace : 如果是true,将允许TRACE HTTP方法
compressibleMimeTypes : 各个mimeType, 以逗号分隔，如text/html,text/xml
compression : 如果带宽有限的话，可以用GZIP压缩
connectionTimeout : 超时时间，默认为60000ms (60s)
maxKeepAliveRequest : 默认值是100
maxThreads : 处理请求的Connector的线程数目，默认值为200
如果是SSL配置，如下：
<Connector port="8181" protocol="HTTP/1.1" SSLEnabled="true" maxThreads="150" scheme="https" secure="true" clientAuth="false" sslProtocol = "TLS" address="0.0.0.0" keystoreFile="E:/java/jonas-full-5.1.0-RC3/conf/keystore.jks" keystorePass="changeit" />
其中，keystoreFile为证书位置，keystorePass为证书密码(2) NIO HTTP/1.1 Connector配置<Connector port=”8080” protocol=”org.apache.coyote.http11.Http11NioProtocol” maxThreads=”150” connectionTimeout=”20000” redirectPort=”8443”/>
(3) Native APR Connector配置ARP是用C/C++写的，对静态资源(HTML，图片等)进行了优化。所以要下载本地库tcnative-1.dll与openssl.exe，将其放在%tomcat%\bin目录下。
下载地址是：http://tomcat.heanet.ie/native/1.1.10/binaries/win32/
在server.xml中要配置一个Listener,如下图。这个配置tomcat是默认配好的。
<!--APR library loader. Documentation at /docs/apr.html -->
<Listener className="org.apache.catalina.core.AprLifecycleListener" SSLEngine="on" />
配置使用APR connector
<Connector port=”8080” protocol=”org.apache.coyote.http11.Http11AprProtocol”
maxThreads=”150” connectionTimeout=”20000” redirectPort=”8443”/>

如果配置成功，启动tomcat,会看到如下信息： org.apache.coyote.http11.Http11AprProtocol init (4)  AJP Connector配置
<Connector port="8009" protocol="AJP/1.3" redirectPort="8443" />

<Connector
port="8080" maxHttpHeaderSize="8192" maxThreads="150" minSpareThreads="25" maxSpareThreads="75" enableLookups="false"
redirectPort="8443" acceptCount="100" connectionTimeout="20000" disableUploadTimeout="true" />port : 在端口号8080处侦听来自客户browser的HTTP1.1请求.如果把8080改成80,则只要输入http://localhost/即可
protocol:设定Http协议,默认值为HTTP/1.1，如果使用AJP处理器，该值必须为AJP/1.3.
minSpareThreads: 该Connector先创建5个线程等待客户请求，每个请求由一个线程负责
maxSpareThreads:设定在监听端口的线程的最大数目,这个值也决定了服务器可以同时响应客户请求的最大数目.默认值为200
acceptCount : 当现有线程已经达到最大数75时，为客户请求排队.当队列中请求数超过100时，后来的请求返回Connection refused错误
redirectport : 当客户请求是https时，把该请求转发到端口8443去,若连接器不支持SSL，如收到SSL请求，Catalina容器将会自动重定向到指定的端口号，让其处理。
enableLookups:若设为true,表示支持域名解析,把IP地址解析为主机名，false返回IP地址.WEB应用中调用request.getRemoteHost方法执行DNS查询返回客户机主机名.默认值为true。
connectionTimeout:定义建立客户连接超时的时间，以毫秒为单位，默认为60000=60秒，如果为-1,表示不限制建立客户连接的时间
allowTrace：是否允许HTTP的TRACE方法，默认为false
emptySessionPath：如果设置为true，用户的所有路径都将设置为/，默认为false。
maxPostSize：指定POST方式请求的最大量，没有指定默认为2097152。
proxyName：如这个连接器正在一个代理配置中被使用，指定这个属性，在request.getServerName()时返回
scheme：设置协议的名字，在request.getScheme()时返回，SSL连接器设为”https”，默认为”http”
secure：在SSL连接器可将其设置为true，默认为false
URIEncoding：用于解码URL的字符编码，没有指定默认值为ISO-8859-1
useBodyEncodingForURI：主要用于Tomcat4.1.x中，指示是否使用在contentType中指定的编码来取代URIEncoding，用于解码URI查询参数，默认为false
xpoweredBy：为true时，Tomcat使用规范建议的报头表明支持Servlet的规范版本，默认为false
bufferSize：设由连接器创建输入流缓冲区的大小，以字节为单位。默认情况下，缓存区大的大小为2048字节
compressableMimeType：MIME的列表，默认以逗号分隔。默认值是text/html，text/xml，text/plain
compression：指定是否对响应的数据进行压缩。off：表示禁止压缩、on：表示允许压缩（文本将被压缩）、force：表示所有情况下都进行压缩，默认值为off
disableUploadTimeOut：允许Servlet容器，正在执行使用一个较长的连接超时值，以使Servlet有较长的时间来完成它的执行，默认值为false
maxHttpHeaderSize：HTTP请求和响应头的最大量，以字节为单位，默认值为4096字节
maxKeepAliveRequest：服务器关闭之前，客户端发送的流水线最大数目。默认值为100
socketBuffer：设Socket输出缓冲区的大小（以字节为单位），-1表示禁止缓冲，默认值为9000字节
toNoDelay：为true时，可以提高性能。默认值为true
threadPriority：设JVM中请求处理线程优先级。默认值为NORMAL-PRIORITY

<!—Define an AJP1.3 Connector on port 8089-->
<Connector port="8080" maxThread="50" minSpareThreads="25" maxSpareThread="75" enableLookups="false" redirectPort="8443" acceptCount="100" debug="0" connectionTimeout="20000" disableUploadTimeout="true" />
<Connection port="8009" enableLookups="false" redirectPort="8443" debug="0" protocol="AJP/1.3" />backlog：当所有可能的请求处理线程都在使用时，队列中排队的请求最大数目。默认为10，当队列已满，任何请求都将被拒绝
maxSpareThread：允许存在空闲线程的最大数目，默认值为50
maxThread：支持的最大并发连接数，默认值为200
minSpareThreads：设当连接器第一次启动时创建线程的数目，确保至少有这么多的空闲线程可用，默认值为4
port：服务端套接字的TCP端口号，默认值为8089（必须）
topNoDelay：为true时，可以提高性能，默认值为true
soTimeout：超时值

下面定义了一个多属性的SSL连接器：
debug="0" 不启动调试模式 ；
<Connector port="8443" maxThreads="150" minSpareThreads="25" maxSpareThread="75" enableLookups="false"acceptCount="100" debug="0" scheme="HTTPs" secure="true" clientAuth="false" sslProtocol="TLS"/>

　其中，keystoreFile为证书位置，keystorePass为证书密码

acceptCount : 当最大请求连接maxConnections满时的最大排队大小，默认100。

　　　　　　　　 注意此属性和Executor中属性maxQueueSize的区别.　　　　　　　　 这个指的是请求连接满时的堆栈大小,　　　　　　　　 Executor的maxQueueSize指的是处理线程满时的堆栈大小

connectionTimeout:定义建立客户连接超时的时间，以毫秒为单位，默认为60000=60秒，如果为-1,表示不限制建立客户连接的时间executor：指定配置的线程池名称keepAliveTimeout：keeAlive超时时间，默认值为connectionTimeout配置值.-1表示不超时maxConnections：最大连接数，连接满时后续连接放入最大为acceptCount的队列中. 对 NIO和NIO2连接,默认值为10000;对 APR/native,默认值为8192maxThreads：支持的最大并发连接数,如果指定了Executor, 此属性忽略;否则为Connector创建的内部线程池最大值，默认200minSpareThreads：如果指定了Executor, 此属性忽略;否则为Connector创建线程池的最小活跃线程数，默认10processorCache：协议处理器缓存Processor对象的大小，-1表示不限制.　　　　　　　　　 当不使用servlet3.0的异步处理情况下: 　　　　　　　　　　　　如果配置Executor,配置为Executor的maxThreads;　　　　　　　　　　　　否则配置为Connnector的maxThreads. 　　　　　　　　　 如果使用Serlvet3.0异步处理, 取maxThreads和maxConnections的最大值

<Service name="xxx"><Executor name="tomcatThreadPool" namePrefix="catalina-exec-" maxThreads="300" minSpareThreads="25"/>
</Service>className: 这个类必须实现org.apache.catalina.Executor接口。默认 org.apache.catalina.core.StandardThreadExecutor
name     : 线程池名称。要求唯一, 供Connector元素的executor属性使用
namePrefix: 线程名称前缀。
maxThreads: 最大活跃线程数。默认200
minSpareThreads: 最小活跃线程数。默认25
maxIdleTime: 当前活跃线程大于minSpareThreads时,空闲线程关闭的等待最大时间。默认60000ms
maxQueueSize: 线程池满情况下的请求排队大小。默认Integer.MAX_VALUE

<Engine name=”Catalina” defaultHost=”localhost”>
defaultHost: 默认主机名，用于标识将处理指向此服务器上主机名称但未在此配置文件中配置的请求的主机。这个名字必须匹配其中一个嵌套的主机元素的名字属性。
name: 此引擎的逻辑名称，用于日志和错误消息。在同一服务器中使用多个服务元素时，每个引擎必须分配一个唯一的名称。

虚拟主机定义示例：
<Engine name=”Catalina” defaultHost=”localhost”><Host name=”localhost” appBase=”webapps” unpackWARs=”true” autoDeploy=”true” xmlValidation=”false” xmlNamespaceAware=”false”><Context path=”” docBase=”ROOT”/><Context path=”/bbs” docBase=”/web/bss” reloadable=”true” crossContext=”true”/> #path定义在defaultHost之后</Host><Host name=”mail.magedu.com” appBase=”/web/mail”><Context path=”” docBase=”ROOT”/></Host>
</Engine>主机别名定义：如果一个主机有两个或两个以上的主机名，额外的名称均可以以别名的形式进行定义，如下：
<Host name=”www.ttlsa.com” appBase=”webapps” unpackWARs=”true”><Alias>feiyu.com</Alias>
</Host>name： 名称，用于日志输出
appBase： 虚拟主机对应的应用基础路径（Host的webapps目录）；可以是个绝对路径, 或CATALINABASE相对路径||xmlBase|虚拟主机XML基础路径,里面应该有Contextxml配置文件
createDirs    当appBase和xmlBase不存在时,是否创建目录    默认为true
autoDeploy： 是否周期性的检查appBase和xmlBase并deploy web应用和context描述符，默认为true
deployIgnore： 忽略deploy的正则
deployOnStartup： Tomcat启动时是否自动deploy，默认为true
failCtxIfServletStartFails： 配置为true情况下,任何load-on-startup >=0的servlet启动失败,则其对应的Contxt也启动失败，默认为false
unpackWars：在启用此webapps时是否对WAR格式的归档文件先进行展开；默认为true；                    

<!– 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”/>altDDName: web.xml部署描述符路径,默认 /WEB-INF/web.xml
docBase: Context的Root路径,和Host的appBase相结合, 可确定web应用的实际目录
failCtxIfServletStartFails: 同Host中的failCtxIfServletStartFails, 只对当前Context有效,默认为false
logEffectiveWebXml: 是否日志打印web.xml内容(web.xml由默认的web.xml和应用中的web.xml组成),默认为false
path: web应用的context path,如果为根路径,则配置为空字符串(""), 不能不配置
privileged: 是否使用Tomcat提供的manager servlet
reloadable：/WEB-INF/classes/ 和/WEB-INF/lib/ 目录中class文件发生变化是否自动重新加载,默认为false
swallowOutput: true情况下, System.out和System.err输出将被定向到web应用日志中,默认为false 

下面是一个常见的使用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” />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实现；

Tomcat6中实现了多种不同的Valve：AccessLogValve：访问日志ValveExtendedAccessValve：扩展功能的访问日志ValveJDBCAccessLogValve：通过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>其中相关属性定义有:
1) className：相关的java实现的类名，相应于分别应该为org.apache.catalina.valves.RemoteHostValve或org.apache.catalina.valves.RemoteAddrValve；
2) allow：以逗号分开的允许访问的IP地址列表，支持正则表达式，因此，点号“.”用于IP地址时需要转义；仅定义allow项时，非明确allow的地址均被deny；
3) deny: 以逗号分开的禁止访问的IP地址列表，支持正则表达式；使用方式同allow；