Ubuntu Tomcat更新如何进行

Ubuntu 上 Tomcat 更新实操指南

一 准备与环境检查

• 确认当前版本与运行状态：
  • 进入安装目录执行：/path/to/tomcat/bin/version.sh
  • 查看进程：ps -ef | grep tomcat
• 检查 Java 是否满足新版本要求（Tomcat 9 需 Java 8+）：java -version
• 规划升级方式：
  • 小版本升级（如 9.0.x → 9.0.y）：建议沿用现有配置与目录结构，风险更低。
  • 大版本升级（如 8 → 9、9 → 10）：需评估应用兼容性、配置差异与废弃项，先在测试环境验证。

二 标准升级步骤（适用于小版本与手动安装版）

• 执行备份：
  • 备份整个安装目录：cp -Rf /opt/tomcat /opt/tomcat-backup
  • 或仅备份关键数据：conf、webapps、logs、work、temp 等
• 停止服务：
  • 脚本方式：/opt/tomcat/bin/shutdown.sh
  • 服务方式：sudo systemctl stop tomcat
• 部署新版本（两种做法，二选一）：
  • 替换目录法：解压新版本到临时目录，将旧目录重命名为 tomcat-old，新目录重命名为原目录名（保持 CATALINA_HOME/CATALINA_BASE 不变，环境变量无需改动）。
  • 符号链接法（推荐）：将新版本解压到如 /opt/tomcat/apache-tomcat-9.0.XX，更新符号链接 /opt/tomcat/latest 指向新目录，避免改动 systemd 或环境变量。
• 迁移配置与数据（小版本升级常用）：
  • 仅复制必要的配置：cp -Rf /opt/tomcat-backup/conf/* /opt/tomcat/conf/
  • 迁移应用：cp -Rf /opt/tomcat-backup/webapps/* /opt/tomcat/webapps/
  • 可选迁移日志：cp -Rf /opt/tomcat-backup/logs/* /opt/tomcat/logs/
  • 提升安全性（可选）：删除默认应用 rm -rf /opt/tomcat/webapps/{docs,examples,manager,host-manager}
• 权限与启动：
  • 赋权：chmod +x /opt/tomcat/bin/*.sh
  • 启动：/opt/tomcat/bin/startup.sh 或 sudo systemctl start tomcat
• 验证：
  • 查看版本：/opt/tomcat/bin/version.sh
  • 查看日志：tail -f /opt/tomcat/logs/catalina.out
  • 访问应用与 /manager/status 检查运行状态。

三 使用 APT 安装时的更新方式

• 若通过 Ubuntu 仓库安装（如版本 8.5），优先使用包管理器：
  • 更新索引并升级：sudo apt update && sudo apt upgrade
  • 重启服务：sudo systemctl restart tomcat
• 注意：发行版仓库版本通常较官方 Apache 版本滞后，如需最新特性与安全修复，建议使用官方二进制包并采用“符号链接法”升级。

四 回滚与常见问题处理

• 快速回滚（替换目录法）：
  • 停止新版本：/opt/tomcat/bin/shutdown.sh 或 sudo systemctl stop tomcat
  • 恢复原目录：rm -rf /opt/tomcat && mv /opt/tomcat-old /opt/tomcat
  • 启动旧版本：/opt/tomcat/bin/startup.sh 或 sudo systemctl start tomcat
• 常见问题与要点：
  • 端口冲突：检查 server.xml 中的 Connector port（默认 8080）
  • 启动失败：查看 catalina.out 与 localhost..log 定位类加载、JAR 冲突、权限等问题
  • 应用未生效：确认应用已部署到 webapps，且未置于 ROOT 之外的子目录而访问路径错误
  • JVM 不匹配：确认 JAVA_HOME 指向合适的 JDK 8/11/17 等版本
  • 安全建议：升级后及时删除 docs/examples/manager/host-manager，并为管理接口配置强口令与访问控制。