Tomcat 9使用小记

下载安装

下载

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

软件要求

安装jdk，且版本在java8以上

安装

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

tar xzvf apache-tomcat-9.0.29.tar.gz

3. 启动tomcat

bin/startup.sh

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

4. 停止tomcat

bin/shutdown.sh

tomcat环境变量

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

1. CATALINA_OPTS

CATALINA_OPTS="-Xms64m -Xmx256m"

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

2. CATALINA_PID

CATALINA_PID="$CATALINA_BASE/tomcat.pid"

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

3. UMASK

UMASK="0022"

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

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

多实例部署

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

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

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

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

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

3. 控制台执行下面的命令，启动该实例

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

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

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

5. 这里提供了一个简单的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

参考资料

• https://tomcat.apache.org/tomcat-9.0-doc/RUNNING.txt
• Tomcat 9官方文档
• bash shell 获取当前正在执行脚本的绝对路径
• umask命令