使用 setenv 配置文件管理 Tomcat 的自定义环境变量

1、背景描述

有时候,我们会在 catalina.bat 或 catalina.sh 文件中,自定义一些环境变量,例如额外指定 JDK 路径或设置 JVM 参数。

实际上,直接在 catalina.bat 或 catalina.sh 文件中,自定义环境变量的做法,是不规范的。

因为在对 Tomcat 进行(小版本)升级时,新版本的 catalina.bat 或 catalina.sh 文件,会覆盖旧版本的文件,从而导致原来的自定义环境变量失效。

对此,Tomcat 官方已在 catalina.bat(或 catalina.sh )文件的注释中(见下图),提示使用 setenv.bat(或 setenv.sh )配置文件(需额外创建)来保存自定义环境变量。

2、指定JDK路径

2.1、Windows系统

2.1.1、指定JDK路径之前

如上图所示,在配置 Tomcat 的自定义环境变量之前,Tomcat 默认使用(Windows)系统环境变量所配置的 JDK 路径。

2.1.2、指定JDK路径命令

如上图所示,先在 Tomcat 的 bin 目录下,创建一个 setenv.txt 文件,编辑好指定JDK路径的命令之后,再将 txt 后缀更改为 bat 即可。

set JAVA_HOME=自定义JDK路径

2.1.3、指定JDK路径之后

如上图所示,通过 setenv.bat 文件,成功使用了指定的 JDK 路径。

2.2、Linux系统

注意:在Linux系统中,Tomcat 使用的是 JRE 路径,因此需要指定的是 JRE_HOME 而不是 JAVA_HOME 。

2.2.1、指定JRE路径之前

如上图所示,在配置 Tomcat 的自定义环境变量之前,Tomcat 默认使用(Linux)系统环境变量所配置的 JDK 路径。

2.2.2、指定JRE路径命令

如上图所示,先在 Tomcat 的 bin 目录下,创建一个 setenv.sh 文件,编辑好指定JRE路径的命令之后,再将该脚本文件添加执行权限(chmod +x setenv.sh)即可。

JRE_HOME="自定义jre路径"

2.2.3、指定JRE路径之后

如上图所示,通过 setenv.sh 文件,成功使用了指定的 JRE 路径。

3、设置JVM参数

3.1、Windows系统

3.1.1、设置JVM参数命令

-Xms:设置 JVM 初始化时内存;

-Xmx:设置 JVM 最大可用内存;

这两个值一般设置相同的大小,以避免每次垃圾回收完成后 JVM 重新分配内存。

set JAVA_OPTS=-Xms自定义大小 -Xmx自定义大小

3.1.2、设置JVM参数之后

如上图所示,通过 setenv.bat 文件,成功使用了设置的 JVM 参数。

3.2、Linux系统

3.2.1、设置JVM参数命令

-Xms:设置 JVM 初始化时内存;

-Xmx:设置 JVM 最大可用内存;

这两个值一般设置相同的大小,以避免每次垃圾回收完成后 JVM 重新分配内存。

JAVA_OPTS="-Xms自定义大小 -Xmx自定义大小"

3.2.2、设置JVM参数之后

如上图所示,通过 setenv.sh 文件,成功使用了设置的 JVM 参数。

本文参考

【1】【zno2】【setenv.bat】【博客园】【2016-10-17】

【2】【song854601134】【 tomcat中管理环境变量之setenv.sh】【CSDN】【2024-05-31】

【3】【且行且思】【Tomcat通过setenv.bat指定jdk和jre(相对路径)】【博客园】【2023-06-28】

【4】【yuer!】【如何修改linux下tomcat指定的jdk路径】【博客园】【2020-04-02】