/ /

编辑部署的配置

2024 年 8 月 30 日以后，Cloud Manager 将不再支持 MongoDB 3.6 和 4.0 的自动化、备份和监控。请升级您的 MongoDB 部署或迁移到 Atlas。

您可以修改部署的配置和拓扑，包括 MongoDB 版本、存储引擎以及主机或分片的数量。您可以在部署拓扑的所有级别进行修改，从顶级分片集群或副本集到较低级别，例如分片集群中的副本集或副本集中的单个进程。您还可以修改独立进程。

Considerations

将更改应用于集群或成员

如果对集群中的单个 MongoDB 进程进行配置更改，则将来对集群的任何更改都不再适用于子进程。

例子

如果您关闭副本集节点的日志功能，然后更改副本集的日志提交间隔，则更改不会应用于该节点。

MongoDB 版本

要选择哪些版本的MongoDB可供Cloud Manager使用，请参阅添加自定义MongoDB版本。

在更改部署的 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会在从一种storage engine迁移到另一种存储引擎的过程中创建备份目录。如果磁盘空间不足，则不会进行备份。迁移完成后，Cloud Manager不会删除备份目录。您可以保留或删除以前的备份目录。备份目录位于mongod的数据目录中。

例子

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

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

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

固定属性

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

database path
分配了 MongoDB 进程的主机名、 bind_ip或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 操作期间向未分片的集合发送的读取和写入操作则可能会导致意外行为，其中包括迁移失败或数据丢失。

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

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

删除多个副本集成员

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

例子

示例 1

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

例子

示例 2

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

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

先决条件

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

步骤

选择要编辑的部署类型：

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

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

显示“进程”页面。

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

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

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

设置	说明
Hostname	Cloud Manager部署`mongod`的主机名。此主机名可以是主机名、 FQDN 、 IPv 4解决或IPv 6解决。您只能在Cloud Manager自动化下部署到主机。有关将服务器添加到Cloud Manager自动化的完整文档，请参阅预配服务器以实现自动化。
Port	指定 `mongod`进程的 IANA 端口号。此设置对应于`net.port`配置文件选项。默认为`27017` 。 `mongod` 必须具有指定端口的独占访问权限。如果将多个 `mongod` 进程部署到单个主机，则必须为每个进程选择唯一的未使用端口。
Version	选择 `mongod` 进程的 MongoDB Server 版本。 Version 选择 `mongod` 进程的 MongoDB Server 版本。
Auth Schema Version	选择用于存储用户的模式，以便为部署存储用户数据。如果要从早于3.0的 MongoDB 版本升级， MongoDB 3.0 + 对用户数据使用与以前版本不同的模式。有关兼容性信息，请参阅 MongoDB 3.0发布说明中的安全更改。
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	选择用于存储用户的模式，以便为部署存储用户数据。如果要从早于3.0的 MongoDB 版本升级， MongoDB 3.0 + 对用户数据使用与以前版本不同的模式。有关兼容性信息，请参阅 MongoDB 3.0发布说明中的安全更改。
Feature Compatibility Version	选择部署的功能兼容性版本。如果您的部署运行 MongoDB 3.4或更高版本，Cloud Manager 将显示此字段。
Replica Set Settings	显示与副本集关联的每个进程的进程表。您可以配置每个进程的 MongoDB Server 版本、数据目录和日志路径。
Process Name	`mongod`进程的主机名和端口。此主机名可以是主机名、 FQDN 、 IPv 4解决或IPv 6解决。 Cloud Manager最初会将每个进程分组在副本集名称下。单击显示副本集的所有`mongod`进程。 Cloud Manager 会将为副本集配置的任何设置应用于其所有关联进程。
Version	选择 `mongod` 进程的 MongoDB Server 版本。 Version 选择 `mongod` 进程的 MongoDB Server 版本。
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	指定副本集节点在选举期间拥有的票数。此设置对应于 `votes` `mongod` 副本集配置选项。
Priority	指定节点在选举期间的优先级。优先级为 `0` 的副本集节点无法成为主节点，也无法触发选举。此设置对应于 `priority` `mongod` 副本集配置选项。
Delay	指定此节点应“滞后于”主节点的“滞后”秒数。此设置对应于 `secondaryDelaySecs` `mongod` 副本集配置选项。
Build Indexes	指定 `true` 以指示 `mongod` 建立索引。此设置对应于 `buildIndexes` `mongod` 副本集配置选项。
Tags	指定与副本集关联的一个或多个标签。此设置对应于 `tags` `mongod` 副本集配置选项。有关副本集标签的完整文档，请参阅副本集标签
Add a Mongod	添加额外的 `mongod` 进程作为副本集节点。添加新的 `mongod` 进程也会更新 Replica Set Configuration 部分的进程列表。您必须配置新进程的 Version、Data Directory 和 Log File。

配置复制设置。

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

设置	说明
Protocol Version	选择副本集使用的复制协议版本。操作设置对应 `protocolVersion` 副本集配置选项。有关更多信息，请参阅副本集协议版本。
Chaining Allowed	指定 `true`，允许从节点从其他从节点进行复制。此设置对应于 `chainingAllowed` 副本集配置选项。
Write Concern Majority Journal Default	如果写关注未明确指定日志选项 `j`，则确定 `{w:"majority"}` 写关注的行为。此设置对应于 `writeConcernMajorityJournalDefault` 副本集配置选项。
Heartbeat Timeout (secs)	指定副本集节点等待彼此成功心跳的秒数。此设置对应 `heartbeatTimeoutSecs` 副本集配置选项。
Election Timeout (ms)	指定检测副本集的主节点无法访问的时间限制（以毫秒为单位）。此设置对应于 `electionTimeoutMillis` 副本集配置选项。
CatchUp Timeout (ms)	指定新选出的主节点与可能有更多近期写入操作的其他副本集节点进行同步（赶上）的时间限制（以毫秒为单位）。此设置对应于 `catchUpTimeoutMillis` 副本集配置选项。
CatchUp Takeover Delay (ms)	指定节点在确定自己领先于当前主节点后启动追赶接管的等待时间（以毫秒为单位）。此设置对应于 `catchUpTakeoverDelayMillis` 副本集配置选项。
Last Error Defaults	指定副本集的默认写关注。仅当写入操作或 getLastError 未指定其他写关注时，副本集才使用此写关注。如果未设置此选项，则副本集的默认写关注只需要主节点的确认。以文档的形式指定此选项，即 `{"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	选择用于存储用户的模式，以便为部署存储用户数据。如果要从早于3.0的 MongoDB 版本升级， MongoDB 3.0 + 对用户数据使用与以前版本不同的模式。有关兼容性信息，请参阅 MongoDB 3.0发布说明中的安全更改。
Feature Compatibility Version	选择部署的功能兼容性版本。如果您的部署运行 MongoDB 3.4或更高版本，Cloud Manager 将显示此字段。
Process Name	与分片集群关联的`mongod`或`mongos`的主机名和端口。此主机名可以是主机名、 FQDN 、 IPv 4地址或IPv 6地址。 Cloud Manager 会将 `mongod` 进程归入其父副本集名称下，将`mongos` 进程归入 mongoses 之下。然后 Cloud Manager 将所有集群组件归到集群名称下。单击分组左侧的以列出其子分组或进程。修改一个分组的任何可用设置，都会改变其子分组和进程的相应值。对于运行 MongoDB 3.0 或更早版本的集群，Cloud Manager 会将配置服务器 `mongod` 进程分组到 configServers 之下。
Version	选择 `mongod` 或 `mongos` 进程的 MongoDB Server 版本。 Version 选择 `mongod` 或 `mongos` 进程的 MongoDB Server 版本。
Log File	指定`mongod`或`mongos`日志文件的完整路径，包括日志文件名和扩展名。此设置对应于`systemLog.path`配置文件选项。 `mongod`或`mongos`必须具有读取和写入指定文件的权限。示例，指定`/var/log/mongodb/mongo.log`会指示`mongod`或`mongos`在`/var/log/mongodb/`中将其日志文件存储为`mongo.log` 。 `mongod`或`mongos`必须有自己唯一的日志文件。如果将多个`mongod`或`mongos`进程部署到同一托管，请确保每个`mongod`或`mongos`都有自己不同的日志文件。

配置集群中的每个分片。

在Member Configuration部分中，单击Shard 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	指定副本集节点在选举期间拥有的票数。此设置对应于 `votes` `mongod` 副本集配置选项。
Priority	指定节点在选举期间的优先级。优先级为 `0` 的副本集节点无法成为主节点，也无法触发选举。此设置对应于 `priority` `mongod` 副本集配置选项。
Delay	指定此节点应“滞后于”主节点的“滞后”秒数。此设置对应于 `secondaryDelaySecs` `mongod` 副本集配置选项。
Build Indexes	指定 `true` 以指示 `mongod` 建立索引。此设置对应于 `buildIndexes` `mongod` 副本集配置选项。
Tags	指定与副本集关联的一个或多个标签。此设置对应于 `tags` `mongod` 副本集配置选项。有关副本集标签的完整文档，请参阅副本集标签
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 Settings打开mongos配置选项。每个mongos进程都有以下选项。无法修改灰显的选项：

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

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

修改高级配置选项。

单击Save 。

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

单击Review & Deploy 查看更改。

单击Confirm & Deploy 以部署更改。

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

后退

准备维护

来年

管理BI Connector

Considerations

将更改应用于集群或成员

例子

MongoDB 版本

注意

降级限制

MongoDB 版本的备份注意事项

引擎加密

重要

例子

固定属性

部署拓扑结构

项目级修改

多重修改

例子

强制重新配置

提示

删除分片

删除多个副本集成员

例子

示例 1

例子

示例 2

先决条件

步骤

在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` 。