完成切换进程

验证 mongosync 的状态。

在开始切换进程之前，调用进度端点以确定mongosync的状态。 确保mongosync进程状态显示以下值：

• canCommit 是 true。

• lagTimeSeconds 很小（接近0 ）。

  如果在转换开始时lagTimeSeconds不接近0 ，则转换可能需要很长时间。

• 使用嵌入式验证程序时，请检查 verification.source和verification.destination 返回文档。两个文档中的 lagTimeSeconds 字段应接近 0，并且 phase 字段应显示 "stream hashing"。

  如果验证者未处于流哈希阶段，则切换进程可能需要很长时间。

以下示例返回同步进程的状态。

curl localhost:27182/api/v1/progress -XGET

{
   "progress":
      {
         "state":"RUNNING",
         "canCommit":true,
         "canWrite":false,
         "info":"change event application",
         "lagTimeSeconds":0,
         "collectionCopy":
            {
               "estimatedTotalBytes":694,
               "estimatedCopiedBytes":694
            },
         "directionMapping":
            {
               "Source":"cluster0: localhost:27017",
               "Destination":"cluster1: localhost:27018"
            },
         "verification":
            {
               "source":
                  {
                     "estimatedDocumentCount": 42,
                     "hashedDocumentCount": 42,
                     "lagTimeSeconds": 2,
                     "totalCollectionCount": 42,
                     "scannedCollectionCount": 10,
                     "phase": "stream hashing"
                  },
               "destination": {
                     "estimatedDocumentCount": 42,
                     "hashedDocumentCount": 42,
                     "lagTimeSeconds": 2,
                     "totalCollectionCount": 42,
                     "scannedCollectionCount": 10,
                     "phase": "stream hashing"
               }
            }
      },
   "success": true
}

停止对源上已同步集合的任何写入操作。

• 等待源集群上的所有事务提交或中止。

• mongosync 默认启用仅默认写入阻塞。 您可以通过启动 mongosync 并将 enableUserWriteBlocking设立为 "destinationOnly" 来显式启用此功能。 mongosync 仅阻止对目标的写入，并在 canWrite 被设立为 true 之前解除阻止。

• 如果在 enableUserWriteBlocking设立为 "sourceAndDestination" 的情况下启动 mongosync，则 mongosync 会阻止目标集群上的所有写入操作，并在将 canWrite设立为 true 之前解除对这些操作的阻止。 调用 /commit 后，mongosync 会阻止对源进行写入。

• If you start mongosync with enableUserWriteBlocking set to "none", ensure that you disable writes. For example, run the setUserWriteBlockMode command on the source cluster:

  db.adminCommand( {
      setUserWriteBlockMode: 1,
      global: true 
  } )

• 如果 mongosync 使用筛选同步，则无需禁用对整个源集群的写入。 但是，您必须确保停止对过滤包含的集合的写入操作。

向 mongosync 发送提交请求。

如果为迁移启动多个 mongosync 实例，则必须为每个 mongosync实例发出提交请求。

curl localhost:27182/api/v1/commit -XPOST --data '{ }'

{"success":true}

等待，直到可以对目标集群执行写入。

调用 progress 终结点以确定 canWrite 是否为 true。如果 canWrite 为 false，请等到 progress 显示 canWrite 为 true。如果您正在运行多个 mongosync 实例，则仅检查第一个 mongosync进程上的 canWrite 是否为 true。任何后续 mongosync 进程的 canWrite 状态均无效。

curl -sS localhost:27182/api/v1/progress -XGET | jq ".progress.canWrite"

true

验证数据传输。

验证数据是否成功从源同步到目标集群。

有关详细信息，请参阅验证数据传输。

If you manually blocked writes on the destination cluster by using setUserWriteBlockMode, enable application writes on the destination cluster.

To enable writes, update setUserWriteBlockMode:

db.adminCommand(
   {
      setUserWriteBlockMode: 1,
      global: false
   }
)

然后，将应用程序工作负载传输到目标集群。

如果您通过在/start端点上使用 enableUserWriteBlocking 选项来启动具有写入阻塞功能的 mongosync，则无需完成此步骤。

调用 progress 终结点以确定 mongosync进程的状态。

当mongosync进度响应指示mongosync状态为COMMITTED时，则表示切换过程已完成。

curl -sS localhost:27182/api/v1/progress -XGET | jq ".progress.state"

"COMMITTED"