Tomcat5.5.x配置整理

[size=medium]
1.下载：
http://www.eu.apache.org/dist/jakarta/tomcat-5/
http://www.apache.org/dist/jakarta/tomcat-5/v5.5.x/bin/jakarta-tomcat-5.5.x-admin.zip
http://www.apache.org/dist/jakarta/tomcat-5/v5.5.x/bin/jakarta-tomcat-5.5.x-compat.zip
http://www.apache.org/dist/jakarta/tomcat-5/v5.5.x/bin/jakarta-tomcat-5.5.x.zip
http://www.apache.org/dist/jakarta/tomcat-5/v5.5.x/bin/jakarta-tomcat-5.5.x-deployer.zip
把jakarta-tomcat-5.5.x.zip
和jakarta-tomcat-5.5.x-compat.zip
和jakarta-tomcat-5.5.x-admin.zip
(Tomcat 默认是没有内置admin模块了
Tomcat's administration web application is no longer installed by default. Download and install the "admin" package to use it. )
都解压到同一个目录下面。比如：D:\jakarta-tomcat-5.5.x\
(如果使用jdk1.4，才需要compat.zip用jdk1.5就可以免了这个。)

2.修改jakarta-tomcat-5.5.x\conf\tomcat-users.xml.
添加管理员账号lizongbo，密码为lizongbopass.
新xml如下：
<?xml version='1.0' encoding='utf-8'?>
<tomcat-users>
<role rolename="tomcat"/>
<role rolename="role1"/>
<role rolename="manager"/>
<role rolename="admin"/>
<user username="tomcat" password="tomcat" roles="tomcat"/>
<user username="role1" password="tomcat" roles="role1"/>
<user username="both" password="tomcat" roles="tomcat,role1"/>
<user username="lizongbo" password="lizongbopass" roles="admin,manager"/>
</tomcat-users>

3.修改jakarta-tomcat-5.5.x\conf\server.xml来解决编码问题。
(给Connector 添加URIEncoding参数，参考http://blog.csdn.net/darkxie/archive/2004/10/25/TOMCATAPP.aspx)
(可以设置成GB18030)
<Connector port="8080"
maxThreads="150" minSpareThreads="25" maxSpareThreads="75"
enableLookups="false" redirectPort="8443" acceptCount="200"
connectionTimeout="20000" disableUploadTimeout="true" URIEncoding="GBK"
compression="on" compressionMinSize="2048"
noCompressionUserAgents="gozilla, traviata"
compressableMimeType="text/html,text/xml"/>

<Connector port="8009"
enableLookups="false" redirectPort="8443" protocol="AJP/1.3" URIEncoding="GBK"/>


4.启用支持gzip压缩.
(http://www.linuxaid.com.cn/forum/showdoc.jsp?l=1&i=81169)
添加下列属性
compression="on"
compressionMinSize="2048"
noCompressionUserAgents="gozilla, traviata"
compressableMimeType="text/html,text/xml"

5.设置虚拟主机。
在jakarta-tomcat-5.5.x\下建立文件夹vhost\www.mydomain.com。
然后修改jakarta-tomcat-5.5.x\conf\server.xml

<Engine defaultHost="localhost" name="Catalina">
<Host appBase="vhost/www.mydomain.com" name="www.mydomain.com">
</Host>
<Host appBase="webapps" name="localhost">
</Host>
<Realm className="org.apache.catalina.realm.UserDatabaseRealm"/>
</Engine>

6.添加数据库驱动,更新mail.jar和actiovation.jar
复制mysql-connector-java-3.0.16-ga-bin.jar,pg74.215.jdbc3.jar到 jakarta-tomcat-5.5.x\common\lib\
还有javamail 1.3.2的mail.jar，jaf-1_0_2的 activation.jar
msSQl 2000 JDBC sp3，msbase.jar,msutil,jar,mssqlserver.jar


7.配置SSL
参考 http://jakarta.apache.org/tomcat/tomcat-5.5-doc/ssl-howto.html
D:\j2sdk1.4.2_06\bin>%JAVA_HOME%\bin\keytool -genkey -alias tomcat -keyalg RSA
输入keystore密码： lizongbossl
您的名字与姓氏是什么？
[tomcat5.5.x]： tomcat5.5.x
您的组织单位名称是什么？
[jakarta]： jakarta
您的组织名称是什么？
[apache]： apache
您所在的城市或区域名称是什么？
[hzcity]： hzcity
您所在的州或省份名称是什么？
[gdp]： gdp
该单位的两字母国家代码是什么
[CN]： CN
CN=tomcat5.5.x, OU=jakarta, O=apache, L=hzcity, ST=gdp, C=CN 正确吗？
[否]： y

输入<tomcat>的主密码
（如果和 keystore 密码相同，按回车）：
(必须密码一致，因此直接回车)
然后再把userhome(例如：C:\Documents and Settings\lizongbo\)下的.keystore复制到
tomcat的conf\目录下。
(例如：D:\jakarta-tomcat-5.5.x\conf\.keystore )
配置jakarta-tomcat-5.5.x\conf\server.xml
加上
<Connector port="8443"
maxThreads="150" minSpareThreads="25" maxSpareThreads="75"
enableLookups="false" disableUploadTimeout="true"
acceptCount="100" scheme="https" secure="true"
clientAuth="false" sslProtocol="TLS"
keystoreFile="conf/.keystore"
keystorePass="lizongbossl"> <!--与先前设置的密码一致-->
</Connector>
8.禁止文件目录列表，
修改jakarta-tomcat-5.5.x\conf\web.xml，把listing设置为false

<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>
</init-param>
<load-on-startup>1</load-on-startup>
</servlet>

9.指定了自己的javaEncoding
(参考 http://gceclub.sun.com.cn/staticcontent/html/sunone/app7/app7-dg-webapp/ch6/ch6-4.html )

<servlet>
<servlet-name>jsp</servlet-name>
<servlet-class>org.apache.jasper.servlet.JspServlet</servlet-class>
<init-param>
<param-name>fork</param-name>
<param-value>false</param-value>
</init-param>
<init-param>
<param-name>javaEncoding</param-name>
<param-value>GB18030</param-value>
</init-param>
<init-param>
<param-name>xpoweredBy</param-name>
<param-value>true</param-value>
</init-param>
<load-on-startup>3</load-on-startup>
</servlet>
10.添加rar,iso等的mime-type映射
避免在浏览器里直接打开。
<mime-mapping>
<extension>mht</extension>
<mime-type>text/x-mht</mime-type>
</mime-mapping>
<mime-mapping>
<extension>rar</extension>
<mime-type>application/octet-stream</mime-type>
</mime-mapping>
<mime-mapping>
<extension>iso</extension>
<mime-type>application/octet-stream</mime-type>
</mime-mapping>
<mime-mapping>
<extension>ape</extension>
<mime-type>application/octet-stream</mime-type>
</mime-mapping>
<mime-mapping>
<extension>rmvb</extension>
<mime-type>application/octet-stream</mime-type>
</mime-mapping>
<mime-mapping>
<extension>ico</extension>
<mime-type>image/x-icon</mime-type>
</mime-mapping>
10.1对html静态页面设置编码
<!-- 修改下面两行以支持静态超文本的自动编码
-->
<mime-mapping>
<extension>htm</extension>
<mime-type>text/html;charset=gb2312</mime-type>
</mime-mapping>
<mime-mapping>
<extension>html</extension>
<mime-type>text/html;charset=gb2312</mime-type>
</mime-mapping>
</web-app>

11.添加welcome-file-list，并调整顺序。
<welcome-file-list>
<welcome-file>index.jsp</welcome-file>
<welcome-file>index.html</welcome-file>
<welcome-file>index.htm</welcome-file>
<welcome-file>default.html</welcome-file>
<welcome-file>default.htm</welcome-file>
<welcome-file>default.jsp</welcome-file>
</welcome-file-list>
12.如果你的webapp需要只能够进行https方式访问，那么在webapp的web.xml里加上：
<security-constraint>
<web-resource-collection>
<web-resource-name>must https</web-resource-name>
<url-pattern>/lizongbo/*</url-pattern>
</web-resource-collection>
<user-data-constraint>
<transport-guarantee>CONFIDENTIAL</transport-guarantee>
</user-data-constraint>
</security-constraint>
参考：http://jakarta.apache.org/tomcat/faq/security.html#https
http://marc.theaimsgroup.com/?l=tomcat-user&m=104951559722619&w=2
13.修改远程关闭服务器的命令。
server.xml默认有下面一行：
<Server port="8005" shutdown="SHUTDOWN">
这样允许任何人只要telnet到服务器的8005端口，输入"SHUTDOWN"，然后回车，服务器立即就被关掉了。
从安全的角度上考虑，我们需要把这个shutdown指令改成一个别人不容易猜测的字符串。
例如修改如下：
<Server port="8006" shutdown="lizongbo">，这样就只有在telnet到8006，并且输入"lizongbo"才能够关闭Tomcat.
注意：这个修改不影响shutdown.bat的执行。运行shutdown.bat一样可以关闭服务器。
参考：http://jakarta.apache.org/tomcat/faq/security.html#8005


以下皆可以参考：http://www.cnjsp.org/document/user/tuman/valve.html


14.配置http访问日志。Tomcat自带的能够记录的http访问日志已经很详细了
取消下面这段的注释：

<Valve className="org.apache.catalina.valves.AccessLogValve"
directory="logs" prefix="localhost_access_log." suffix=".txt"
pattern="common" resolveHosts="false"/>

然后修改为：
<Valve className="org.apache.catalina.valves.FastCommonAccessLogValve"
directory="logs" prefix="localhost_access_log." suffix=".txt"
pattern="combined" resolveHosts="false" fileDateFormat="yyyy-MM-dd.HH"/>

pattern="combined" 记录的日志内容更详细，fileDateFormat="yyyy-MM-dd.HH"，会让日志文件按小时进行滚卷，
比默认的按天滚卷要好些，尤其是访问量大的网站，可以考虑写成fileDateFormat="yyyy-MM-dd.HH.mm"，就会是每分钟一个日志文件了。
而且可以分别按Engine, Host, or Context,来记录自己的日志
详情参考：
http://jakarta.apache.org/tomcat/tomcat-5.5-doc/config/valve.html
http://jakarta.apache.org/tomcat/tomcat-5.0-doc/config/logger.html
http://jakarta.apache.org/tomcat/tomcat-5.0-doc/config/host.html#Access%20Logs
而且还可以配合awstats来进行日志统计分析： http://www.chedong.com/tech/awstats.html

15.限制ip，限制主机访问等。
如果想禁止指定的ip或者主机名来拒绝某些机器访问，或者指定某些机器来访问。
也支持分别按Engine, Host, or Context,进行以下配置：
<Context path="/examples" ...> ...
<Valve className="org.apache.catalina.valves.RemoteHostValve"
allow="*.mycompany.com,www.yourcompany.com"/>
<Valve className="org.apache.catalina.valves.RemoteAddrValve"
deny="192.168.1.*"/>
</Context>
参考：
http://jakarta.apache.org/tomcat/tomcat-5.0-doc/config/context.html

16.发布webapp到网站根目录
1。直接复制到ROOT目录下。
2.因为无法创建无名字的xml文件，并且在xml文件里指定path也是无效的(tomcat靠文件名字来判断的)，
因此必须在server.xml里写下面一段：
<Context docBase="${catalina.home}/vhost/www.lizongbo.com" path="/"
privileged="true" antiResourceLocking="false" antiJARLocking="false">
<Manager className="org.apache.catalina.session.StandardManager" algorithm="SHA-512"
entropy="suijisifuchuansuijisifuchuansuijisifuchuansuijisifuchuan"
maxActiveSessions="800" />
<Valve className="org.apache.catalina.valves.FastCommonAccessLogValve"
directory="logs" prefix="localhost_mytest_access_log." suffix=".txt"
pattern="combined" resolveHosts="true" fileDateFormat="yyyy-MM-dd.HH"/>

</Context>
而且必须把ROOT目录删除掉，否则Tomcat还是优先部署ROOT目录为"/"。

17.在重新启动Tomcat的webapp的时候，禁止把session写入文件。
修改conf/web.xml
取消注释：
<!---->
<Manager pathname="" />

18.增强SessiionID的生成算法和长度。


<Manager className="org.apache.catalina.session.StandardManager" algorithm="SHA-512" sessionIdLength="40">
</Manager>

（默认的是MD5,长度是16位。）

19.配置日志：(http://jakarta.apache.org/tomcat/tomcat-5.5-doc/logging.html)

在D:\jakarta-tomcat-5.5.8\common\classes\新建log4j.properties

内容：
log4j.rootLogger=debug, R
log4j.appender.R=org.apache.log4j.RollingFileAppender
log4j.appender.R.File=${catalina.home}/logs/tomcat5.5.log
log4j.appender.R.MaxFileSize=10MB
log4j.appender.R.MaxBackupIndex=10
log4j.appender.R.layout=org.apache.log4j.PatternLayout
log4j.appender.R.layout.ConversionPattern=%p %t %c - %m%n
log4j.logger.org.apache.catalina=DEBUG, R
log4j.logger.org.apache.catalina.core.ContainerBase.Catalina.localhost=DEBUG, R
log4j.logger.org.apache.catalina.core=DEBUG, R
log4j.logger.org.apache.catalina.session=DEBUG, R
复制log4j-1.2.9.jar和commons-logging.jar到
D:\jakarta-tomcat-5.5.8\common\lib

20.使用windows域用户验证
===============
J2SDK1.5+TOMCAT5.5 最详细有效安装及配置
网上教程不记其数，浪费我心血时间也不少，首先在此鄙视一下复制人家教程却故意不复制完全的人。

j2sdk1.5 下载地址： http://java.sun.com
tomcat5.5 下载地址： http://jakarta.apache.org/site/binindex.cgi
j2sdk1.5 安装目录： c:\j2sdk1.5.0
tomcat5.5 安装目录： c:\tomcat

一 . 配置 j2sdk1.5.0
1.windows 2000 server 系列下配置
我的电脑 -> 属性 -> 高级 -> 环境变量
追加变量名： java_home 变量值： c:\j2sdk1.5.0
追加变量名： path 下变量值： %java_home%\bin;
追加变量名： classpath 下变量值： .;%java_home%\lib; 或 .;%java_home%\lib\dt.jar;%java_home%\lib\tools.jar
* 注： “.;” 代表当前目录下的所有引用， “%...%” 变量宏替换。

2.windows 9x 系列下配置
用记事本编辑 autoexec.bat ，加入下列语句：
set java_home=c:\j2sdk1.5.0;
set path=%path%;%java_home%\bin;
set classpath=.;%java_home%\lib; 或 .;%java_home%\lib\dt.jar;%java_home%\lib\tools.jar

3.windows xp 、 2003 server 下配置
以上两种方法皆可

4. 运行

a. 用记事本编辑以下代码，并保存为 helloworld.java ：
public class helloworld{
public static void main(string[] args){
system.out.println("hello,world!");
}
}

b. 开始 -> 运行 ->cmd
在控制台中切换到当前目录：
javac helloworld.java
java helloworld
你就会在控制台上看见输出的 hello,world!

* 注： javac 是编译命令，它把 helloworld.java 编译成 helloworld.class
java 就是解释命令， jvm 把 helloworld.class 解释执行
至此 java 运行环境配置、调试完成。

二 . 配置 tomcat5.5
1.windows 2000 server 系列下配置
我的电脑 -> 属性 -> 高级 -> 环境变量
追加变量名： tomcat_home 变量值： c:\tomcat
追加变量名： classpath 下变量值： %tomcat_home%\common\lib;

2.windows 9x 系列下配置
用记事本编辑 autoexec.bat ，加入下列语句：
set tomcat_home=c:\tomcat;
set classpath=%classpath%;%tomcat_home%\common\lib;

3.windows xp 、 2003 server 下配置
以上两种方法皆可

4. 运行
在控制台中转到 c:\tomcat\bin 这个目录，运行 startup.bat ，然后会出现一个窗口，连跳一大串东西，最后表示 server 已经运行：
“server startup in ... ms”
打开 ie 浏览器并在地址栏中输入： http://localhost:8080
此时出现欢迎界面表示 tomcat 已经 ok ！
在控制台中转到 c:\tomcat\bin 这个目录，运行 shutdown.bat ，关闭服务器。
至此 tomcat 运行环境配置、调试完成。

三 . 配置 javabeans

1. 用记事本编辑以下代码，并保存为 circle.java ：
package abc.def;
import java.io.*;
public class circle{
int radius;
public circle(){
radius=1;
}
public int getradius(){
return radius;
}
public void setradius(int newradius){
radius=newradius;
}
public double circlearea(){
return math.pi*radius*radius;
}
public double circlelength(){
return 2.0*math.pi*radius;
}
}

2. 将 circle.java 保存在 c:\tomcat\common\classes\abc\def 目录下。

3. 开始 -> 运行 ->cmd
在控制台中切换到当前目录：
javac circle.java 或直接输入 javac c:\tomcat\common\classes\abc\def\circle.java

4. 用记事本编辑以下代码，并保存为 usebeans.jsp ：
<%@ page contenttype="text/html;charset=gb2312" %>
<%@ page import="abc.def.circle" %>
<html>
<body bgcolor=cyan>
<font size=1>
<jsp:usebean id="girl" class="abc.def.circle" scope="page">
</jsp:usebean>
<% girl.setradius(100);
%>
<p> 圆的半径是：
<%= girl.getradius() %>
<p> 圆的周长是：
<%= girl.circlelength() %>
<p> 圆的面积是：
<%= girl.circlearea() %>
</font>
</body>
</html>

5. 将 usebeans.jsp 保存在 c:\tomcat\webapps\root 目录下。

6. 启动服务器后，打开 ie 浏览器并在地址栏中输入： http://localhost:8080/usebeans.jsp
如出现预期值，表示 javabeans 配置成功！
“
圆的半径是： 100

圆的周长是： 628.3185307179587

圆的面积是： 31415.926535897932
”
至此 javabeans 运行环境配置、调试完成。

四 .servlet 配置
1.windows 2000 server 系列下配置
我的电脑 -> 属性 -> 高级 -> 环境变量
追加变量名： classpath 下变量值： %tomcat_home%\common\lib\servlet-api.jar;

2.windows 9x 系列下配置
用记事本编辑 autoexec.bat ，加入下列语句：
set classpath=%classpath%;%tomcat_home%\common\lib\servlet-api.jar;

3.windows xp 、 2003 server 下配置
以上两种方法皆可

4. 运行
a. 用记事本编辑以下代码，并保存为 hello.java ：
import java.io.*;
import javax.servlet.*;
import javax.servlet.http.*;
public class hello extends httpservlet{
public void init(servletconfig config) throws servletexception{
super.init(config);
}
public void service(httpservletrequest request,httpservletresponse response) throws ioexception{
printwriter out=response.getwriter();
response.setcontenttype("text/html;charset=gb2312");
out.println("<html><body>");
out.println("hello!");
out.println("</body></html>");
}
}

b. 将 hello.java 保存在 c:\tomcat\common\classes 目录下。

c. 开始 -> 运行 ->cmd
在控制台中切换到当前目录：
javac hello.java 或直接输入 javac c:\tomcat\common\classes\hello.java

d. 注册 servlet
用记事本打开 c:\tomcat\webapps\root\web-inf\web.xml
在
- <web-app xmlns="http://java.sun.com/xml/ns/j2ee" xmlns:xsi="http://www.w3.org/2001/xmlschema-instance" xsi:schemalocation="http://java.sun.com/xml/ns/j2eehttp://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd"; version="2.4">
<display-name>welcome to tomcat</display-name>
<description>welcome to tomcat</description>
- <!-- jspc servlet mappings start
-->
.
.
.
- <!-- jspc servlet mappings end
-->
</web-app>
之间相应位置追加以下两组数据：
<servlet>
<servlet-name>hello</servlet-name>
<servlet-class>hello</servlet-class>
</servlet>

<servlet-mapping>
<servlet-name>hello</servlet-name>
<url-pattern>/servlet/hello</url-pattern>
</servlet-mapping>

* 注： <servlet-name>...</servlet-name> 为 servlet 在服务器中的 id
<servlet-class>...</servlet-class> 为 servlet-class 类名
<url-pattern>...</url-pattern> 为镜像路径亦虚拟路径
c:\tomcat\common\classes 为类共享目录，亦可在：
c:\tomcat\webapps\ 你的应用目录 \web-inf\web.xml
中注册，不过在应用 servlet 时须加入 c:\tomcat\webapps\ 下的目录名，如：
http://localhost:8080/ 你的应用目录 /servlet/hello
建议你自己应用所用的 servlet 类放置到 c:\tomcat\webapps\ 你的应用目录 \web-inf\classes 中；在 web.xml 注册 servlet 类路径也是 “/hello” 即可。

e. 重新启动服务器后，打开 ie 浏览器并在地址栏中输入： http://localhost:8080/servlet/hello
显示： “hello!” ，则配置成功！
至此 servlet 运行环境配置、调试完成。

以上为 j2sdk1.5.0+tomcat5.5(04.07.21) 配置环境步骤。由于 tomcat 版本更新极快，所以各版本配置略有差异。希望大家能够灵活变通！

这里强调本版本几个注意事项：
1.javabeans 强制引入包 package *.*;
2.servlet 类库为 %tomcat_home%\common\lib\servlet-api.jar
而不是 %tomcat_home%\lib\servlet.jar （不存在这个目录及类库）
3. 引入第三方类库须加入 classpath 或加入 %java_home%\lib\ 下，以正常加载。用 tomcat5.5(04.07.21) 引用该类库时须将该 *.jar 文件加入 %tomcat_home%\common\lib\ 下。[/size]