Tomcat 5.5 Setup官方文档翻译

delkar

Tomcat 5.5 Setup

介绍
    这个文档介绍了通过多种途径安装Tomcat使得它运行在各种不同的平台上。请注意有些高级安装发行版本在这里没有作介绍：整个的分配(ZIP file or tarball)包含了一个文件叫做running.txt这个文件讨论了这些没有概括到的问题。

Windows

    在Windows下可以简单的使用Windows安装程序安装Tomcat。它的界面和功能类似于别的基于Windows的安装程序。

    ·作为服务安装：Tomcat将被作为Windows NT/2k/XP服务被安装无论选择什么样的设置。使用在组件页上的检查栏设置服务为自动运行，这样Tomcat就会在Windows启动时一同启动。为了安全起见，服务应该用单令的用户运行，以降低权限（见Windows服务管理工具和它的文档）。

    ·Java定位：安装程序将使用注册或JAVA_HOME环境变量来计算J2SE 5 JRE的主路径。

    ·托盘图标：当Tomcat作为服务运行时，将不会有任何托盘图标出现。注意，当在Tomcat的安装末尾选择了运行，托盘图标将被使用即使Tomcat被作为Windows服务。

    ·查阅Windows Service HOW-TO可以获得如何管理Tomcat Windows服务。

    安装程序将会创建快捷方式允许开始和配置Tomcat。非常值得注意的是Tomcat管理web程序只能在Tomcat运行的时候才能使用。



Unix daemon

    Tomcat可以使用公共-后台程序的jsvc工具作为后台程序运行来运行。jsvc源码文件包含了Tomcat的需要编译的二进制文件。构建jsvc需要一个C语言的美国国家标准化组织的编译器（例如GCC），GNU Autoconf，和一个JDK。

    在运行脚本之前，JAVA_HOME环境变量应该被设置了JDK的基本路径。另一方面，当调用./configure脚本时，JDK的路径也许应该使用 --with-java 参数被指定。例如：./configure --with-java=/usr/java.

    使用下面的命令将导致编译jsvc二进制，定位于$CATALINA_HOME/bin目录。假设GNU TAR已经被使用，CATALINA_HOME环境变量已经指向Tomcat的安装基本路径。

    请注意你应该使用GNU make (gmake)代替native BSD make在FreeBSD操作系统下。

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


使用下面的命令Tomcat就可以作为后台程序运行了

    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还有其他有用的参数，例如：-user 可以在后台程序初始化完成后切换到其他用户。这是允许的，举个例子，运行Tomcat的是一个没有特权的用户但你仍然需要使用特权端口。jsvc --help 将转向完整的jsvc使用信息。特别的，-debug选项对于排除错误是很有用的。


    文件$CATALINA_HOME/bin/jsvc/native/tomcat.sh 可以作为一个样板使用用来在引导时使用/etc/init.d自动启动。这个文件通常用来配置运行中的Tomcat 4.1.x，编辑和更改引导类别是很有必要的。

    注意公共-后台程序JAR文件必须使用在你的运行时间类路径这种方法。（此处翻译有问题，请大家指正）Commons-Daemon JAR 文件是引导程序中录入的类路径的表现。如果你得到了一个ClassNotFoundException或者一个NoClassDefFoundError的公共-后台程序的类，在开发jsvc的时候将公共-后台程序JAR加入-cp参数。

本人第一次翻译文档。请大伙多多指正。原版英文文档在http://tomcat.apache.org/tomcat-5.5-doc/setup.html