实战 linux 下JDK6 + TOMCAT6 安装与配置

《 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 这样的信息，说明成功。