Ubuntu上WebLogic更新与升级指南

Ubuntu上 WebLogic 更新与升级指南

一 升级路径与准备

• 明确目标与范围：区分是补丁更新（Service Pack、Rolling Patch、PSU/CPU）还是版本升级（如 11g → 12c(12.2.x)，或 12c → 14c(14.1.x)）。不同路径步骤差异很大。
• 版本与 JDK 对齐：WebLogic 与 JDK 版本强相关，例如 12.2.1.4 常用 JDK 8u333；安装/升级前确认目标版本所需的 JDK 已就位并配置好 JAVA_HOME。
• 应用兼容性评估：升级前使用 WebLogic Migration Analysis Tool 扫描应用，识别已移除/弃用的 API；必要时结合 OpenRewrite 进行代码迁移，减少运行时异常。
• 规划与回滚：梳理变更窗口、回滚策略与验证用例；准备完整备份（域目录、应用、配置、密钥库、数据库）与快照（物理机/虚拟机/WSL）。

二 标准升级流程

• 准备阶段：
  • 停止整个应用环境的所有 Server/NodeManager/AdminServer（先停托管服务器，再停管理服务器）。
  • 完整备份：至少备份 $DOMAIN_HOME、安装目录、数据源配置、启动脚本、证书与密钥库、外部存储配置等。
• 应用评估与改造：
  • 使用 weblogic.migration-analysis-tool.jar 扫描 WAR/EAR，修复编译期/运行期不兼容问题；必要时用 OpenRewrite 批量迁移。
• 执行升级：
  • 补丁更新（Service Pack/滚动补丁）：遵循官方工具流程（如 Smart Update/bsu），注意不同版本工具与限制。
  • 版本升级（跨主版本）：安装新版本 Oracle Home，使用 WLST 创建/更新域，迁移应用与资源配置，再逐步启动验证。
• 启动与验证：
  • 按序启动 AdminServer → NodeManager → 受管服务器，核对日志、线程、数据源、JMS、集群、安全提供程序等关键组件状态。
• 回滚预案：出现阻塞问题时，优先回滚到已备份的 域/安装 快照，缩短恢复时间。

三 补丁更新步骤

• 11g（WebLogic 10.3.x）使用 Smart Update（bsu.sh）：
  • 进入 BEA_HOME/utils，执行 ./bsu.sh 启动 GUI；在界面中选择 Service Pack/Rolling Patch，按向导下载并安装。
  • 重要限制：不支持热安装，必须在停机窗口进行；安装前建议卸载冲突/旧补丁，安装后重启。
• 12c（12.1.3/12.2.x）使用 OPatch：
  • 下载匹配 Oracle Home 与 JDK 的 OPatch 与补丁 ZIP；设置 ORACLE_HOME/WL_HOME 与 PATH。
  • 检查互操作性：opatch lsinventory；预检：opatch prereq -oh $ORACLE_HOME -phBaseDir /path/patches；实施：opatch apply；回滚：opatch rollback -id 。
• 通用要点：
  • 全程停机；先备份 $ORACLE_HOME 与 $DOMAIN_HOME；在测试环境验证补丁后再上生产；保留补丁说明与变更记录。

四 跨版本升级步骤

• 安装新版本 Oracle Home：在 Ubuntu 上以 非 root 用户解压/静默安装 12c/14c 安装包（示例：java -jar fmw_*.jar -silent -responseFile … -invPtrLoc …），确保 JDK 版本满足要求。
• 域迁移与重建：
  • 建议在新 Oracle Home 下使用 WLST 创建新域，再通过 pack/unpack 迁移应用与配置，或参考官方域模板/配置向导逐步迁移。
  • 升级 JDBC 驱动、JMS 持久化、集群通信、安全领域 等关键配置，校验启动参数与资源引用。
• 应用部署与验证：
  • 先部署核心应用进行冒烟测试，再分批上线；核对 类加载、数据源连接池、事务、JMX/MBean、日志 等。
• 回滚：保留旧 Oracle Home 与 域备份，异常时切回并恢复备份。

五 Ubuntu 与 WLS 注意事项及常见问题

• 运行身份与权限：创建专用 weblogic 用户进行安装/运行，避免 root 直接运行，目录权限设置为 weblogic:weblogic。
• JDK 与安装器：
  • 多数 12c 版本建议使用 JDK 8；安装器可能对 OpenJDK 不兼容，优先使用 Oracle JDK。
  • 静默安装时可通过命令行显式指定 JDK：/usr/local/jdk1.8.0_333/bin/java -jar fmw_*.jar -silent …
• 交换空间：安装程序对 swap 有要求（常见需 ≥ 512MB）；不足时创建并启用 swapfile，否则安装可能失败。
• 图形与环境：
  • Smart Update 早期版本需要 Java GUI；在 Ubuntu Server/无头环境 建议使用 X11 转发 或改用 OPatch 进行补丁管理。
  • 多用户/切换用户时，确认 JAVA_HOME 与 PATH 指向正确的 JDK，避免调用到系统自带 OpenJDK。
• 回滚与验证：任何步骤失败优先回滚到已备份的 域/安装；升级后通过控制台与日志逐项验证服务可用性。