/ /

/ /

降级8.3 将副本集设置为8.0

重要

MongoDB 8.3 是最新的次要发布。从MongoDB 8.2 开始，针对特定使用案例的本地部署部署（社区和 EA）可使用次要版本。有关更多信息，请参阅 MongoDB版本控制。

要安装支持本地部署使用的最新MongoDB版本，请参阅安装说明。

尝试降级之前，请先熟悉本页面的内容。

降级路径

重要

升级或降级副本集之前，请确保所有副本集节点都正在运行。否则，升级或降级操作将在所有节点启动后才会完成。

如果您需要从8.3降级，请降级到8.0的最新补丁发布。

MongoDB仅支持相邻版本的单版本降级。您无法降级到发布当前发布落后多个版本的版本。

对于任何版本，无论是主要版本还是次要版本，都可以升级或降级到其相邻的邻居。示例，您可以从 8.3 降级到 8.2，或从 7.0升级到 8.0。
对于所有版本，无论是主要版本还是次要版本，您都可以降级到上一个主要版本。示例，从 8.3 到 8.0。
对于任何次要版本，您都可以升级到立即的下一个版本。示例，从 8.2 到 8.3。

访问控制

如果副本集启用了访问控制，则降级用户权限必须包括跨数据库列出和托管索引的权限。具有 root角色的用户拥有所需的权限。

先决条件

在开始降级程序之前，必须完成以下先决条件步骤。

创建备份

可选但建议使用。创建数据库备份。

要学习；了解如何创建备份，请参阅自托管部署的备份方法。

删除向后不兼容的功能

要从8.3 降级到8.0 ，您必须删除与8.3 8.0不兼容的功能。有关不兼容功能的列表以及如何删除这些功能，请参阅降级注意事项。

降级功能兼容版本（fCV）

要降级副本集的 FCV ：

确保没有正在进行任何初始同步。在初始同步进行时运行setFeatureCompatibilityVersion命令会导致初始同步重新启动。
确保所有节点的副本集配置中都没有newlyAdded字段。在副本集中的每个节点上运行以下命令以验证这一点：
```
use local
db.system.replset.find( { "members.newlyAdded" : { $exists : true } } );
```
newlyAdded字段仅在初始同步期间和初始同步后不久出现在节点的副本集配置文档中。
确保没有副本集成员处于ROLLBACK或RECOVERING状态。
使用 mongosh连接到您的主节点 (primary node in the replica set)。
将 featureCompatibilityVersion 降级为 "8.0"。
重要
在降级二进制版本之前，请确认您已删除所有向后不兼容的功能。在继续之前，请务必评估您的升级路径。
```
db.adminCommand( { setFeatureCompatibilityVersion: "8.0", confirm: true } )
```
setFeatureCompatibilityVersion命令对内部系统collection执行写入，并且是幂等的。如果该命令未成功完成，请在主节点上重试该命令。
要确保副本集的所有节点都有更新的featureCompatibilityVersion ，请连接到每个副本集节点并检查featureCompatibilityVersion ：
db.adminCommand( { getParameter: 1, featureCompatibilityVersion: 1 } )
"featureCompatibilityVersion" : { "version" : "8.0" }
如果任何成员返回"8.3"的featureCompatibilityVersion ，请等待该成员返回版本"8.0" ，然后再继续。

有关返回的featureCompatibilityVersion值的详细信息，请参阅获取 FeatureCompatibilityVersion。

降级程序

警告

在继续执行降级过程之前，请确保所有副本集节点（包括延迟的副本集节点）都有先决条件更改。为此，请在降级之前检查featureCompatibilityVersion并删除每个节点的不兼容功能。

下载最新的 8.0 二进制文件

使用包管理器或手动下载，获取最新版本的 8.0。如果使用包管理器，请为 8.0 二进制文件添加新的存储库，然后执行实际的降级进程。

重要

在升级或降级集群之前，请确保所有集群节点都正在运行。否则，升级或降级将在所有节点启动后才能完成。

如果您需要从8.3降级，请降级到8.0的最新补丁发布。

将 8.3 二进制文件替换为下载的 8.0 二进制文件

确保 8.0 二进制文件位于您的系统路径中。要确认二进制版本，运行以下命令：

mongod --version

命令输出应显示 8.0发布。

降级从节点(secondary node from replica set)副本集

降级副本集的每个从节点，一次一个：

关闭节点。
要关闭mongod进程，请使用mongosh连接到从节点并运行以下命令：
```
db.adminCommand( { shutdown: 1 } )
```
重新启动成员。
要启动 mongod 进程，请运行以下命令：
```
mongod --dbpath </path-to-data-folder>
```
如需了解有关启动 mongod 进程的更多信息，请参阅“启动 mongod 进程”。
等待成员进入SECONDARY状态。
在降级下一个从从节点(secondary node from replica set)之前，请等待该成员恢复到SECONDARY状态。要检查成员的状态，请使用 mongosh 中的rs.status()方法
当成员处于SECONDARY阶段后，降级下一个从节点。

仲裁节点副本集成员降级

如果副本集不包含仲裁节点，请跳过此步骤。

降级副本集的仲裁节点：

关闭节点。
要关闭仲裁节点，请使用mongosh连接到仲裁节点并运行以下命令：
```
db.adminCommand( { shutdown: 1 } )
```
删除仲裁节点数据目录的内容。
要查找仲裁节点mongod的数据目录，请检查storage.dbPath配置设置或--dbpath命令行选项。
运行以下命令：
```
rm -rf /path/to/mongodb/datafiles/*
```
重新启动仲裁节点。
要启动 mongod 进程，请运行以下命令：
```
mongod --dbpath </path-to-mongodb-datafiles>
```
如需了解有关启动 mongod 进程的更多信息，请参阅“启动 mongod 进程”。
等待成员进入ARBITER状态。
在将主节点降级之前，请等待该成员恢复到ARBITER状态。要检查成员的状态，请使用 mongosh 中的rs.status()方法

降级主节点 (primary node in the replica set)

从主节点降级。
在mongosh中，使用rs.stepDown()退出主节点并强制执行正常的故障转移过程。
```
rs.stepDown()
```
验证主节点是否已降级。
运行以下命令：
```
rs.status()
```
验证主节点是否已降级以及其他节点是否已进入PRIMARY状态。
替换并重新启动以前的主mongod 。
1. 关闭节点。
  要关闭主节点，请使用mongosh连接到主节点并运行以下命令：
  db.adminCommand( { shutdown: 1 } )
2. 使用8.0二进制文件重新启动mongod 。
  要启动 mongod 进程，请运行以下命令：
  mongod --dbpath </path-to-mongodb-datafiles>
  如需了解有关启动 mongod 进程的更多信息，请参阅“启动 mongod 进程”。

后退

独立运行的实例

来年

分片集群