Tomcat升级在Linux上要注意什么

Linux 上 Tomcat 升级注意事项

一 升级前准备

• 备份关键数据与配置：完整备份安装目录（如 /usr/local/tomcat）、单独备份 conf/（端口、用户、连接器）、以及 webapps/ 下的业务应用；备份命令示例：cp -r /usr/local/tomcat /usr/local/tomcat_backup_$(date +%Y%m%d)。同时确认当前版本：/usr/local/tomcat/bin/version.sh。升级前务必先停止服务：systemctl stop tomcat 或 bin/shutdown.sh。检查 JDK 是否满足目标 Tomcat 要求（如 Tomcat 10 需 JDK 8+，Tomcat 11 需 JDK 11+），避免版本不兼容导致启动失败。为降低风险，准备可回滚方案（保留旧目录，失败可快速恢复）。

二 版本选择与安装方式

• 选择目标版本与安装方式：离线安装（下载官方 tar.gz，可精确指定版本，适合无网或需特定版本）；在线安装（使用 yum/dnf/apt，操作简单但版本受仓库限制）。注意不同发行版目录结构差异：例如 yum/dnf 常见路径为 /usr/share/tomcat、/etc/tomcat、/var/lib/tomcat/webapps、/var/log/tomcat；apt 常见路径为 /usr/share/tomcat9、/etc/tomcat9、/var/lib/tomcat9/webapps、/var/log/tomcat9。跨大版本升级（如 8→10）可能存在配置不兼容，需参考官方迁移文档逐项比对修改，不要直接覆盖 conf/。运行安全：不要用 root 启动 Tomcat，建议创建 tomcat 普通用户并赋权运行。

三 配置迁移与兼容性

• 迁移策略：新解压的实例是默认配置，需将旧版的 conf/（如 server.xml 端口、tomcat-users.xml 用户、web.xml 编码/过滤器）、以及业务 webapps/ 逐一迁移；优先“对比后迁移”，跨大版本避免整目录覆盖。权限与用户：确保新目录属主为 tomcat 用户（chown -R tomcat:tomcat /usr/local/tomcat），否则可能因权限不足导致无法写入日志或部署失败。连接器与端口：如 8080/8009/8005 被占用或需并行运行多实例，先在 server.xml 调整端口后再启动。应用兼容性：升级后若出现 404/启动失败，优先检查应用的 Servlet/JSP 规范与依赖库是否与新版本 Tomcat 兼容，并结合 catalina.out、localhost.log 定位问题（常见为配置差异、依赖冲突或部署方式变化）。

四 启动验证与回滚

• 启动与验证：启动服务（systemctl start tomcat 或 bin/startup.sh），确认状态为 active (running)；查看版本：/usr/local/tomcat/bin/version.sh；访问测试：本地 curl http://localhost:8080 或远程浏览器访问；检查日志：tail -f logs/catalina.out，确保无 ERROR/SEVERE。网络与防火墙：若远程无法访问，放行 8080（firewalld：firewall-cmd --zone=public --add-port=8080/tcp --permanent && firewall-cmd --reload；ufw：ufw allow 8080/tcp）。回滚预案：升级异常时，快速恢复旧版——停止新实例、删除新目录、恢复备份目录并启动旧服务（示例：systemctl stop tomcat；rm -rf /usr/local/tomcat；mv /usr/local/tomcat_backup_20240520 /usr/local/tomcat；systemctl start tomcat）。