Docs 菜单
Docs 主页
/
MongoDB Cluster-to-Cluster Sync
/

配置

您可以使用命令行选项或配置文件在初创企业时配置 mongosync 实例。配置文件指定的设置值相当于 mongosync命令行选项。

迁移期间,您可以按照 在同步期间重新配置 (重新配置 )中的步骤重新配置某些mongosync mongosync设置。

您可以写入大多数mongosync命令行选项写入 YAML文件。 配置文件使用 YAML 格式指定每个设置的值。

例如:

cluster0: "mongodb://192.0.2.10:27017"
cluster1: "mongodb://192.0.2.20:27017"
logPath: "/var/log/mongosync"
verbosity: "WARN"

要使用配置文件,请使用--config选项启动mongosync ,以设立文件的路径:

mongosync --config <configPath>

您可以使用配置文件配置以下 mongosync 设置。

mongosync要命令行配置 ,请参阅命令行选项。

注意

start 命令为 reversibilityuser write blocking 等功能提供了更多选项。有关更多详细信息,请参阅 API 文档的 start 部分。

acceptDisclaimer

类型:布尔值

接受针对嵌入式验证程序的免责声明。

如果在没有此设置的情况下启动 mongosync进程,则会提示用户接受每项免责声明。

此设置允许已阅读并接受免责声明的用户接受免责声明并启动 mongosync进程。

要从命令行设置 acceptDisclaimer 设置,请参阅 --acceptDisclaimer 选项。

1.9 版本中的新功能

cluster0

类型:字符串

设置第一个集群的连接 URI。在同步过程中,第一个集群既可以作为源,也可以作为目标。在调用 start API 端点时指定源集群和目标集群。

有关连接 mongosync 的更多信息,请参阅连接

要从命令行设置 cluster0 设置,请参阅 --cluster0 选项。

cluster1

类型:字符串

设置第二个集群的连接 URI 。在同步进程中,第二个集群既可以作为源,也可以作为目标。在 start API 端点的调用中指定源集群和目标集群。

有关连接 mongosync 的更多信息,请参阅连接

要从命令行设置 cluster1 设置,请参阅 --cluster1 选项。

disableTelemetry

类型:布尔值

版本 1.4.0 中的新增功能

禁用收集 mongosync 遥测数据

默认情况下,mongosync收集匿名的汇总使用数据以改进 MongoDB 产品。当您运行mongosync时,您可以禁用此遥测数据的收集。

要从命令行设置 disableTelemetry 设置,请参阅 --disableTelemetry 选项。

有关更多信息,请参阅用户数据集合

disableVerification

类型:布尔值

禁用嵌入式验证器。禁用后,mongosync 不会验证迁移。 有关其他验证方法,请参阅验证数据传输。

对于在运行带验证的 mongosync 时遇到 OOM 终止并且无法分配更多资源或无法容忍重新启动验证的客户,此选项提供了一种解决方法。 它允许在禁用验证的情况下完成迁移。 对于后续的重启和撤销,验证保持禁用状态。

初次启动 mongosync 时不应使用此选项。 相反,请使用 /start请求参数 verification.enabled: false禁用验证,因为默认下会启用验证。

要从命令行禁用验证,请参阅--disableVerification 选项。

1.10 版本中的新增功能

id

类型:字符串

mongosync 实例设置标识符。

在分片集群上运行多个 mongosync 实例时,使用此设置单独同步分片。

此设置的标识符值必须与同步分片的分片 ID 相对应。要查找分片 ID,请使用 listShards 命令。

要从命令行设置 id 设置,请参阅 --id 选项。

loadLevel

类型:整型

默认值3

设置在源集群和目标集群之间同步数据的集群工作负载级别:

  • 4,这是最高设置,最大限度地提高集群工作负载,数据同步的速度最快。

  • 1,这是最低设置,最大限度地减少了集群工作负载,数据同步的速度最慢。

要从命令行设置 loadLevel 设置,请参阅 --loadLevel 选项。

警告

loadLevel设置为高于默认值 3 可能会对目标集群性能产生负面影响。

如果源集群存在读取瓶颈或目标集群存在写入瓶颈,则减少 loadLevel 可能会提高性能。

1.4 版本中的新增功能

logPath

类型:字符串

设置日志目录的路径。集群到集群同步会将日志写入该目录下的文件。

有关更多信息,请参阅日志记录。

要从命令行设置 logPath 设置,请参阅 --logPath 选项。

port

类型:整型

默认值27182

设置 HTTP 服务器用于集群到集群同步 HTTP API 的端口。

要从命令行设置 port 设置,请参阅 --port 选项。

verbosity

类型:字符串

默认值DEBUG

设置要在日志消息中使用的详细程度。 Cluster-to-Cluster Sync 记录指定级别的所有消息和较低级别的所有消息。

verbosity 设置支持以下值:

  • TRACE

  • DEBUG

  • INFO

  • WARN

  • ERROR

  • FATAL

  • PANIC

要从命令行设置 verbosity 设置,请参阅 --verbosity 选项。

重要

迁移期间只能调整以下设置。 其他设置必须在 mongosync重启之间保持不变。

mongosync 同步时,您可以通过执行以下步骤来重新配置--config--disableTelemetry 、 、--loadLevel--logPath --port--verbosity 选项:

1

在每个运行的pause 进程上运行mongosync

您可以稍后从暂停状态恢复mongosync进程,如最后一步所示。

提示

如果您不想在重新配置后立即恢复数据同步操作,请考虑暂停 mongosync 进程。 如果您要协调多个 mongosync 进程的操作,这非常有用。

2

使用操作系统停止每个运行的mongosync进程。 有关具体步骤,请参阅操作系统文档。

3

如果您在首次初始化--config 时使用mongosync 选项设立配置文件的路径,请使用每个设置的新值更新此配置文件。

4

如果您在上一步中更新了配置文件,请初始化mongosync 进程,并将--config 选项设立为已更新配置文件的路径:

mongosync --config <configPath>

如果在首次初始化 --config时未使用mongosync mongosync选项,请使用将命令行选项设立为更新后的值来初始化 进程:

mongosync \
--cluster0 "<cluster0_connection_string>" \
--cluster1 "<cluster1_connection_string>" \
--loadLevel <newLevel>

有关更多信息,请参阅初始化 mongosync。

5

mongosync如果您之前在可选的第一步中暂停了任何 进程,请对暂停的resume mongosync进程运行 。

如果您在未使用 的情况下停止了任何mongosync pause进程,请对已停止的start mongosync进程运行 。有关更多详细说明,请参阅在集群之间同步数据。

mongosync 将同步大致恢复到停止早期进程之前的位置。 终止时正在进行的任何分区都将从头开始重新启动。

后退

行为

在此页面上

  • 配置文件
  • 设置
  • 在同步重新配置 mongosync
  • (可选)暂停mongosync进程
  • 停止mongosync进程
  • (可选)更新配置文件
  • 初始化mongosync进程
  • 启动或恢复 mongosync 进程