在更改部署的 MongoDB 版本之前，请检查以下文档，了解任何注意事项或兼容性问题：
- MongoDB 发布说明
- 驱动程序的文档。
- MongoDB 兼容性矩阵
在预定义的维护窗口内计划版本更改。
在更改生产环境之前，请更改过渡环境中的 MongoDB 版本。过渡环境应反映生产环境。这有助于避免可能导致生产部署停机的兼容性问题。
执行副本集和分片集群的手动升级时，请遵循 MongoDB 发布说明。

注意

降级限制

无法对 MongoDB 部署进行以下降级：

从版本 5.0 到 4.4.0 之前的任何版本

MongoDB 版本的备份注意事项

要了解有关备份注意事项的更多信息，请参阅备份注意事项。

如果您选择使用"featureCompatibilityVersion" : 4.2升级到 MongoDB 4.2，Cloud Manager 会显示一个模态窗口，要求您同意 MongoDB, Inc. 授予的使用 MongoDB Enterprise 进行备份的特殊许可。

引擎加密

重要

MongoDB 在 MongoDB 4.2中删除了对 MMAPv 1存储引擎的支持。如果您编辑部署的配置以将存储引擎更改为WiredTiger 存储引擎，Cloud Manager 将重新启动 MongoDB 进程。

如果您运行或升级到MongoDB 3.0或更高版本并修改MongoDB存储引擎， Cloud Manager将关闭并重新启动MongoDB进程。对于多成员副本集， Cloud Manager对每个成员执行滚动初始同步。

如果托管有足够的磁盘空间， Cloud Manager会在从一种存储引擎迁移到另一种存储引擎的过程中创建备份目录。如果磁盘空间不足，则不会进行备份。迁移完成后， Cloud Manager不会删除备份目录。您可以保留或删除以前的备份目录。备份目录位于 mongod的数据目录中。

例子

如果数据目录为/data/process ，则备份将为/data/process.bak.UNIQUENAME 。 UNIQUENAME是 Cloud Manager 生成的随机字符串。

在更改独立运行实例或副本集的存储引擎之前，必须授予自动化对MongoDB数据目录父目录的写入访问权限。更新存储引擎时，代理会在父目录中创建数据的临时备份。独立运行实例上的存储引擎更改还需要足够的磁盘空间来执行完整的/mongodump和/mongorestore 。在存储引擎配置更改后，此磁盘空间将恢复到实例。 Cloud Manager不会删除备份目录。

您无法更改配置服务器上的存储引擎。有关存储引擎的更多信息，请参阅MongoDB手册中的存储引擎。

固定属性

创建部署后，无法修改以下设置：

database path
bind_ip分配了MongoDB进程的主机名、port 或

您可以修改以下部署设置：

log path 在进程级别
高级选项

部署拓扑结构

您可以在部署拓扑结构的所有级别（包括子进程）进行修改。

要修改拓扑或进程，请使用本教程或更具体的教程之一：

项目级修改

影响部署的某些修改发生在项目级别。以下更改会影响项目中的每个 MongoDB 进程。对于这些更改，请使用指定的教程：

要为部署启用TLS ，请参阅为部署启用 TLS。
要为部署启用身份验证，请参阅为 Cloud Manager 项目启用身份验证。
要为部署添加或修改 MongoDB 用户和角色，请参阅管理 MongoDB 用户。

多重修改

您可以将多项修改合并到一个部署中。

例子

在单击Review Changes按钮之前，您可以进行以下所有修改：

将 MongoDB 的最新稳定版本添加到“添加自定义构建”中。
为部署的 MongoDB 进程启用TLS 。
添加一个运行上述最新稳定版本 MongoDB 的新分片集群。

当您单击Review Changes时，审核会在一个屏幕上显示所有更改，供您在部署之前确认。

强制重新配置

仅适用于副本集和分片集群

当您将Force Reconfigure复制设置设置为Yes时，MongoDB Agent可以强制副本集接受新配置。仅强制重新配置以将副本集从其少数成员可用的状态恢复。

警告：强制重新配置副本集可能会导致多数提交写入操作回滚。

请谨慎操作。如果您对此操作的潜在影响有任何疑问，请联系 MongoDB 支持团队。

提示

MongoDB手册中的“重新配置具有不可用成员的副本集”。

删除分片

仅适用于分片集群

删除分片，该分片的任何未分片数据库都将使用movePrimary 命令移动到剩余分片。

在分片移除过程中，所有分片集合均会保持在线并可用。但是，在 movePrimary 操作期间向未分片的集合发送的读取和写入操作则可能会导致意外行为，其中包括迁移失败或数据丢失。

我们建议在删除主分片之前移动包含未分片集合的任何数据库的主节点。

要学习；了解有关删除分片的更多信息，请参阅从现有分片集群中删除分片。

删除多个副本集成员

您可以一次删除或迁移多个副本集成员，但必须保留大多数投票成员。如果需要删除更多投票成员，请一次删除一个。

例子

示例 1

您有一个四节点副本集。所有节点都是有投票权的成员。您只能删除一个节点，这会保留四个投票节点中三个的多数。您可以稍后从剩余的三节点副本集中删除另一个节点。这会保留大多数剩余投票节点。

例子

示例 2

您有一个四节点副本集。三个节点为有投票权成员，一个节点为无投票权成员。您可以同时删除一名有投票权成员和一名无投票权成员。这保留了三个投票节点中两个的多数。

要了解有关投票的更多信息，请参阅副本集高可用性和副本集选举。

先决条件

您的部署必须运行与 Cloud Manager 兼容的自动化版本。如果您的部署未运行兼容版本的代理，Cloud Manager 会显示横幅，提示您更新代理。

步骤

选择要编辑的部署类型：

在MongoDB Cloud Manager中，转到项目的 Processes 页面。

如果尚未显示，请从导航栏上的 Organizations 菜单中选择包含所需项目的组织。
如果尚未显示，请从导航栏的Projects菜单中选择所需的项目。
在侧边栏中，单击 Database 标题下的 Processes。

显示“进程”页面。

在列出部署项的行上，单击Modify 。

修改独立运行的实例设置。

Standalone Settings部分包含以下配置设置：

设置	说明
Hostname	Cloud Manager部署 `mongod` 的主机名。此主机名可以是主机名、FQDN、IPv4解决或 IPv6解决。您只能在Cloud Manager自动化下部署到主机。有关将服务器添加到Cloud Manager自动化的完整文档，请参阅预配服务器以实现自动化。
Port	指定 `mongod`进程的 IANA 端口号。此设置对应于 `net.port` 配置文件选项。默认为 `27017`。 `mongod`必须具有对指定端口的独占访问权限。如果将多个`mongod` 进程部署到单个托管，则必须为每个进程选择一个唯一的未使用端口。
Version	选择进程的MongoDB服务器版本。`mongod` Version 选择进程的MongoDB服务器版本。`mongod`
Auth Schema Version	选择用于存储用户的模式，用于存储部署的用户数据。如果您要从早于的MongoDB版本升级，3.0 MongoDB3.0 + 将对用户数据使用与以前版本不同的模式。有关兼容性信息，请参阅MongoDB. 30发布说明中的安全更改。
Feature Compatibility Version	`Feature Compatibility Version`选择部署的。如果您的部署运行MongoDB.3 4或更高版本， Cloud Manager会显示此字段。
Log File	指定 `mongod` 日志文件的完整路径，包括日志文件名和扩展名。此设置对应于 `systemLog.path` 配置文件选项。`mongod` 必须具有读取和写入指定文件的权限。示例，指定`/var/log/mongodb/mongo.log` 会指示在`mongod` 中将其日志文件存储为`/var/log/mongodb/` `mongo.log`。 `mongod` 必须有自己独特的日志文件。如果在同一主机上部署多个 `mongod` 进程，请确保每个 `mongod` 都具有自己独特的日志文件。

修改高级配置选项。

Advanced Configuration Options（高级配置选项）部分允许您为部署中的每个 MongoDB 进程设置 MongoDB 运行时选项。

要添加选项：

单击 Add Option（连接）。
单击 Select a Startup Option（选择启动选项），然后选择配置选项。
Cloud Manager 显示上下文相关输入，用于为所选选项配置可接受的值。
单击Add将所选选项及其相应的值添加到流程中。

有关可用 Advanced Configuration Options（高级配置选项）的说明，请参阅 MongoDB 部署的高级选项。

单击 Save（保存并关闭）。

Cloud Manager 会将您重定向到Deployment页面，您必须在该页面中查看更改，然后才能部署更新的配置。

单击Review & Deploy 查看更改。

单击Confirm & Deploy 以部署更改。

否则，请单击 Cancel，您可以进行其他更改。

在MongoDB Cloud Manager中，转到项目的 Processes 页面。

如果尚未显示，请从导航栏上的 Organizations 菜单中选择包含所需项目的组织。
如果尚未显示，请从导航栏的Projects菜单中选择所需的项目。
在侧边栏中，单击 Database 标题下的 Processes。

显示“进程”页面。

在列出部署项的行上，单击Modify 。

修改集群范围的设置。

Replica Set Configuration（副本集配置）部分包含以下集群范围的配置设置。

设置	说明
Auth Schema Version	选择用于存储用户的模式，用于存储部署的用户数据。如果您要从早于的MongoDB版本升级，3.0 MongoDB3.0 + 将对用户数据使用与以前版本不同的模式。有关兼容性信息，请参阅MongoDB. 30发布说明中的安全更改。
Feature Compatibility Version	`Feature Compatibility Version`选择部署的。如果您的部署运行MongoDB.3 4或更高版本， Cloud Manager会显示此字段。
Replica Set Settings	显示与副本集关联的每个进程的进程表。您可以配置每个进程的 MongoDB Server 版本、数据目录和日志路径。
Process Name	`mongod`进程的主机名和端口。此主机名可以是主机名、FQDN、IPv4解决或 IPv6解决。 Cloud Manager最初会将每个进程分组在副本集名称下。单击副本集名称左侧的显示副本集集中的所有 `mongod` 进程。 Cloud Manager 会将为副本集配置的任何设置应用于其所有关联进程。
Version	选择进程的MongoDB服务器版本。`mongod` Version 选择进程的MongoDB服务器版本。`mongod`
Log File	指定 `mongod` 日志文件的完整路径，包括日志文件名和扩展名。此设置对应于 `systemLog.path` 配置文件选项。`mongod` 必须具有读取和写入指定文件的权限。示例，指定`/var/log/mongodb/mongo.log` 会指示在`mongod` 中将其日志文件存储为`/var/log/mongodb/` `mongo.log`。 `mongod` 必须有自己独特的日志文件。如果在同一主机上部署多个 `mongod` 进程，请确保每个 `mongod` 都具有自己独特的日志文件。

配置每个副本集节点。

Cloud Manager在Member Configuration部分的MongoD Settings标题下列出每个副本集节点。每个副本集节点都有以下可配置选项：

设置	说明
Member	从菜单中选择以下副本集节点角色之一： `Default` 副本集承载数据的节点，可以成为主节点，在选举中投票。投票节点副本集的非数据承载节点，可以在选举中投票。对应于`arbiterOnly` 副本配置选项。 Hidden 副本集承载数据的节点，可以在选举中投票。对应于`hidden` 副本配置选项。延迟隐藏副本集承载数据的节点，可以在选举中投票。对应于`secondaryDelaySecs` 和`hidden` 副本配置选项。
Hostname	从菜单中选择 Cloud Manager Automation 将副本集节点部署到的主机。该菜单仅列出 Cloud Manager Automation 下的主机。有关向 Cloud Manager Automation 添加服务器的完整文档，请参阅预配服务器以实现自动化。此主机名可以是主机名、FQDN、IPv4解决或 IPv6解决。
Port	指定 `mongod`进程的 IANA 端口号。此设置对应于 `net.port` 配置文件选项。默认为 `27017`。 `mongod`必须具有对指定端口的独占访问权限。如果将多个`mongod` 进程部署到单个托管，则必须为每个进程选择一个唯一的未使用端口。
Votes	指定副本集成员在选举期间拥有的票数。此设置对应于`votesmongod` 副本集配置选项。
Priority	指定节点在选举期间的优先级。优先级为 `0` 的副本集节点无法成为主节点，也无法 trigger 选举。此设置对应于 `priority` `mongod` 副本集配置选项。
Delay	指定“落后”的秒数该成员应该“滞后”的主节点 (primary node in the`secondaryDelaySecsmongod` replica set)。此设置对应于副本集配置选项。
Build Indexes	`truemongod`指定以指示构建索引。此设置对应于`buildIndexesmongod` 副本集配置选项。
Tags	指定与副本集关联的标签或多个标签。此设置对应于`tagsmongod` 副本集配置选项。有关副本集标签的完整文档，请参阅副本集标签
Add a Mongod	添加额外的`mongod` 进程作为副本集成员。添加新的 `mongod` 进程也会更新 Replica Set Configuration 部分中的进程列表。您必须配置新进程的 Version、Data Directory 和 Log File。

配置复制设置。

Replication Settings（复制设置）部分包含副本集的以下配置选项：

设置	说明
Protocol Version	选择副本集使用的复制协议版本。此设置对应于`protocolVersion` 副本集配置选项。有关更多信息，请参阅副本集协议版本。
Chaining Allowed	指定`true` 以允许从从节点(secondary node from replica set)从其他从从节点(secondary node from replica set)复制。此设置对应于副本集配置选项。`chainingAllowed`
Write Concern Majority Journal Default	`{w:"majority"}`如果写关注（write concern）未显式指定日志选项`j` ，则确定写关注（write`writeConcernMajorityJournalDefault` concern）的行为。此设置对应于副本集配置选项。
Heartbeat Timeout (secs)	指定副本集节点等待彼此成功心跳的秒数。此设置对应于 `heartbeatTimeoutSecs` 副本集配置选项。
Election Timeout (ms)	指定检测副本集主节点 (primary node in the replica`electionTimeoutMillis` set)无法访问的时间限制（以毫秒为单位）。此设置对应于副本集配置选项。
CatchUp Timeout (ms)	指定新选出的主节点(primary node in`catchUpTimeoutMillis` the replica set)与可能有更多近期写入操作的其他副本集成员同步或赶上的时间限制（以毫秒为单位）。此设置对应于副本集配置选项。
CatchUp Takeover Delay (ms)	指定节点在确定其领先于当前主节点 (primary node in the replica`catchUpTakeoverDelayMillis` set)后等待启动追赶接管的时间（以毫秒为单位）。此设置对应于副本集配置选项。
Last Error Defaults	指定副本集的默认写关注（write concern）。仅当写入操作或`getLastError` 未指定其他写关注（write concern）时，副本集才会使用此写关注（write concern）。如果未设置此选项，则副本集的默认写关注只需要主节点的确认。以文档的形式指定此选项，即 `{"w":2}`。
Force Reconfigure	指定要强制重新配置副本集。当设置为 `Yes`（是）时，即使其大多数节点不可用，MongoDB 助手也会强制副本集接受新配置。警告：强制重新配置副本集可能会导致多数提交写入操作回滚。请谨慎操作。如果您对此操作的潜在影响有任何疑问，请联系 MongoDB 支持团队。要学习；了解更多信息，请参阅MongoDB Server手册中的重新配置具有不可用成员的副本集。

修改高级配置选项。

单击 Save（保存并关闭）。

Cloud Manager会将您重定向到部署页面，您必须在其中查看更改，然后才能部署更新的配置。

单击Review & Deploy 查看更改。

单击Confirm & Deploy 以部署更改。

否则，请单击 Cancel，您可以进行其他更改。

在MongoDB Cloud Manager中，转到项目的 Processes 页面。

如果尚未显示，请从导航栏上的 Organizations 菜单中选择包含所需项目的组织。
如果尚未显示，请从导航栏的Projects菜单中选择所需的项目。
在侧边栏中，单击 Database 标题下的 Processes。

显示“进程”页面。

在列出部署项的行上，单击Modify 。

配置集群范围的设置。

Cluster Configuration（副本集配置）部分包含以下集群范围的配置设置。

设置	说明
Shard Name Prefix	指定集群中每个分片的前缀。 Cloud Manager使用`<prefix_n>` 格式命名集群中的每个分片，其中`n` 是一个以0 为索引、单调递增的整数。
Auth Schema Version	选择用于存储用户的模式，用于存储部署的用户数据。如果您要从早于的MongoDB版本升级，3.0 MongoDB3.0 + 将对用户数据使用与以前版本不同的模式。有关兼容性信息，请参阅MongoDB. 30发布说明中的安全更改。
Feature Compatibility Version	`Feature Compatibility Version`选择部署的。如果您的部署运行MongoDB.3 4或更高版本， Cloud Manager会显示此字段。
Process Name	与分片集群关联的 `mongod` 或`mongos` 的主机名和端口。此主机名可以是主机名、FQDN、IPv4解决或 IPv6解决。 Cloud Manager将`mongod` 进程分组在其父副本副本集名称下，并将`mongos` mongoses进程分组在下。然后， Cloud Manager将所有集群组件分组在集群名称下。单击分组左侧的可列出其子组或进程。修改分组的任何可用设置都会更改其子组和进程中的相应值。对于运行 MongoDB 3.0 或更早版本的集群，Cloud Manager 会将配置服务器 `mongod` 进程分组到 configServers 之下。
Version	选择`mongod` 或`mongos` 进程的MongoDB服务器版本。 Version 选择`mongod` 或`mongos` 进程的MongoDB服务器版本。
Log File	指定`mongod` 或`mongos` 日志文件的完整路径，包括日志文件名和扩展名。此设置对应于`systemLog.path` 配置文件选项。`mongod` 或`mongos` 必须具有读取和写入指定文件的权限。例如，指定 `/var/log/mongodb/mongo.log` 会指示 `mongod` 或 `mongos` 将其日志文件以 `mongo.log` 的形式存储到 `/var/log/mongodb/` 中。 `mongod`或`mongos` 必须有自己唯一的日志文件。如果将多个`mongod` 或`mongos` 进程部署到同一托管，请确保每个`mongod` 或`mongos` 都有自己不同的日志文件。

配置集群中的每个分片。

Member ConfigurationShard Settings在部分中，单击打开分片配置选项。 Cloud Manager列出集群中的每个分片以及与该分片关联的mongod 进程。每个分片进程都有以下选项。无法修改灰显的选项：

设置	说明
Member	从菜单中选择以下副本集节点角色之一： `Default` 副本集承载数据的节点，可以成为主节点，在选举中投票。投票节点副本集的非数据承载节点，可以在选举中投票。对应于`arbiterOnly` 副本配置选项。 Hidden 副本集承载数据的节点，可以在选举中投票。对应于`hidden` 副本配置选项。延迟隐藏副本集承载数据的节点，可以在选举中投票。对应于`secondaryDelaySecs` 和`hidden` 副本配置选项。
Hostname	从菜单中选择 Cloud Manager Automation 将副本集节点部署到的主机。该菜单仅列出 Cloud Manager Automation 下的主机。有关向 Cloud Manager Automation 添加服务器的完整文档，请参阅预配服务器以实现自动化。此主机名可以是主机名、FQDN、IPv4解决或 IPv6解决。
Port	指定 `mongod`进程的 IANA 端口号。此设置对应于 `net.port` 配置文件选项。默认为 `27017`。 `mongod`必须具有对指定端口的独占访问权限。如果将多个`mongod` 进程部署到单个托管，则必须为每个进程选择一个唯一的未使用端口。
Votes	指定副本集成员在选举期间拥有的票数。此设置对应于`votesmongod` 副本集配置选项。
Priority	指定节点在选举期间的优先级。优先级为 `0` 的副本集节点无法成为主节点，也无法 trigger 选举。此设置对应于 `priority` `mongod` 副本集配置选项。
Delay	指定“落后”的秒数该成员应该“滞后”的主节点 (primary node in the`secondaryDelaySecsmongod` replica set)。此设置对应于副本集配置选项。
Build Indexes	`truemongod`指定以指示构建索引。此设置对应于`buildIndexesmongod` 副本集配置选项。
Tags	指定与副本集关联的标签或多个标签。此设置对应于`tagsmongod` 副本集配置选项。有关副本集标签的完整文档，请参阅副本集标签
Add a Mongod	添加额外的`mongod` 进程作为副本集成员。添加新的 `mongod` 进程也会更新 Replica Set Configuration 部分中的进程列表。您必须配置新进程的 Version、Data Directory 和 Log File。

如要向集群添加其他分片，请执行以下操作：

单击 Add a Shard（连接）。
在Cluster Configuration 部分下，为分片的每个mongod 设立以下参数：
- Version
- Data Directory
- Log File

配置集群中的每个配置服务器。

配置集群中的每个 `mongos`。

在部分中，单击Member Configuration Mongos Settingsmongos打开mongos 配置选项。每个进程都有以下选项。无法修改灰显的选项：

设置	说明
Hostname	从菜单中选择Cloud Manager Automation 将部署到的托管。该菜单仅列出Cloud Manager Automation 下的主机。有关向Cloud Manager`mongos` Automation 添加服务器的完整文档，请参阅预配服务器以实现自动化。此主机名可以是主机名、FQDN、IPv4解决或 IPv6解决。
Port	指定 `mongos`进程的 IANA 端口号。此设置对应于 `net.port` 配置文件选项。默认为 `27017`。 `mongos`必须具有对指定端口的独占访问权限。如果将多个`mongos` 进程部署到单个托管，则必须为每个进程选择一个唯一的未使用端口。
Add a Mongos	单击可添加其他`mongos` 进程。

配置集群中的每个副本集。

修改高级配置选项。

单击 Save（保存并关闭）。

Cloud Manager会将您重定向到部署页面，您必须在其中查看更改，然后才能部署更新的配置。

单击Review & Deploy 查看更改。

单击Confirm & Deploy 以部署更改。

否则，请单击 Cancel，您可以进行其他更改。

编辑部署的配置

Considerations

将更改应用于集群或成员

MongoDB 版本

MongoDB 版本的备份注意事项

引擎加密

固定属性

部署拓扑结构

项目级修改

多重修改

强制重新配置

删除分片

删除多个副本集成员

先决条件

步骤

在MongoDB Cloud Manager中，转到项目的 Processes 页面。

在列出部署项的行上，单击Modify 。

修改独立运行的实例设置。

修改高级配置选项。

单击 Save（保存并关闭）。

单击Review & Deploy 查看更改。

单击Confirm & Deploy 以部署更改。

在MongoDB Cloud Manager中，转到项目的 Processes 页面。

在列出部署项的行上，单击Modify 。

修改集群范围的设置。

配置每个副本集节点。

配置复制设置。

修改高级配置选项。

单击 Save（保存并关闭）。

单击Review & Deploy 查看更改。

单击Confirm & Deploy 以部署更改。

在MongoDB Cloud Manager中，转到项目的 Processes 页面。

在列出部署项的行上，单击Modify 。

配置集群范围的设置。

配置集群中的每个分片。

配置集群中的每个配置服务器。

配置集群中的每个 mongos。

配置集群中的每个副本集。

修改高级配置选项。

单击 Save（保存并关闭）。

单击Review & Deploy 查看更改。

单击Confirm & Deploy 以部署更改。

配置集群中的每个 `mongos`。