如何更新Linux上的Tomcat版本

Linux 上 Tomcat 版本升级实操指南

一 升级前准备

• 明确升级路径：优先在同大版本内做小版本升级（如 8.5.x → 8.5.y），跨大版本（如 8 → 9）需充分回归测试。升级前在测试环境验证应用的兼容性。
• 备份关键资产：打包备份整个 Tomcat 目录（含 conf/、自定义脚本、证书等）与应用数据；如涉及持久化，同步备份数据库。
• 检查端口与依赖：确认 8080/8005/8009 等端口未被占用；核对应用对 JDK 版本 与 Servlet/JSP API 的兼容性；必要时调整构建产物与依赖。
• 准备回退方案：保留旧版本目录与备份包，确保异常可快速回滚。

二 标准升级步骤

• 步骤1 停止旧实例
  进入旧版 bin/ 执行：./shutdown.sh；若进程残留，使用 ps + grep 定位并 kill。
• 步骤2 获取新版本
  从 Apache Tomcat 官方下载所需版本压缩包（tar.gz）。
• 步骤3 安装到新目录
  解压到与旧版不同的目录，避免覆盖。
• 步骤4 迁移配置与内容
  复制旧版的 conf/（如 server.xml、web.xml、context.xml）、应用 webapps/、以及自定义目录（如 logs/ 的历史归档、证书等）到新版对应位置；按需调整差异项。
• 步骤5 权限与脚本可执行
  确保 bin/*.sh 具备执行权限：chmod +x bin/*.sh。
• 步骤6 启动与验证
  启动新版：./startup.sh；查看 logs/catalina.out 与 localhost 日志；访问 http://ip:8080 验证；在 bin/ 执行 ./version.sh 确认版本号。

三 小版本与大版本策略

• 小版本就地升级（同大版本，如 8.5.x → 8.5.y）
  可仅替换 lib/ 目录（保留原有 conf/ 与 webapps/），然后启动；适用于修复安全与稳定性问题，风险相对较低。
• 跨大版本升级（如 8 → 9）
  建议全新安装新版本目录，再迁移配置与应用，进行全量回归测试；必要时同时关注 JDK 与依赖库的兼容性变化。

四 使用包管理器或 systemd 的场景

• Debian/Ubuntu 使用 APT 安装
  通过 apt 升级系统包，随后重启服务；注意升级后检查 /etc/tomcat/* 下的配置与应用的兼容性。
• 使用 systemd 管理 Tomcat
  升级后若 CATALINA_HOME 变更，需更新 /etc/systemd/system/tomcat.service 中的环境变量与路径，执行 systemctl daemon-reload，再启动服务。

五 常见问题与回退

• 启动报错 “Cannot find ./catalina.sh … no execute permission”
  执行：chmod +x bin/*.sh。
• 端口冲突
  检查并释放 8080/8005/8009 等端口，或调整 server.xml 中的端口配置。
• 应用启动异常或兼容性问题
  对照新旧 server.xml/web.xml 差异，核对 JDK 与依赖版本；必要时回退到备份版本并重新评估升级计划。
• 快速回退
  停止新版，恢复原目录或备份目录，恢复环境变量（如 CATALINA_HOME），再启动旧版。