如何更新Ubuntu Tomcat版本

Ubuntu 更新 Tomcat 版本实操指南

一 升级前准备

• 确认当前版本与运行方式：查看版本号（如 /opt/tomcat/bin/version.sh），确认是通过脚本还是 systemd 服务运行（如 sudo systemctl status tomcat）。
• 检查 JDK 兼容性：Tomcat 10.x 需要 JDK 11+；Tomcat 8.5/9.0 支持 JDK 8+。
• 备份关键数据与配置：建议完整备份安装目录和应用数据（如 /opt/tomcat），至少备份 conf/（如 server.xml、tomcat-users.xml）、webapps/、以及必要的 logs/。
• 选择升级策略：同系列小版本升级（如 9.0.x → 9.0.y）可直接沿用配置；跨主版本（如 8.5 → 9.0 或 9.0 → 10.0）需评估 Servlet/JSP 规范差异与配置变更，先在测试环境验证。

二 标准升级步骤

1. 停止当前实例
   • 脚本方式：执行 /opt/tomcat/bin/shutdown.sh；
   • 服务方式：执行 sudo systemctl stop tomcat。
2. 备份与重命名旧目录
   • 备份：sudo tar -zcvf /opt/tomcat-backup-$(date +%F).tar.gz /opt/tomcat；
   • 重命名：sudo mv /opt/tomcat /opt/tomcat-old。
3. 下载并解压新版本（示例为 9.0.93，可按需替换版本）
   • 下载：wget https://dlcdn.apache.org/tomcat/tomcat-9/v9.0.93/bin/apache-tomcat-9.0.93.tar.gz；
   • 解压：sudo tar -zxvf apache-tomcat-9.0.93.tar.gz -C /opt/；
   • 重命名：sudo mv /opt/apache-tomcat-9.0.93 /opt/tomcat。
4. 迁移配置与业务
   • 配置：sudo cp -R /opt/tomcat-old/conf/ /opt/tomcat/conf/*；
   • 应用：sudo cp -R /opt/tomcat-old/webapps/ /opt/tomcat/webapps/*；
   • 可选日志：sudo cp -R /opt/tomcat-old/logs/ /opt/tomcat/logs/*（便于问题追溯）。
5. 权限与脚本可执行
   • sudo chmod +x /opt/tomcat/bin/*.sh。
6. 启动与验证
   • 启动：脚本方式 /opt/tomcat/bin/startup.sh；服务方式 sudo systemctl start tomcat；
   • 版本核验：/opt/tomcat/bin/version.sh 或访问 http://服务器IP:8080；
   • 日志排查：tail -f /opt/tomcat/logs/catalina.out。
7. 可选安全加固
   • 删除默认示例与管理应用：docs、examples、manager、host-manager（如不需要）。

三 作为 systemd 服务运行时的注意事项

• 若使用 systemd，确保 /etc/systemd/system/tomcat.service 中的 JAVA_HOME、CATALINA_HOME、CATALINA_BASE、ExecStart/ExecStop 等路径与新版本一致；修改后执行 sudo systemctl daemon-reload。
• 示例关键片段（路径按实际调整）：
  • Environment=JAVA_HOME=/usr/lib/jvm/java-11-openjdk-amd64
  • Environment=CATALINA_HOME=/opt/tomcat
  • Environment=CATALINA_BASE=/opt/tomcat
  • ExecStart=/opt/tomcat/bin/startup.sh
  • ExecStop=/opt/tomcat/bin/shutdown.sh
• 启动与验证：sudo systemctl start tomcat、sudo systemctl status tomcat。

四 回滚与常见问题

• 快速回滚（出现异常时）
  • 停止新版本：/opt/tomcat/bin/shutdown.sh 或 sudo systemctl stop tomcat；
  • 恢复原目录：sudo rm -rf /opt/tomcat && sudo mv /opt/tomcat-old /opt/tomcat；
  • 启动旧版本并核验。
• 常见问题处理
  • 端口占用：检查 conf/server.xml 中的 Connector port=“8080”，必要时调整；
  • 无法正常关闭：使用 ps aux | grep tomcat 定位进程，必要时 kill （谨慎操作）；
  • 权限问题：确保运行用户（如 tomcat）对 /opt/tomcat 及子目录具备合适权限；
  • 应用启动失败：对比新旧 conf/ 差异，查看 catalina.out 与应用的专有日志。