tomcat学习笔记之catalina.sh

最新推荐文章于 2024-10-12 11:13:46 发布

小南家的青蛙

最新推荐文章于 2024-10-12 11:13:46 发布

阅读量2.5w

点赞数 2

分类专栏： Java 文章标签： Java tomcat catalina.sh

本文链接：https://blog.csdn.net/jackie_xiaonan/article/details/49229139

版权

Java 专栏收录该内容

103 篇文章 1 订阅

订阅专栏

本文基于tomcat 8.0.18版本的源码实现写作，随tomcat7发布的脚本可能会有些差异。
最早是在07年部门培训的时候接触到tomcat，但后来的工作都和web开发不相关，所以没有积累多少使用经验，只有一点肤浅的感性认识；12年中项目组启动了新部件的开发，使用tomcat做为运行平台，但和我的工作内容不相关，所以还没有实质性的接触；15年初，调离原项目，加入新产品的研发，而新产品是基于tomcat的j2ee项目，工作这么多年终于有机会和tomcat做一次亲密接触。

与catalina.sh相关的脚本

tomcat发布版本中附带了很多脚本，和catalina.sh相关有如下

version.sh，查看当前tomcat的版本号。
startup.sh，启动运行tomcat实例。
shutdown.sh，停止tomcat实例的运行。
configtest.sh，校验tomcat配置文件server.xml的格式、内容等是否合法、正确。
setclasspath.sh，catalina.sh依赖这个脚本来设置一些运行时变量。

脚本version.sh、startup.sh、shutdown.sh、configtest.sh都是对catalina.sh的包装，内容大同小异，差异在于功能介绍和调用catalina.sh时的参数不同。
下面就重点分析下catalina.sh的实现。

catalina.sh的命令行选项

在shell下不带任何参数来执行catalina.sh，可以看到类似如下的输出信息。
Usage: catalina ( commands ... ) commands: debug Start Catalina in a debugger debug -security Debug Catalina with a security manager jpda start Start Catalina under JPDA debugger run Start Catalina in the current window run -security Start in the current window with security manager start Start Catalina in a separate window start -security Start in a separate window with security manager stop Stop Catalina configtest Run a basic syntax check on server.xml version What version of tomcat are you running?
帮助信息给出了各选项的意义，但tomcat提供的封装脚本中只用到了其中的一部分，比如：

version，在version.sh中使用。
start，在startup.sh中使用。
stop，在shutdown.sh中使用。
configtest，在configtest.sh中使用。

如果需要使用其它命令行选项，最简单的方法即是复制startup.sh脚本并重命名为新的脚本，使用文本编辑器调整传给catalina.sh的参数，如此操作之后，满足自定义需求的脚本即创建好了。

catalina.sh中使用的变量

catalina.sh提供了哪些变量？

用文本编辑器打开catalina.sh，首先可以看到一些环境变量的说明，基于功能可以做如下分类：

指定tomcat和应用的启动路径
- CATALINA_HOME，指向tomcat的安装路径，或者脚本catalina.sh所在位置的父目录。
- CATALINA_BASE，可选项，如无定义，则与CATALINA_HOME取值相同。用于指向用户自定义的tomcat路径，tomcat启动时将以CATALINA_BASE变量值来计算配置文件、日志文件等的路径。
Java运行时路径，tomcat运行依赖系统已安装好的Java运行时软件，因此如下两个变量中至少定义一个，并且变量值指向合法路径。
- JAVA_HOME，指定JDK的安装路径。
- JRE_HOME，指定JRE的安装路径。取值原则，如用户未指定JRE_HOME，则取JAVA_HOME的值；如JRE_HOME和JAVA_HOME都有定义，则优先取JRE_HOME的定义。
Java运行时参数
- JAVA_OPTS，顾名思义，用来定义传递Java运行时的参数，对全部命令行选项都会生效，因此不建议在本变量中定义堆大小、GC参数、JMX参数等。
- CATALINA_OPTS，用来定义传递给Java运行时的参数，仅在命令行选项为run/start/debug时有效，可以用来传递堆大小、GC参数、JMX参数等。
- CATALINA_TMPDIR，用来定义java.io.tmpdir变量的值，默认值为$CATALINA_BASE/temp。
- JAVA_ENDORSED_DIRS，以分号相隔的目录列表，用来替换非JCP提供的jar实现，默认值为$CATALINA_HOME/endorsed。
远程调试参数。当开发环境与应用运行环境不一致，或者开发环境下出于各种原因不适合调试应用时，这时即可借助远程调试来解决问题。JPDA的介绍可参考阅读资料。
- JPDA_TRANSPORT，默认值dt_socket。
- JPDA_ADDRESS，默认值localhost:8000。
- JPDA_SUSPEND，默认值n
- JPDA_OPTS，默认值为-agentlib:jdwp=transport=$JPDA_TRANSPORT,address=$JPDA_ADDRESS,server=y,suspend=$JPDA_SUSPEND
其它
- CATALINA_OUT，使用全路径方式指定stdout和stderr重定向之后的文件名，默认值为$CATALINA_BASE/logs/catalina.out。
- CATALINA_PID，本选项在*nix下有效，指定pid文件的存储路径，默认值为空，如用户指定，则启动、停止时都会从变量指定的文件中提取进程ID。
- LOGGING_CONFIG，定义tomcat使用的日志配置文件的路径，默认值为$CATALINA_BASE/conf/logging.properties。
- LOGGING_MANAGER，定义tomcat使用的日志管理器。