JSP项目在Debian上的迁移指南

JSP项目在Debian上的迁移指南

一 迁移前评估与准备

• 明确当前运行环境：记录源环境的 Java 版本（如 OpenJDK 8/11/17）、Tomcat 版本（如 8.5/9/10）、是否使用 Apache httpd 前置反向代理/负载均衡、JSP/Servlet 规范级别、依赖库与数据库驱动（JDBC）、JNDI 资源配置、文件编码与目录结构。
• 梳理应用特性：是否使用 连接池（HikariCP/DBCP）、会话粘性、SSL/TLS、缓存、日志框架、定时任务、文件上传限制、第三方组件（如 POI、PDFBox）等。
• 准备迁移包与清单：源码或已构建的 WAR、数据库 DDL/DML 脚本、配置文件（如 context.xml、server.xml、web.xml、logging.properties）、环境变量、启动/停止脚本、初始化数据与环境差异说明。
• 规划目标环境：选择 Debian 稳定版与合适的 OpenJDK 与 Tomcat 版本；尽量保持版本一致以减少兼容风险；准备相同目录布局与权限模型；制定回滚方案与验收用例。

二 目标环境搭建

• 安装 Java
  • 更新索引并安装 JDK（示例为 OpenJDK 11）：
    • sudo apt update
    • sudo apt install openjdk-11-jdk
  • 验证：java -version；如需设置 JAVA_HOME，可写入 /etc/environment：JAVA_HOME=“/usr/lib/jvm/java-11-openjdk-amd64”，然后 source 使其生效。
• 安装 Tomcat（两种常用方式）
  • 方式 A（系统包，便于管理）：sudo apt install tomcat9（或 tomcat10）；部署 WAR 至 /var/lib/tomcat9/webapps/，通过 systemd 管理：sudo systemctl start|stop|restart|enable tomcat9。
  • 方式 B（官方二进制，便于多实例/自定义）：下载并解压至 /opt，创建专用用户与目录权限，配置 systemd 服务单元（示例见下文），使用 startup.sh/shutdown.sh 或 systemctl 启停。

三 数据与应用迁移

• 数据库迁移
  • 在目标库执行 DDL 建库建表；导入 DML 初始化数据；校验字符集（建议 UTF-8）、时区与排序规则；更新 JDBC URL/驱动类名/账号密码；若使用连接池，核对连接池参数与最大连接数。
• 应用部署
  • 将应用打包为 WAR 并复制到 Tomcat 的 webapps 目录（系统包常见路径：/var/lib/tomcat9/webapps/；二进制安装常见路径：/opt/tomcat/webapps/），Tomcat 会自动解压部署；或配置 Host 的 appBase/webapps 与 Context 指向你的应用目录。
• 配置迁移与差异处理
  • 迁移并校对 context.xml（数据源 JNDI、资源引用、环境条目）、server.xml（端口、连接器、AJP/HTTP）、web.xml（过滤器/监听器/欢迎页/MIME）、日志与 JVM 参数；如原系统使用 Apache httpd + mod_jk/mod_proxy_ajp 前置，需在目标环境按相同方式配置并核对 workers.properties/AJP 端口 8009。

四 前后端接入与网络配置

• 仅 Tomcat 直出：应用默认通过 8080 端口访问；如需修改端口，编辑 server.xml 的 Connector 端口；如需外网访问，开放防火墙端口（如 sudo ufw allow 8080）。
• Apache httpd 前置（推荐用于静态资源与统一入口）
  • 方案 1（mod_jk）：安装 libapache2-mod-jk，配置 workers.properties（worker.list=worker1；worker.worker1.type=ajp13；host=localhost；port=8009），在 Apache 启用 jk 模块并重启；AJP 使用 8009 端口与 Tomcat 通信。
  • 方案 2（mod_proxy_ajp）：在 Apache 虚拟主机中使用 ProxyPass/ProxyPassReverse 将指定路径代理到 ajp://127.0.0.1:8009/your-app。

五 启动验证 监控与回滚

• 启动与验证
  • 启动服务：sudo systemctl start tomcat9（或 systemctl start tomcat）；访问 http://服务器IP:8080/ 与 http://服务器IP:8080/your-app 验证首页与关键业务流；查看 catalina.out 与应用日志定位问题。
• 运行监控与维护
  • 使用 systemd 管理生命周期（enable 开机自启、restart 自动恢复）；定期检查 /opt/tomcat/logs/ 或 /var/log/tomcat9/ 的日志；必要时用 JConsole/VisualVM 做性能与内存监控；定期更新 Java 与 Tomcat 获取安全修复。
• 常见问题与回滚
  • 端口冲突：检查 8080/8009 是否被占用并调整；权限问题：确保 Tomcat 专用用户对安装与日志目录具备读写权限；JSP 无法编译：确认 JDK 安装与 JAVA_HOME 配置；依赖缺失：补齐 JDBC 驱动与第三方 JAR；回滚：保留旧实例与旧 WAR，切换反向代理/负载配置指向旧版本，确认无误后再下线。