2010-01-29 初稿java
2011-01-19 更改 部分地方筆誤。linux
2011-01-20 增長 常見錯誤解決方法。web
《 tomcat 6 故障解決 》http://jedy82.blog.51cto.com/425872/487618shell
1、安裝前的準備和相關說明express
下載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 ~]#apache
相關說明:
網站目錄爲:/data/webapps
log目錄爲:/var/logs
2、安裝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 測試javabootstrap
3、安裝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>tomcat
<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安裝完成
4、設置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]的信息,這樣就完成設置過程。
5、錯誤解決
一、使用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 也會出現上述錯誤。
二、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 這樣的信息,說明成功。