vlambda博客
学习文章列表

tomcat常用配置详解

1 目录结构 

/bin:脚本文件目录。 

/common/lib:存放所有web项目都可以访问的公共jar包(使用Common类加载器加载)。 

/conf:存放配置文件,最重要的是server.xml。 /logs:存放日志文件。 

/server/webapps:来管理Tomcat-web服务用的。仅对TOMCAT可见,对所有的WEB APP都不可见(使用Catalina类加载器加载)。 

/shared/lib:仅对所有WEB APP可见,对TOMCAT不可见(使用Shared类加载器加载)。 

/temp:Tomcat运行时候存放临时文件用的。 

/webapps:web应用发布目录。 

/work:Tomcat把各种由jsp生成的servlet文件放在这个目录下。删除后,启动时会自动创建。 

 2 配置文件 

server.xml:主要的配置文件。 

web.xml:缺省的web app配置,WEB-INF/web.xml会覆盖该配置。 

context.xml:不清楚跟server.xml里面的context是否有关系。  

server.xml配置 

server标签 

port:指定一个端口,这个端口负责监听关闭tomcat的请求。 

shutdown:指定向端口发送的命令字符串。  

service标签 name:指定service的名字。  

Connector(表示客户端和service之间的连接)标签

port:指定服务器端要创建的端口号,并在这个端口监听来自客户端的请求。 

minProcessors:服务器启动时创建的处理请求的线程数。 

maxProcessors:最大可以创建的处理请求的线程数。 

redirectPort:指定服务器正在处理http请求时收到了一个SSL传输请求后重定向的端口号。 

acceptCount:指定当所有可以使用的处理请求的线程数都被使用时,可以放到处理队列中的请求数,超过这个数的请求将不予处理。 

connectionTimeout:指定超时的时间数(以毫秒为单位)。  

Engine(表示指定service中的请求处理机,接收和处理来自Connector的请求)标签 

defaultHost:指定缺省的处理请求的主机名,它至少与其中的一个host元素的name属性值是一样的。  

Context(表示一个web应用程序,通常为WAR文件,关于WAR的具体信息见servlet规范)标签 docBase:该web应用的文档基准目录(DocumentBase,也称为Context Root),或者是WAR文件的路径。可以使用绝对路径,也可以使用相对于context所属的Host的appBase路径。 

path:表示此web应用程序的url的前缀,这样请求的url为http://localhost:8080/path/****。 

reloadable:这个属性非常重要,如果为true,则tomcat会自动检测应用程序的/WEB-INF/lib和/WEB-INF/classes目录的变化,自动装载新的应用程序,我们可以在不重起tomcat的情况下改变应用程序。 

useNaming:如果希望Catalina为该web应用使能一个JNDI InitialContext对象,设为true。该InitialialContext符合J2EE平台的约定,缺省值为true。 

workDir:Context提供的临时目录的路径,用于servlet的临时读/写。利用javax.servlet.context.tempdir属性,servlet可以访问该目录。如果没有指定,使用$CATALINA_HOME/work下一个合适的目录。 

swallowOutput:如果该值为true,System.out和System.err的输出被重定向到web应用的logger。如果没有指定,缺省值为false 

debug:与这个Engine关联的Logger记录的调试信息的详细程度。数字越大,输出越详细。如果没有指定,缺省为0。  

host(表示一个虚拟主机)标签 

name:指定主机名。 

appBase:应用程序基本目录,即存放应用程序的目录。 

unpackWARs:如果为true,则tomcat会自动将WAR文件解压,否则不解压,直接从WAR文件中运行应用程序。  

Logger(表示日志,调试和错误信息)标签 

className:指定logger使用的类名,此类必须实现org.apache.catalina.Logger接口。 

prefix:指定log文件的前缀。 

suffix:指定log文件的后缀。 

timestamp:如果为true,则log文件名中要加入时间,如下例:localhost_log.2001-10-04.txt。  

Realm(表示存放用户名,密码及role的数据库)标签 

className:指定Realm使用的类名,此类必须实现org.apache.catalina.Realm接口。  

Valve(功能与Logger差不多,其prefix和suffix属性解释和Logger  中的一样)标签 

className:指定Valve使用的类名,如用org.apache.catalina.valves.AccessLogValve类可以记录应用程序的访问信息。 

directory:指定log文件存放的位置。 

3 配置虚拟目录 

1)直接部署到webapps目录下面访问。 

2)修改conf/server.xml文件。在<Hostname="localhost" appBase="webapps"unpackWARs="true" xmlValidation="false"xmlNamespaceAware="false"></host>中加入<Contextpath="/test" docBase="webdemo" debug="0"reloadable="true" />。docBase目录默认使用appBase="webapps"这个目录。也可以是绝对路径。配置主目录,可以将path=""。 

3)当项目没有放在webapps目录下时,可以在conf/Catalina/localhost新建一个XXX.XML文件。里面加入<ContextdocBase="E:webdemo" debug="0" reloadable="true"/>。 

注意:这里的path属性不需要设置,设置了也不会起作用的。 

也可以使用该方法建立主目录指向另一个目录,例如:<Context docBase="E:webdemo" debug="0"reloadable="true" />命名为ROOT.xml,这样默认访问的主目录就被修改过了。  

4 配置连接数 

maxThreads:Tomcat使用线程来处理接收的每个请求。这个值表示Tomcat可创建的最大的线程数。 

acceptCount:指定当所有可以使用的处理请求的线程数都被使用时,可以放到处理队列中的请求数,超过这个数的请求将不予处理。 

minSpareThreads:Tomcat初始化时创建的线程数。 

maxSpareThreads:一旦创建的线程超过这个值,Tomcat就会关闭不再需要的socket线程。 

enableLookups:是否反查域名,取值为:true或false。为了提高处理能力,应设置为false connectionTimeout:网络连接超时,单位:毫秒。设置为0表示永不超时,这样设置有隐患的。默认可设置为20000毫秒。  

web server允许的最大连接数还受制于操作系统的内核参数设置,通常Windows是2000个左右,Linux是1000个左右。  

5 配置内存大小 修改bin/catalina.bat中的set CATALINA_OPTS=-Xms64m-Xmx128m。 Xms指最小内存,Xmx指最大内存。  

6 安全配置 

1)将<Server port="8005"shutdown="SHUTDOWN">SHUTDOWN修改为其他一些字符串。否则就容易被人给停止掉了。  

2)对应tomcat3.1中,屏蔽目录文件自动列出 

修改conf/web.xml中的

    <servlet>

        <servlet-name>default</servlet-name>

        <servlet-class>org.apache.catalina.servlets.DefaultServlet</servlet-class>        <init-param>

            <param-name>debug</param-name>

            <param-value>0</param-value>

        </init-param>

        <init-param>

            <param-name>listings</param-name>

            <param-value>true</param-value><!-- 改成false -->

        </init-param>

        <load-on-startup>1</load-on-startup>

     </servlet>  

3)访问日志设置 在server.xml中加入 <ValveclassName="org.apache.catalina.valves.AccessLogValve"                 directory="logs" prefix="localhost_access_log." suffix=".txt"                 pattern="common"resolveHosts="false"/> 

这样访问日志会记录到Logs中。  

4)修改用户名、密码 conf/tomcat-users.xml  

5)屏蔽后台管理入口 

方法一:从控制用户和权限着手。废掉要管理权限的用户就可以了。 

方法二:将conf/Catalina/localhost/manager.xml改名。  

6)配置403,404,500错误页面 默认情况下,报出HTTP错误的时候会暴露tomcat版本号。如果不想暴露的话,就需要重新定义错误跳转页面。

 <error-page>

 <error-code>401</error-code>

 <location>/401.jsp</location>

 </error-page>

 <error-page>

 <error-code>404</error-code>

 <location>/404.jsp</location>

 </error-page>

 <error-page>

 <error-code>500</error-code>

 <location>/500.jsp</location>

 </error-page>

  注意:在测试的时候碰到一个奇怪的现象,平时项目里面的时候测试正常的。可是今天在tomcat目录里面新建一个测试目录测试并不能跳转到指定错误页面。暂时不知道为什么。  

7 配置Log4j日志记录 

项目中抛出的异常,抛到tomcat中的异常会被tomcat记录下来,存放至logs/localhost.yyyy-MM-dd.log文件中。 

平时我们在项目中使用的log4j记录日志跟tomcat是没有任何关系的,是独立的一个程序,记录的文件是自定义的。 我们可以在tomcat中定义一个log4j的公共日志处理方式,这样在项目中就不需要在定义log4j的配置了。 

1)将log4j-1.2.15.jar加入到commonlib目录。 

2)将log4j.properties加入到commonclasses目录。 

内容例如:

 # Output pattern : date[thread] priority category - message log4j.rootLogger=DEUBG, stdout,logfile

  log4j.appender.stdout=org.apache.log4j.ConsoleAppender

 log4j.appender.stdout.layout=org.apache.

log4j.PatternLayout log4j.appender.stdout.layout.ConversionPattern=%d[%t] %-5p [%c] - %m%n  

log4j.appender.logfile=org.apache.

log4j.DailyRollingFileAppender 

log4j.appender.logfile.File=${catalina.home}/logs/tomcat_app.log

 log4j.appender.logfile.layout=org.apache.log4j.PatternLayout

log4j.appender.logfile.layout.ConversionPattern=%d[%t] %-5p [%c] - %m%n  

#3rd party library level 

log4j.logger.org.hibernate.cache=ERROR

  注意:我们项目中使用e.printStackTrace();输出的异常会在控制台输出来,但是,不会记录到tomcat日志中。

 而且,也不会记录到log4j的日志中。要想记录到log4j日志中,必须使用log4j输出来。

 所以,实际上web项目中进行异常处理应该将e.printStackTrace();写写法多改成log4j的形式才对!

 但是,实际项目中很多项目多偷懒使用了e.printStackTrace();方式输出异常。当出现异常的时候在控制台上查看一下就可以了,也不考虑实际运行时候的维护。假如有人不小心关了控制台,那么,你不就看不到异常了吗?

 个人介意使用log4j的形式记入web异常!  

8 Tomcat5乱码问题 

Tomcat5跟Tomcat4对参数处理是不一样的,在Tomcat4中get与post的编码是一样的,所以只要在过滤器中通过request.setCharacterEncoding()设定一次就可以解决get与set的问题。然而,在Tomcat5中,get与post的处理是分开的,对get请求使用URIEncoding进行处理,对post使用request.setCharacterEncoding()处理。Tomcat5中,在server.xml的Connector元素增加了以下配置参数:

 URIEncoding:用来设定通过URI传递的