Ubuntu下MongoDB如何升级版本

Ubuntu 下 MongoDB 升级指南

一 升级前准备

• 备份数据：使用 mongodump 完整备份，确保可回滚。示例：mongodump --out /path/to/backup。
• 检查运行状态与版本：确认服务在运行且版本符合预期。示例：sudo systemctl status mongod、mongod --version。
• 规划版本路径：MongoDB 官方通常要求按主要版本逐级升级（如 4.4 → 5.0 → 6.0 → 7.0），跨多版本一次性升级可能不被支持。
• 检查兼容性：核对驱动、应用、存储引擎（如 WiredTiger）、认证机制与参数变更。
• 准备回滚方案：保留旧包与数据备份，记录当前配置。
  以上为升级的必要前置动作，可显著降低风险。

二 标准升级步骤（同系列内升级，如 4.4 → 4.4.x）

• 停止服务：sudo systemctl stop mongod
• 导入官方 GPG 密钥（按需选择与你目标版本匹配的密钥）：
  • Ubuntu 20.04（focal）示例密钥：wget -qO - https://www.mongodb.org/static/pgp/server-4.4.asc | sudo apt-key add -
• 添加 MongoDB APT 源（将 <UBUNTU_CODENAME> 替换为你的系统代号，如 focal/jammy；将 替换为目标系列，如 4.4）：
  • 示例：echo "deb [ arch=amd64,arm64 ] https://repo.mongodb.org/apt/ubuntu <UBUNTU_CODENAME>/mongodb-org/<VERSION> multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-<VERSION>.list
• 更新索引并安装目标版本：
  • 安装最新修订版：sudo apt-get update && sudo apt-get install -y mongodb-org
  • 或固定精确版本：sudo apt-get install -y mongodb-org=<VERSION> mongodb-org-server=<VERSION> mongodb-org-shell=<VERSION> mongodb-org-mongos=<VERSION> mongodb-org-tools=<VERSION>
• 启动与验证：sudo systemctl start mongod、sudo systemctl status mongod、mongod --version
• 如升级失败，可用备份恢复：mongorestore /path/to/backup
  以上流程适用于同系列的小版本升级，操作简洁且风险可控。

三 跨主要版本升级（如 4.4 → 5.0 → 6.0 → 7.0）

• 基本原则：按官方支持矩阵逐级升级，每一步都完成备份、版本验证与业务回归后再进行下一步。
• 升级后检查点：
  • 配置项变更：检查 /etc/mongod.conf 中已弃用或行为变更的参数，必要时调整。
  • 功能与驱动：确认应用驱动版本兼容新服务器版本。
  • 复制集/分片：遵循官方滚动升级步骤，逐个节点升级，确保多数派与数据一致性。
• 回滚策略：若某一步异常，使用最近一次备份与旧版本包回滚，再排查问题。
  跨版本升级更敏感，务必在测试环境演练并严格按官方路径执行。

四 常见问题与处理

• 导入 GPG 密钥失败：更换可用镜像源或手动下载并添加密钥，确保网络可达性与密钥匹配目标版本。
• APT 源错误：核对 <UBUNTU_CODENAME> 与 是否匹配（如 focal 对应 4.4 系列），错误的源会导致找不到包。
• 服务无法启动：查看日志 sudo journalctl -u mongod，重点排查配置冲突、权限与存储路径问题。
• 版本未变化：确认 APT 源已切换到目标系列，执行 sudo apt-get update，必要时用 apt-cache policy mongodb-org 检查可用版本。
• 回滚：使用 mongorestore 恢复备份，或在确认无兼容问题后重装旧版本包。
  以上问题在实操中较常见，按日志与版本匹配原则逐一排查通常可快速定位。