在5.0版本下的配置:

    
    
    
     
      factory
      org.apache.commons.dbcp.BasicDataSourceFactory
     

      
      ...

     ...

      
     ...

     ...

在5.5版本下的配置:

                   auth="Container" type="javax.sql.DataSource" 
                 maxActive="100"
                 maxIdle="30"
                 maxWait="10000"
                 username="root"
                 password=""
                 driverClassName="org.gjt.mm.mysql.Driver"
                 url="jdbc:mysql://localhost:3306/myhibernate"/>
  

来使用绑定到JNDI的连接池中提供的连接。我们使用XML格式的Hibernate配置。
XML配置文件放在上下文类路径(WEB-INF/classes)下面，称为hibernate.cfg.xml:

   
      java:comp/env/jdbc/myhibernate
      false
      net.sf.hibernate.dialect.MySQLDialect
      
      
   

在5.0版本下的配置:

    
    
    
     
      factory
      org.apache.commons.dbcp.BasicDataSourceFactory
     

      
      ...

     ...

      
     ...

     ...

在5.5版本下的配置:

                   auth="Container" type="javax.sql.DataSource" 
                 maxActive="100"
                 maxIdle="30"
                 maxWait="10000"
                 username="root"
                 password=""
                 driverClassName="org.gjt.mm.mysql.Driver"
                 url="jdbc:mysql://localhost:3306/myhibernate"/>
  

来使用绑定到JNDI的连接池中提供的连接。我们使用XML格式的Hibernate配置。
XML配置文件放在上下文类路径(WEB-INF/classes)下面，称为hibernate.cfg.xml:

   
      java:comp/env/jdbc/myhibernate
      false
      net.sf.hibernate.dialect.MySQLDialect
      
      
   

RedHat Linux 8.0
J2sdk1.4.1_02
Tomcat 4.1.12 binary
Apache 2.0.47 built from source
jk2 connector source from jakarta.apache.org

安装JDK:

下载: j2sdk-1_4_1_02-linux-i586.bin
把jdk 安装在/usr/local/j2sdk1.4.1_02
在/usr/local 下建立 软连接 jdk
#ln -s /usr/local/j2sdk1.4.1_02 /usr/local/jdk

[user@host]# cat /etc/profile.d/java.sh
# set java environment
export JAVA_HOME=/usr/local/jdk
export PATH=$PATH:$JAVA_HOME/bin
export CLASSPATH=$JAVA_HOME/lib

#更改shell文件属性:
#chmod 755 /etc/profile.d/java.sh

#查看是否正确
#which java
/usr/local/jdk/bin/java

安装apache :

#cd /usr/local/src/
#tar -xzvf httpd-2.0.47.tar.gz
#cd httpd-2.0.47
#配置apache 支持动态module 加载
#./configure
"--with-layout=Apache"
"--prefix=/usr/local/apache"
"--enable-module=so"
"--enable-module=setenvif"
"--enable-module=rewrite"
"--with-mpm=prefork"

#make
#make install

#修改http.conf 具体的修改请参考apache2.0文档
# 或者查看 http://www.cnfug.org/journal/3/02.html

StartServers 10
MinSpareServers 25
MaxSpareServers 50
ServerLimit 2000
MaxClients 1500 #Apache可以同时处理的请求
MaxRequestsPerChild 10000

安装Php :
下载: php-4.3.3.tar.gz
#cd /usr/local/src
#tar -xzvf

#php for apache 以apache modules的方式运行
./configure --with-apxs2=/usr/local/apache/bin/apxs

#php run like shell 以单独的shell方式运行
./configure --prefix=/usr/local/php

#php for apache
./configure
--with-apxs2=/usr/local/apache/bin/apxs
--enable-track-vars
--enable-debug
--enable-url-includes
--enable-sockets
--with-config-file-path=/usr/local/apache/conf #php.ini文件放的目录
#下面的参数是安装PHP + gd库
--with-gd=/usr/local
--enable-gd-native-ttf
--with-ttf=/usr/local
--with-jpeg-dir=/usr/local
--with-zlib-dir=/usr/local
--with-png-dir=/usr/local
#make
#make install
#ls -l /usr/local/apache/modules/libphp4.so #存在 安装成功

#修改apache http.conf
添加
LoadModule php4_module modules/libphp4.so
AddType application/x-httpd-php .php

安装Tomcat:
#cd /usr/local
#tar -xzvf jakarta-tomcat-4.1.24.tar.gz
#ln -s jakarta-tomcat-4.1.24 tomcat
#测试Tomcat正常安装:
#/usr/local/tomcat/bin/startup.sh

#通过IE http://yourIP:8080/ Tomcat的页面正常显示

安装JK2 :
#cd /usr/local/src
#tar -xzvf jakarta-tomcat-connectors-jk2-2.0.2-src.tar.gz
#cd jakarta-tomcat-connectors-jk2-2.0.2-src
#cd jk/native2
#chmod 755 buildconf.sh
#./configure --with-apxs2=/usr/local/apache/bin/apxs --enable-EAPI
#make
#make install
#如果make install 不成功需要手工发布mod_jk2.so
#cd /usr/local/src/jakarta-tomcat-connectors-jk2-2.0.2-src/jk/build/jk2/apache2
#cp *.so /usr/local/apache/modules/

配置$CATLINA/conf/server.xml

debug="0"/>
debug="0"/>

port="8080" minProcessors="5" maxProcessors="75"
enableLookups="true" redirectPort="8443"
acceptCount="100" debug="0" connectionTimeout="-1"
useURIValidationHack="false" disableUploadTimeout="true" />

port="8009" minProcessors="5" maxProcessors="75"
enableLookups="true" redirectPort="8443"
acceptCount="10" debug="0" connectionTimeout="-1"
useURIValidationHack="false"
protocolHandlerClassName="org.apache.jk.server.JkCoyoteHandler"/>

prefix="catalina_log." suffix=".txt"
timestamp="true"/>

unpackWARs="true" autoDeploy="true">

directory="logs" prefix="localhost_log." suffix=".txt"
timestamp="true"/>

#编辑
#vi /usr/local/tomcat/conf/jk2.properties
# list of needed handlers.
handler.list=channelSocket,request
# Override the default port for the channelSocket
channelSocket.port=8009

#编辑文件:

#vi /usr/local/apache/conf/workers2.properties

# only at beginnin. In production uncomment it out
[logger.apache2]
level=DEBUG

[shm]
file=/usr/local/apache/logs/shm.file
size=1048576

# Example socket channel, override port and host.
[channel.socket:localhost:8009]
port=8009
host=127.0.0.1

# define the worker
[ajp13:localhost:8009]
channel=channel.socket:localhost:8009

# Uri mapping
[uri:192.168.0.90/*.jsp]
worker=ajp13:localhost:8009

[uri:211.167.83.165/*.jsp]
worker=ajp13:localhost:8009

#编辑http.conf
#修改
DocumentRoot "/usr/local/tomcat/webapps"
#添加index.jsp
DirectoryIndex index.html index.html.var index.jsp

LoadModule jk2_module modules/mod_jk2.so

Order deny,allow
Deny from all

#
# Order deny,allow
# Deny from all
#

Order Allow,Deny

ServerName www.home.net
ServerAlias www
ServerAlias localhost
ServerAlias 192.168.0.90
ServerAlias 211.167.83.165
ServerAdmin webmater@5757.com
DocumentRoot /usr/local/tomcat/webapps

ErrorLog logs/home.net-errorlog
CustomLog logs/home.net-access.log common

JkUriSet worker ajp13:localhost:8009

在配置server.xml 的时候:
配置管理端口 和连接的端口顺序颠倒一下
在 catalina.out 可以观察到:
这样用apache 连接的时候,就不用等待了.

port="8009" minProcessors="5" maxProcessors="75"
enableLookups="true" redirectPort="8443"
acceptCount="10" debug="0" connectionTimeout="0"
useURIValidationHack="false"
protocolHandlerClassName="org.apache.jk.server.JkCoyoteHandler"/>

port="8080" minProcessors="5" maxProcessors="75"
enableLookups="true" redirectPort="8443"
acceptCount="100" debug="0" connectionTimeout="20000"
useURIValidationHack="false" disableUploadTimeout="true" />

#server.xml 不支持中文的注释
#对 shared/classes 目录下的java进行的修改不能立刻的反应到jsp中标.不能立即起作用.

以上的安装同样适合jakarta-tomcat-5.0.12 在以下的配置中注意

#在配置 jakarta-tomcat-5.0.12 的时候,注意 server.xml 中

没有封闭.

BUG:

在catalina.out 报错误.

总体上感觉tomcat 5.0 比4.x在性能上是有了改进.启动的速度快.

RedHat Linux 8.0
J2sdk1.4.1_02
Tomcat 4.1.12 binary
Apache 2.0.47 built from source
jk2 connector source from jakarta.apache.org

安装JDK:

下载: j2sdk-1_4_1_02-linux-i586.bin
把jdk 安装在/usr/local/j2sdk1.4.1_02
在/usr/local 下建立 软连接 jdk
#ln -s /usr/local/j2sdk1.4.1_02 /usr/local/jdk

[user@host]# cat /etc/profile.d/java.sh
# set java environment
export JAVA_HOME=/usr/local/jdk
export PATH=$PATH:$JAVA_HOME/bin
export CLASSPATH=$JAVA_HOME/lib

#更改shell文件属性:
#chmod 755 /etc/profile.d/java.sh

#查看是否正确
#which java
/usr/local/jdk/bin/java

安装apache :

#cd /usr/local/src/
#tar -xzvf httpd-2.0.47.tar.gz
#cd httpd-2.0.47
#配置apache 支持动态module 加载
#./configure
"--with-layout=Apache"
"--prefix=/usr/local/apache"
"--enable-module=so"
"--enable-module=setenvif"
"--enable-module=rewrite"
"--with-mpm=prefork"

#make
#make install

#修改http.conf 具体的修改请参考apache2.0文档
# 或者查看 http://www.cnfug.org/journal/3/02.html

StartServers 10
MinSpareServers 25
MaxSpareServers 50
ServerLimit 2000
MaxClients 1500 #Apache可以同时处理的请求
MaxRequestsPerChild 10000

安装Php :
下载: php-4.3.3.tar.gz
#cd /usr/local/src
#tar -xzvf

#php for apache 以apache modules的方式运行
./configure --with-apxs2=/usr/local/apache/bin/apxs

#php run like shell 以单独的shell方式运行
./configure --prefix=/usr/local/php

#php for apache
./configure
--with-apxs2=/usr/local/apache/bin/apxs
--enable-track-vars
--enable-debug
--enable-url-includes
--enable-sockets
--with-config-file-path=/usr/local/apache/conf #php.ini文件放的目录
#下面的参数是安装PHP + gd库
--with-gd=/usr/local
--enable-gd-native-ttf
--with-ttf=/usr/local
--with-jpeg-dir=/usr/local
--with-zlib-dir=/usr/local
--with-png-dir=/usr/local
#make
#make install
#ls -l /usr/local/apache/modules/libphp4.so #存在 安装成功

#修改apache http.conf
添加
LoadModule php4_module modules/libphp4.so
AddType application/x-httpd-php .php

安装Tomcat:
#cd /usr/local
#tar -xzvf jakarta-tomcat-4.1.24.tar.gz
#ln -s jakarta-tomcat-4.1.24 tomcat
#测试Tomcat正常安装:
#/usr/local/tomcat/bin/startup.sh

#通过IE http://yourIP:8080/ Tomcat的页面正常显示

安装JK2 :
#cd /usr/local/src
#tar -xzvf jakarta-tomcat-connectors-jk2-2.0.2-src.tar.gz
#cd jakarta-tomcat-connectors-jk2-2.0.2-src
#cd jk/native2
#chmod 755 buildconf.sh
#./configure --with-apxs2=/usr/local/apache/bin/apxs --enable-EAPI
#make
#make install
#如果make install 不成功需要手工发布mod_jk2.so
#cd /usr/local/src/jakarta-tomcat-connectors-jk2-2.0.2-src/jk/build/jk2/apache2
#cp *.so /usr/local/apache/modules/

配置$CATLINA/conf/server.xml

debug="0"/>
debug="0"/>

port="8080" minProcessors="5" maxProcessors="75"
enableLookups="true" redirectPort="8443"
acceptCount="100" debug="0" connectionTimeout="-1"
useURIValidationHack="false" disableUploadTimeout="true" />

port="8009" minProcessors="5" maxProcessors="75"
enableLookups="true" redirectPort="8443"
acceptCount="10" debug="0" connectionTimeout="-1"
useURIValidationHack="false"
protocolHandlerClassName="org.apache.jk.server.JkCoyoteHandler"/>

prefix="catalina_log." suffix=".txt"
timestamp="true"/>

unpackWARs="true" autoDeploy="true">

directory="logs" prefix="localhost_log." suffix=".txt"
timestamp="true"/>

#编辑
#vi /usr/local/tomcat/conf/jk2.properties
# list of needed handlers.
handler.list=channelSocket,request
# Override the default port for the channelSocket
channelSocket.port=8009

#编辑文件:

#vi /usr/local/apache/conf/workers2.properties

# only at beginnin. In production uncomment it out
[logger.apache2]
level=DEBUG

[shm]
file=/usr/local/apache/logs/shm.file
size=1048576

# Example socket channel, override port and host.
[channel.socket:localhost:8009]
port=8009
host=127.0.0.1

# define the worker
[ajp13:localhost:8009]
channel=channel.socket:localhost:8009

# Uri mapping
[uri:192.168.0.90/*.jsp]
worker=ajp13:localhost:8009

[uri:211.167.83.165/*.jsp]
worker=ajp13:localhost:8009

#编辑http.conf
#修改
DocumentRoot "/usr/local/tomcat/webapps"
#添加index.jsp
DirectoryIndex index.html index.html.var index.jsp

LoadModule jk2_module modules/mod_jk2.so

Order deny,allow
Deny from all

#
# Order deny,allow
# Deny from all
#

Order Allow,Deny

ServerName www.home.net
ServerAlias www
ServerAlias localhost
ServerAlias 192.168.0.90
ServerAlias 211.167.83.165
ServerAdmin webmater@5757.com
DocumentRoot /usr/local/tomcat/webapps

ErrorLog logs/home.net-errorlog
CustomLog logs/home.net-access.log common

JkUriSet worker ajp13:localhost:8009

在配置server.xml 的时候:
配置管理端口 和连接的端口顺序颠倒一下
在 catalina.out 可以观察到:
这样用apache 连接的时候,就不用等待了.

port="8009" minProcessors="5" maxProcessors="75"
enableLookups="true" redirectPort="8443"
acceptCount="10" debug="0" connectionTimeout="0"
useURIValidationHack="false"
protocolHandlerClassName="org.apache.jk.server.JkCoyoteHandler"/>

port="8080" minProcessors="5" maxProcessors="75"
enableLookups="true" redirectPort="8443"
acceptCount="100" debug="0" connectionTimeout="20000"
useURIValidationHack="false" disableUploadTimeout="true" />

#server.xml 不支持中文的注释
#对 shared/classes 目录下的java进行的修改不能立刻的反应到jsp中标.不能立即起作用.

以上的安装同样适合jakarta-tomcat-5.0.12 在以下的配置中注意

#在配置 jakarta-tomcat-5.0.12 的时候,注意 server.xml 中

没有封闭.

BUG:

在catalina.out 报错误.

总体上感觉tomcat 5.0 比4.x在性能上是有了改进.启动的速度快.

本文档提供关于Tomcat的基础信息.主要内容如下:
Tomcat二进制版本安装
与Tomcat相关的脚本的主要内容
与server.xml相关的主要内容,Tomcat的主要配置文件
如何设置Tomcat与宿主web服务器一起工作的说明
如何应用Tomcat配置一个现实中的web站点
希望此文档足以使新用户可以开始使用Tomcat.如找不到某方面的内容请(按以下顺序)
查找Tomcat faq
查找Tomcat包清单
向Tomcat用户邮件列表发出问题
如此疑问的答案不存在,我们鼓励把对疑问的解答放入Tomcat faq或此文档.如对此文档有意见或建议,请发送到Tomcat的邮件列表.

Getting Started
Tomcat是一个带有jsp环境的servlet容器.servlet容器是一个根据用户的行为可以管理和激活servlet的运行时的shell.
粗略地可以将servlet容器分为如下几类:

独立的servlet容器
内置有web服务器的一部分.指当使用基于Java的web服务器的情形,例如servlet容器是JavaWebServer的一个部分. 独立的servlet容器是Tomcat的默认模式.
大多数的web服务器并非基于Java,因此,我们可以得出如下两种容器的模式.

进程内的servlet容器
servlet容器作为web服务器的插件和Java容器的实现.Web服务器插件在内部地址空间打开一个JVM(java virtual machine)使Java容器得以在内部运行.如有某个需要调用servlet的请求,,插件将取得对此请求的控制并将他传递(使用JNI)给Java容器.进程内容器对于多线程,单进程的服务器非常合适并且提供很好的运行速度,但伸缩性有所不足.

进程外的servlet容器
servlet容器运行于web服务器之外的地址空间且作为web服务器的插件和Java容器的实现的结合.web服务器插件和Java容器 JVM使用IPC机制(通常是TCP/IP)进行通讯.当一个调用servlet的请求到达时,插件将取得对此请求的控制并将其传递(使用IPC等)给Java容器,进程外容器的反应时间或进程外容器引擎不如进程内容器,但进程外容器引擎在许多其他可比的范围内更好(伸缩性,稳定性等).
Tomcat既可作为独立的容器(主要是用于开发与调试)又可作为对现有服务器的附加(当前支持Apache,IIS和Netscape服务器).即任何时候配置Tomcat你都必须决定如何应用他,如选择第二或第三种模式,你还需要安装一个web服务器接口.
Tomcat与Jserv有何区别?Tomcat是Jserv吗?
这是个常见的误解.Jserv是Servlet API2.0兼容并与Apache一起使用的容器.Tomcat是一个完全重写的并与Servlet API2.2和JSP1.1兼容的容器.
Tomcat使用了一些为Jserv而写的代码,特别是Jserv的Apache接口,但这是唯一的相同之处.
怎样安装Tomcat的二进制版本?
非常简单,只需:
下载 zip/tar.gz 任何压缩文件,从http://jakarta.apche.org/download/binindex.html处.
解压缩此文件到某目录(如:foo).将会生成一子目录,名为”tomcat”.
转换到”tomcat”目录设置一新的环境变量(TOMCAT_HOME)指向你安装的tomcat的目录
WIN32平台,键入:
“set TOMCAT_HOME=foo\tomcat”
Unix平台:
如是bash/sh环境, 键入:”TOMCAT_HOME=foo/tomcat;export TOMCAT_HOME”
如是tcsh环境, 键入:”setenv TOMCAT_HOME foo/tomcat”
设置环境变量JAVA_HOME指向你JDK的目录,然后添加JAVA解释器到你的PATH环境变量.
好了!现在可以运行TOMCAT并作为一个独立的Servlet容器(模式一)
启动与关闭Tomcat
使用”bin”目录中的脚本启动与关闭Tomcat.
启动:
uinx:bin/startup.sh
win32:bin\startup
关闭:
unix:bin/shutdown.sh
win32:bin\shutdown
Tomcat目录结构
假设你已将Tomcat解压,你已得到下列目录结构:
目录名--描述
bin
包含启动/关闭脚本
conf
包含不同的配置文件,
包括 server.xml(Tomcat的主要配置文件)和为不同的Tomcat配置的web应用设置缺省值的文件web.xml
doc
包含各种Tomcat文档
lib
包含Tomcat使用的jar文件.unix平台此目录下的任何文件都被加到Tomcat的classpath中
logs
Tomcat摆放日志文件的地方
src
ServletAPI源文件.先别高兴,这些只有些必须在Servlet容器内实现的空接口和抽象类
webapps
包含web项目示例
此外你可以Tomcat会创建如下目录:
work
Tomcat自动生成,放置Tomcat运行时的临时文件(如编译后的JSP文件).如在Tomcat运行时删除此目录.JSP页面将不能运行.
classes
你可以创建此目录来添加一些附加的类到类路径中.任何你加到此目录中的类都可在Tomcat的类路径中找到自身.
Tomcat的脚本
Tomcat是一个Java程序,因此在设置好几个环境变量后即可用命令行的方式运行.然而设置Tomcat使用的每个环境变量和如下的命令行参数乏味且易错.因此,Tomcat开发组提供了一些脚本使启动和关闭Tomcat变得轻松.
注意:这些脚本仅仅是个便利的方法去启动和关闭Tomcat.你可修改他们来定制CLASSPATH,环境变量如PATH,LD_LIBRARY_PATH,等等,只要是生成一个正确的命令行即可.
这些脚本是什么呢?下表列出对一般用户最重要的脚本.
tomcat
主脚本.设置合适的环境变量,包括CLASSPATH,TOMCAT_HOME和JAVA_HOME和用适合的命令行参数启动Tomcat

startup

在后台启动Tomcat.”tomcat start”命令的替换方式

shutdown

关闭Tomcat.”tomcat stop”命令的替换方式

对用户最重要的脚本是tomcat(tomcat.bat/tomcat.sh).其他Tomcat相关的脚本作为一个简单的面向单任务的指向Tomcat脚本(设置不同的命令行参数等)的入口.

仔细考察tomcat.bat/tomcat.sh,它按以下步骤运行:

在Unix下的步骤：

如未指定,推测 TOMCAT_HOME

如未指定,推测 JAVA_HOME

设置CLASS_PATH包含:

1.${TOMCAT_HOME}/classes目录(如果存在)

2.${TOMCAT_HOME}/lib的一切内容

3.${JAVA_HOME}/lib/tools.jar(此jar文件包含工具javac,我们需要javac处理jsp文件.

运行带有设定Java环境变量的命令行参数的java命令,调入tomcat.home,和org.apache.tomcat.startup.Tomcat 作为启始类.同时也传递命令行参数到org.apache.tomcat.startup.Tomcat ,例如:

执行start/stop/run 等的操作

此Tomcat进程使用指向server.xml的路径,

例如server.xml放置于etc/server_1.xml并且用户意图在后台启动apache,键 入如下命令行:

bin/tomcat.sh start –f /etc/server_1.xml

在Win32下的步骤：(略)

由此可见,win32版的tomcat.bat与Unix版的几乎一致.尤其在它不推测TOMCAT_HOME和JAVA_HOME的值,并且不将所有的jar文件放入类路径中.

Tomcat的配置文件

Tomcat的配置基于两个配置文件:

1.server.xml - Tomcat的全局配置文件

2.web.xml - 在Tomcat中配置不同的关系环境

这一部分将讲述如何使用这些文件.我们不会包含web.xml的内部机制,这些内部机制深入到了Servlet API的细节,因此,我们将讨论涵盖servler.xml内容及web.xml在Tomcat关系环境中的用法.

server.xml

server.xml是Tomcat的主配置文件.完成两个目标:

1 提供Tomcat组件的初始配置.

2 说明Tomcat的结构,含义,使得Tomcat通过实例化组件完成起动及构建自身, 如在server.xml所指定的

下表描述server.xml种的重要元素:

元素及其描述

Server
server.xml文件中最重要的元素.Server定义了一个Tomcat服务器.一般你不用对他担心太多.Server元素能包含Logger和ContextManager元素类型

Logger
此元素定义一个Logger对象,每个Logger都有一个名字去标识,也有一个纪录Logger的输出和冗余级别(描述此日志级别)和包含日志文件的路径.通常有servlet的Logger(ServletContext.log()处),JSP和Tomcat运行时的Logger.

ContextManager
ContextManager说明一套ContextInterceptor, RequestInterceptor , Context和他们的Connectors的配置及结构.ContextManager有几个随同提供的特性:
1. 用来纪录调试信息的调试级别
2. webapps/,conf/,logs/和所有已定义的环境的基本位置.用来使Tomcat可以在TOMCAT_HOME外的其他目录启动.
3. 工作目录的名字

ContextInterceptor&RequestInterceptor
这些侦听器(interceptors)侦听具体发生在ContextManager中的事件.例如,ContextInterceptor侦听Tomcat的启动及终止事件,RequestInterceptor监视在它服务过程中用户请求需要通过的不同阶段.Tomcat的管理员不必知道太多关于侦听器的知识;另外,开发者应该知道这是如何在Tomcat中实现一个”全局”型的操作(例如安全性及每个请求日志)

Connector
Connector表示一个到用户的联接,不管是通过web服务器或直接到用户浏览器(在一个独立配置中).Connector负责管理Tomcat的工作线程和 读/写 连接到不同用户的端口的 请求/响应.Connector的配置包含如下信息:

1.句柄类

2.句柄监听的TCP/IP端口

3.句柄服务器端口的TCP/IP的backlog.

稍后我们将在此文档中描述如何配置Connector.

Context
每个Context提供一个指向你放置你Web项目的Tomcat的下属目录。每个Context包含如下配置：

1. Context放置的路径,可以是与ContextManager主目录相关的路径.

2.纪录调试信息的调试级别

3.可重载的标志.开发Servlet时,重载更改后的Servlet,这是一个非常便利的特性,你可以调试或用Tomcat测试新代码而不用停止或重新启动Tomcat.要打开重载,把reloadable设为真即可.这虽花费时间但可检测所发生的变化;更重要的事,鉴于,在一个装载类对象装入一个新的servlet时,类装载触发器可能会掷出一些错误.为避免这些问题,你可以设置可重载为假,这将停止重载功能.

从另一个目录中启动Tomcat

作为缺省值将使用TOMCAT_HOME/conf/server.xml作为配置文件.缺省配置将使用TOMCT_HOME作为关系环境的基础.

使用 “-f/你的/目录/server.xml”选项你可改变这种情况,使用另一个服务器配置文件和设置关系环境管理器的目录属性你需要在主目录内设置以下几个文件:

Ø 一个 webapps/目录(如果你已生成) – 所有war文件奖杯界压倒此目录而且所有子目录将作为关系环境添加.

Ø conf/目录 - 你可保存一个特殊的web.xml文件和其他配置文件

Ø logs/ - 所有日志文件将代替TOMCAT_HOME/logs/纪录到此目录中

Ø work/ - 关系环境的工作目录

如server.xml中的ContextManager.home属性有关联,将关联到到当前工作目录.

web。xml

关于web。xml和web项目结构（包括目录服务及配置）的详细描述可在Servlet API Spec的第9，10，14章中找到。

然而有一个与Tomcat有关的小“特性“与web.xml有关。Tomcat可以让用户通过将缺省的web.xml放入conf目录中来定义所有关系环境的web.xml的缺省值.建立一个新的关系环境时,Tomcat使用缺省的web.xml文件作为基本设置和应用项目特定的web.xml(放在应用项目的WEB-INF/web.xml文件)来覆盖这些缺省值.

设置Tomcat与Apache Web 服务器

服务器

到现在为止,我们未讨论作为服务器扩展的Tomcat,只讨论了作为独立运行的服务器.但有一些问题需要说明:

1. 当处理静态页面时,Tomcat不如Apache迅速.

2. Tomcat不象Apache一样可配置.

3. Tomcat不象Apache一样强壮.

4. 有很多网站已在某一特定web server上投入了很长时间,例如,使用CGI脚本/Server API模组/perl/php…我们不能假设这些遗留下来的东西都会被丢弃.

基于以上原因,一个现实的网站建议使用一个Web服务器,如Apache,为网站的静态页面请求提供服务,并使用Tomcat作为一个Servlet/JSP插件.

我们不准备深入的讨论每个不同的配置,我们将:

1. 涵盖Web服务器的基本行为

2. 解释需要何种配置

3. 在Apache上的实例

Web 服务器操作

简单说来，web服务器总是等待来自客户端的HTTP请求。当请求到达时，服务器会提供一切必要的内容来满足此请求。加入一个Servlet容器某种程度上会改变此行为。但服务器仍需处理如下因素：

载入servlet容器接口库并初始化（处理请求之前）。

当收到一个请求时，检查是否属于某Servlet，如是，则接口库接收此请求并处理。

另一方面，接口库需要知道他将服务某种请求，通常是基于请求的URL的某种模式和将此请求导向何处。

当用户想要设置使用虚拟主机的配置时，事情会变得更加复杂，或者想多个开发者在一个服务器上进行开发但使用不同的Servlet容器的JVMs。以下我们将讨论这两个问题。

必需进行的配置

应该考虑的是最明显的配置是servlet URL具有对servlet容器中的servlet具有表示的责任。很明显，你必须知道传递什么到Servlet容器。我们仍需提供附加的配置项目到web-server或servlet-container的结合体中.

l 考虑到Tomcat进程是否可取得，我们仍需提供配置和Tomcat正在监听的TCP/IP 主机名/端口号。

l 需要告知web服务器接口库的位置（因此我们可以在起始时装入）

l 需要设置接口内部信息如将日志记录在何处和如何纪录，等等。

所有此类信息必须出现在web服务器配置里或被接口使用的私有配置文件中。下面将讲述如何在Apache中如何实现这些配置。

Apache上的实现

这一部分演示如何配置Apache与Tomcat一起工作；并试图解释深入到可能会用到的配置规范。在jserv 安装页上可找到其他信息。

本文档提供关于Tomcat的基础信息.主要内容如下:
Tomcat二进制版本安装
与Tomcat相关的脚本的主要内容
与server.xml相关的主要内容,Tomcat的主要配置文件
如何设置Tomcat与宿主web服务器一起工作的说明
如何应用Tomcat配置一个现实中的web站点
希望此文档足以使新用户可以开始使用Tomcat.如找不到某方面的内容请(按以下顺序)
查找Tomcat faq
查找Tomcat包清单
向Tomcat用户邮件列表发出问题
如此疑问的答案不存在,我们鼓励把对疑问的解答放入Tomcat faq或此文档.如对此文档有意见或建议,请发送到Tomcat的邮件列表.

Getting Started
Tomcat是一个带有jsp环境的servlet容器.servlet容器是一个根据用户的行为可以管理和激活servlet的运行时的shell.
粗略地可以将servlet容器分为如下几类:

独立的servlet容器
内置有web服务器的一部分.指当使用基于Java的web服务器的情形,例如servlet容器是JavaWebServer的一个部分. 独立的servlet容器是Tomcat的默认模式.
大多数的web服务器并非基于Java,因此,我们可以得出如下两种容器的模式.

进程内的servlet容器
servlet容器作为web服务器的插件和Java容器的实现.Web服务器插件在内部地址空间打开一个JVM(java virtual machine)使Java容器得以在内部运行.如有某个需要调用servlet的请求,,插件将取得对此请求的控制并将他传递(使用JNI)给Java容器.进程内容器对于多线程,单进程的服务器非常合适并且提供很好的运行速度,但伸缩性有所不足.

进程外的servlet容器
servlet容器运行于web服务器之外的地址空间且作为web服务器的插件和Java容器的实现的结合.web服务器插件和Java容器 JVM使用IPC机制(通常是TCP/IP)进行通讯.当一个调用servlet的请求到达时,插件将取得对此请求的控制并将其传递(使用IPC等)给Java容器,进程外容器的反应时间或进程外容器引擎不如进程内容器,但进程外容器引擎在许多其他可比的范围内更好(伸缩性,稳定性等).
Tomcat既可作为独立的容器(主要是用于开发与调试)又可作为对现有服务器的附加(当前支持Apache,IIS和Netscape服务器).即任何时候配置Tomcat你都必须决定如何应用他,如选择第二或第三种模式,你还需要安装一个web服务器接口.
Tomcat与Jserv有何区别?Tomcat是Jserv吗?
这是个常见的误解.Jserv是Servlet API2.0兼容并与Apache一起使用的容器.Tomcat是一个完全重写的并与Servlet API2.2和JSP1.1兼容的容器.
Tomcat使用了一些为Jserv而写的代码,特别是Jserv的Apache接口,但这是唯一的相同之处.
怎样安装Tomcat的二进制版本?
非常简单,只需:
下载 zip/tar.gz 任何压缩文件,从http://jakarta.apche.org/download/binindex.html处.
解压缩此文件到某目录(如:foo).将会生成一子目录,名为”tomcat”.
转换到”tomcat”目录设置一新的环境变量(TOMCAT_HOME)指向你安装的tomcat的目录
WIN32平台,键入:
“set TOMCAT_HOME=foo\tomcat”
Unix平台:
如是bash/sh环境, 键入:”TOMCAT_HOME=foo/tomcat;export TOMCAT_HOME”
如是tcsh环境, 键入:”setenv TOMCAT_HOME foo/tomcat”
设置环境变量JAVA_HOME指向你JDK的目录,然后添加JAVA解释器到你的PATH环境变量.
好了!现在可以运行TOMCAT并作为一个独立的Servlet容器(模式一)
启动与关闭Tomcat
使用”bin”目录中的脚本启动与关闭Tomcat.
启动:
uinx:bin/startup.sh
win32:bin\startup
关闭:
unix:bin/shutdown.sh
win32:bin\shutdown
Tomcat目录结构
假设你已将Tomcat解压,你已得到下列目录结构:
目录名--描述
bin
包含启动/关闭脚本
conf
包含不同的配置文件,
包括 server.xml(Tomcat的主要配置文件)和为不同的Tomcat配置的web应用设置缺省值的文件web.xml
doc
包含各种Tomcat文档
lib
包含Tomcat使用的jar文件.unix平台此目录下的任何文件都被加到Tomcat的classpath中
logs
Tomcat摆放日志文件的地方
src
ServletAPI源文件.先别高兴,这些只有些必须在Servlet容器内实现的空接口和抽象类
webapps
包含web项目示例
此外你可以Tomcat会创建如下目录:
work
Tomcat自动生成,放置Tomcat运行时的临时文件(如编译后的JSP文件).如在Tomcat运行时删除此目录.JSP页面将不能运行.
classes
你可以创建此目录来添加一些附加的类到类路径中.任何你加到此目录中的类都可在Tomcat的类路径中找到自身.
Tomcat的脚本
Tomcat是一个Java程序,因此在设置好几个环境变量后即可用命令行的方式运行.然而设置Tomcat使用的每个环境变量和如下的命令行参数乏味且易错.因此,Tomcat开发组提供了一些脚本使启动和关闭Tomcat变得轻松.
注意:这些脚本仅仅是个便利的方法去启动和关闭Tomcat.你可修改他们来定制CLASSPATH,环境变量如PATH,LD_LIBRARY_PATH,等等,只要是生成一个正确的命令行即可.
这些脚本是什么呢?下表列出对一般用户最重要的脚本.
tomcat
主脚本.设置合适的环境变量,包括CLASSPATH,TOMCAT_HOME和JAVA_HOME和用适合的命令行参数启动Tomcat

startup

在后台启动Tomcat.”tomcat start”命令的替换方式

shutdown

关闭Tomcat.”tomcat stop”命令的替换方式

对用户最重要的脚本是tomcat(tomcat.bat/tomcat.sh).其他Tomcat相关的脚本作为一个简单的面向单任务的指向Tomcat脚本(设置不同的命令行参数等)的入口.

仔细考察tomcat.bat/tomcat.sh,它按以下步骤运行:

在Unix下的步骤：

如未指定,推测 TOMCAT_HOME

如未指定,推测 JAVA_HOME

设置CLASS_PATH包含:

1.${TOMCAT_HOME}/classes目录(如果存在)

2.${TOMCAT_HOME}/lib的一切内容

3.${JAVA_HOME}/lib/tools.jar(此jar文件包含工具javac,我们需要javac处理jsp文件.

运行带有设定Java环境变量的命令行参数的java命令,调入tomcat.home,和org.apache.tomcat.startup.Tomcat 作为启始类.同时也传递命令行参数到org.apache.tomcat.startup.Tomcat ,例如:

执行start/stop/run 等的操作

此Tomcat进程使用指向server.xml的路径,

例如server.xml放置于etc/server_1.xml并且用户意图在后台启动apache,键 入如下命令行:

bin/tomcat.sh start –f /etc/server_1.xml

在Win32下的步骤：(略)

由此可见,win32版的tomcat.bat与Unix版的几乎一致.尤其在它不推测TOMCAT_HOME和JAVA_HOME的值,并且不将所有的jar文件放入类路径中.

Tomcat的配置文件

Tomcat的配置基于两个配置文件:

1.server.xml - Tomcat的全局配置文件

2.web.xml - 在Tomcat中配置不同的关系环境

这一部分将讲述如何使用这些文件.我们不会包含web.xml的内部机制,这些内部机制深入到了Servlet API的细节,因此,我们将讨论涵盖servler.xml内容及web.xml在Tomcat关系环境中的用法.

server.xml

server.xml是Tomcat的主配置文件.完成两个目标:

1 提供Tomcat组件的初始配置.

2 说明Tomcat的结构,含义,使得Tomcat通过实例化组件完成起动及构建自身, 如在server.xml所指定的

下表描述server.xml种的重要元素:

元素及其描述

Server
server.xml文件中最重要的元素.Server定义了一个Tomcat服务器.一般你不用对他担心太多.Server元素能包含Logger和ContextManager元素类型

Logger
此元素定义一个Logger对象,每个Logger都有一个名字去标识,也有一个纪录Logger的输出和冗余级别(描述此日志级别)和包含日志文件的路径.通常有servlet的Logger(ServletContext.log()处),JSP和Tomcat运行时的Logger.

ContextManager
ContextManager说明一套ContextInterceptor, RequestInterceptor , Context和他们的Connectors的配置及结构.ContextManager有几个随同提供的特性:
1. 用来纪录调试信息的调试级别
2. webapps/,conf/,logs/和所有已定义的环境的基本位置.用来使Tomcat可以在TOMCAT_HOME外的其他目录启动.
3. 工作目录的名字

ContextInterceptor&RequestInterceptor
这些侦听器(interceptors)侦听具体发生在ContextManager中的事件.例如,ContextInterceptor侦听Tomcat的启动及终止事件,RequestInterceptor监视在它服务过程中用户请求需要通过的不同阶段.Tomcat的管理员不必知道太多关于侦听器的知识;另外,开发者应该知道这是如何在Tomcat中实现一个”全局”型的操作(例如安全性及每个请求日志)

Connector
Connector表示一个到用户的联接,不管是通过web服务器或直接到用户浏览器(在一个独立配置中).Connector负责管理Tomcat的工作线程和 读/写 连接到不同用户的端口的 请求/响应.Connector的配置包含如下信息:

1.句柄类

2.句柄监听的TCP/IP端口

3.句柄服务器端口的TCP/IP的backlog.

稍后我们将在此文档中描述如何配置Connector.

Context
每个Context提供一个指向你放置你Web项目的Tomcat的下属目录。每个Context包含如下配置：

1. Context放置的路径,可以是与ContextManager主目录相关的路径.

2.纪录调试信息的调试级别

3.可重载的标志.开发Servlet时,重载更改后的Servlet,这是一个非常便利的特性,你可以调试或用Tomcat测试新代码而不用停止或重新启动Tomcat.要打开重载,把reloadable设为真即可.这虽花费时间但可检测所发生的变化;更重要的事,鉴于,在一个装载类对象装入一个新的servlet时,类装载触发器可能会掷出一些错误.为避免这些问题,你可以设置可重载为假,这将停止重载功能.

从另一个目录中启动Tomcat

作为缺省值将使用TOMCAT_HOME/conf/server.xml作为配置文件.缺省配置将使用TOMCT_HOME作为关系环境的基础.

使用 “-f/你的/目录/server.xml”选项你可改变这种情况,使用另一个服务器配置文件和设置关系环境管理器的目录属性你需要在主目录内设置以下几个文件:

Ø 一个 webapps/目录(如果你已生成) – 所有war文件奖杯界压倒此目录而且所有子目录将作为关系环境添加.

Ø conf/目录 - 你可保存一个特殊的web.xml文件和其他配置文件

Ø logs/ - 所有日志文件将代替TOMCAT_HOME/logs/纪录到此目录中

Ø work/ - 关系环境的工作目录

如server.xml中的ContextManager.home属性有关联,将关联到到当前工作目录.

web。xml

关于web。xml和web项目结构（包括目录服务及配置）的详细描述可在Servlet API Spec的第9，10，14章中找到。

然而有一个与Tomcat有关的小“特性“与web.xml有关。Tomcat可以让用户通过将缺省的web.xml放入conf目录中来定义所有关系环境的web.xml的缺省值.建立一个新的关系环境时,Tomcat使用缺省的web.xml文件作为基本设置和应用项目特定的web.xml(放在应用项目的WEB-INF/web.xml文件)来覆盖这些缺省值.

设置Tomcat与Apache Web 服务器

服务器

到现在为止,我们未讨论作为服务器扩展的Tomcat,只讨论了作为独立运行的服务器.但有一些问题需要说明:

1. 当处理静态页面时,Tomcat不如Apache迅速.

2. Tomcat不象Apache一样可配置.

3. Tomcat不象Apache一样强壮.

4. 有很多网站已在某一特定web server上投入了很长时间,例如,使用CGI脚本/Server API模组/perl/php…我们不能假设这些遗留下来的东西都会被丢弃.

基于以上原因,一个现实的网站建议使用一个Web服务器,如Apache,为网站的静态页面请求提供服务,并使用Tomcat作为一个Servlet/JSP插件.

我们不准备深入的讨论每个不同的配置,我们将:

1. 涵盖Web服务器的基本行为

2. 解释需要何种配置

3. 在Apache上的实例

Web 服务器操作

简单说来，web服务器总是等待来自客户端的HTTP请求。当请求到达时，服务器会提供一切必要的内容来满足此请求。加入一个Servlet容器某种程度上会改变此行为。但服务器仍需处理如下因素：

载入servlet容器接口库并初始化（处理请求之前）。

当收到一个请求时，检查是否属于某Servlet，如是，则接口库接收此请求并处理。

另一方面，接口库需要知道他将服务某种请求，通常是基于请求的URL的某种模式和将此请求导向何处。

当用户想要设置使用虚拟主机的配置时，事情会变得更加复杂，或者想多个开发者在一个服务器上进行开发但使用不同的Servlet容器的JVMs。以下我们将讨论这两个问题。

必需进行的配置

应该考虑的是最明显的配置是servlet URL具有对servlet容器中的servlet具有表示的责任。很明显，你必须知道传递什么到Servlet容器。我们仍需提供附加的配置项目到web-server或servlet-container的结合体中.

l 考虑到Tomcat进程是否可取得，我们仍需提供配置和Tomcat正在监听的TCP/IP 主机名/端口号。

l 需要告知web服务器接口库的位置（因此我们可以在起始时装入）

l 需要设置接口内部信息如将日志记录在何处和如何纪录，等等。

所有此类信息必须出现在web服务器配置里或被接口使用的私有配置文件中。下面将讲述如何在Apache中如何实现这些配置。

Apache上的实现

这一部分演示如何配置Apache与Tomcat一起工作；并试图解释深入到可能会用到的配置规范。在jserv 安装页上可找到其他信息。

Tomcat Server在启动的时候将构造一个ClassLoader树，以保证模块的类库是私有的
Tomcat Server的ClassLoader结构如下：

        +-----------------------------+
        |         Bootstrap           |
        |             |               |
        |          System             |
        |             |               |
        |          Common             |
        |         /      \            |
        |     Catalina  Shared        |
        |               /    \        |
        |          WebApp1  WebApp2   |
        +-----------------------------+

2 - ClassLoader的工作原理

每个运行中的线程都有一个成员contextClassLoader，用来在运行时动态地载入其它类
系统默认的contextClassLoader是systemClassLoader，所以一般而言java程序在执行时可以使用JVM自带的类、$JAVA_HOME/jre/lib/ext/中的类和$CLASSPATH/中的类
可以使用Thread.currentThread().setContextClassLoader(...);更改当前线程的contextClassLoader，来改变其载入类的行为

ClassLoader被组织成树形，一般的工作原理是：
1) 线程需要用到某个类，于是contextClassLoader被请求来载入该类
2) contextClassLoader请求它的父ClassLoader来完成该载入请求
3) 如果父ClassLoader无法载入类，则contextClassLoader试图自己来载入

注意：WebApp?ClassLoader的工作原理和上述有少许不同：
它先试图自己载入类（在ContextBase?/WEB-INF/...中载入类），如果无法载入，再请求父ClassLoader完成

由此可得：
- 对于WEB APP线程，它的contextClassLoader是WebApp?ClassLoader
- 对于Tomcat Server线程，它的contextClassLoader是CatalinaClassLoader

3 - 部分原代码分析

Tomcat Server线程的起点
构造ClassLoader树，并设置Tomcat Server线程的contextClassLoader为catalinaloader
载入若干类，然后转入org.apache.catalina.startup.Catalina类中

[查看代码]

根据设置创建并返回StandardClassLoader的实例

[查看代码]

类载入器

该类仅包含一个静态方法，用来为catalinaLoader载入一些类

[查看代码]

Appendix - 参考

[1] http://jakarta.apache.org/tomcat/中的Tomcat 4.1.x文档Class Loader HOW-TO

Tomcat Server在启动的时候将构造一个ClassLoader树，以保证模块的类库是私有的
Tomcat Server的ClassLoader结构如下：

        +-----------------------------+
        |         Bootstrap           |
        |             |               |
        |          System             |
        |             |               |
        |          Common             |
        |         /      \            |
        |     Catalina  Shared        |
        |               /    \        |
        |          WebApp1  WebApp2   |
        +-----------------------------+

2 - ClassLoader的工作原理

每个运行中的线程都有一个成员contextClassLoader，用来在运行时动态地载入其它类
系统默认的contextClassLoader是systemClassLoader，所以一般而言java程序在执行时可以使用JVM自带的类、$JAVA_HOME/jre/lib/ext/中的类和$CLASSPATH/中的类
可以使用Thread.currentThread().setContextClassLoader(...);更改当前线程的contextClassLoader，来改变其载入类的行为

ClassLoader被组织成树形，一般的工作原理是：
1) 线程需要用到某个类，于是contextClassLoader被请求来载入该类
2) contextClassLoader请求它的父ClassLoader来完成该载入请求
3) 如果父ClassLoader无法载入类，则contextClassLoader试图自己来载入

注意：WebApp?ClassLoader的工作原理和上述有少许不同：
它先试图自己载入类（在ContextBase?/WEB-INF/...中载入类），如果无法载入，再请求父ClassLoader完成

由此可得：
- 对于WEB APP线程，它的contextClassLoader是WebApp?ClassLoader
- 对于Tomcat Server线程，它的contextClassLoader是CatalinaClassLoader

3 - 部分原代码分析

Tomcat Server线程的起点
构造ClassLoader树，并设置Tomcat Server线程的contextClassLoader为catalinaloader
载入若干类，然后转入org.apache.catalina.startup.Catalina类中

[查看代码]

根据设置创建并返回StandardClassLoader的实例

[查看代码]

类载入器

该类仅包含一个静态方法，用来为catalinaLoader载入一些类

[查看代码]

Appendix - 参考

[1] http://jakarta.apache.org/tomcat/中的Tomcat 4.1.x文档Class Loader HOW-TO

脚本catalina.sh用于启动和关闭tomcat服务器，是最关键的脚本
另外的脚本startup.sh和shutdown.sh都是使用不同的参数调用了该脚本
该脚本的使用方法如下（引自该脚本本身）：

  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"

2 - 脚本分析

#!/bin/sh


# =============================================================
# 该脚本设置正确的环境变量和系统信息，然后启动或者停止tomcat server
# 具体的操作是：
# 使用命令行参数作为args的实参，调用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=false
case "`uname`" in
CYGWIN*) cygwin=true;;
esac


# PRG是被执行的脚本的名称，可以认为PRG=="catalina.sh"，也可能是某个符号链，指向该脚本。

PRG="$0"


# 处理了一下PRG，等循环跳出之后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"
  fi
done



# PRGDIR是PRG的目录路径名称

PRGDIR=`dirname "$PRG"`


# 执行$CATALINA_HOME/BIN/setenv.sh来设置环境变量
# [ -r filename ] 是判断是否文件存在且可读

CATALINA_HOME=`cd "$PRGDIR/.." ; pwd`
if [ -r "$CATALINA_HOME"/bin/setenv.sh ]; then
  . "$CATALINA_HOME"/bin/setenv.sh
fi



# 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


# 设置用来初始化SystemClassLoader的CLASSPATH变量：通过执行脚本setclasspath.sh完成
# 注意：脚本setclasspath.sh改变了原来的$CLASSPATH变量，而把它设为：
# 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 class

if [ -r "$CATALINA_HOME"/bin/setclasspath.sh ]; then
  BASEDIR="$CATALINA_HOME"
  . "$CATALINA_HOME"/bin/setclasspath.sh
else
  echo "Cannot find $CATALINA_HOME/bin/setclasspath.sh"
  echo "This file is needed to run this program"
  exit 1
fi


# 在CLASSPATH环境变量后面补上一些JAR文件
# [ -n string ] 判断字符串是否长度非0；[ -z string ] 判断字符串是否长度为0
# 它们可以用来判断是否某个环境变量已经被设置

if [ -n "$JSSE_HOME" ]; then
  CLASSPATH="$CLASSPATH":"$JSSE_HOME"/lib/jcert.jar:"$JSSE_HOME"/lib/jnet.jar:"$JSSE_HOME"/lib/jsse.jar
fi
CLASSPATH="$CLASSPATH":"$CATALINA_HOME"/bin/bootstrap.jar



# 指定CATALINA_BASE变量
# 如果CATALINA_BASE没有值，就让CATALINA_BASE=$CATALINA_HOME


if [ -z "$CATALINA_BASE" ] ; then
  CATALINA_BASE="$CATALINA_HOME"
fi



# 指定CATALINA_TMPDIR变量
# 如果CATALINA_TMPDIR没有值，就让CATALINA_TMPDIR=$CATALINA_BASE/temp

if [ -z "$CATALINA_TMPDIR" ] ; then
  # Define the java.io.tmpdir to use for Catalina
  CATALINA_TMPDIR="$CATALINA_BASE"/temp
fi


# For Cygwin, 在执行java程序前把路径名转换成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



# 显示信息，然后执行命令
echo "Using CATALINA_BASE:   $CATALINA_BASE"
echo "Using CATALINA_HOME:   $CATALINA_HOME"
echo "Using CATALINA_TMPDIR: $CATALINA_TMPDIR"
echo "Using JAVA_HOME:       $JAVA_HOME"



# ......当执行catalina.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"
  shift
fi



# ......当执行catalina.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



# ......当执行catalina.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 "$@"



# +----------------------------------------------------+
# |  ......当执行catalina.sh的参数是run的时候......    |
# |  在当前窗口中启动tomcat服务器！！！                |
# +----------------------------------------------------+

elif [ "$1" = "run" ]; then

  # 把参数run去掉

  shift
  

  # 如果参数是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
      

  # 如果参数是孤单的run，则在本窗口中启动tomcat服务器
  # 在本窗口中启动的方法是使用exec，让当前进程fork一个新进程来启动tomcat，当前进程是tomcat的父进程
  # 启动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


# +----------------------------------------------------+
# |  ......当执行catalina.sh的参数是start的时候......  |
# |  在新窗口中启动tomcat服务器！！！                  |
# +----------------------------------------------------+

elif [ "$1" = "start" ] ; then

  # 把参数start去掉

  shift
  
  # 创建一个文件（如果文件不存在的话）$CATALINA_BASE/logs/catalina.out  

  touch "$CATALINA_BASE"/logs/catalina.out

  # 如果参数是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
      

  # 如果参数是孤单的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


# +----------------------------------------------------+
# |  ......当执行catalina.sh的参数是stop的时候......   |
# |  关闭tomcat服务器！！！                            |
# +----------------------------------------------------+

elif [ "$1" = "stop" ] ; then

  # 把参数stop去掉

  shift
  

  # 关闭tomcat服务器的类是org.apache.catalina.startup.Bootstrap->main("stop");
  # 注意：java -D 是设置系统属性
  
  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



# +----------------------------------------------------+
# |  ......当执行catalina.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 1

fi

脚本catalina.sh用于启动和关闭tomcat服务器，是最关键的脚本
另外的脚本startup.sh和shutdown.sh都是使用不同的参数调用了该脚本
该脚本的使用方法如下（引自该脚本本身）：

  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"

2 - 脚本分析

#!/bin/sh


# =============================================================
# 该脚本设置正确的环境变量和系统信息，然后启动或者停止tomcat server
# 具体的操作是：
# 使用命令行参数作为args的实参，调用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=false
case "`uname`" in
CYGWIN*) cygwin=true;;
esac


# PRG是被执行的脚本的名称，可以认为PRG=="catalina.sh"，也可能是某个符号链，指向该脚本。

PRG="$0"


# 处理了一下PRG，等循环跳出之后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"
  fi
done



# PRGDIR是PRG的目录路径名称

PRGDIR=`dirname "$PRG"`


# 执行$CATALINA_HOME/BIN/setenv.sh来设置环境变量
# [ -r filename ] 是判断是否文件存在且可读

CATALINA_HOME=`cd "$PRGDIR/.." ; pwd`
if [ -r "$CATALINA_HOME"/bin/setenv.sh ]; then
  . "$CATALINA_HOME"/bin/setenv.sh
fi



# 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


# 设置用来初始化SystemClassLoader的CLASSPATH变量：通过执行脚本setclasspath.sh完成
# 注意：脚本setclasspath.sh改变了原来的$CLASSPATH变量，而把它设为：
# 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 class

if [ -r "$CATALINA_HOME"/bin/setclasspath.sh ]; then
  BASEDIR="$CATALINA_HOME"
  . "$CATALINA_HOME"/bin/setclasspath.sh
else
  echo "Cannot find $CATALINA_HOME/bin/setclasspath.sh"
  echo "This file is needed to run this program"
  exit 1
fi


# 在CLASSPATH环境变量后面补上一些JAR文件
# [ -n string ] 判断字符串是否长度非0；[ -z string ] 判断字符串是否长度为0
# 它们可以用来判断是否某个环境变量已经被设置

if [ -n "$JSSE_HOME" ]; then
  CLASSPATH="$CLASSPATH":"$JSSE_HOME"/lib/jcert.jar:"$JSSE_HOME"/lib/jnet.jar:"$JSSE_HOME"/lib/jsse.jar
fi
CLASSPATH="$CLASSPATH":"$CATALINA_HOME"/bin/bootstrap.jar



# 指定CATALINA_BASE变量
# 如果CATALINA_BASE没有值，就让CATALINA_BASE=$CATALINA_HOME


if [ -z "$CATALINA_BASE" ] ; then
  CATALINA_BASE="$CATALINA_HOME"
fi



# 指定CATALINA_TMPDIR变量
# 如果CATALINA_TMPDIR没有值，就让CATALINA_TMPDIR=$CATALINA_BASE/temp

if [ -z "$CATALINA_TMPDIR" ] ; then
  # Define the java.io.tmpdir to use for Catalina
  CATALINA_TMPDIR="$CATALINA_BASE"/temp
fi


# For Cygwin, 在执行java程序前把路径名转换成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



# 显示信息，然后执行命令
echo "Using CATALINA_BASE:   $CATALINA_BASE"
echo "Using CATALINA_HOME:   $CATALINA_HOME"
echo "Using CATALINA_TMPDIR: $CATALINA_TMPDIR"
echo "Using JAVA_HOME:       $JAVA_HOME"



# ......当执行catalina.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"
  shift
fi



# ......当执行catalina.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



# ......当执行catalina.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 "$@"



# +----------------------------------------------------+
# |  ......当执行catalina.sh的参数是run的时候......    |
# |  在当前窗口中启动tomcat服务器！！！                |
# +----------------------------------------------------+

elif [ "$1" = "run" ]; then

  # 把参数run去掉

  shift
  

  # 如果参数是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
      

  # 如果参数是孤单的run，则在本窗口中启动tomcat服务器
  # 在本窗口中启动的方法是使用exec，让当前进程fork一个新进程来启动tomcat，当前进程是tomcat的父进程
  # 启动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


# +----------------------------------------------------+
# |  ......当执行catalina.sh的参数是start的时候......  |
# |  在新窗口中启动tomcat服务器！！！                  |
# +----------------------------------------------------+

elif [ "$1" = "start" ] ; then

  # 把参数start去掉

  shift
  
  # 创建一个文件（如果文件不存在的话）$CATALINA_BASE/logs/catalina.out  

  touch "$CATALINA_BASE"/logs/catalina.out

  # 如果参数是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
      

  # 如果参数是孤单的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


# +----------------------------------------------------+
# |  ......当执行catalina.sh的参数是stop的时候......   |
# |  关闭tomcat服务器！！！                            |
# +----------------------------------------------------+

elif [ "$1" = "stop" ] ; then

  # 把参数stop去掉

  shift
  

  # 关闭tomcat服务器的类是org.apache.catalina.startup.Bootstrap->main("stop");
  # 注意：java -D 是设置系统属性
  
  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



# +----------------------------------------------------+
# |  ......当执行catalina.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 1

fi

1.1 - Server

A Server element represents the entire Catalina servlet container. (Singleton)

1.2 - Service

A Service element represents the combination of one or more Connector components that share a single Engine
Service是这样一个集合：它由一个或者多个Connector组成，以及一个Engine，负责处理所有Connector所获得的客户请求

1.3 - Connector

一个Connector将在某个指定端口上侦听客户请求，并将获得的请求交给Engine来处理，从Engine处获得回应并返回客户
TOMCAT有两个典型的Connector，一个直接侦听来自browser的http请求，一个侦听来自其它WebServer的请求
Coyote Http/1.1 Connector 在端口8080处侦听来自客户browser的http请求
Coyote JK2 Connector 在端口8009处侦听来自其它WebServer(Apache)的servlet/jsp代理请求

1.4 - Engine

The Engine element represents the entire request processing machinery associated with a particular Service
It receives and processes all requests from one or more Connectors
and returns the completed response to the Connector for ultimate transmission back to the client
Engine下可以配置多个虚拟主机Virtual Host，每个虚拟主机都有一个域名
当Engine获得一个请求时，它把该请求匹配到某个Host上，然后把该请求交给该Host来处理
Engine有一个默认虚拟主机，当请求无法匹配到任何一个Host上的时候，将交给该默认Host来处理

1.5 - Host

代表一个Virtual Host，虚拟主机，每个虚拟主机和某个网络域名Domain Name相匹配
每个虚拟主机下都可以部署(deploy)一个或者多个Web App，每个Web App对应于一个Context，有一个Context path
当Host获得一个请求时，将把该请求匹配到某个Context上，然后把该请求交给该Context来处理
匹配的方法是“最长匹配”，所以一个path==""的Context将成为该Host的默认Context
所有无法和其它Context的路径名匹配的请求都将最终和该默认Context匹配

1.6 - Context

一个Context对应于一个Web Application，一个Web Application由一个或者多个Servlet组成
Context在创建的时候将根据配置文件$CATALINA_HOME/conf/web.xml和$WEBAPP_HOME/WEB-INF/web.xml载入Servlet类
当Context获得请求时，将在自己的映射表(mapping table)中寻找相匹配的Servlet类
如果找到，则执行该类，获得请求的回应，并返回

2 - Tomcat Server的结构图

3 - 配置文件$CATALINA_HOME/conf/server.xml的说明

该文件描述了如何启动Tomcat Server

  

  
  


  

  
    ... ... ... ...
  


  

  


    

    


    

    
    

      

      

      

      


      

      
      

        

        
      

        

        
        

        

        
             
        
      
      
    

  

4 - Context的部署配置文件web.xml的说明

一个Context对应于一个Web App，每个Web App是由一个或者多个servlet组成的
当一个Web App被初始化的时候，它将用自己的ClassLoader对象载入“部署配置文件web.xml”中定义的每个servlet类
它首先载入在$CATALINA_HOME/conf/web.xml中部署的servlet类
然后载入在自己的Web App根目录下的WEB-INF/web.xml中部署的servlet类
web.xml文件有两部分：servlet类定义和servlet映射定义
每个被载入的servlet类都有一个名字，且被填入该Context的映射表(mapping table)中，和某种URL PATTERN对应
当该Context获得请求时，将查询mapping table，找到被请求的servlet，并执行以获得请求回应

分析一下所有的Context共享的web.xml文件，在其中定义的servlet被所有的Web App载入

  



  
  
  

  

  

    
        default
        
          org.apache.catalina.servlets.DefaultServlet
        
        
            debug
            0
        
        
            listings
            true
        
        1
    


  

    
        invoker
        
          org.apache.catalina.servlets.InvokerServlet
        
        
            debug
            0
        
        2
    


  

    
        jsp
        org.apache.jasper.servlet.JspServlet
        
            logVerbosityLevel
            WARNING
        
        3
    



  
  
  

    
    
        default
        /
    

    
        invoker
        /servlet/*
    

    
        jsp
        *.jsp
    


  
  
  

    ... ... ... ...

5 - Tomcat Server处理一个http请求的过程

假设来自客户的请求为：
http://localhost:8080/wsota/wsota_index.jsp

1) 请求被发送到本机端口8080，被在那里侦听的Coyote HTTP/1.1 Connector获得
2) Connector把该请求交给它所在的Service的Engine来处理，并等待来自Engine的回应
3) Engine获得请求localhost/wsota/wsota_index.jsp，匹配它所拥有的所有虚拟主机Host
4) Engine匹配到名为localhost的Host（即使匹配不到也把请求交给该Host处理，因为该Host被定义为该Engine的默认主机）
5) localhost Host获得请求/wsota/wsota_index.jsp，匹配它所拥有的所有Context
6) Host匹配到路径为/wsota的Context（如果匹配不到就把该请求交给路径名为""的Context去处理）
7) path="/wsota"的Context获得请求/wsota_index.jsp，在它的mapping table中寻找对应的servlet
8) Context匹配到URL PATTERN为*.jsp的servlet，对应于JspServlet类
9) 构造HttpServletRequest对象和HttpServletResponse对象，作为参数调用JspServlet的doGet或doPost方法
10)Context把执行完了之后的HttpServletResponse对象返回给Host
11)Host把HttpServletResponse对象返回给Engine
12)Engine把HttpServletResponse对象返回给Connector
13)Connector把HttpServletResponse对象返回给客户browser

1.1 - Server

A Server element represents the entire Catalina servlet container. (Singleton)

1.2 - Service

A Service element represents the combination of one or more Connector components that share a single Engine
Service是这样一个集合：它由一个或者多个Connector组成，以及一个Engine，负责处理所有Connector所获得的客户请求

1.3 - Connector

一个Connector将在某个指定端口上侦听客户请求，并将获得的请求交给Engine来处理，从Engine处获得回应并返回客户
TOMCAT有两个典型的Connector，一个直接侦听来自browser的http请求，一个侦听来自其它WebServer的请求
Coyote Http/1.1 Connector 在端口8080处侦听来自客户browser的http请求
Coyote JK2 Connector 在端口8009处侦听来自其它WebServer(Apache)的servlet/jsp代理请求

1.4 - Engine

The Engine element represents the entire request processing machinery associated with a particular Service
It receives and processes all requests from one or more Connectors
and returns the completed response to the Connector for ultimate transmission back to the client
Engine下可以配置多个虚拟主机Virtual Host，每个虚拟主机都有一个域名
当Engine获得一个请求时，它把该请求匹配到某个Host上，然后把该请求交给该Host来处理
Engine有一个默认虚拟主机，当请求无法匹配到任何一个Host上的时候，将交给该默认Host来处理

1.5 - Host

代表一个Virtual Host，虚拟主机，每个虚拟主机和某个网络域名Domain Name相匹配
每个虚拟主机下都可以部署(deploy)一个或者多个Web App，每个Web App对应于一个Context，有一个Context path
当Host获得一个请求时，将把该请求匹配到某个Context上，然后把该请求交给该Context来处理
匹配的方法是“最长匹配”，所以一个path==""的Context将成为该Host的默认Context
所有无法和其它Context的路径名匹配的请求都将最终和该默认Context匹配

1.6 - Context

一个Context对应于一个Web Application，一个Web Application由一个或者多个Servlet组成
Context在创建的时候将根据配置文件$CATALINA_HOME/conf/web.xml和$WEBAPP_HOME/WEB-INF/web.xml载入Servlet类
当Context获得请求时，将在自己的映射表(mapping table)中寻找相匹配的Servlet类
如果找到，则执行该类，获得请求的回应，并返回

2 - Tomcat Server的结构图

3 - 配置文件$CATALINA_HOME/conf/server.xml的说明

该文件描述了如何启动Tomcat Server

  

  
  


  

  
    ... ... ... ...
  


  

  


    

    


    

    
    

      

      

      

      


      

      
      

        

        
      

        

        
        

        

        
             
        
      
      
    

  

4 - Context的部署配置文件web.xml的说明

一个Context对应于一个Web App，每个Web App是由一个或者多个servlet组成的
当一个Web App被初始化的时候，它将用自己的ClassLoader对象载入“部署配置文件web.xml”中定义的每个servlet类
它首先载入在$CATALINA_HOME/conf/web.xml中部署的servlet类
然后载入在自己的Web App根目录下的WEB-INF/web.xml中部署的servlet类
web.xml文件有两部分：servlet类定义和servlet映射定义
每个被载入的servlet类都有一个名字，且被填入该Context的映射表(mapping table)中，和某种URL PATTERN对应
当该Context获得请求时，将查询mapping table，找到被请求的servlet，并执行以获得请求回应

分析一下所有的Context共享的web.xml文件，在其中定义的servlet被所有的Web App载入

  



  
  
  

  

  

    
        default
        
          org.apache.catalina.servlets.DefaultServlet
        
        
            debug
            0
        
        
            listings
            true
        
        1
    


  

    
        invoker
        
          org.apache.catalina.servlets.InvokerServlet
        
        
            debug
            0
        
        2
    


  

    
        jsp
        org.apache.jasper.servlet.JspServlet
        
            logVerbosityLevel
            WARNING
        
        3
    



  
  
  

    
    
        default
        /
    

    
        invoker
        /servlet/*
    

    
        jsp
        *.jsp
    


  
  
  

    ... ... ... ...

5 - Tomcat Server处理一个http请求的过程

假设来自客户的请求为：
http://localhost:8080/wsota/wsota_index.jsp

1) 请求被发送到本机端口8080，被在那里侦听的Coyote HTTP/1.1 Connector获得
2) Connector把该请求交给它所在的Service的Engine来处理，并等待来自Engine的回应
3) Engine获得请求localhost/wsota/wsota_index.jsp，匹配它所拥有的所有虚拟主机Host
4) Engine匹配到名为localhost的Host（即使匹配不到也把请求交给该Host处理，因为该Host被定义为该Engine的默认主机）
5) localhost Host获得请求/wsota/wsota_index.jsp，匹配它所拥有的所有Context
6) Host匹配到路径为/wsota的Context（如果匹配不到就把该请求交给路径名为""的Context去处理）
7) path="/wsota"的Context获得请求/wsota_index.jsp，在它的mapping table中寻找对应的servlet
8) Context匹配到URL PATTERN为*.jsp的servlet，对应于JspServlet类
9) 构造HttpServletRequest对象和HttpServletResponse对象，作为参数调用JspServlet的doGet或doPost方法
10)Context把执行完了之后的HttpServletResponse对象返回给Host
11)Host把HttpServletResponse对象返回给Engine
12)Engine把HttpServletResponse对象返回给Connector
13)Connector把HttpServletResponse对象返回给客户browser

１．下载Tomcat

在下面的地址下载Tomcat的二进制版

    http://mirrors.ccs.neu.edu/Apache/dist/jakarta/tomcat-4/binaries/

即下载文件

    tomcat-4.1.18.tar.gz

2. 安装

首先解压缩

    gunzip tomcat-4.1.18.tar.gz
    tar -zxvf tomcat-4.1.18.tar

得到Tomcat的所有文件.然后把它拷贝到你要安装的位置，如

    /opt/tomcat-4.1.18/

然后为了方便，你可以把目录名tomcat-4.1.18改为tomcat．

３．设置

• 设置路经
  
  在/etc/profile文件中加入如下两行
  
      export JAVA_HOME=/opt/jdk1.4
      export TOMCAT_HOME=/opt/tomcat
  
  在此我们假设Java JDK安装在/opt/jdk1.4目录下．
  　
• 激活ROOT
  
  ROOT的缺省设置是没有激活(disabled)．为了激活ROOT，打开文件
  
      tomcat/conf/server.xml
  
  然后把
  
     
  
  的注释去掉，即去掉．
   
• 激活Invoker Servlet
  
  即把tomcat/conf/web.xml中的下列字段的注释去掉
  
     
          invoker
          /servlet/*
     
  　
• 设置Port
  Tomcat缺省的Port number是8080．由于Tomcat是一个独立的(Standalone) Web Server，它可以不用Apache而独立工作，所以你可以不安装Apache，这样你可以把Tomcat设置在Port 80．这样你就可以在URL中省略:8080. 打开文件tomcat/conf/server.xml，找到如下的字段：
  
      className="org.apache.coyote.tomcat4.CoyoteConnector"
      port="8080" ...
      ... />
  
  然后把8080改成80即可．
  　
• 创建temp子目录
  在/opt/tomcat/目录下建立一个temp子目录
      mkdir temp

４．启动Tomcat

安装完后，重新启动计算机，以使JAVA_HOME和TOMCAT_HOME的设置生效．然后到

    /opt/tomcat/bin

下，运行命令：

    ./startup.sh

正常情况下可以见到如下的信息：

    Using CATALINA_BASE:   /opt/tomcat
    Using CATALINA_HOME:   /opt/tomcat
    Using CATALINA_TEMDIR: /opt/tomcat/temp
    Using JAVA_HOME:       /opt/jdk1.4

然后用浏览器打开如下的网页

    http://localhost/

或者

    http://localhost:8080/     （如果没有把Port number改为８０）

如果你见到Tomcat的网页（index.jsp），证明Tomcat安装成功，并已经启动．

如要关闭Tomcat，在/opt/tomcat/bin下运行下面的命令即可

    ./shutdown.sh

5. 注册你自己的项目（Project）

假设你有一个自己的JSP项目，他应该安装在下面的目录下：

    /opt/tomcat/webapps/myproject

你必须在tomcat/conf/server.xml中加入一行

在浏览器中对应的地址为：

    http://localhost/myproject

１．下载Tomcat

在下面的地址下载Tomcat的二进制版

    http://mirrors.ccs.neu.edu/Apache/dist/jakarta/tomcat-4/binaries/

即下载文件

    tomcat-4.1.18.tar.gz

2. 安装

首先解压缩

    gunzip tomcat-4.1.18.tar.gz
    tar -zxvf tomcat-4.1.18.tar

得到Tomcat的所有文件.然后把它拷贝到你要安装的位置，如

    /opt/tomcat-4.1.18/

然后为了方便，你可以把目录名tomcat-4.1.18改为tomcat．

３．设置

• 设置路经
  
  在/etc/profile文件中加入如下两行
  
      export JAVA_HOME=/opt/jdk1.4
      export TOMCAT_HOME=/opt/tomcat
  
  在此我们假设Java JDK安装在/opt/jdk1.4目录下．
  　
• 激活ROOT
  
  ROOT的缺省设置是没有激活(disabled)．为了激活ROOT，打开文件
  
      tomcat/conf/server.xml
  
  然后把
  
     
  
  的注释去掉，即去掉．
   
• 激活Invoker Servlet
  
  即把tomcat/conf/web.xml中的下列字段的注释去掉
  
     
          invoker
          /servlet/*
     
  　
• 设置Port
  Tomcat缺省的Port number是8080．由于Tomcat是一个独立的(Standalone) Web Server，它可以不用Apache而独立工作，所以你可以不安装Apache，这样你可以把Tomcat设置在Port 80．这样你就可以在URL中省略:8080. 打开文件tomcat/conf/server.xml，找到如下的字段：
  
      className="org.apache.coyote.tomcat4.CoyoteConnector"
      port="8080" ...
      ... />
  
  然后把8080改成80即可．
  　
• 创建temp子目录
  在/opt/tomcat/目录下建立一个temp子目录
      mkdir temp

４．启动Tomcat

安装完后，重新启动计算机，以使JAVA_HOME和TOMCAT_HOME的设置生效．然后到

    /opt/tomcat/bin

下，运行命令：

    ./startup.sh

正常情况下可以见到如下的信息：

    Using CATALINA_BASE:   /opt/tomcat
    Using CATALINA_HOME:   /opt/tomcat
    Using CATALINA_TEMDIR: /opt/tomcat/temp
    Using JAVA_HOME:       /opt/jdk1.4

然后用浏览器打开如下的网页

    http://localhost/

或者

    http://localhost:8080/     （如果没有把Port number改为８０）

如果你见到Tomcat的网页（index.jsp），证明Tomcat安装成功，并已经启动．

如要关闭Tomcat，在/opt/tomcat/bin下运行下面的命令即可

    ./shutdown.sh

5. 注册你自己的项目（Project）

假设你有一个自己的JSP项目，他应该安装在下面的目录下：

    /opt/tomcat/webapps/myproject

你必须在tomcat/conf/server.xml中加入一行

在浏览器中对应的地址为：

    http://localhost/myproject

1、Java

这里使用的是jdk1.4.2。

下载地址： http://dlc.sun.com/jdk/j2sdk-1_4_2_07-windows-i586-p.exe；

2、Tomcat

这里的tomcat的版本是5.0的，安装版或是解压版都是可以的。

下载地址： http://apache.linuxforum.net/dist/jakarta/tomcat-5/v5.0.28/bin/jakarta-t omcat-5.0.28.exe

3、Tomcat插件

tomcatPluginV3.zip(下载之前需要查看插件是否适合eclipse的版本)

下载地址： http://www.sysdeo.com/eclipse/tomcatPluginV3.zip

4、Eclipse

开发IDE eclipse-SDK-3.0.1-win32.zip

下载地址： http://sunsite.informatik.rwth-aachen.de/eclipse/downloads/drops/R-3.0.1 -200409161125/download.php?dropFile=eclipse-SDK-3.0.1-win32.zip 语言包 NLpack-eclipse-SDK-3.0.x-win32.zip

下载地址： http://sunsite.informatik.rwth-aachen.de/eclipse/downloads/drops/L-3.0.1 _Translations-200409161125/NLpack-eclipse-SDK-3.0.x-win32.zip

5、lomboz插件

lomboz插件需要下载两个部分，一个是emf环境，另一个是lomboz插件

下载地址： http://eclipse.mirrors.tds.net/tools/emf/downloads/drops/2.0.1/R20040917 1617/emf-sdo-runtime-2.0.1.zip

下载地址： http://download.forge.objectweb.org/lomboz/org.objectweb.lomboz_3.0.1.N2 0050106.zip

二、软件安装：

1、Java安装

运行可执行文件j2sdk-1_4_2_07-windows-i586-p.exe，安装结束后需配置环境变量，在我的电脑->属性->高级->环境变量->系统变量中添加以下环境变量

CLASSPATH: %JAVA_HOME%\lib;%TOMCAT_HOME%\common\lib

JAVA_HOME: c:\j2sdk1.4.2

PATH: %SystemRoot%\system32;%SystemRoot%;%SystemRoot%\System32\Wbem;C:\Program Files\ATI Technologies\ATI Control Panel;%JAVA_HOME%\bin;%TOMCAT_HOME%\bin

2、tomcat安装

解压版的直接解压就可以了，然后配置环境变量TOMCAT_HOME = C:\Program Files\Apache Software Foundation\Tomcat 5.0，安装版的要注意的两点，一个是安装完之后tomcat的服务就能够启动的了，但是还是要配置TOMCAT_HOME；第二个就是需要查看一下安装程序是不是把tomcat服务注册成为windows的启动服务，需要到“服务”里查看，如果有这个选项就把它设置为手动启动，并且先停止这个服务。

[测试]：使用startup.bat命令，服务正常启动之后，IE浏览器里输入http://localhost:8080/ 如果出现正常的页面，那就应该没有问题了。

3、Eclipse安装

Eclipse的安装很简单，只要解压，然后把Eclipse目录复制到盘符下就可以了，启动的时候，系统会自动寻找Jvm，当然可以再以后配置，但是好像是必须先安装jdk。我这里是放在D:\eclipse下

4、Tomcat插件安装，emf插件安装，lomboz插件安装，tomcatPluginV3.zip解压后将文件夹com.sysdeo.eclipse.tomcat_3.0.0拷贝到D:\eclipse\plugins emf插件和lomboz插件解压后将feature和plugins目录拷贝到 D:\eclipse\ 即可

三、Eclipse配置

配置Java

在Eclipse中点击windows->preferences,在出现的窗口中选择java->Installed JRES,这时可以在右边的窗口中看到己经有一项目，名字为j2re1.4.2_04。我们再在这里点击右面的"Add"按钮，增加一个JRE，在出现的对话框中输入：

JRE  Type:  Standard  VM 
JRE  name:  可以随意输入一个名字 
JRE  home directory:这里选择你的JDK的安装目录，
好比你的JDK装在F:\J2SDK\，
那么这里就是选择F:\J2SDK\这个目录。 
其它的可以都不管，点击OK就新增了一个JRE了
 

这里修改完了之后回到preferences对话框中的Java->Build Path这一项，点击Build Path后，在右面的面板中我们选择Source and output folder下面的Folders这一项，而两个Source folder name和Output folder name的值我们不修改，保存为系统默认值，但是下面的As JRE library use:我们要选择为JRE_LIB variable这一项，不能为默认值JRE container，最后点击下面的Apply按钮。这一步千万不要忘记了，不然刚才的都是白做了。

4、设置Lomboz

在Preferences窗口中选定Lomboz，然后把右边面板中的JDK Tools.jar选择为你安装好JDK后，在JAVA_HOME\LIB\目录下面的tools.jar文件就可以了，一定不要搞错了，如果你的JDK是安装在F:\J2SDK\下面，那么这里的值就应该是F:\J2SDK\lib\tools.jar，是其它的都不对。其它的保持为默认值。

接着把Lomboz这一项展开，关键要设置的地方是Server Definitions这一项，另外两项Code Generation和JSP Editor可以不管。

展开Lomboz的Server Definitions后，在Server types里选择Apache Tomcat v4.1.0(这是按照我的机器上的配置进行设置的，如果你安装的是其它版本的TOMCAT，你就要选择对应的选项)，主要设置如下：

Properties

Application Server Directory:这是我的TOMCAT 4.1.30的安装目录，我装在F:\tomcat下面，所以它的值就是F:/tomcat

Address:127.0.0.1

Port：80(因为我在TOMCAT中把8080改为80了，所以这里就是80了，以你的TOMCAT的监听端口为准)

Classpath Variable Name: TOMCAT_HOME(可以修改成其它的字符串)

Classpath Variable: F:/tomcat(TOMCAT的安装目录)

然后点击Apply按钮。

Server Classpath:

JDK_TOOLS 
${classPathVariableName}/bin/bootstrap.jar 
${classPathVariableName}/common/servlet.jar 
${classPathVariableName}/common/jasper-runtime.jar
 

然后点击Apply按钮。

Client Classpath:这里为空，什么也没有。

Project Classpath:

JDK_TOOLS 
${classPathVariableName}/bin/bootstrap.jar 
${classPathVariableName}/common/servlet.jar 
${classPathVariableName}/common/jasper-runtime.jar
 

然后点击Apply按钮。

这里的Server Classpath:和Project Classpath:我设置的是一样的。

注意：（以上配置 Server Classpath与 Project Classpath时，可能因为tomcat版本的不同而*.jar的文件位置也不同，如果时tomcat5.x版的 ,则${classPathVariableName}/common/servlet.jar 与 ${classPathVariableName}/common/jasper-runtime.jar 应为${classPathVariableName}/common/lib/servlet-api.jar 与 ${classPathVariableName}/common/lib/jasper-runtime.jar ，比4.x版的多了一层lib目录。）

5、修改文件

把Eclipse_home\plugins\com.objectlearn.jdt.j2ee_3.0.1\servers下面对应的server文件打开，比如我安装的TOMCAT是4.1.30版的，那么就把tomcat410.server这个文件打开，把里面的

-Djava.endorsed.dirs="$
{
serverRootDirectory}/bin;
$
{
serverRootDirectory
}
/common/endorsed"
 

改成：

-Djava.endorsed.dirs="$
{
serverRootDirectory
}
/common/endorsed"
 

一共有两处，都要修改，修改完之后保存，退出，重新启动Eclipse，这一步很重要，一定要做，不然的话你在Lomboz中启动TOMCAT的时候会再现很多莫明其妙的异常的。

注意：如果用的是tomcat5.x版的可能没有以上东西要改。

6、调出Lomboz各个菜单

启动Eclipse，然后点击windows->Customize Perspective,在出现的对话框中的Shortcuts页面中首先选中左边面板中的Lomboz J2EE Wizards，这时右边的面板中会出现很多选项的，同时也把它们各项前面的对钩打上。

然后在这个Shortcuts面板中改变Submenus:的值，选择Show View，接着在出现的面板的左边里选中Lomboz J2EE，同时也要把它前面的方框中打上对钩。

最后是更换Customize Perspective对话框中的面板到Commands这一页：在Commands这一页中选定Lomboz Actions同时也把它们各项前面的对钩打上。所有的设置完毕。

这样一切做完之后，Eclipse和Lomboz的环境就配置好了，你可以进行开发各种程序了。

个人体会：

可能在第5步中有些机器上可以不做，因为有不同的TOMCAT版本，不过有些机器一定要改了才行，不然的话是不能正常启动TOMCAT的。我个人使用TOMCAT4.1.30版的，是因为我觉得这个版本的比较小，运行起来也比较快，比5.0以上版本的要快多了，而且也要相对稳定一些(个人看法，不代表其他人的)，还有就是对于Eclipse 3.0的，可以参照上面的说明进行配置，基本上也可以行得通的，没有什么比较大的问题。

1、Java

这里使用的是jdk1.4.2。

下载地址： http://dlc.sun.com/jdk/j2sdk-1_4_2_07-windows-i586-p.exe；

2、Tomcat

这里的tomcat的版本是5.0的，安装版或是解压版都是可以的。

下载地址： http://apache.linuxforum.net/dist/jakarta/tomcat-5/v5.0.28/bin/jakarta-t omcat-5.0.28.exe

3、Tomcat插件

tomcatPluginV3.zip(下载之前需要查看插件是否适合eclipse的版本)

下载地址： http://www.sysdeo.com/eclipse/tomcatPluginV3.zip

4、Eclipse

开发IDE eclipse-SDK-3.0.1-win32.zip

下载地址： http://sunsite.informatik.rwth-aachen.de/eclipse/downloads/drops/R-3.0.1 -200409161125/download.php?dropFile=eclipse-SDK-3.0.1-win32.zip 语言包 NLpack-eclipse-SDK-3.0.x-win32.zip

下载地址： http://sunsite.informatik.rwth-aachen.de/eclipse/downloads/drops/L-3.0.1 _Translations-200409161125/NLpack-eclipse-SDK-3.0.x-win32.zip

5、lomboz插件

lomboz插件需要下载两个部分，一个是emf环境，另一个是lomboz插件

下载地址： http://eclipse.mirrors.tds.net/tools/emf/downloads/drops/2.0.1/R20040917 1617/emf-sdo-runtime-2.0.1.zip

下载地址： http://download.forge.objectweb.org/lomboz/org.objectweb.lomboz_3.0.1.N2 0050106.zip

二、软件安装：

1、Java安装

运行可执行文件j2sdk-1_4_2_07-windows-i586-p.exe，安装结束后需配置环境变量，在我的电脑->属性->高级->环境变量->系统变量中添加以下环境变量

CLASSPATH: %JAVA_HOME%\lib;%TOMCAT_HOME%\common\lib

JAVA_HOME: c:\j2sdk1.4.2

PATH: %SystemRoot%\system32;%SystemRoot%;%SystemRoot%\System32\Wbem;C:\Program Files\ATI Technologies\ATI Control Panel;%JAVA_HOME%\bin;%TOMCAT_HOME%\bin

2、tomcat安装

解压版的直接解压就可以了，然后配置环境变量TOMCAT_HOME = C:\Program Files\Apache Software Foundation\Tomcat 5.0，安装版的要注意的两点，一个是安装完之后tomcat的服务就能够启动的了，但是还是要配置TOMCAT_HOME；第二个就是需要查看一下安装程序是不是把tomcat服务注册成为windows的启动服务，需要到“服务”里查看，如果有这个选项就把它设置为手动启动，并且先停止这个服务。

[测试]：使用startup.bat命令，服务正常启动之后，IE浏览器里输入http://localhost:8080/ 如果出现正常的页面，那就应该没有问题了。

3、Eclipse安装

Eclipse的安装很简单，只要解压，然后把Eclipse目录复制到盘符下就可以了，启动的时候，系统会自动寻找Jvm，当然可以再以后配置，但是好像是必须先安装jdk。我这里是放在D:\eclipse下

4、Tomcat插件安装，emf插件安装，lomboz插件安装，tomcatPluginV3.zip解压后将文件夹com.sysdeo.eclipse.tomcat_3.0.0拷贝到D:\eclipse\plugins emf插件和lomboz插件解压后将feature和plugins目录拷贝到 D:\eclipse\ 即可

三、Eclipse配置

配置Java

在Eclipse中点击windows->preferences,在出现的窗口中选择java->Installed JRES,这时可以在右边的窗口中看到己经有一项目，名字为j2re1.4.2_04。我们再在这里点击右面的"Add"按钮，增加一个JRE，在出现的对话框中输入：

JRE  Type:  Standard  VM 
JRE  name:  可以随意输入一个名字 
JRE  home directory:这里选择你的JDK的安装目录，
好比你的JDK装在F:\J2SDK\，
那么这里就是选择F:\J2SDK\这个目录。 
其它的可以都不管，点击OK就新增了一个JRE了
 

这里修改完了之后回到preferences对话框中的Java->Build Path这一项，点击Build Path后，在右面的面板中我们选择Source and output folder下面的Folders这一项，而两个Source folder name和Output folder name的值我们不修改，保存为系统默认值，但是下面的As JRE library use:我们要选择为JRE_LIB variable这一项，不能为默认值JRE container，最后点击下面的Apply按钮。这一步千万不要忘记了，不然刚才的都是白做了。

4、设置Lomboz

在Preferences窗口中选定Lomboz，然后把右边面板中的JDK Tools.jar选择为你安装好JDK后，在JAVA_HOME\LIB\目录下面的tools.jar文件就可以了，一定不要搞错了，如果你的JDK是安装在F:\J2SDK\下面，那么这里的值就应该是F:\J2SDK\lib\tools.jar，是其它的都不对。其它的保持为默认值。

接着把Lomboz这一项展开，关键要设置的地方是Server Definitions这一项，另外两项Code Generation和JSP Editor可以不管。

展开Lomboz的Server Definitions后，在Server types里选择Apache Tomcat v4.1.0(这是按照我的机器上的配置进行设置的，如果你安装的是其它版本的TOMCAT，你就要选择对应的选项)，主要设置如下：

Properties

Application Server Directory:这是我的TOMCAT 4.1.30的安装目录，我装在F:\tomcat下面，所以它的值就是F:/tomcat

Address:127.0.0.1

Port：80(因为我在TOMCAT中把8080改为80了，所以这里就是80了，以你的TOMCAT的监听端口为准)

Classpath Variable Name: TOMCAT_HOME(可以修改成其它的字符串)

Classpath Variable: F:/tomcat(TOMCAT的安装目录)

然后点击Apply按钮。

Server Classpath:

JDK_TOOLS 
${classPathVariableName}/bin/bootstrap.jar 
${classPathVariableName}/common/servlet.jar 
${classPathVariableName}/common/jasper-runtime.jar
 

然后点击Apply按钮。

Client Classpath:这里为空，什么也没有。

Project Classpath:

JDK_TOOLS 
${classPathVariableName}/bin/bootstrap.jar 
${classPathVariableName}/common/servlet.jar 
${classPathVariableName}/common/jasper-runtime.jar
 

然后点击Apply按钮。

这里的Server Classpath:和Project Classpath:我设置的是一样的。

注意：（以上配置 Server Classpath与 Project Classpath时，可能因为tomcat版本的不同而*.jar的文件位置也不同，如果时tomcat5.x版的 ,则${classPathVariableName}/common/servlet.jar 与 ${classPathVariableName}/common/jasper-runtime.jar 应为${classPathVariableName}/common/lib/servlet-api.jar 与 ${classPathVariableName}/common/lib/jasper-runtime.jar ，比4.x版的多了一层lib目录。）

5、修改文件

把Eclipse_home\plugins\com.objectlearn.jdt.j2ee_3.0.1\servers下面对应的server文件打开，比如我安装的TOMCAT是4.1.30版的，那么就把tomcat410.server这个文件打开，把里面的

-Djava.endorsed.dirs="$
{
serverRootDirectory}/bin;
$
{
serverRootDirectory
}
/common/endorsed"
 

改成：

-Djava.endorsed.dirs="$
{
serverRootDirectory
}
/common/endorsed"
 

一共有两处，都要修改，修改完之后保存，退出，重新启动Eclipse，这一步很重要，一定要做，不然的话你在Lomboz中启动TOMCAT的时候会再现很多莫明其妙的异常的。

注意：如果用的是tomcat5.x版的可能没有以上东西要改。

6、调出Lomboz各个菜单

启动Eclipse，然后点击windows->Customize Perspective,在出现的对话框中的Shortcuts页面中首先选中左边面板中的Lomboz J2EE Wizards，这时右边的面板中会出现很多选项的，同时也把它们各项前面的对钩打上。

然后在这个Shortcuts面板中改变Submenus:的值，选择Show View，接着在出现的面板的左边里选中Lomboz J2EE，同时也要把它前面的方框中打上对钩。

最后是更换Customize Perspective对话框中的面板到Commands这一页：在Commands这一页中选定Lomboz Actions同时也把它们各项前面的对钩打上。所有的设置完毕。

这样一切做完之后，Eclipse和Lomboz的环境就配置好了，你可以进行开发各种程序了。

个人体会：

可能在第5步中有些机器上可以不做，因为有不同的TOMCAT版本，不过有些机器一定要改了才行，不然的话是不能正常启动TOMCAT的。我个人使用TOMCAT4.1.30版的，是因为我觉得这个版本的比较小，运行起来也比较快，比5.0以上版本的要快多了，而且也要相对稳定一些(个人看法，不代表其他人的)，还有就是对于Eclipse 3.0的，可以参照上面的说明进行配置，基本上也可以行得通的，没有什么比较大的问题。

会提示“TOMCAT web Server Administrator"下面是要输入用户和密码，因为默认的时候是没有管理用户的权限的用户，所以我们要创建一个：

在你的tomcat/conf/下有个tomcat-users.xml

打开：

我们看到在tomcat用户配置文件里，有tomcat,manager,admin等几个角色，下面我们增加一个用户，并为他赋予全部权限：

保存文件，重新启动tomcat,打开http://localhost:8080/admin/,输入用户名和密码：

OK!期待中的tomcat web管理后台出现了，可以用它配置数据源，连接池等，相应的配置，tomcat会自动修改server.xml文件。

会提示“TOMCAT web Server Administrator"下面是要输入用户和密码，因为默认的时候是没有管理用户的权限的用户，所以我们要创建一个：

在你的tomcat/conf/下有个tomcat-users.xml

打开：

我们看到在tomcat用户配置文件里，有tomcat,manager,admin等几个角色，下面我们增加一个用户，并为他赋予全部权限：

保存文件，重新启动tomcat,打开http://localhost:8080/admin/,输入用户名和密码：

OK!期待中的tomcat web管理后台出现了，可以用它配置数据源，连接池等，相应的配置，tomcat会自动修改server.xml文件。