Tomcat 日志切割变量 CATALINA_OUT_CMD

一、准备rotatelogs工具

1. 从安装httpd的服务器上，拷贝/usr/sbin/rotatelogs文件到$CATALINA_HOME/bin/目录，并加可执行权限。
2. 安装依赖软件 apr ， 否则会报错。请见 附件3。

 yum install apr apr-util -y

3. 执行./rotatelogs -h测试rotatelogs是否工作

[tomcat@VM-99-19-centos bin]$ ./rotatelogs -h
rotatelogs: illegal option -- h
Usage: ./rotatelogs [-v] [-l] [-L linkname] [-p prog] [-f] [-t] [-e] [-c] [-n number] <logfile> {<rotation time in seconds>|<rotation size>(B|K|M|G)} [offset minutes from UTC]

二、在$CATALINA_HOME/bin/目录下创建setenv.sh，内容如下：

CATALINA_OUT_CMD="$CATALINA_BASE/bin/rotatelogs -f $CATALINA_BASE/logs/catalina.out.%Y-%m-%d.log 86400 480"

三、优点描述

1. rotatelogs工具可以集成到tomcat软件包，批量部署
2. setenv.sh可以集成，也可以通过自动化运维工具批量修改，自定义空间大
3. 解决打补丁、升级的问题。
   无侵入。不需要安装cronolog，不需要安装httpd，仅需要安装依赖组件 apr。无需打补丁啊。
4. 给定一个tomcat包，开发人员开箱即用。

---

附件1、 关于 rotatelogs 工具

关于 rotatelogs - Piped logging program to rotate Apache logs - Apache HTTP Server Version 2.4

rotatelogs 由 httpd-2.4.6-95.el7.centos.x86_64 : Apache HTTP Server 提供

CATALINA_OUT_CMD="rotatelogs -f $CATALINA_BASE/logs/catalina.out.%Y-%m-%d.log 86400 480"

-f
在rotatelogs启动时候立即打开logfile，而不是等到读取第一个logfile条目（对于不忙的站点，在服务器启动和处理第一个请求见可能有较长时间的差距，意味着在这之前相关的logfile不“存在”，这会导致某些自动化日志工具出问题）。

86400
指派日志的轮转时间 86400 ，即按天（ 24 hours， 1 day） 。

480
偏移量 offset，东八区为480分钟 。

把系统时间向前调，生成的日志文件名不变；把系统时间向后调，会根据规则变更日志文件名。

---

附件2、 关于 mkfifo 工具 & named pipe

mkfifo(3) - Linux manual page (man7.org)

---

附件3、故障

##故障现象
./rotatelogs: error while loading shared libraries: libapr-1.so.0: cannot open shared object file: No such file or directory
##解决方式，安装apr
 yum install apr apr-utils -y

---

附件4、关于 CATALINA_OUT_CMD

查看 Apache Tomcat 9 (9.0.53) - Changelog 关于CATALINA_OUT_CMD的记录

Tomcat 9.0.36 (markt) 2020-06-07
64430: Add support for the CATALINA_OUT_CMD environment variable that defines a command to which captured stdout and stderr will be redirected. Patch provided by Harald Dunkel. (markt)

Tomcat 9.0.17 (markt) 2019-03-18
63041: Revert the changes for 53930 that added support for the CATALINA_OUT_CMD environment variable as they prevented correct operation with systemd configurations that did not explicitly specify a PID file. (markt)

Tomcat 9.0.14 (markt) 2018-12-12
53930: Add support for the CATALINA_OUT_CMD environment variable that defines a command to which captured stdout and stderr will be redirected. Patch provided by Casey Lucas. (markt)

当然，其他大版本也增加了关于CATALINA_OUT_CMD的特性

如上可以看到，9.0.14提交了初版，9.0.17回滚，9.0.36再次提交。所以，要使用 9.0.36 之后的版本。