迁移 mongomirror

源 MongoDB 部署

• 源 MongoDB 部署必须是副本集。如果源是独立运行的 MongoDB 部署，则在运行 mongomirror 之前， 应将独立运行转换为副本集。

• 源副本集必须运行 2.6 或更高版本的 MongoDB。

• 源MongoDB副本集不能是 M0 免费集群或 M2/M5共享集群。

• 源MongoDB副本集不能包含时间序列集合中的数据。

• 在此过程中，始终请勿更改 featureCompatibilityVersion 标志。

• 从 MongoDB 4.4 或更早版本迁移到运行 MongoDB 5.0 或更高版本的 Atlas 集群时，请从集合中删除任何 geoHaystack 索引。

• mongomirror 与 TTL 索引不兼容。删除所有现有 TTL 索引，并在迁移流程完成后重建它们。如果因其对查询性能十分重要而不想删除现有索引，则请 联系支持人员 以了解备用选项。

• 在迁移过程中，不要对命名空间进行任何更改，例如使用 renameCollection 命令或执行包含 $out 聚合阶段的聚合管道。

• 您不能将 renameCollection 命令或 $out 聚合阶段用作初始同步的一部分，初始同步作为 mongomirror 进程的一部分运行。

• 在迁移的初始同步阶段，不得重新启动主节点。

• 如果 MongoDB 部署包含的索引的键值超过索引键值限制，则在启动实时迁移之前修改索引，使其不包含过大的键值。

源副本集所需的访问权限

mongomirror 必须具有源副本集的网络访问权限。如果源副本集需要身份验证，则须在运行 mongomirror 时包含用户档案。您必须指定至少具有以下特权的数据库用户：

• 读取所有数据库和集合。admin 数据库上的 readAnyDatabase 角色满足了此要求。

• 阅读 oplog。参见 Oplog 访问权限。

• 运行 getParameter 命令。

如果不存在这样的用户，请在源 MongoDB 副本集中创建该用户。不同的 MongoDB 服务器版本有不同的内置角色。根据 MongoDB Server 版本选择内置角色，然后在 mongosh: 中运行相应命令：

• 对于源集群，用户必须拥有 readAnyDatabase、clusterMonitor 和 backup 角色。

  要验证将运行实时迁移过程的数据库用户是否具有这些角色，请在 admin 数据库上运行 db.getUser() 命令。

  use admin
  db.getUser("admin")
  {
    "_id" : "admin.admin",
    "user" : "admin",
    "db" : "admin",
    "roles" : [
      {
        "role" : "backup",
        "db" : "admin"
      },
      {
        "role" : "clusterMonitor",
        "db" : "admin"
      }
      {
        "role" : "readAnyDatabase",
        "db" : "admin"
      }
    ]
  } ...

  此外，源集群的数据库用户必须具有读取 admin 数据库的 oplog 的角色。如需了解更多信息，请参阅 Oplog 访问权限。

• 对于运行 MongoDB 3.4 的源集群，用户至少必须拥有 clusterMonitor 和 readAnyDatabase 角色。例如：

   use admin
   db.createUser(
     {
       user: "mySourceUser",
       pwd: "mySourceP@$$word",
       roles: [ "clusterMonitor", "readAnyDatabase" ]
     }
   )

• 对于运行 MongoDB 3.2 的源集群，用户必须至少拥有 clusterManager 和 readAnyDatabase 角色，以及对 local 数据库的读取权限。为此，需要一个自定义角色，而您可使用以下命令创建该角色：

    use admin
    db.createRole(
         {
           role: "migrate",
           privileges: [
             { resource: { db: "local", collection: "" }, actions: [ "find" ] }
           ],
           roles: ["readAnyDatabase", "clusterManager"]
         }
       )
     db.createUser(
         {
           user: "mySourceUser",
           pwd: "mySourceP@$$word",
           roles: [ "migrate" ]
         }
       )

• 对于运行 MongoDB 2.6 或 3.0 的源集群，用户必须至少拥有 readAnyDatabase 角色。例如：

    use admin
       db.createUser(
         {
           user: "mySourceUser",
           pwd: "mySourceP@$$word",
           roles: [ "readAnyDatabase" ]
         }
       )

目标 Atlas 部署

目标 Atlas 部署：

• 不能是 M0 免费集群、M2 或 M5 共享集群。

• 不能是无服务器实例。

• 必须是副本集。

• 必须采用与源集群 MongoDB 版本相同或更高的版本。请参阅升级路径。

• 不得包含任何与源集群重叠的命名空间。如果 mongomirror 在目标集群上检测到重叠的命名空间，它则会在启动此流程之前失败。如果目标集群包含重叠的命名空间，请使用 --drop 从目标集群中删除所有数据，或是使用 --includeNamespace 列出要从源集群导入的命名空间。

• 必须在其 IP 访问列表中包含以下任一对象：

  • 运行 mongomirror 的服务器的公共 IP 地址，或是

  • 如果设置为 VPC 对等互连，则为对等方的 VPC CIDR 区块（或子集） 或对等 VPC 的安全组。

  注意

  要查找集群中任何节点的公共 IP 地址，请从命令行使用 nslookup 工具。要了解更多信息，请参阅 Atlas 集群的公网 IP 是否有变化？

目标集群所需的访问权限

mongomirror 必须具有目标集群的网络访问权限。

必须指定具有 Atlas admin 角色的数据库用户才能运行 mongomirror。要了解更多信息，请参阅添加数据库用户。