Tomcat 9使用小记

下载安装

下载

进入官方下载网站，选择适合自己平台的文件进行下载

软件要求

安装jdk，且版本在java8以上

安装

将下载好的文件放到对应目录，linux系统一般将该文件放在/user/local下面
解压文件：

tar xzvf apache-tomcat-9.0.29.tar.gz

启动tomcat

bin/startup.sh

访问http://your-host:8080，可以看到如下页面：

停止tomcat

bin/shutdown.sh

tomcat环境变量

在bin/目录下新建一个文件setenv.sh，该文件中可以设置在bin/catalina.sh文件上面注释中列出的环境变量。
下面列出一些常见tomcat环境变量的配置：

CATALINA_OPTS

CATALINA_OPTS="-Xms64m -Xmx256m"

设置tomcat运行时使用的jvm内存

CATALINA_PID

CATALINA_PID="$CATALINA_BASE/tomcat.pid"

tomcat启动时会生成一个tomcat.pid文件，该文件里会写入当前运行的tomcat进程号，利用该环境变量可以防止tomcat重复启动，并且当tomcat无法正常关闭时，可以强制关闭。

UMASK

UMASK="0022"

该值可以决定tomcat运行中所创建文件的文件权限。web应用通过网页上传的文件所拥有的权限也由该环境变量的值来决定，所以假若该值设定不当，可能会引发web应用上传的文件无法被外界读取的问题。

CATALINA_TMPDIR
该环境变量的值将作为java系统参数java.io.tmpdir的值，用于指定虚拟机的临时目录。默认为$CATALINA_BASE/temp。

多实例部署

设置CATALINA_HOME变量
linux下编辑/etc/profile文件，增加下面一行：

export CATALINA_HOME="/usr/local/apache-tomcat-9.0.29"

编辑完成后可以使用命令source /etc/profile，让设置的环境变量立刻生效。

新建一个目录作为tomcat实例的CATALINA_BASE目录，在该目录下最少需要下面三个文件夹：

也就是conf、logs、webapps三个文件夹，其中conf文件夹需要复制CATALINA_HOME/conf中的所有文件。
除开这三个文件夹以外，还可以在此目录下新建一个bin文件夹，bin文件夹下可以放置该实例的setenv.sh和tomcat-juli.jar文件。
控制台执行下面的命令，启动该实例

CATALINA_BASE=/tmp/tomcat_base1 $CATALINA_HOME/bin/startup.sh

控制台执行下面的命令，停止该实例

CATALINA_BASE=/tmp/tomcat_base1 $CATALINA_HOME/bin/shutdown.sh

这里提供了一个简单的instance.sh脚本，使用该脚本可以使多实例部署模式下的tomcat项目更便于维护：

#!/bin/bash
# Program:
#       tomcat多实例部署模式下更便捷维护tomcat项目的脚本，提供启动，停止，重启，更新等功能，会使用当前脚本所在的目录作为CATALINA_BASE
# History:
# 2019/12/20    winter  First release

SHELL_FOLDER=$(cd "$(dirname "$0")";pwd)
UPGRADE_FILE="upgrade.war"

if [ -z "$CATALINA_HOME" ]; then
    echo "environment variable CATALINA_HOME is not set";
    exit 1;
fi

start(){
    if [ $RM_LOGS -eq 1 ]; then
        echo "remove all logs in $SHELL_FOLDER/logs/"
        rm -rf $SHELL_FOLDER/logs/*
    fi
    CATALINA_BASE=$SHELL_FOLDER $CATALINA_HOME/bin/startup.sh
}

stop(){
    CATALINA_BASE=$SHELL_FOLDER $CATALINA_HOME/bin/shutdown.sh
}

RM_LOGS=0
if [ "$2" = "-rmlogs" ]; then
    RM_LOGS=1
fi

echo "CATALINA_HOME:$CATALINA_HOME"
echo "CATALINA_BASE:$SHELL_FOLDER"

case $1 in
    "start")
        start
        ;;
    "stop")
        stop
        ;;
    "restart")
        stop
        start
        ;;
    "upgrade")
        if [ ! -e $SHELL_FOLDER/$UPGRADE_FILE ]; then
            echo "$UPGRADE_FILE not found";
            exit 1;
        fi
        
        stop
        
        #解压war文件到ROOT目录
        echo "extract $UPGRADE_FILE to ROOT directory"
        rm -rf $SHELL_FOLDER/webapps/ROOT/*
        cd $SHELL_FOLDER/webapps/ROOT/
        jar -xf ../../$UPGRADE_FILE
        cd -
        
        start
        ;;
    *)
        echo "Usage: instance.sh ( commands ... )"
        echo "commands:"
        echo "  start             Start instance"
        echo "  stop              Stop instance"
        echo "  restart           Restart instance"
        echo "  upgrade           Upgrade instance"
        echo "  start -rmlogs     Start instance after removing logs"
        echo "  restart -rmlogs   Restart instance and remove logs"
        echo "  upgrade -rmlogs   Upgrade instance and remove logs"
        ;;
esac

参考资料

最后编辑于：2020.03.05 16:04:22