Linux WebLogic版本升级注意点

Linux 上 WebLogic 版本升级注意点

一 规划与兼容性

• 明确升级路径：区分是补丁/维护包还是小版本升级，两者的步骤与风险不同。
• 做兼容性矩阵：核对目标 WebLogic 版本与操作系统版本（如 CentOS 7/8）、JDK 版本、中间件/驱动（JDBC、JMS、Web 服务器插件）等的兼容性。
• 评估应用影响：梳理应用使用的API/特性是否在新版本中弃用或变更，必要时提前改造。
• 制定回滚方案：包括全量备份、快照、回滚脚本与演练计划，确保可快速恢复。
• 变更窗口与通知：选择低峰时段，提前通知业务方与上下游系统。
• 参考官方升级指南并按要求准备响应文件与清单文件（如 wls.rsp、oraInst.loc）。

二 备份与回滚

• 全量备份：优先备份域目录（user_projects/domains）、安装目录（Oracle/Middleware）、应用归档（WAR/EAR）、数据源与密钥库、以及数据库与配置文件（config.xml、setDomainEnv.sh 等）；虚拟化环境建议同时做快照。
• 备份验证：在测试环境恢复演练，确认备份可用。
• 回滚触发条件：升级失败、健康检查不通过、关键业务异常、严重兼容性问题等。
• 回滚操作：按既定流程停止服务→恢复备份/快照→启动验证，并保留回滚原因与影响范围记录。

三 停启与补丁策略

• 标准停启顺序：先停止应用，再停止受管服务器，最后停止管理服务器；启动则反向进行。
• 集群环境优先滚动升级：逐台升级并重启受管服务器，其余节点保持对外服务，显著降低停机时间；升级完成后重启管理服务器。
• 补丁管理：使用 OPatch 安装补丁，遵循“停服务→打补丁→验证→再下一台”的节奏，严格检查补丁与 WebLogic/JDK 的兼容性。
• 旧版本提示：WebLogic 10.3.x 使用 bsu.sh 管理补丁，切勿与 OPatch 混用。

四 配置与验证

• 环境准备：使用专用 weblogic 用户/用户组与最小权限；正确设置 JAVA_HOME/WL_HOME 与库路径；必要时调整 ulimit/nofile 等系统参数。
• 配置核查：升级后核对 config.xml、startWebLogic.sh/setDomainEnv.sh、数据源、JMS、SSL/TLS、字符集（如 UTF-8）等关键配置是否生效。
• 启动与连通：按顺序启动后，先检查节点管理状态、数据源连接池、应用部署状态，再做端到端功能与性能回归。
• 日志与监控：实时关注 server.log、diagnostics.log 等日志，结合监控告警验证线程、JVM、连接数、GC等指标是否正常。

五 常见风险与排查要点

• 字符编码问题：中文或特殊字符出现乱码时，统一检查JVM 启动参数（-Dfile.encoding=UTF-8）、应用与数据库字符集设置。
• JDBC/驱动不兼容：升级后连接失败/性能下降，优先核对JDBC 驱动版本与连接池参数是否匹配新版本要求。
• 应用兼容性：出现类找不到/方法不存在/行为变更，回看新版本弃用清单与API 变更，必要时调整代码或依赖。
• 补丁冲突：多补丁叠加导致启动失败/功能异常，按官方说明卸载并重装指定补丁顺序。
• 回滚失败：备份不完整或清单/响应文件路径错误，导致恢复异常；务必在演练中验证备份与回滚脚本的可用性。