腳本catalina.sh用于啟動和關(guān)閉tomcat服務(wù)器，是最關(guān)鍵的腳本
另外的腳本startup.sh和shutdown.sh都是使用不同的參數(shù)調(diào)用了該腳本
該腳本的使用方法如下（引自該腳本本身）：
#!/bin/sh# =============================================================# 該腳本設(shè)置正確的環(huán)境變量和系統(tǒng)信息，然后啟動或者停止tomcat server# 具體的操作是：# 使用命令行參數(shù)作為args的實(shí)參，調(diào)用org.apache.catalina.startup.Bootstrap.main(String[])# ==============================================================# -----------------------------------------------------------------------------# Start/Stop Script for the CATALINA Server## Environment Variable Prequisites## CATALINA_HOME May point at your Catalina "build" directory.## CATALINA_BASE (Optional) Base directory for resolving dynamic portions# of a Catalina installation. If not present, resolves to# the same directory that CATALINA_HOME points to.## CATALINA_OPTS (Optional) Java runtime options used when the "start",# "stop", or "run" command is executed.## CATALINA_TMPDIR (Optional) Directory path location of temporary directory# the JVM should use (java.io.tmpdir). Defaults to# $CATALINA_BASE/temp.## JAVA_HOME Must point at your Java Development Kit installation.## JAVA_OPTS (Optional) Java runtime options used when the "start",# "stop", or "run" command is executed.## JPDA_TRANSPORT (Optional) JPDA transport used when the "jpda start"# command is executed. The default is "dt_socket".## JPDA_ADDRESS (Optional) Java runtime options used when the "jpda start"# command is executed. The default is 8000.## JSSE_HOME (Optional) May point at your Java Secure Sockets Extension# (JSSE) installation, whose JAR files will be added to the# system class path used to start Tomcat.## CATALINA_PID (Optional) Path of the file which should contains the pid# of catalina startup java process, when start (fork) is used# -----------------------------------------------------------------------------# OS specific support. $var _must_ be set to either true or false.cygwin=falsecase "`uname`" inCYGWIN*) cygwin=true;;esac# PRG是被執(zhí)行的腳本的名稱，可以認(rèn)為PRG=="catalina.sh"，也可能是某個符號鏈，指向該腳本。PRG="$0"# 處理了一下PRG，等循環(huán)跳出之后PRG成為 ????while [ -h "$PRG" ]; do ls=`ls -ld "$PRG"` link=`expr "$ls" : '.*-> \(.*\)$'` if expr "$link" : '.*/.*' > /dev/null; then PRG="$link" else PRG=`dirname "$PRG"`/"$link" fidone# PRGDIR是PRG的目錄路徑名稱PRGDIR=`dirname "$PRG"`# 執(zhí)行$CATALINA_HOME/BIN/setenv.sh來設(shè)置環(huán)境變量# [ -r filename ] 是判斷是否文件存在且可讀CATALINA_HOME=`cd "$PRGDIR/.." ; pwd`if [ -r "$CATALINA_HOME"/bin/setenv.sh ]; then . "$CATALINA_HOME"/bin/setenv.shfi# For Cygwin, 確保所有的路徑名都符合UNIX格式if $cygwin; then [ -n "$JAVA_HOME" ] && JAVA_HOME=`cygpath --unix "$JAVA_HOME"` [ -n "$CATALINA_HOME" ] && CATALINA_HOME=`cygpath --unix "$CATALINA_HOME"` [ -n "$CATALINA_BASE" ] && CATALINA_BASE=`cygpath --unix "$CATALINA_BASE"` [ -n "$CLASSPATH" ] && CLASSPATH=`cygpath --path --unix "$CLASSPATH"` [ -n "$JSSE_HOME" ] && JSSE_HOME=`cygpath --path --unix "$JSSE_HOME"`fi# 設(shè)置用來初始化SystemClassLoader的CLASSPATH變量：通過執(zhí)行腳本setclasspath.sh完成# 注意：腳本setclasspath.sh改變了原來的$CLASSPATH變量，而把它設(shè)為：# CLASSPATH=$CATALINA_HOME/bin/bootstrap.jar:$JAVA_HOME/lib/tools.jar# 其中bootstrap.jar是package org.apache.catalina.startup的打包文件，# 含有啟動方法org.apache.catalina.startup.Bootstrap.main(String[] args)# tools.jar含有javac編譯器，用來把jsp文件編譯成為servlet classif [ -r "$CATALINA_HOME"/bin/setclasspath.sh ]; then BASEDIR="$CATALINA_HOME" . "$CATALINA_HOME"/bin/setclasspath.shelse echo "Cannot find $CATALINA_HOME/bin/setclasspath.sh" echo "This file is needed to run this program" exit 1fi# 在CLASSPATH環(huán)境變量后面補(bǔ)上一些JAR文件# [ -n string ] 判斷字符串是否長度非0；[ -z string ] 判斷字符串是否長度為0# 它們可以用來判斷是否某個環(huán)境變量已經(jīng)被設(shè)置if [ -n "$JSSE_HOME" ]; then CLASSPATH="$CLASSPATH":"$JSSE_HOME"/lib/jcert.jar:"$JSSE_HOME"/lib/jnet.jar:"$JSSE_HOME"/lib/jsse.jarfiCLASSPATH="$CLASSPATH":"$CATALINA_HOME"/bin/bootstrap.jar# 指定CATALINA_BASE變量# 如果CATALINA_BASE沒有值，就讓CATALINA_BASE=$CATALINA_HOMEif [ -z "$CATALINA_BASE" ] ; then CATALINA_BASE="$CATALINA_HOME"fi# 指定CATALINA_TMPDIR變量# 如果CATALINA_TMPDIR沒有值，就讓CATALINA_TMPDIR=$CATALINA_BASE/tempif [ -z "$CATALINA_TMPDIR" ] ; then # Define the java.io.tmpdir to use for Catalina CATALINA_TMPDIR="$CATALINA_BASE"/tempfi# For Cygwin, 在執(zhí)行java程序前把路徑名轉(zhuǎn)換成WINDOWS格式if $cygwin; then JAVA_HOME=`cygpath --path --windows "$JAVA_HOME"` CATALINA_HOME=`cygpath --path --windows "$CATALINA_HOME"` CATALINA_BASE=`cygpath --path --windows "$CATALINA_BASE"` CATALINA_TMPDIR=`cygpath --path --windows "$CATALINA_TMPDIR"` CLASSPATH=`cygpath --path --windows "$CLASSPATH"` JSSE_HOME=`cygpath --path --windows "$JSSE_HOME"`fi# 顯示信息，然后執(zhí)行命令echo "Using CATALINA_BASE: $CATALINA_BASE"echo "Using CATALINA_HOME: $CATALINA_HOME"echo "Using CATALINA_TMPDIR: $CATALINA_TMPDIR"echo "Using JAVA_HOME: $JAVA_HOME"# ......當(dāng)執(zhí)行catalina.sh的參數(shù)是jpda的時候......if [ "$1" = "jpda" ] ; then if [ -z "$JPDA_TRANSPORT" ]; then JPDA_TRANSPORT="dt_socket" fi if [ -z "$JPDA_ADDRESS" ]; then JPDA_ADDRESS="8000" fi if [ -z "$JPDA_OPTS" ]; then JPDA_OPTS="-Xdebug -Xrunjdwp:transport=$JPDA_TRANSPORT,address=$JPDA_ADDRESS,server=y,suspend=n" fi CATALINA_OPTS="$CATALINA_OPTS $JPDA_OPTS" shiftfi# ......當(dāng)執(zhí)行catalina.sh的參數(shù)是debug的時候......if [ "$1" = "debug" ] ; then shift if [ "$1" = "-security" ] ; then echo "Using Security Manager" shift exec "$_RUNJDB" $JAVA_OPTS $CATALINA_OPTS -Djava.endorsed.dirs="$JAVA_ENDORSED_DIRS" -classpath "$CLASSPATH" -sourcepath "$CATALINA_HOME"/../../jakarta-tomcat-4.0/catalina/src/share -Djava.security.manager -Djava.security.policy=="$CATALINA_BASE"/conf/catalina.policy -Dcatalina.base="$CATALINA_BASE" -Dcatalina.home="$CATALINA_HOME" -Djava.io.tmpdir="$CATALINA_TMPDIR" org.apache.catalina.startup.Bootstrap "$@" start else exec "$_RUNJDB" $JAVA_OPTS $CATALINA_OPTS -Djava.endorsed.dirs="$JAVA_ENDORSED_DIRS" -classpath "$CLASSPATH" -sourcepath "$CATALINA_HOME"/../../jakarta-tomcat-4.0/catalina/src/share -Dcatalina.base="$CATALINA_BASE" -Dcatalina.home="$CATALINA_HOME" -Djava.io.tmpdir="$CATALINA_TMPDIR" org.apache.catalina.startup.Bootstrap "$@" start fi# ......當(dāng)執(zhí)行catalina.sh的參數(shù)是embedded的時候......elif [ "$1" = "embedded" ] ; then shift echo "Embedded Classpath: $CLASSPATH" exec "$_RUNJAVA" $JAVA_OPTS $CATALINA_OPTS -Djava.endorsed.dirs="$JAVA_ENDORSED_DIRS" -classpath "$CLASSPATH" -Dcatalina.base="$CATALINA_BASE" -Dcatalina.home="$CATALINA_HOME" -Djava.io.tmpdir="$CATALINA_TMPDIR" org.apache.catalina.startup.Embedded "$@"# +----------------------------------------------------+# | ......當(dāng)執(zhí)行catalina.sh的參數(shù)是run的時候...... |# | 在當(dāng)前窗口中啟動tomcat服務(wù)器?。?！ |# +----------------------------------------------------+elif [ "$1" = "run" ]; then # 把參數(shù)run去掉 shift # 如果參數(shù)是run -security，則啟動Security Manager if [ "$1" = "-security" ] ; then echo "Using Security Manager" shift exec "$_RUNJAVA" $JAVA_OPTS $CATALINA_OPTS -Djava.endorsed.dirs="$JAVA_ENDORSED_DIRS" -classpath "$CLASSPATH" -Djava.security.manager -Djava.security.policy=="$CATALINA_BASE"/conf/catalina.policy -Dcatalina.base="$CATALINA_BASE" -Dcatalina.home="$CATALINA_HOME" -Djava.io.tmpdir="$CATALINA_TMPDIR" org.apache.catalina.startup.Bootstrap "$@" start # 如果參數(shù)是孤單的run，則在本窗口中啟動tomcat服務(wù)器 # 在本窗口中啟動的方法是使用exec，讓當(dāng)前進(jìn)程fork一個新進(jìn)程來啟動tomcat，當(dāng)前進(jìn)程是tomcat的父進(jìn)程 # 啟動tomcat的類是org.apache.catalina.startup.Bootstrap.main("start"); else exec "$_RUNJAVA" $JAVA_OPTS $CATALINA_OPTS -Djava.endorsed.dirs="$JAVA_ENDORSED_DIRS" -classpath "$CLASSPATH" -Dcatalina.base="$CATALINA_BASE" -Dcatalina.home="$CATALINA_HOME" -Djava.io.tmpdir="$CATALINA_TMPDIR" org.apache.catalina.startup.Bootstrap "$@" start fi# +----------------------------------------------------+# | ......當(dāng)執(zhí)行catalina.sh的參數(shù)是start的時候...... |# | 在新窗口中啟動tomcat服務(wù)器！！！ |# +----------------------------------------------------+elif [ "$1" = "start" ] ; then # 把參數(shù)start去掉 shift # 創(chuàng)建一個文件（如果文件不存在的話）$CATALINA_BASE/logs/catalina.out touch "$CATALINA_BASE"/logs/catalina.out # 如果參數(shù)是start -security，則啟動Security Manager if [ "$1" = "-security" ] ; then echo "Using Security Manager" shift "$_RUNJAVA" $JAVA_OPTS $CATALINA_OPTS -Djava.endorsed.dirs="$JAVA_ENDORSED_DIRS" -classpath "$CLASSPATH" -Djava.security.manager -Djava.security.policy=="$CATALINA_BASE"/conf/catalina.policy -Dcatalina.base="$CATALINA_BASE" -Dcatalina.home="$CATALINA_HOME" -Djava.io.tmpdir="$CATALINA_TMPDIR" org.apache.catalina.startup.Bootstrap "$@" start >> "$CATALINA_BASE"/logs/catalina.out 2>&1 & if [ ! -z "$CATALINA_PID" ]; then echo $! > $CATALINA_PID fi # 如果參數(shù)是孤單的start，那么在新窗口中啟動tomcat else "$_RUNJAVA" $JAVA_OPTS $CATALINA_OPTS -Djava.endorsed.dirs="$JAVA_ENDORSED_DIRS" -classpath "$CLASSPATH" -Dcatalina.base="$CATALINA_BASE" -Dcatalina.home="$CATALINA_HOME" -Djava.io.tmpdir="$CATALINA_TMPDIR" org.apache.catalina.startup.Bootstrap "$@" start >> "$CATALINA_BASE"/logs/catalina.out 2>&1 & if [ ! -z "$CATALINA_PID" ]; then echo $! > $CATALINA_PID fi fi# +----------------------------------------------------+# | ......當(dāng)執(zhí)行catalina.sh的參數(shù)是stop的時候...... |# | 關(guān)閉tomcat服務(wù)器?。?！ |# +----------------------------------------------------+elif [ "$1" = "stop" ] ; then # 把參數(shù)stop去掉 shift # 關(guān)閉tomcat服務(wù)器的類是org.apache.catalina.startup.Bootstrap->main("stop"); # 注意：java -D 是設(shè)置系統(tǒng)屬性 exec "$_RUNJAVA" $JAVA_OPTS $CATALINA_OPTS -Djava.endorsed.dirs="$JAVA_ENDORSED_DIRS" -classpath "$CLASSPATH" -Dcatalina.base="$CATALINA_BASE" -Dcatalina.home="$CATALINA_HOME" -Djava.io.tmpdir="$CATALINA_TMPDIR" org.apache.catalina.startup.Bootstrap "$@" stop# +----------------------------------------------------+# | ......當(dāng)執(zhí)行catalina.sh的參數(shù)不可辨認(rèn)的時候...... |# | 打印幫助信息，由此查看各種參數(shù)代表的意義?。?！ |# +----------------------------------------------------+else echo "Usage: catalina.sh ( commands ... )" echo "commands:" echo " debug Start Catalina in a debugger" echo " debug -security Debug Catalina with a security manager" echo " embedded Start Catalina in embedded mode" echo " jpda start Start Catalina under JPDA debugger" echo " run Start Catalina in the current window" echo " run -security Start in the current window with security manager" echo " start Start Catalina in a separate window" echo " start -security Start in a separate window with security manager" echo " stop Stop Catalina" exit 1fiFrom: http://www.huihoo.org/apache/tomcat/heavyz/02-catalina.sh.html
echo "Usage: catalina.sh ( commands ... )" echo "commands:" echo " debug Start Catalina in a debugger" echo " debug -security Debug Catalina with a security manager" echo " embedded Start Catalina in embedded mode" echo " jpda start Start Catalina under JPDA debugger" echo " run Start Catalina in the current window" echo " run -security Start in the current window with security manager" echo " start Start Catalina in a separate window" echo " start -security Start in a separate window with security manager" echo " stop Stop Catalina"
