Docs 菜单
Docs 主页
/ /
参考
Docs 主页
/
工具
/
mongosync
/
参考
Docs 主页
/
工具
/
mongosync
/
参考

配置

您可以使用命令行选项或配置文件在初创企业时配置 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 命令为 reversibility 和 user 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 选项。

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

id

类型：字符串

为 mongosync 实例设置标识符。

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

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

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

loadLevel

类型：整型

默认值：3

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

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

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

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

警告

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

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

1.4 版本中的新增功能。

logPath

类型：字符串

设置日志目录的路径。Mongosync 将日志写入此目录中的文件。

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

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

port

类型：整型

默认值：27182

设置HTTP服务器用于 Mongosync HTTP API 的端口。

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

verbosity

类型：字符串

默认值：DEBUG

设置要在日志消息中使用的详细程度。Mongosync 会记录指定级别的所有消息以及较低级别的所有消息。

verbosity 设置支持以下值：

  • TRACE

  • DEBUG

  • INFO

  • WARN

  • ERROR

  • FATAL

  • PANIC

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

在同步期间重新配置mongosync

重要

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

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

1

（可选）暂停mongosync 进程

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

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

提示

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

2

停止mongosync 进程

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

3

（可选）更新配置文件

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

4

初始化mongosync 进程

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

mongosync --config <configPath>

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

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

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

5

启动或恢复mongosync 进程

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

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

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

后退

行为

来年

开始

在此页面上