CentOS 上 Tomcat 的更新与升级方法
一 升级策略与准备
- 明确目标：是做同系列小版本更新（如 9.0.x → 9.0.y），还是跨系列升级（如 8.5 → 9.0）。跨系列升级需评估应用的兼容性与配置差异。
- 备份关键资产：
- 配置与目录：/opt/tomcat/conf、/opt/tomcat/webapps、/opt/tomcat/lib、自定义脚本与日志。
- 运行信息：记录当前 Tomcat 版本、JDK 版本、应用部署方式（war/目录）、端口与 AJP 使用情况。
- 准备新版本介质：在能联网环境下载所需版本的 Core 版 tar.gz，传至服务器；离线环境可用 U 盘或内网镜像。
- 检查兼容性：确认应用与中间件（如 JDBC 驱动、JVM 参数、安全策略）与新版本兼容；跨系列升级时重点核对 server.xml 差异。
- 维护窗口与回滚方案：选择低峰时段，保留旧目录以便快速回滚。
二 标准升级步骤（systemd 管理的二进制安装）
- 停服与备份：
- 停止服务：
sudo systemctl stop tomcat
- 备份目录：
sudo cp -rp /opt/tomcat /opt/tomcat-bak-$(date +%F)
- 部署新版本：
- 解压：
sudo tar -xvzf apache-tomcat-9.0.xx.tar.gz -C /opt/
- 保持目录名一致（便于不改动 systemd 与脚本）：
sudo mv /opt/apache-tomcat-9.0.xx /opt/tomcat-new
- 迁移配置与数据（按需）：
- 配置：
sudo cp -rp /opt/tomcat-bak/conf /opt/tomcat-new/conf
- 应用：
sudo cp -rp /opt/tomcat-bak/webapps /opt/tomcat-new/webapps（或仅迁移业务 war/目录）
- 驱动与库：
sudo cp -p /opt/tomcat-bak/lib/*.jar /opt/tomcat-new/lib/（避免覆盖新版本自带组件）
- 切换版本：
- 原子切换：
sudo rm -rf /opt/tomcat && sudo mv /opt/tomcat-new /opt/tomcat
- 如采用替换目录方式，确保 systemd 服务文件中的 CATALINA_HOME/CATALINA_BASE 指向 /opt/tomcat；必要时执行
sudo systemctl daemon-reload
- 启动与验证：
- 启动：
sudo systemctl start tomcat
- 状态：
sudo systemctl status tomcat
- 日志：
tail -n 200 /opt/tomcat/logs/catalina.out
- 访问：
curl -I http://localhost:8080 或服务器 IP
- 回滚：
- 快速回退：
sudo systemctl stop tomcat && sudo rm -rf /opt/tomcat && sudo mv /opt/tomcat-bak-$(date +%F) /opt/tomcat && sudo systemctl start tomcat
三 离线环境升级要点
- 在联网机下载所需版本的 apache-tomcat-9.0.xx.tar.gz，通过 U 盘/SCP 传入目标服务器。
- 其余步骤与标准升级一致；重点是确保介质完整（校验包大小/哈希）、备份充分、切换原子化。
四 常见差异与注意事项
- 目录结构变化：跨系列升级时，部分目录或默认行为可能变化，优先沿用旧版的 conf/ 与 webapps/，逐项比对差异。
- AJP 协议：部分版本（如 8.5.51）默认关闭 AJP，如业务依赖需在 conf/server.xml 中显式开启并配置 secretRequired/secret。
- 环境变量与脚本：若采用替换目录方式，通常无需改动 JAVA_HOME 与 CATALINA_HOME；若更换路径，需同步更新 systemd 服务文件与自定义脚本。
- JVM 参数：保留旧版的 JAVA_OPTS/CATALINA_OPTS（如堆大小、GC 策略、headless 等），在新版验证无误后再做优化。
- 驱动与依赖：数据库驱动、JCE 策略等第三方 jar 按应用需要迁移，避免覆盖新版本内置组件。
- 安全加固：升级后及时清理 webapps/examples、限制管理应用访问、开启访问日志与必要的加固项。
五 验证与回滚清单
- 版本核验：
- 管理页：
curl -I http://localhost:8080
- 服务版本：
/opt/tomcat/bin/version.sh
- 应用可用性：登录应用、执行业务关键路径、检查数据库连接池与线程池状态。
- 日志与健康：检查 catalina.out、localhost.log*、access.log 是否有异常堆栈、启动失败、类加载或权限错误。
- 回滚触发条件：版本无法启动、关键功能异常、性能显著退化；按“备份与切换”步骤快速恢复。