Ubuntu下MongoDB如何进行版本升级

Ubuntu 下 MongoDB 版本升级指南

一 升级前准备

• 备份数据：使用 mongodump 完整导出数据，确保可回滚。示例：mongodump --out /path/to/backup-$(date +%F)。
• 检查现状：确认当前 MongoDB 版本 与运行状态。示例：mongod --version、sudo systemctl status mongod。
• 选择策略：优先采用同系列内的小版本就地升级；跨大版本（如 3.x → 4.x、4.x → 5.x、5.x → 6.x、6.x → 7.x）需按官方支持矩阵逐步升级，避免直接跨多代。
• 维护窗口：选择低峰时段执行，准备回滚方案与监控告警。
  以上准备动作（备份、版本检查）是安全升级的必要步骤。

二 就地升级步骤（同系列小版本）

• 导入官方 GPG 密钥（示例为 Ubuntu 20.04 Focal；如使用其他版本，请替换为对应的 Ubuntu 代号，如 jammy、noble）：
  wget -qO - https://www.mongodb.org/static/pgp/server-6.0.asc | sudo apt-key add -
• 添加 MongoDB 官方仓库（以 6.0 为例，按需替换为目标系列）：
  echo "deb [ arch=amd64,arm64 ] https://repo.mongodb.org/apt/ubuntu focal/mongodb-org/6.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-6.0.list
• 更新索引并仅升级包：
  sudo apt-get update
sudo apt-get install --only-upgrade mongodb-org
• 重启服务并验证：
  sudo systemctl restart mongod
mongod --version 或 mongo --eval 'db.version()'（如仍保留旧 shell，可用 mongosh 连接验证）
  该流程适用于同系列的小版本升级，操作简洁且风险可控。

三 跨大版本升级与注意事项

• 升级路径：严格遵循官方支持矩阵进行逐级升级（不建议跨多代）。例如从 4.4 → 5.0 → 6.0 → 7.0 依次进行。
• 兼容性检查：升级前审阅目标版本的兼容性变更、废弃特性与驱动版本要求，必要时先在测试环境验证。
• 配置与特性：部分版本对 WiredTiger 压缩/加密、审计、认证机制等有变更，升级后按需调整配置。
• 监控与回滚：升级后密切监控错误日志、复制延迟、慢查询；若异常，按备份执行回滚。
  跨大版本升级的核心是“路径正确、验证充分、可回滚”。

四 常见问题与处理

• 导入 GPG 失败或仓库 404：确认 Ubuntu 代号 与 MongoDB 系列匹配（如 focal、jammy、noble 与 6.0/7.0 的对应关系），必要时更换为正确的仓库地址。
• 服务无法启动：检查 /var/log/mongodb/mongod.log 的错误信息；常见原因包括 dbPath 权限、配置文件语法、WiredTiger 版本不兼容等。
• 旧系统无 mongodb-org 包：早期系统可能使用 mongodb/mongodb-server 等包名，卸载时可用 sudo apt-get purge mongodb* mongodb-server* mongodb-clients* 清理，再按官方源安装。
• 避免意外升级：如需固定版本，可在升级后用 APT 固定版本号（或谨慎使用 apt-mark hold mongodb-org）。