怎样升级Ubuntu的Tomcat版本

Ubuntu 上升级 Tomcat 的实操指南

一、升级前准备

• 明确升级路径：优先在同系列做小版本升级（如：8.5.x → 8.5.y、9.0.x → 9.0.y），跨大版本（如：8 → 9、9 → 10）属于迁移，配置与应用兼容性需充分验证。Tomcat 10+ 实现的是 Jakarta EE 规范，而 9 及更早实现的是 Java EE 规范，API 包名从 javax. 变为 jakarta.**，可能导致应用编译或运行失败。建议先在测试环境验证。
• 检查当前环境：
  • 查看版本：在 $CATALINA_HOME/bin 执行：./version.sh（或 version.bat）。
  • 查看 Java：java -version。Tomcat 9 要求 Java 8+，生产常用 OpenJDK 11。
• 备份关键数据：完整备份 conf/、webapps/、以及必要的 lib/、自定义脚本与证书等；记录当前 server.xml 关键配置（端口、连接器、Realm、Valve 等）。
• 规划停机窗口与回滚方案：准备回滚包或将旧目录重命名留存，确保出现异常可快速恢复。

二、标准升级步骤（适用于二进制安装，/opt/tomcat 或 /usr/local 常见）

• 下载新版本：前往 Apache Tomcat 下载页，选择合适的小版本，使用 wget 下载到 /tmp。示例（请替换为最新小版本号）：
  • wget https://dlcdn.apache.org/tomcat/tomcat-9/v9.0.93/bin/apache-tomcat-9.0.93.tar.gz -P /tmp
• 停止服务：
  • 若以服务运行：sudo systemctl stop tomcat
  • 若以脚本运行：$CATALINA_HOME/bin/shutdown.sh
• 备份与替换：
  • 备份旧目录：cp -a $CATALINA_HOME $CATALINA_HOME-backup-$(date +%F)
  • 解压新版本到同级目录：tar -xf /tmp/apache-tomcat-9.0.93.tar.gz -C /opt/
  • 方案 A（推荐，便于下次升级）：使用符号链接
    • 建立链接：sudo ln -sfn /opt/apache-tomcat-9.0.93 /opt/tomcat/latest
    • 保持现有配置与数据：确保新目录权限与旧版一致（见下节权限设置）
  • 方案 B（替换目录）：
    • 重命名旧目录：mv $CATALINA_HOME $CATALINA_HOME-old
    • 重命名新目录：mv /opt/apache-tomcat-9.0.93 $CATALINA_HOME
• 恢复配置与业务：
  • 仅复制必要目录：conf/、webapps/（必要时 logs/ 用于保留历史日志）。
  • 删除新包自带的默认应用（提升安全性）：docs、examples、manager、host-manager。
• 权限设置：
  • 若使用 tomcat 系统用户：sudo chown -R tomcat:tomcat $CATALINA_HOME
  • 可执行脚本：sudo chmod +x $CATALINA_HOME/bin/*.sh
• 启动与验证：
  • 启动：sudo systemctl start tomcat 或 $CATALINA_HOME/bin/startup.sh
  • 查看日志：tail -f $CATALINA_HOME/logs/catalina.out
  • 访问应用与 /manager/status，确认版本与运行状态。

三、使用 systemd 管理时的注意事项

• 若采用“符号链接”方式（如 /opt/tomcat/latest），确保 Environment=CATALINA_HOME/CATALINA_BASE 指向该链接路径，避免升级后服务指向旧目录。
• 升级后执行：sudo systemctl daemon-reload（若修改了单元文件则必需），再启动服务。
• 示例关键环境变量（按实际路径调整）：
  • Environment=“JAVA_HOME=/usr/lib/jvm/java-11-openjdk-amd64”
  • Environment=“CATALINA_HOME=/opt/tomcat/latest”
  • Environment=“CATALINA_BASE=/opt/tomcat/latest”

四、跨大版本迁移要点（如 9 → 10 或 8 → 9）

• 规范与包名变化：Tomcat 10+ 为 Jakarta EE，包名由 javax.servlet 等变为 jakarta.servlet 等。若应用包含编译期依赖（如 Maven），需相应升级依赖版本并重新编译；运行期需确保类路径中没有残留旧版 javax 包。
• 连接器与协议：检查 server.xml 中的 HTTP/1.1 与 AJP 连接器配置、SSL/TLS 配置是否兼容新版本默认行为。
• 逐项回归测试：登录认证、会话管理、过滤器/监听器、JSP 编译、文件上传、Websocket、第三方框架（如 Spring）版本匹配等。

五、回滚与验证清单

• 快速回滚：
  • 停止新版本：sudo systemctl stop tomcat
  • 方案 A（符号链接）：将链接指回旧版本目录（ln -sfn /opt/tomcat-old /opt/tomcat/latest），再启动
  • 方案 B（替换目录）：删除新目录，mv $CATALINA_HOME-old $CATALINA_HOME，再启动
• 验证要点：
  • 版本：执行 version.sh，确认 Server version 与 JVM Version
  • 应用：登录、核心业务流、管理页（如 /manager/status）、日志无异常堆栈
  • 端口与连接器：确认 8080/8005/8009 等端口监听正常，无端口冲突
  • 安全：删除或限制默认应用，检查 users 与访问权限配置