Tomcat 5.5.23 文档阅读Tips 2 - Setup，有JSVC的重要内容

本文虽然是Setup，但是没有讲最generic的安装方法，那就是直接将Tomcat解开，然后配置好JAVA_HOME，用$CATALINA_HOME/bin/startup.sh(.bat)来启动Tomcat，这是最普通的做法。本文重点介绍的是更好的一种方法，那就是在windows和linux下都把Tomcat跑成一个service/daemon。 

1. 在windows下的安装非常简单。Tomcat 5本身就带了一个exe格式的安装文件，直接双击这个文件就可以开始安装，安装过程中还可以选择是否将Tomcat配置成一个windows的service，非常好用。 

2. 重点是UNIX/Linux下的安装。要让Tomcat在Linux下跑成一个daemon，需要jsvc，这个东西来自apache common daemon project，所以在$CATALINA_HOME/bin目录下我们能看到jsvc.tar.gz和common-daemon.jar这些文件。在Linux下安装jsvc必需要手动编译，如下： 

CODE:  SELECT ALL

cd $CATALINA_HOME/bin
tar xvfz jsvc.tar.gz
cd jsvc-src
autoconf
chmod u+x configure
./configure
make
cp jsvc ..
cd ..

这里我们看到，首先执行了一个autoconf这个命令，这个东西会在当前目录下查找configure.in这样的文件，然后生成configure脚本，其实我个人觉得这个没有必要，因为jsvc这个包解开就有了configure脚本，不过既然文档这么说，就做一下吧；然后我们chmod u+x configure给configure脚本加上可执行权限。make完成后就会在当前目录生成jsvc可执行文件，我们将其拷贝到了上一层目录，也就是$CATALINA_HOME/bin下面。

然后文档就给出了一个用jsvc启动Tomcat的例子：

CODE:  SELECT ALL

cd $CATALINA_HOME
./bin/jsvc -Djava.endorsed.dirs=./common/endorsed -cp ./bin/bootstrap.jar \
              -outfile ./logs/catalina.out -errfile ./logs/catalina.err \
              org.apache.catalina.startup.Bootstrap

这个是可以的，我已经试过了。不过jsvc还提供了一个更好的东西，一个可以放在/etc/init.d目录下的一个脚本的template。这里文档中有两个错误，第一就是这个脚本是位于：$CATALINA_HOME/bin/jsvc-src/native目录下，而不是$CATALINA_HOME/bin/jsvc/native目录下；第二就是tomcat 5.5.23中有一个Tomcat5.sh的template，而不是只有tomcat.sh这个脚本。文档中说tomcat.sh这个脚本是给tomcat 4用的，不能给tomcat 5用，需要手动修改一下，其实$CATALINA_HOME/bin/jsvc-src/native目录下有一个Tomcat5.sh的template，正好给我们用，这里我修改了一下，并且测试了一下，下面给出我修改好的这个脚本（我把这个脚本取名tomcat，放在了/etc/init.d目录下，权限设成了755）：

CODE:  SELECT ALL

#!/bin/sh
#
# chkconfig: 35 95 95
# description: tomcat start/stop scripts
#
##############################################################################
#
#   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-5.0.x (Apache Tomcat/5.0)
#
# Adapt the following lines to your configuration
JAVA_HOME=/usr/java/jdk1.5.0_07
CATALINA_HOME=/root/apache-tomcat-5.5.23
DAEMON_HOME=/root/apache-tomcat-5.5.23/bin
#TOMCAT_USER=tomcat5
# Added by Eric Zhang
JVM_MODE=server

# for multi instances adapt those lines.
TMP_DIR=/tmp
PID_FILE=/var/run/jsvc.pid
CATALINA_BASE=/root/apache-tomcat-5.5.23

CATALINA_OPTS=""
CLASSPATH=$JAVA_HOME/lib/tools.jar:$CATALINA_HOME/bin/commons-daemon.jar:$CATALINA_HOME/bin/bootstrap.jar

# we ignore the -user $TOMCAT_USER line
# and we added the -jvm $JVM_MODE line
# add -debug before the org.apache.catalina.startup.Bootstrap line if you want to see debug infos

case "$1" in
  start)
    #
    # Start Tomcat
    #
    $DAEMON_HOME/jsvc \
    -jvm $JVM_MODE \
    -home $JAVA_HOME \
    -Dcatalina.home=$CATALINA_HOME \
    -Dcatalina.base=$CATALINA_BASE \
    -Djava.io.tmpdir=$TMP_DIR \
    -wait 10 \
    -pidfile $PID_FILE \
    -outfile $CATALINA_HOME/logs/catalina.out \
    -errfile $CATALINA_HOME/logs/catalina.err \
    $CATALINA_OPTS \
    -cp $CLASSPATH \
    -verbose:gc \
    org.apache.catalina.startup.Bootstrap
    exit $?
    ;;

  stop)
    #
    # Stop Tomcat
    #
    $DAEMON_HOME/jsvc \
    -stop \
    -pidfile $PID_FILE \
    org.apache.catalina.startup.Bootstrap
    exit $?
    ;;

  *)
    echo "Usage tomcat.sh start/stop"
    exit 1;;
esac

从上可以看到，我把chkconfig的东西也加了进去，而且在原有template的基础上，加入了JVM_MODE的设定，让JVM跑在server模式下，对-verbose也修改成了-verbose:gc，因为我们目前只关注gc的动作，看是否有内存泄漏......具体看脚本吧。最后用chkconfig --add tomcat就可以把tomcat加到启动中，下次重启机器，tomcat就起来了。在ps进程中可以看到两个jsvc的进程，都是jsvc启动起来的，这两个进程进程pid正好相差1，很明显是jsvc执行的时候fork了一个子进程。 

上面的tomcat脚本基本涵盖了jsvc所有常用的option，我们可以jsvc -help来查看所有jsvc支持的option，常用的就是上面列出的，象-jvm, -cp, -outfile, -errfile这些。看看stop部分，stop tomcat的时候jsvc的命令行应该用-stop option。 

有一点需要注意，如果从这里将tomcat脚本拷贝出去，粘贴使用的时候，不要忘记在每个\的后面都有一个\n存在，而这个换行在tomcat脚本中是不允许的，因为这是一行命令，只是我们为了书写好看，用\换行了而已，所以千万记得要手动去掉每个\符号后面的换行回车符号。