Ubuntu Tomcat升级步骤详细解析

作者：袖梨 2026-06-25

Ubuntu 下 Tomcat 升级步骤详解

Ubuntu Tomcat升级步骤详解

一 升级前准备

  • 确认当前版本与运行方式查看版本：在 $CATALINA_HOME/bin 执行 ./version.sh；如通过服务运行，使用 systemctl status tomcat 或 service tomcat status 确认服务名与运行状态。
  • 核对 Java 与版本兼容性Ubuntu 20.04/22.04 常见 OpenJDK 11/17/21。Tomcat 与 JDK 存在对应关系：例如 Tomcat 10.1.x 不再支持 JDK 8，若仍在 JDK 8，应优先选择 Tomcat 9.0.x；升级前务必确认应用与 JDK 的兼容性。
  • 规划目录与服务账户建议将 Tomcat 安装在 /opt/tomcat 或 /usr/local/apache-tomcat，运行用户使用专用的 tomcat 系统账号，便于权限与审计管理。
  • 备份关键数据完整备份 $CATALINA_HOME（或使用 tar 归档），重点包括 conf/、webapps/、logs/，以及自定义的 setenv.sh/bin/setenv.bat、证书与外部依赖配置。

二 标准升级流程

  • 下载并校验新版本从官网下载对应系列的 Core 版本 .tar.gz，使用 sha512sum 校验完整性，避免传输损坏。
  • 停止旧实例优雅停止：$CATALINA_HOME/bin/shutdown.sh；如为服务：systemctl stop tomcat。必要时检查并清理残留进程。
  • 备份与重命名旧目录示例：
    • 备份：tar -zcvf /opt/backup/tomcat-$(date +%F).tar.gz -C /opt/tomcat .
    • 重命名：mv /opt/tomcat /opt/tomcat-old
  • 部署新版本解压到目标路径（保持与旧版本一致便于无缝切换）：
    • 示例：tar xzvf apache-tomcat-9.0.93.tar.gz -C /opt
    • 若希望目录即为 /opt/tomcat，可使用 –strip-components=1 直接解压到该目录。
  • 迁移配置与业务仅迁移必要内容：
    • 配置：conf/（建议先备份新版的 server.xml 再覆盖）
    • 应用：webapps/（优先复制你的业务 WAR/目录，避免覆盖新版的默认应用）
    • 可选：logs/（便于问题追溯）
    • 安全加固：删除或限制访问 docs、examples、manager、host-manager 等默认应用。
  • 权限与服务单元设置目录与脚本权限：chown -R tomcat:tomcat /opt/tomcat；chmod +x /opt/tomcat/bin/*.sh。如使用 systemd，确保 /etc/systemd/system/tomcat.service 中的 JAVA_HOME、CATALINA_HOME、CATALINA_BASE、User/Group 等指向新路径。
  • 启动与验证启动：systemctl start tomcat 或 $CATALINA_HOME/bin/startup.sh；查看日志：tail -f logs/catalina.out；访问应用与 /manager/status 校验运行状态与线程、内存等关键指标。

三 版本选择与兼容性要点

  • 版本矩阵建议
    • JDK 8：选择 Tomcat 9.0.x（Tomcat 10.1+ 不支持 JDK 8）
    • JDK 11/17/21：选择 Tomcat 10.1.x 或 Tomcat 9.0.x（优先 10.1.x 获取安全修复与新特性）
  • 系列内与跨系列升级
    • 同系列小版本升级（如 9.0.x → 9.0.y）通常可直接沿用 conf/ 与 webapps/。
    • 跨系列升级（如 9 → 10）需评估 JDK 要求、Servlet/JSP 规范变更、废弃/移除特性 与应用的兼容性，先在测试环境验证再上线。
  • 常见兼容性报错出现 “could not create the Java virtual machine” 或启动异常，优先检查 JDK 版本是否满足目标 Tomcat 的要求，再排查内存参数与环境变量。

四 回滚与常见问题处理

  • 快速回滚停止新实例 → 删除新目录 → 恢复原目录（如 mv /opt/tomcat-old /opt/tomcat）→ 启动旧实例；回滚后核对 conf/ 与应用版本是否被意外覆盖。
  • 常见问题速查
    • 端口占用：检查 server.xml 的 Connector port，以及 netstat -tulpen | grep 8080；必要时调整端口或停用占用进程。
    • 启动失败：优先查看 catalina.out 与 localhost..log，定位类加载、JDBC 驱动、内存参数等问题。
    • 权限问题：确保 tomcat 用户对 $CATALINA_HOME 及子目录具备 读/执行 权限，日志目录可写。
    • 管理端访问：如需使用 /manager 与 /host-manager，请在 tomcat-users.xml 配置角色与强密码，并在对应 META-INF/context.xml 中限制 RemoteAddrValve 的访问网段。

相关文章

精彩推荐