마이그레이션 대상: mongomirror

소스 MongoDB 배포

• The source MongoDB deployment must be a replica set. If the source is a standalone MongoDB deployment, before running mongomirror, convert the standalone to a replica set.

• 소스 복제본 세트는 MongoDB 버전 2.6 이상을 실행해야 합니다.

• 소스 MongoDB 복제본 세트 무료 클러스터 (이전의 M0) 또는 Flex 클러스터 일 수 없습니다.

• 소스 MongoDB 복제본 세트 time series 컬렉션의 데이터를 포함할 수 없습니다.

• 절차 중 어떤 경우에도 featureCompatibilityVersion 플래그를 변경하지 않습니다.

• MongoDB 4.4 이하에서 MongoDB 7.0 이상을 실행하는 Atlas 클러스터로 마이그레이션하는 경우, 컬렉션에서 geoHaystack 인덱스를 제거하세요.

• mongomirror is not compatible with TTL indexes. Drop any existing TTL indexes and rebuild them when the migration process is complete. If you do not want to drop an existing index because it is important for query performance, contact support for alternative options.

• Don't make any namespace changes during the migration process, such as using the renameCollection command or executing an aggregation pipeline that includes the $out aggregation stage.

• You can't use the renameCollection command or the $out aggregation stage as part of initial sync, which runs as a part of the mongomirror process.

• 마이그레이션의 초기 동기화 단계에서는 프라이머리를 재시작하지 않도록 합니다.

• If your MongoDB deployment contains indexes with keys which exceed the Index Key Limit, before you start the live migration procedure, modify indexes so that they do not contain oversized keys.

소스 복제본 세트에 대한 필수 액세스 권한

mongomirror는 소스 복제본 세트에 대한 네트워크 액세스 권한이 있어야 합니다. 소스 복제본 세트에 인증이 필요한 경우 mongomirror를 실행할 때 사용자 자격 증명을 포함하세요. 최소한 다음 권한을 가진 데이터베이스 사용자를 지정합니다.

• Read all databases and collections. The readAnyDatabase role on the admin database covers this requirement.

• Read the oplog. See Oplog Access.

• Run the getParameter command.

If no such user exists, create the user in your source MongoDB replica set. Different MongoDB Server versions have different built-in roles. Select a built-in role based on your MongoDB Server version and run the appropriate commands in the mongosh:

• For source clusters a user must have the readAnyDatabase, clusterMonitor, and backup roles.

  To verify that the database user who will run the live migration process has these roles, run the db.getUser() command on the admin database.

  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"
      }
    ]
  } ...

  이외에도 소스 클러스터의 데이터베이스 사용자는 데이터베이스의 oplog를 읽을 수 있는 역할이 있어야 admin 합니다. 자세히 알아보려면 Oplog 액세스를참조하십시오.

• For source clusters running MongoDB 3.4 a user must have, at a minimum, both clusterMonitor and readAnyDatabase roles. For example:

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

• For source clusters running MongoDB 3.2 a user must have, at a minimum, both clusterManager and readAnyDatabase roles, as well as read access on the local database. This requires a custom role, which you can create with the following commands:

    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" ]
         }
       )

• For source clusters running MongoDB 2.6 or 3.0 a user must have, at a minimum, the readAnyDatabase role. For example:

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

대상 Atlas 배포

대상 Atlas 배포:

• 무료 클러스터 또는 Flex 클러스터 일 수 없습니다.

• 복제본 세트이어야 합니다.

• Must have the version that is the same as or later than the source cluster MongoDB version. See Upgrade Path.

• 소스 클러스터와 겹치는 네임스페이스를 포함해서는 안 됩니다. mongomirror 2}가 대상 클러스터에서 겹치는 네임스페이스를 감지하는 경우 프로세스를 시작하기 전에 실패합니다. 대상 클러스터에 네임스페이스가 겹치는 경우 --drop를 사용하여 대상 클러스터에서 데이터를 모두 삭제하거나 --includeNamespace사용하여 소스 클러스터에서 가져올 네임스페이스를 나열합니다.

• 다음 중 하나의 IP 액세스 목록에도 포함되어야 합니다.

  • mongomirror가 실행 중인 서버의 공용 IP 주소 또는

  • VPC 피어링을 설정한 경우, 상대방의 VPC CIDR 블록(또는 서브넷) 또는 상대방 VPC의 보안 그룹(Security Group) 중 하나를 사용해야 합니다.

  참고

  클러스터 내 임의의 노드에 대한 공용 IP 주소를 찾으려면 명령줄에서 nslookup 도구를 사용합니다. 자세한 내용은 Atlas 클러스터의 공용 IP가 변경되나요?를 참조하세요.

대상 cluster에 대한 필수 액세스 권한

mongomirror 대상 클러스터에 대한 네트워크 액세스 권한이 있어야 합니다.

You must specify a database user with the Atlas admin role to run mongomirror. To learn more, see Configure Database Users.