Upgrade a Replica Set to 8.2将副本集升级到8.2

Upgrade Version Path升级版本路径

To upgrade an existing MongoDB deployment to 8.2, you must be running a 8.0-series release.要将现有的MongoDB部署升级到8.2，您必须运行8.0系列版本。

To upgrade from a version earlier than the 8.0-series, you must successively upgrade major releases until you have upgraded to 8.0-series. 要从早于8.0系列的版本升级，您必须连续升级主要版本，直到升级到8.0系列。For example, if you are running a 7.0-series, you must upgrade first to 8.0 before you can upgrade to 8.2.例如，如果您运行的是7.0系列，则必须先升级到8.0，然后才能升级到8.2。

Check Driver Compatibility检查驱动程序兼容性

Before you upgrade MongoDB, check that you're using a MongoDB 8.2-compatible driver. Consult the driver documentation for your specific driver to verify compatibility with MongoDB 8.2.在升级MongoDB之前，请检查您是否使用了与MongoDB 8.2兼容的驱动程序。请参阅特定驱动程序的驱动程序文档，以验证与MongoDB 8.2的兼容性。

Upgraded deployments that run on incompatible drivers might encounter unexpected or undefined behavior.在不兼容的驱动程序上运行的升级部署可能会遇到意外或未定义的行为。

Preparedness准备

Before beginning your upgrade, see the Compatibility Changes in MongoDB 8.2 document to ensure that your applications and deployments are compatible with MongoDB 8.2. Resolve the incompatibilities in your deployment before starting the upgrade.在开始升级之前，请参阅MongoDB 8.2中的兼容性更改文档，以确保您的应用程序和部署与MongoDB 8.2兼容。在开始升级之前，请解决部署中的不兼容问题。

Before upgrading MongoDB, always test your application in a staging environment before deploying the upgrade to your production environment.在升级MongoDB之前，请务必在将升级部署到生产环境之前，在测试环境中测试您的应用程序。

Downgrade Consideration降级考虑

You cannot downgrade your deployment's binary version without assistance from support.没有支持人员的帮助，您无法降级部署的二进制版本。

All Members Version所有成员版本

All replica set members must be running version 8.0. To upgrade a replica set from 7.0-series and earlier, first upgrade all members of the replica set to the latest 8.0-series release, and then follow the procedure to upgrade from MongoDB 8.0 to 8.2.所有副本集成员都必须运行版本8.0。要从7.0系列和更早版本升级副本集，请首先将副本集的所有成员升级到最新的8.0系列版本，然后按照从MongoDB 8.0升级到8.2的过程进行操作。

Feature Compatibility Version功能兼容性版本

The 8.0 replica set must have featureCompatibilityVersion set to "8.0".8.0副本集必须将featureCompatibilityVersion设置为"8.0"。

To ensure that all members of the replica set have featureCompatibilityVersion set to "8.0", connect to each replica set member and check the featureCompatibilityVersion:为确保副本集的所有成员都将featureCompatibilityVersion设置为"8.0"，请连接到每个副本集成员并检查featureCompatibilityVersion：

db.adminCommand( { getParameter: 1, featureCompatibilityVersion: 1 } )

All members should return a result that includes "featureCompatibilityVersion" : { "version" : "8.0" }.所有成员都应返回包含"featureCompatibilityVersion" : { "version" : "8.0" }的结果。

To set or update featureCompatibilityVersion, run the following command on the primary. A majority of the data-bearing members must be available:要设置或更新featureCompatibilityVersion，请在主服务器上运行以下命令。大多数数据承载成员必须可用：

db.adminCommand( { setFeatureCompatibilityVersion: "8.0" , confirm: true } )

For more information, see setFeatureCompatibilityVersion.有关更多信息，请参阅setFeatureCompatibilityVersion。

Replica Set Member State副本集成员状态

Ensure that no replica set member is in the ROLLBACK or RECOVERING state by issuing the replSetGetStatus command:通过发出replSetGetStatus命令，确保没有副本集成员处于ROLLBACK或RECOVERING状态：

db.adminCommand( { replSetGetStatus: 1 } )

Remove Invalid system.buckets Collections删除无效的system.buckets集合

When you upgrade to 8.3, if you have any system.buckets collections that are not time-series collections, you might need to drop or rename those collections before you upgrade, depending on your 8.0 patch release:升级到8.3时，如果您有任何不是时间序列集合的system.buckets集合，则可能需要在升级之前drop（丢弃）或rename（重命名）这些集合，具体取决于您的8.0补丁版本：

MongoDB 8.0.5 and laterMongoDB 8.0.5及更高版本

You do not need to drop system.buckets collections that aren't time-series collections before you upgrade. However, you must drop or rename them after you complete your upgrade.在升级之前，您不需要删除非时间序列集合的system.buckets集合。但是，您必须在完成升级后删除或重命名它们。

MongoDB 8.0.4 and earlierMongoDB 8.0.4及更早版本

You must drop or rename system.buckets collections that aren't time-series collections before you upgrade. 在升级之前，您必须删除或重命名非时间序列集合的system.buckets集合。All system.buckets collections must have valid time series options configured before you upgrade to versions 8.0.0 - 8.0.4.在升级到版本8.0.0-8.0.4之前，所有system.buckets集合都必须配置有效的时间序列选项。

To determine whether you have system.buckets collections that are not time-series collections, use the db.getCollectionInfos() method with a filter:要确定是否有非时间序列集合的system.buckets集合，请使用db.getCollectionInfos()方法和筛选器：

db.getCollectionInfos(
   {
      $and: [
         { name: { $regex: /^system\.buckets/ } },
         { 'options.timeseries': { $exists: false } }
      ]
   }
)

Use a Package Manager使用包管理器

If you installed MongoDB from the MongoDB apt, yum, dnf, or zypper repositories, you should upgrade to 8.2 using your package manager.如果你从MongoDB apt、yum、dnf或zypper存储库安装了MongoDB，你应该使用包管理器升级到8.2。

Follow the appropriate 8.2 installation instructions for your Linux system. This will involve adding a repository for the new release, then performing the actual upgrade process.按照适用于您的Linux系统的8.2安装说明进行操作。这将涉及为新版本添加一个存储库，然后执行实际的升级过程。

Manually手动地

If you have not installed MongoDB using a package manager, you can manually download the MongoDB binaries from the MongoDB Download Center.如果你没有使用包管理器安装MongoDB，你可以从MongoDB下载中心手动下载MongoDB二进制文件。

See 8.2 installation instructions for more information.有关更多信息，请参阅8.2安装说明。