实时迁移（推送） MongoDB Ops Manager或Cloud Manager监控的副本集（ MongoDB 6.0.13 之前的版本）

在 Atlas 中，转到Organization Settings 页面。

1. 如果尚未显示，请从导航栏中的Organizations菜单。

2. 单击 Organizations 菜单旁边的 Organization Settings 图标。

   显示“组织设置”页面。

转到Live Migration to Atlas 页面。

单击侧边栏中的 Live Migration（支持）。

显示“实时迁移到 Atlas”页面。

启动迁移过程。

1. 单击 Migrate from Ops Manager or Cloud Manager（连接）。

2. 单击I'm Ready to Start ，如果您要使用 从MongoDB Community 迁移MongoDB Ops Manager ，请单击Ops Manager License Agreement 以阅读并接受。要在实时迁移向导之外阅读协议，请参阅MongoDB Ops Manager迁移协议。

Atlas 显示实时迁移向导，其中包含如何继续此进程的说明。 此进程将数据从源集群推送到新的目标集群。 在完成向导步骤后，您可以将应用程序指向新集群。

与 Atlas 链接。

1. 单击 Generate Link-Token。Atlas 显示用于生成链接令牌的页面。

   • 如果您要从 Ops Manager 迁移，请输入 Ops Manager 实例的外部 IP 地址或CIDR区块，将它们添加到链接令牌（Link-Token）中嵌入的 API 密钥的访问列表。这样，Ops Manager 就能向 Atlas 发送项目和集群信息。 在此步骤中，Ops Manager 不会发送存储在 MongoDB 数据库中的任何数据。例如，输入23.248.95.14 。

   • 如果您要从 Cloud Manager 迁移，请跳过此步骤。

2. 单击Next可查看包含生成的链接令牌的页面。

3. 复制链接令牌，将其存储在安全位置。 Atlas 从不显示链接令牌的内容。 Atlas 在生成链接令牌后也不显示其内容。请勿 公开分享。

   注意

   使用一个唯一的链接令牌将一个 Cloud Manager 或 Ops Manager 组织中的所有项目实时迁移到 Atlas。

4. 单击 Done（连接）。

将链接令牌（Link-Token）粘贴到 Ops Manager 或 Cloud Manager 中。

1. 在 Cloud Manager 或 Ops Manager 中访问组织：

   打开 Ops Manager 或 Cloud Manager， 然后导航到要将其项目集群实时迁移到 Atlas 的组织。

2. 单击左侧导航面板中的 Settings。

3. 在Live Migration: Connect to Atlas部分中，单击Connect to Atlas 。 Connect to Atlas对话框打开。

4. 粘贴“实时迁移”向导上一步生成的链接令牌，然后单击Connect to Atlas 。 Cloud Manager或MongoDB Ops Manager建立与Atlas的连接。 如有需要，请使用Refresh按钮将更新发送到 Atlas。 要了解更多信息，请参阅在 中连接到Atlas Atlas 进行实时 MongoDB Ops Manager，或在 中Atlas 到 Atlas 进行实时迁移 Cloud Manager。

创建目标 Atlas 集群。

如果还没有，请在 Atlas 中创建目标集群。 请参阅先决条件。

启动从目标集群的迁移。

1. 单击 Select Target Cluster from Projects（连接）。

2. 转到目标 Atlas 集群的项目，找到目标集群。

3. 单击然后从下拉列表中选择Migrate Data to this Cluster以开始迁移。 Migrate Data to This Cluster页面打开。

4. 单击Migrate from Ops Manager or Cloud Manager并填写字段，如下所示：

   • 如果您还没有选择源项目，请在 Cloud Manager 或 Ops Manager 中选择源项目。

   • 选择用于处理迁移的迁移主机。

   • 查看 IP 地址访问列表，检查迁移主机的外部 IP 地址 是否包含在此列表中。如果没有 添加， 现在添加：

     • 单击 Set Network Access for Host

     • 单击 + Add IP Address

     • 返回实时迁移向导。 从下拉列表中选择源集群，然后在Migrate data to this cluster 。

   • 从下拉列表中选择源集群。

   • 如果在Cloud Manager或MongoDB Ops Manager中暂停源集群的自动化，但继续使用监控代理监控源集群，则会显示 Username 和 Password。 如果您的部署需要用户身份验证，请在这些字段中提供用户名和密码。 您提供的档案的数据库用户必须至少在管理员数据库上具有备份角色，并且必须使用SCRAM-SHA- 1和 SCRAM-SHA- 256进行身份验证。

   • 如果源集群使用TLS / SSL ，请切换Is encryption in transit enabled?按钮。

   • 如果源集群使用带有自定义根证书颁发机构的 TLS/SSL，请从迁移主机复制 CA 文件的路径，并将此路径粘贴到所提供的文本框。此文件必须保存在迁移主机上，确保迁移主机可以读取证书。ATLAS 检查证书是否存在且可读。

   • 如果副本集目标集群有数据，而您想要保留这些数据，请保持Clear any existing data on your destination cluster选项处于未选中状态。 如果实时迁移服务发现重复的命名空间，则会向您发出警告。 如果要删除现有数据，请选中此选项。

   • 选择用于连接到集群的连接。 Standard connection在用户界面中始终显示为可用。 但是，仅当您之前配置了 VPC 对等互连或私有端点时，才会启用其他连接选项。 如果 Atlas 检测到您没有配置 VPC 连接或私有端点，这些选项将灰显。

     • 如果您未使用 VPC 对等互连或私有端点，请单击Standard connection并继续执行此步骤的Validation阶段。

     • 如果您在迁移主机和 Atlas 集群之间配置了VPC 对等互连，则VPC Peering选项处于活动状态。单击VPC Peering以使用 VPC 对等互连进行连接，以实现实时迁移。如果VPC Peering选项显示为灰色，请在开始此过程之前配置 VPC 对等连接。要了解更多信息，请参阅对 VPC 对等互连和私有端点的支持。

     • 如果您要迁移副本集并在迁移主机和 Atlas 集群之间配置了私有端点，则Private Endpoint选项处于活动状态。 单击Private Endpoint （与私有端点连接），然后从下拉列表中选择之前配置的私有端点。 只有处于AVAILABLE状态的私有端点才有效。 如果Private Endpoint选项显示为灰色，请在开始此过程之前配置私有端点。 要了解更多信息，请参阅对 VPC 对等互连和私有端点的支持。

       注意

       私有端点仅支持在单个云提供商和单个地区部署的副本集的实时迁移。 分片集群、多地区集群和多云集群不支持 通过私有端点进行实时迁移。

   • 单击 Validate。验证进程将验证迁移主机是否可访问，并执行以下验证检查，确保您可以启动到 Atlas 的实时迁移。

     要利用以下验证检查， 请将 中的MongoDB Agent MongoDB Ops ManagerMongoDB 助手 升级到最新版本，或将 中的 助手升级 到最新版本。MongoDB AgentCloud Manager如果实时迁移进程检测到源集群正在运行早于MongoDB Agent 12.0.11.7606（ ）的MongoDB Ops Manager 助手版本，或12 .5 .0 .7713对于Cloud Manager ，它会显示一条警告横幅，建议您升级MongoDB Agent 。

     实时迁移期间会运行以下验证检查：

     • 迁移主机可以连接到目标集群。

     • 如果源集群使用带有自定义根证书颁发机构的 TLS/SSL，则迁移主机可以使用 TLS/SSL 访问源集群。

     • 数据库用户凭证有效。只有 在 Cloud Manager 或 Ops Manager 中暂停源集群的自动化， 但继续使用“监控代理”监控源集群时， 才会运行此验证检查。

     • 如果您要从 5.0.9 之前版本的MongoDB Ops Manager进行迁移，实时迁移进程会根据数据大小，验证目标集群是否具有足够的磁盘空间。 如果您要从Cloud Manager或MongoDB Ops Manager 5.0.9 或更高版本进行迁移，迁移进程会根据压缩数据的存储大小，验证目标集群是否具有足够的磁盘空间。 要了解有关数据和存储大小的更多信息，请参阅dbStats。

   • 如果验证失败，请检查迁移主机、外部 IP 地址或 CIDR 块以及链路令牌的有效性。另请检查数据库用户凭据、TLS/SSL 证书以及目标集群的磁盘存储大小。

   • 如果验证成功，请单击Next 。 显示Migrate from Ops Manager or Cloud Manager页面。

开始迁移。

1. 查看列出源组织、项目和集群以及实时迁移进程 将使用的迁移主机的报告。

2. 单击 Start the Migration（连接）。

准备切换。

在最终 oplog 收尾阶段会显示一个延迟时间值， 该值代表源集群和目标集群之间的当前延迟。 此延迟时间可能会根据源集群上 oplog 生成的速率而变化， 但随着实时迁移过程将 oplog 条目复制到目标集群， 它应该会随着时间的推移而减少。

1. 当延迟计时器和Prepare to Cutover按钮变为绿色时，单击以继续下一步。

执行切换。

当 Atlas 检测到源集群和目标集群几乎同步时，它会启动一个可延长的 120 小时（5 天）定时器，以开始实时迁移过程的切换阶段。120 小时后，Atlas 将停止与源集群同步。您可以通过点击 <time> left to cut over 计时器下方的 Extend time 将剩余时间延长 24 小时。

如果您的迁移即将过期，Atlas 会向您发送一封类似于以下示例的电子邮件：

A migration to your Atlas cluster will expire in <number> hours!
Navigate to your destination cluster to start the cutover process. If
you don't take any action within <number> hours, the migration will be
cancelled and you will need to start again. You can also extend the
migration process if you need more time.

要完成将 MongoDB 数据迁移到 Atlas 集群的过程，请在Your migration is almost complete!页面上完成以下步骤：

1. 准备指向 Atlas 集群。复制新的连接字符串，以便更新，并将应用程序指向目标 Atlas 集群。

2. 停止您的应用程序。此操作可确保不再对源集群执行写入操作。

3. 等待 ops/sec 间隙归零。当计数器归零时， 源集群和目标集群同步。

4. 单击Cut Over以完成迁移过程。

   如果您单击实时迁移进度条上的Cancel ，Atlas 将停止同步来自源集群的写入。 所有迁移的数据都保留在 Atlas 集群上。

   您可以再次单击Cut Over ，以允许 Atlas 完成迁移过程。

5. 等待 Atlas 配置好目标集群并可供使用。对于较小的集群，该时间为3 - 5分钟。对于较大的集群，此时间最多可延长10分钟或更长，具体取决于集群大小和配置。

   如果转换过程已进行至少12小时，Atlas 会向您发送一封电子邮件，建议您检查迁移进程或联系支持部门。

6. 当您准备好将写入重定向到 Atlas 的目标集群时：

   1. 使用目标集群的连接字符串连接应用程序。

   2. 确认应用程序正在与目标 Atlas 集群一起工作。

   3. 验证目标集群上的数据。

   4. 恢复写入目标集群。

   Atlas 执行以下操作来完成此进程：

   • 从目标群集的 IP 访问列表中 删除MongoDB 实时迁移服务器子网。

   • 删除实时迁移用于将数据导入到目标集群的数据库用户。

   • 将迁移过程标记为已完成。