Debian 上 Tomcat 升级指南

升级前准备

• 明确当前部署方式：是 APT 包管理 还是 手动安装（tar.gz），两者升级路径不同。
• 完整备份：至少备份 $CATALINA_BASE/conf（如 server.xml、context.xml、web.xml）、webapps、以及自定义的 setenv.sh/bin、证书与数据库配置。
• 检查兼容性：确认 Java 与 Tomcat 的版本匹配（如 Tomcat 9 需 JDK 8+，Tomcat 10 需 JDK 11+），并评估应用对 API/规范 的兼容性。
• 选择版本策略：优先选择 稳定版，关注 安全修复 与 发行说明；跨主版本升级（如 9→10）需格外谨慎并充分回归测试。

升级路径一 APT 包管理升级（推荐）

• 更新索引并查看可用版本：
  sudo apt update
  apt-cache policy tomcat9
• 原地升级到指定版本（示例）：
  sudo apt install tomcat9=9.0.56-1~buster
  如需同时升级相关包：sudo apt install tomcat9-admin tomcat9-common tomcat9-user
• 重启服务并验证：
  sudo systemctl restart tomcat9
  sudo systemctl status tomcat9
  curl -I http://localhost:8080/
• 回滚（如出现问题）：
  sudo apt install tomcat9=旧版本号
  说明：具体可用版本号与仓库有关，请以 apt-cache policy 输出为准。

升级路径二 手动安装升级（tar.gz 二进制）

• 停止旧实例：
  sudo systemctl stop tomcat # 或 tomcat9
• 备份与准备目录：
  sudo cp -a /opt/tomcat /opt/tomcat_backup_$(date +%F)
  cd /opt
• 下载并解压新版本（示例为 9.0.x）：
  wget https://downloads.apache.org/tomcat/tomcat-9/v9.0.x/bin/apache-tomcat-9.0.x.tar.gz
  sudo tar -xvf apache-tomcat-9.0.x.tar.gz -C /opt/tomcat --strip-components=1
• 同步配置与目录（按需）：

  仅复制配置与必要目录，避免覆盖新二进制

  sudo cp -a /opt/tomcat_backup_/conf /opt/tomcat/conf
  sudo cp -a /opt/tomcat_backup_/webapps /opt/tomcat/webapps
  sudo cp -a /opt/tomcat_backup_*/bin/setenv.sh /opt/tomcat/bin/ 2> /dev/null || true
• 修正权限（如使用 tomcat 用户）：
  sudo chown -R tomcat:tomcat /opt/tomcat
• 使用符号链接便于下次升级（可选）：
  sudo ln -sfn /opt/tomcat/apache-tomcat-9.0.x /opt/tomcat/latest
• 更新 systemd 单元（若路径变更）：
  sudo systemctl edit --full tomcat.service
  确保 Environment=CATALINA_HOME=/opt/tomcat/latest（或实际路径）
  sudo systemctl daemon-reload
• 启动与验证：
  sudo systemctl start tomcat
  sudo systemctl status tomcat
  tail -n50 /opt/tomcat/logs/catalina.out
  curl -I http://localhost:8080/

升级后验证与常见问题

• 版本与连通性：
  curl -I http://localhost:8080/
  访问管理页面（如启用）验证应用列表与部署状态。
• 日志与故障排查：
  查看 catalina.out、localhost.log*，重点留意 类加载、JDBC 驱动、端口占用（默认 8080）、内存与 GC 配置。
• 防火墙与端口：
  如需外网访问，放行端口（示例）：sudo ufw allow 8080/tcp。
• 回滚方案：
  • APT：sudo apt install tomcat9=旧版本号
  • 手动：将 /opt/tomcat 还原为备份目录，或切回符号链接 /opt/tomcat/latest 指向旧版本。

声明：本文内容由网友自发贡献，本站不承担相应法律责任。对本内容有异议或投诉，请联系2913721942#qq.com核实处理，我们将尽快回复您，谢谢合作！