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传递的