将分片群集升级到 3.6

在本页面

• 升级建议和清单

• Prerequisites

• 下载 3.6 二进制文件

• Upgrade Process

• 其他升级步骤

如果您需要有关升级到 3.6 的指导，请MongoDB 提供主要版本升级服务帮助确保平稳过渡而不会中断您的 MongoDB 应用程序。

升级建议和清单

升级时，请考虑以下事项：

升级版本路径

要将现有的 MongoDB 部署升级到 3.6，必须运行 3.4 系列发行版。

要从 3.4 系列之前的版本升级，必须连续升级主要版本，直到升级到 3.4 系列为止。例如，如果您运行的是 3.2 系列，则必须在首先升级到 3.4 之前才能升级到 3.6.

Preparedness

开始升级之前，请参阅MongoDB 3.6 中的兼容性更改文档，以确保您的应用程序和部署与 MongoDB 3.6 兼容。开始升级之前，请解决部署中的不兼容性。

在升级 MongoDB 之前，请务必先在临时环境中测试应用程序，然后再将升级部署到生产环境中。

Downgrade Consideration

升级到 3.6 后，如果需要降级，我们建议downgrading升级到最新的 3.4 补丁程序。

默认绑定到 localhost

从 MongoDB 3.6 开始，默认情况下mongod和mongos实例绑定到 localhost。远程 Client 端(包括副本集的其他成员)无法连接到仅绑定到 localhost 的实例。要覆盖并绑定到其他 IP 地址，请使用net.bindIp配置文件设置或--bind_ip命令行选项来指定 IP 地址列表。

如果分片群集成员在其他主机上运行，或者希望远程 Client 端连接到分片群集，则升级过程将要求您指定net.bindIp设置(或--bind_ip)。

有关更多信息，请参见Localhost 绑定兼容性更改

分片副本集

从 MongoDB 3.6 开始，具有分片服务器角色的mongod实例必须是副本集成员。

要将分片群集升级到版本 3.6，分片服务器必须作为副本集运行。要将现有的分片独立实例转换为分片副本集，请参见将分片独立版转换为分片副本集。

Drivers

对于 MongoDB 3.6.0-3.6.3 二进制文件，只有在升级 MongoDB 二进制文件并将分片群集的功能兼容版本更新为 3.6 之后，才应将驱动程序升级为3 .6 功能兼容的驱动程序。

有关更多信息，请参见SERVER-33763。

阅读关注多数

从 MongoDB 3.6 开始，MongoDB 默认情况下启用对"majority"读取关注的支持。

但是，对于 MongoDB 3.6.1-3.6.x，您可以禁用读取关注"majority"，以防止存储高速缓存压力使具有主从仲裁器(PSA)架构的部署固定下来。禁用"majority"读取关注也将禁用对Change Streams的支持

有关更多信息，请参见禁用多数阅读关注。

Prerequisites

• • 3.4 版或更高版本

  • 要将分片群集升级到 3.6，群集的所有成员必须至少为 3.4 版。升级过程将检查群集的所有组件，如果任何组件运行的版本早于 3.4，将产生警告。

• • 功能兼容版本

  • 3.4 分片群集必须将featureCompatibilityVersion设置为3.4。

为了确保分片群集的所有成员都将featureCompatibilityVersion设置为3.4，请连接到每个分片副本集成员和每个配置服务器副本集成员，并检查featureCompatibilityVersion：

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

所有成员都应返回包含"featureCompatibilityVersion": "3.4"的结果。

要设置或更新featureCompatibilityVersion，请在mongos上运行以下命令：

db.adminCommand( { setFeatureCompatibilityVersion: "3.4" } )

有关更多信息，请参见setFeatureCompatibilityVersion。

• • Shard Aware

  • 3.4 分片群集中的分片必须是分片感知的(即，分片必须已收到位于admin.system.version集合中的shardIdentity文档)：

• 对于以 3.4 开始的分片群集，分片是分片感知的。

  • 对于从 3.2 系列升级的 3.4 分片群集，当您将featureCompatibilityVersion从3.2更新到3.4时，配置服务器会尝试每 30 秒发送一次分片各自的shardIdentity文档，直到成功。您必须等到所有分片都收到文档为止。

  • 要检查分片副本集成员是否已收到其shardIdentity文档，请对admin数据库中的system.version集合发出find命令，并在"_id" : "shardIdentity"中检查文档。

有关shardIdentity文档的示例：

{
  "_id" : "shardIdentity",
  "clusterId" : ObjectId("2bba123c6eeedcd192b19024"),
  "shardName" : "shard2",
  "configsvrConnectionString" : "configDbRepl/alpha.example.net:28100,beta.example.net:28100,charlie.example.net:28100" }

• 禁用平衡器

• • 备份config数据库

  • *可选，但建议.*作为预防措施，在升级分片群集之前，请备份config数据库。

下载 3.6 二进制文件

使用软件包 Management 器

如果从 MongoDB apt，yum，dnf或zypper存储库安装了 MongoDB，则应使用程序包 Management 器升级到 3.6.

遵循适用于您的 Linux 系统的3 .6 安装说明。这将涉及为新版本添加存储库，然后执行实际的升级过程。

手动下载 3.6 Binaries

如果尚未使用包 Management 器安装 MongoDB，则可以从MongoDB 下载中心手动下载 MongoDB 二进制文件。

有关更多信息，请参见3 .6 安装说明。

Upgrade Process

禁用平衡器。

将mongoShell 连接到分片群集中的mongos实例，然后运行sh.stopBalancer()以禁用平衡器：

sh.stopBalancer()

要验证是否禁用了平衡器，请运行sh.getBalancerState()，如果禁用了平衡器，则返回 false：

sh.getBalancerState()

有关禁用平衡器的更多信息，请参阅禁用平衡器。

升级配置服务器。

• 一次升级一个副本集的secondary个成员：

• 关闭辅助mongod实例，并将 3.4 二进制文件替换为 3.6 二进制文件。

  • 从--configsvr，--replSet和--port启动 3.6 二进制文件。包括部署使用的任何其他选项。

mongod --configsvr --replSet <replSetName> --port <port> --dbpath <path> --bind_ip localhost,<ip address>

如果使用configuration file，则更新文件以指定sharding.clusterRole: configsvr，replication.replSetName，net.port和net.bindIp，然后启动 3.6 二进制文件：

sharding:
   clusterRole: configsvr
replication:
   replSetName: <string>
net:
   port: <port>
   bindIp: localhost,<ip address>
storage:
   dbpath: <path>

包括适用于您的部署的任何其他设置。

• await 该成员恢复到SECONDARY状态，然后再升级下一个辅助成员。要检查成员的状态，请在mongo shell 中发出rs.status()。

对每个次要成员重复上述步骤。

• 降级主副本集。

• 将mongoShell 连接到主要数据库，并使用rs.stepDown()降低主要数据库并强制选择新的主要数据库：

rs.stepDown()

• 当rs.status()显示主要数据库已降级，而另一个成员已处于PRIMARY状态时，请关闭已降级的主要数据库并将mongod二进制文件替换为 3.6 二进制文件。

• 使用--configsvr，--replSet，--port和--bind_ip选项启动 3.6 二进制文件。包括先前部署使用的所有可选命令行选项：

mongod --configsvr --replSet <replSetName> --port <port> --dbpath <path> --bind_ip localhost,<ip address>

如果使用configuration file，则更新文件以指定sharding.clusterRole: configsvr，replication.replSetName，net.port和net.bindIp，然后启动 3.6 二进制文件：

sharding:
   clusterRole: configsvr
replication:
   replSetName: <string>
net:
   port: <port>
   bindIp: localhost,<ip address>
storage:
   dbpath: <path>

包括适合您的部署的任何其他配置。

升级碎片。

一次升级一个碎片。

对于每个分片副本集：

• 一次升级一个副本集的secondary个成员：

• 关闭mongod实例，并将 3.4 二进制文件替换为 3.6 二进制文件。

  • 使用--shardsvr，--replSet，--port和--bind_ip选项启动 3.6 二进制文件。包括先前部署使用的所有可选命令行选项：

mongod --shardsvr --replSet <replSetName> --port <port> --dbpath <path> --bind_ip localhost,<ip address>

如果使用configuration file，请将文件更新为包括sharding.clusterRole: shardsvr，replication.replSetName，net.port和net.bindIp，然后启动 3.6 二进制文件：

sharding:
   clusterRole: shardsvr
replication:
   replSetName: <string>
net:
   port: <port>
   bindIp: localhost,<ip address>
storage:
   dbpath: <path>

包括适合您的部署的任何其他配置。

• await 该成员恢复到SECONDARY状态，然后再升级下一个辅助成员。要检查成员的状态，您可以在mongo shell 中发出rs.status()。

对每个次要成员重复上述步骤。

• 降级主副本集。

将mongoShell 连接到主要数据库，并使用rs.stepDown()降低主要数据库并强制选择新的主要数据库：

rs.stepDown()

• 当rs.status()显示主要数据库已卸任，另一个成员已处于PRIMARY状态时，请升级已卸任的主要数据库：

• 关闭逐步降低的主数据库，并将mongod二进制文件替换为 3.6 二进制文件。

  • 使用--shardsvr，--replSet，--port和--bind_ip选项启动 3.6 二进制文件。包括先前部署使用的所有可选命令行选项：

mongod --shardsvr --replSet <replSetName> --port <port> --dbpath <path> --bind_ip localhost,<ip address>

如果使用configuration file，则更新文件以指定sharding.clusterRole: shardsvr，replication.replSetName，net.port和net.bindIp，然后启动 3.6 二进制文件：

sharding:
   clusterRole: shardsvr
replication:
   replSetName: <string>
net:
   port: <port>
   bindIp: localhost,<ip address>
storage:
   dbpath: <path>

包括适合您的部署的任何其他配置。

升级 mongos 实例。

用 3.6 二进制文件替换每个mongos实例，然后重新启动。包括适合您的部署的任何其他配置。

mongos --configdb csReplSet/<rsconfigsver1:port1>,<rsconfigsver2:port2>,<rsconfigsver3:port3> --bind_ip localhost,<ip address>

重新启用平衡器。

使用 3.6 mongo shell，连接到集群中的mongos并运行sh.setBalancerState()重新启用均衡器：

sh.setBalancerState(true)

3.4 和更早版本的mongo shell 与 3.6 群集不兼容。

有关重新启用平衡器的更多信息，请参阅启用平衡器。

启用向后不兼容的 3.6 功能。

此时，您可以在没有 3.6 不兼容的功能和 3.4 的情况下运行 3.6 二进制文件。也就是说，您可以运行功能兼容版本设置为 3.4 的 3.6 分片群集

要启用这些 3.6 功能，请将功能兼容版本(FCV)设置为 3.6.

在mongos实例上，在admin数据库中运行setFeatureCompatibilityVersion命令：

db.adminCommand( { setFeatureCompatibilityVersion: "3.6" } )

此命令必须执行对内部系统集合的写入。如果由于某种原因该命令未成功完成，则可以安全地在mongos上重试该命令，因为该操作是幂等的。

重新启动 mongos 实例。

更改featureCompatibilityVersion之后，需要重新启动所有mongos实例以获取因果一致性行为中的更改。

其他升级步骤

• 要升级独立版本，请参阅将独立版本升级到 3.6。

• 要升级副本集，请参阅将副本集升级到 3.6。