配置
您可以使用命令行选项或配置文件在初创企业时配置 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
选项。有关更多信息,请参阅用户数据集合。
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 版本中的新增功能。
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
重启之间保持不变。
当mongosync
同步时,您可以通过执行以下步骤来重新配置--config
、--disableTelemetry
、 、--loadLevel
、--logPath
--port
和--verbosity
选项:
(可选)暂停mongosync
进程
在每个运行的pause
进程上运行mongosync
。
您可以稍后从暂停状态恢复mongosync
进程,如最后一步所示。
提示
如果您不想在重新配置后立即恢复数据同步操作,请考虑暂停 mongosync
进程。 如果您要协调多个 mongosync
进程的操作,这非常有用。
(可选)更新配置文件
如果您在首次初始化--config
时使用mongosync
选项设立配置文件的路径,请使用每个设置的新值更新此配置文件。
启动或恢复mongosync
进程
mongosync
如果您之前在可选的第一步中暂停了任何 进程,请对暂停的resume
mongosync
进程运行 。
如果您在未使用 的情况下停止了任何mongosync
pause
进程,请对已停止的start
mongosync
进程运行 。有关更多详细说明,请参阅在集群之间同步数据。
mongosync
将同步大致恢复到停止早期进程之前的位置。 终止时正在进行的任何分区都将从头开始重新启动。