修改记录:

2010-01-29 初稿

2011-01-19 更改 部分地方笔误。

2011-01-20 增加 常见错误解决方法。

《 tomcat 6 故障解决 》http://jedy82.blog.51cto.com/425872/487618

一、安装前的准备和相关说明

下载JDK,tomcat
     我下载的是
     apache-tomcat-6.0.24.tar.gz        注意有些版本中不含jsvc.tar.gz,比如: apache-tomcat-6.0.29.tar.gz
     jdk-6u22-linux-i586-rpm.bin
    
查看系统版本
[root@www ~]# uname -a
Linux web 2.6.18-164.el5 #1 SMP Tue Aug 18 15:51:54 EDT 2009 i686 i686 i386 GNU/Linux
[root@www ~]#

相关说明:
网站目录为:/data/webapps
log目录为:/var/logs
 
 
二、安装JDK
[root@www ~]# cd /software
[root@www software]# chmod +x jdk-6u22-linux-i586-rpm.bin
[root@www software]# ./jdk-6u22-linux-i586-rpm.bin
[root@www software]# vi /etc/profile
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
在export PATH前增加以下内容
JAVA_HOME=/usr/java/jdk1.6.0_22
CLASSPATH=$JAVA_HOME/lib/tools.jar:$JAVA_HOME/lib/dt.jar
CATALINA_HOME=/usr/local/tomcat
CATALINA_BASE=/usr/local/tomcat
PATH=$PATH:$JAVA_HOME/bin:$CATALINA_HOME/bin/
在export PATH 的后面增加以下内容
JAVA_HOME CLASSPATH CATALINA_HOME CATALINA_BASE
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
注销用户后重新登陆
[root@www software]# set |grep java 查看输出中有没有java的变量
[root@www software]# java -version 测试java

三、安装tomcat
[root@www software]# chmod +x apache-tomcat-6.0.24.tar.gz
[root@www software]# cd /usr/local
[root@www local]# tar -xzvf /software/apache-tomcat-6.0.24.tar.gz
[root@www local]# ln -s apache-tomcat-6.0.24 tomcat
[root@www local]# chmod +x -R tomcat/bin
[root@www local]#  cd tomcat
[root@www tomcat]# startup.sh 启动tomcat
[root@www tomcat]# netstat -ln | grep 80 要保证出现下面一行   
tcp        0      0 :::8080                       :::*                        LISTEN   
在浏览器里输入
http://localhsot:8080 应该会出来tomcat的标志
[root@www tomcat]# shutdown.sh 停止tomcat
[root@www tomcat]# vi conf/server.xml 更改以下几行
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
    <Engine name="Catalina" defaultHost="www.web.com">         \\更改默认主机     
 
       <Connector port="8080" protocol="HTTP/1.1"
               connectionTimeout="20000"
               redirectPort="8443" />                   更改端口为8080
                   
                                                                  \\主机信息段
            <Host name="localhost"  appBase="/usr/local/tomcat/webapps"
             unpackWARs="true" autoDeploy="true"
             xmlValidation="false" xmlNamespaceAware="false">
           </Host>

         <Host name="www.web.com"  appBase="/data/webapps"
             unpackWARs="true" autoDeploy="true"
             xmlValidation="false" xmlNamespaceAware="false">
      <Context path="" docBase="/data/webapps/web" reloadable="true" caseSensitive="false" debug="0"/>
      </Host>

         <Host name="www.web1.com"  appBase="webapps"
             unpackWARs="true" autoDeploy="true"
             xmlValidation="false" xmlNamespaceAware="false">
      <Alias>www.web1.cn</Alias>                       \\别名主机
      <Context path="" docBase="/data/webapps/web1" reloadable="true" caseSensitive="false" debug="0"/>
         </Host>
                                                       \\主机信息段 结束,多主机可重复此信息      

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~


[root@www tomcat]# vi conf/tomcat-users.xml 更改以下几行
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 <user username="tomcat" password="admin" roles="admin,manager"/> 增加tomcat管理用户
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
[root@www tomcat]# mkdir -pv /var/logs
[root@www tomcat]# mkdir -pv /var/www
[root@www tomcat]# startup.sh 启动tomcat
[root@www tomcat]#  netstat -ln | grep 80 要保证出现下面一行   
tcp        0      0 :::80                       :::*                        LISTEN   
在浏览器里输入
http://localhsot 应该会出来自定义的网站
[root@www tomcat]# shutdown.sh 停止tomcat
[root@www tomcat]#

tomcat安装完成


四、设置tomcat开机自启动

以下文章参考了网上的文章,但经过自己试验和整理。
linux自动启动程序的方法很多,但是有时某些程序要设置环境变量的就会引起麻烦。
tomcat启动时需要设置JAVA_HOME,CLASSPATH等环境变量,
很多文章说设置好环境变量,把$path/startup.sh放到rc.local中就可以实现自动启动了,
但是实际操作发现,很多的linux版本因为安全原因,rc.local中忽略了export命令,也就是说在这里设置的export都是无效的,同时,放在rc.local中默认会以root用户运行,只要在远程运行一个jsp文件就可能会删除系统文件,是极不安全的方式。


以下方法经过我的验证,可以实现。

在Linux下,Tomcat可以作为一个守护进程来启动以及停止,这个必须借助于项目commons-daemon中的jsvc工具。Tomcat安装完后就带有这个工具的源码{tomcat}/bin/jsvc.tar.gz。按照下列命令安装这个工具:
[root@www ~]# cd /usr/local/tomcat/bin/
[root@www bin]# tar zxvf /usr/local/tomcat/bin/jsvc.tar.gz
[root@www bin]# cd jsvc-src
[root@www jsvc-src]# chmod +x configure
[root@www jsvc-src]# ./configure --with-java=/usr/java/jdk1.6.0_22/
[root@www jsvc-src]# make
[root@www jsvc-src]# ./jsvc -help

jsvc工具本身带了一个脚本(在native目录下)用来启动和停止Tomcat守护进程,但是在试验中发现该脚本无法设置为自动启动,显示的错误信息是:tomcat 服务不支持 chkconfig,因此修改了此脚本。(网上大部分代码有错误,经修改运行OK)

[root@www jsvc-src]#  cp  /usr/local/tomcat/bin/jsvc-src/native/Tomcat5.sh /etc/rc.d/init.d/tomcatd
[root@www jsvc-src]#  useradd tomcat
[root@www jsvc-src]#  chown -R tomcat /usr/local/tomcat/
[root@www jsvc-src]#  vi /etc/rc.d/init.d/tomcatd
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
#!/bin/sh
##############################################################################
#
#   Copyright 2004 The Apache Software Foundation.
#
#   Licensed under the Apache License, Version 2.0 (the "License");
#   you may not use this file except in compliance with the License.
#   You may obtain a copy of the License at
#
#       http://www.apache.org/licenses/LICENSE-2.0
#
#   Unless required by applicable law or agreed to in writing, software
#   distributed under the License is distributed on an "AS IS" BASIS,
#   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
#   See the License for the specific language governing permissions and
#   limitations under the License.
##############################################################################
#
# Small shell script to show how to start/stop Tomcat using jsvc
# If you want to have Tomcat running on port 80 please modify the server.xml
# file:
#
#    <!-- Define a non-SSL HTTP/1.1 Connector on port 80 -->
#    <Connector className="org.apache.catalina.connector.http.HttpConnector"
#               port="80" minProcessors="5" maxProcessors="75"
#               enableLookups="true" redirectPort="8443"
#               acceptCount="10" debug="0" connectionTimeout="60000"/>
#
# That is for Tomcat-6.0.x (Apache Tomcat/6.0)
#
#chkconfig: 345 87 13
#description: Tomcat Daemon
#
#processname: jsvc
prog=tomcat
 
#
# Adapt the following lines to your configuration
JAVA_HOME=/usr/java/jdk1.6.0_22
CATALINA_HOME=/usr/local/tomcat
DAEMON_HOME=$CATALINA_HOME/bin
TOMCAT_USER=tomcat
 
# for multi instances adapt those lines.
TMP_DIR=/tmp
#pidfile:/var/run/jsvc.pid
CATALINA_OPTS=
PID_FILE=/var/run/jsvc.pid
CATALINA_BASE=$CATALINA_HOME
 
#CATALINA_OPTS="-Djava.library.path=/home/jfclere/jakarta-tomcat-connectors/jni/native/.libs"
CLASSPATH=$JAVA_HOME/lib/tools.jar:$CATALINA_HOME/bin/commons-daemon.jar:$CATALINA_HOME/bin/bootstrap.jar
 
#case "$1" in
start(){
       echo -n "Starting $prog: "
    #
    # Start Tomcat
    #
#    $DAEMON_HOME/src/native/unix/jsvc \
    $DAEMON_HOME/jsvc-src/jsvc \
    -user $TOMCAT_USER \
    -home $JAVA_HOME \
    -Dcatalina.home=$CATALINA_HOME \
    -Djava.io.tmpdir=$TMP_DIR \
    -XX:PermSize=256M -XX:MaxPermSize=1024m \
    -pidfile $PID_FILE \
    -outfile $CATALINA_HOME/logs/catalina.out \
    -errfile '&1' \
    $CATALINA_OPTS \
    -cp $CLASSPATH \
    org.apache.catalina.startup.Bootstrap
    #
    # To get a verbose JVM
    #-verbose \
    # To get a debug of jsvc.
    #-debug \
        RETVAL=$?
        [ $RETVAL = 0 ] && touch /var/lock/subsys/jsvc
        [ $RETVAL = 0 ] && echo success || echo failure
    echo return $RETVAL PID:`cat /var/run/jsvc.pid` 
}
#    exit $?
  stop(){
       echo -n "Stopping $prog: "
    #
    # Stop Tomcat
    #
    PID=`cat /var/run/jsvc.pid` 
    kill $PID
         RETVAL=$?
         [ $RETVAL = 0 ] && rm -f /var/lock/subsys/jsvc
         [ $RETVAL = 0 ] && echo success || echo failure
     echo return $RETVAL
}
 
case "$1" in
          start) start;;
           stop) stop;;
        restart) stop && start;;
              *) "Usage $0 start stop restart"
 
#    $DAEMON_HOME/src/native/unix/jsvc \
#    -stop \
#    -pidfile $PID_FILE \
#    org.apache.catalina.startup.Bootstrap
#    exit $?
#    ;;
 
#  *)
#    echo "Usage tomcat.sh start/stop"
    exit 1;;
esac

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

[root@www ~]# chmod +x /etc/rc.d/init.d/tomcatd

来验证守护进程是否可以正常启动和停止。
[root@www ~]# /etc/rc.d/init.d/tomcatd start|stop 启动或停止tomcat

[root@www ~]# service tomcatd start | stop|restart

接下来就是把这个脚本设置成系统启动时自动执行,系统关闭时自动停止,使用如下命令:
[root@www ~]# chkconfig --add tomcatd

重新启动系统后可以启动的过程中看到Starting Tomcat ..... [OK]的信息,这样就完成设置过程。

五、错误解决

1、使用startup.sh 能正常启动,可以正常访问web应用,但停止tomcat时却提示拒绝链接,提示信息如下:
##############################################################

[root@web tomcat]# shutdown.sh
Using CATALINA_BASE:   /usr/local/tomcat
Using CATALINA_HOME:   /usr/local/tomcat
Using CATALINA_TMPDIR: /usr/local/tomcat/temp
Using JRE_HOME:        /usr/java/jdk1.6.0_22
Using CLASSPATH:       /usr/local/tomcat/bin/bootstrap.jar
2011-1-20 13:48:41 org.apache.catalina.startup.Catalina stopServer

严重: Catalina.stop:
java.net.ConnectException: Connection timed out
        at java.net.PlainSocketImpl.socketConnect(Native Method)
        at java.net.PlainSocketImpl.doConnect(PlainSocketImpl.java:333)
        at java.net.PlainSocketImpl.connectToAddress(PlainSocketImpl.java:195)
        at java.net.PlainSocketImpl.connect(PlainSocketImpl.java:182)
        at java.net.SocksSocketImpl.connect(SocksSocketImpl.java:366)
        at java.net.Socket.connect(Socket.java:529)
        at java.net.Socket.connect(Socket.java:478)
        at java.net.Socket.<init>(Socket.java:375)
        at java.net.Socket.<init>(Socket.java:189)
        at org.apache.catalina.startup.Catalina.stopServer(Catalina.java:424)
        at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
        at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:39)
        at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:25)
        at java.lang.reflect.Method.invoke(Method.java:597)
        at org.apache.catalina.startup.Bootstrap.stopServer(Bootstrap.java:338)
        at org.apache.catalina.startup.Bootstrap.main(Bootstrap.java

##############################################################

解决方法:

经过调试tomcat发现,tomcat在停止的时候链接的是[计算机名:8009];而我的计算机名称是[web],由于我没有在hosts里面

配置web --> 127.0.0.1,导致被无法解析,所以tomcat在停止时候无法链接该地址的8009端口,只要在/etc/hosts里增加web -->

127.0.0.1的解析就可以。
另外 如果tomcat 本身是关闭的,使用shutdown.sh 也会出现上述错误。

2、tomcat能正常启动 ,如果是多个网站,有的网站能访问,有的不能访问,log 提示信息如下:
##############################################################
信息: Deploying web application archive test.war
Exception in thread "Thread-12" java.lang.OutOfMemoryError: PermGen space
        at sun.net.www.protocol.http.Handler.openConnection(Handler.java:44)
        at sun.net.www.protocol.http.Handler.openConnection(Handler.java:39)
        at java.net.URL.openConnection(URL.java:945)
        at com.digican.pc.ss.ReviceMessageServer.run(ReviceMessageServer.java:58)
        at java.lang.Thread.run(Thread.java:662)
Exception in thread "main" java.lang.OutOfMemoryError: PermGen space
Exception in thread "Thread-28" java.lang.OutOfMemoryError: PermGen space
Exception in thread "Thread-34" java.lang.OutOfMemoryError: PermGen space
[root@web logs]# 

##############################################################
解决方法:

经过调试tomcat发现,此问题是由于tomcat本身默认的内存较小造成的,解决方法分两种:

如将内存增加至1024M

第一种: 使用startup.sh 启动tomcat的解决方法

修改 TOMCAT_HOME/bin/catalina.sh

在“echo "Using CATALINA_BASE:   $CATALINA_BASE"”上面加入以下行:
JAVA_OPTS="-server -XX:PermSize=512M -XX:MaxPermSize=1024m"

重启tomcat

 使用ps -aux 能得到  -XX:PermSize=256M -XX:MaxPermSize=1024m 这样的信息,说明成功。
 
第二种:使用server tomcatd start 启动tomcat的解决方法

修改 /etc/init.d/tomcatd

在“"-Djava.io.tmpdir=$TMP_DIR \
    -pidfile $PID_FILE \”
   
    之间增加一行
    “-XX:PermSize=256M -XX:MaxPermSize=1024m \”
   
    修改后的内容如下:
    “"-Djava.io.tmpdir=$TMP_DIR \
    -XX:PermSize=256M -XX:MaxPermSize=1024m \
    -pidfile $PID_FILE \”
   
    之后重启tomcat
   
    使用ps -aux 能得到  -XX:PermSize=256M -XX:MaxPermSize=1024m 这样的信息,说明成功。