Linux系统升级MongoDB版本的完整流程

一、升级前的准备工作

1. 备份数据

升级前必须备份所有重要数据，防止操作失误导致数据丢失。常用工具为mongodump，示例命令：
mongodump --out /path/to/backup
备份完成后，验证备份文件的完整性（如检查备份目录是否存在dump文件夹及其中的集合数据）。

2. 检查当前版本与升级路径

使用以下命令查看当前MongoDB版本：
mongod --version
MongoDB不支持跨主要版本升级（如从3.6直接升级到4.2），必须按照官方推荐的顺序逐步升级（例如：3.6→4.0→4.2→…）。可通过MongoDB官方文档确认当前版本的最低升级目标。

3. 阅读兼容性文档

升级前务必查阅目标版本的兼容性更改文档（如MongoDB 4.2的Compatibility Changes），重点关注以下内容：

• 废弃或不兼容的配置选项（如4.2移除了ssl相关选项，需替换为tls）；
• 应用程序驱动的兼容性要求（如驱动需支持目标版本的retryWrites特性）；
• 功能限制（如3.6及之前版本的text/2dsphere索引升级后可能无法降级到2.4）。

4. 测试环境验证

在生产环境升级前，必须在测试环境中模拟升级流程：

• 部署与生产环境一致的MongoDB版本和配置；
• 导入备份数据，运行应用程序的关键功能（如读写、聚合查询、事务）；
• 验证数据一致性和性能是否符合预期。

二、具体升级步骤

1. 停止MongoDB服务

根据系统初始化工具选择对应命令：

• Systemd系统（如Ubuntu 16.04+、CentOS 7+）：
  sudo systemctl stop mongod
• SysVinit系统（如Ubuntu 14.04、CentOS 6）：
  sudo service mongod stop
  停止后，通过ps aux | grep mongod确认进程已终止。

2. 升级MongoDB二进制文件

方式一：通过包管理器升级（推荐）

若通过apt（Debian/Ubuntu）或yum（CentOS/RHEL）安装MongoDB，可直接使用包管理器升级：

• Debian/Ubuntu：

  sudo apt-get update
  sudo apt-get install mongodb-org
  

• CentOS/RHEL：

  sudo yum install mongodb-org
  

包管理器会自动处理依赖关系并保留原有配置。

方式二：手动下载安装

若未使用包管理器，需手动下载目标版本的二进制包（如从MongoDB下载页面获取Linux版本的tgz文件）：

# 下载（以4.4为例）
wget https://fastdl.mongodb.org/linux/mongodb-linux-x86_64-4.4.6.tgz

# 解压
tar -zxvf mongodb-linux-x86_64-4.4.6.tgz

# 替换旧版本二进制文件（假设旧版本在/usr/local/mongodb）
sudo mv mongodb-linux-x86_64-4.4.6 /usr/local/mongodb
sudo ln -sf /usr/local/mongodb/bin/mongod /usr/bin/mongod
sudo ln -sf /usr/local/mongodb/bin/mongo /usr/bin/mongo

手动升级需注意：备份原有配置文件（如/etc/mongod.conf），避免被新版本覆盖。

3. 启动新版本MongoDB

• Systemd系统：
  sudo systemctl start mongod
• SysVinit系统：
  sudo service mongod start
  启动后，通过以下命令检查服务状态：
  sudo systemctl status mongod（或service mongod status）。

4. 验证升级结果

连接到MongoDB实例，检查版本信息：

mongo --eval 'db.version()'

输出应为目标版本（如4.4.6）。进一步验证数据完整性：

mongo --eval 'db.runCommand({connectionStatus: 1})'

确保ok值为1，表示连接正常。

三、升级后的关键操作

1. 更新特性兼容版本（FCV）

FCV（Feature Compatibility Version）决定了MongoDB实例是否支持新版本的功能。升级后需将FCV设置为目标版本：

mongo --eval 'db.adminCommand({setFeatureCompatibilityVersion: "4.4"})'

验证FCV设置：

mongo --eval 'db.adminCommand({getParameter: 1, featureCompatibilityVersion: 1})'

输出应显示"version": "4.4"。

2. 清理旧版本文件（可选）

若升级成功且无回滚需求，可清理旧版本的残留文件：

• 删除旧版本二进制文件（如/usr/bin/mongod旧链接）；
• 清理旧版本配置文件（如/etc/mongod.conf.bak）；
• 删除旧版本数据目录（如/var/lib/mongo旧数据，需确认备份已完成）。

3. 监控系统状态

升级后24小时内密切监控数据库性能（如CPU、内存、磁盘IO）和日志（/var/log/mongodb/mongod.log），重点关注：

• 是否有错误或警告信息；
• 查询延迟是否异常；
• 副本集/分片集群的同步状态（如rs.status()）。

四、常见问题与注意事项

1. 跨版本升级限制

若当前版本与目标版本间隔超过1个主要版本（如从3.6升级到4.4），需逐版本升级（3.6→4.0→4.2→4.4）。例如：

• 先按上述步骤升级到4.0；
• 再升级到4.2；
• 最后升级到4.4。

2. 配置文件兼容性

升级后需检查配置文件（如/etc/mongod.conf）中的选项是否与新版本兼容：

• 移除废弃选项（如ssl相关选项，替换为tls）；
• 更新新版本新增的选项（如tlsMode、tlsCertificateKeyFile）。

3. 回滚准备

升级前需制定回滚方案：

• 保留旧版本的二进制文件和配置文件；
• 确认备份数据的可用性；
• 若升级失败，可通过以下命令快速回退：

  # 停止新版本服务
  sudo systemctl stop mongod
  # 替换回旧版本二进制文件
  sudo mv /usr/local/mongodb.old /usr/local/mongodb
  sudo ln -sf /usr/local/mongodb/bin/mongod /usr/bin/mongod
  # 启动旧版本服务
  sudo systemctl start mongod
  ```。