샤딩된 클러스터를 6.0으로 업그레이드하기

밸런서를 비활성화합니다.

mongosh를 샤드된 클러스터의 mongos 인스턴스에 연결하고 sh.stopBalancer()를 실행하여 밸런서를 사용하지 않도록 설정합니다.

sh.stopBalancer()

sh.getBalancerState()

밸런서 비활성화에 대한 자세한 내용은 밸런서 비활성화를 참조하세요.

각 mongos 에 대해 캐시된 라우팅 테이블을 새로 고칩니다.

클러스터의 mongos마다 mongosh를 mongos 인스턴스에 연결하고 flushRouterConfig를 실행하여 캐시된 라우팅 테이블을 새로 고칩니다.

db.adminCommand("flushRouterConfig")
db.adminCommand(
   {
     flushRouterConfig: 1
   }
)

config 서버를 업그레이드합니다.

1. 복제본 세트 의 세컨더리 멤버를 한 번에 하나씩 업그레이드합니다.

   1. 세컨더리 인스턴스를 종료합니다.

      mongod 프로세스를 종료하려면 mongosh를 사용하여 클러스터 노드에 연결하고 다음 명령을 실행하세요.

      db.adminCommand( { shutdown: 1 } )

   2. 5.0 바이너리를 6.0 바이너리로 교체합니다.

   3. 6.0 바이너리를 시작합니다.

      6.0 바이너리를 --configsvr, --replSet, --port와 함께 시작합니다. 배포에서 사용하는 다른 옵션이 있다면 포함합니다.

      mongod --configsvr --replSet <replSetName> --port <port> --dbpath <path> --bind_ip localhost,<ip address>

      구성 파일을 사용하는 경우 파일을 업데이트하여 sharding.clusterRole: configsvr, replication.replSetName, net.port 및 net.bindIp을 지정하고 6.0 바이너리를 시작합니다.

      sharding:
         clusterRole: configsvr
      replication:
         replSetName: <string>
      net:
         port: <port>
         bindIp: localhost,<ip address>
      storage:
         dbpath: <path>

      배포에 적합한 다른 설정을 포함합니다.

   4. 다음 세컨더리 멤버를 업그레이드하기 전에 멤버가 SECONDARY 상태 로 복구될 때까지 기다립니다.

      멤버의 상태를 확인하려면 mongosh에서 rs.status()를 실행합니다.

   5. 각 세컨더리 멤버에 대해 이 과정을 반복합니다.

2. 복제본 세트 기본값을 내려놓습니다.

   1. 프라이머리을 내려놓습니다.

      프라이머리에 mongosh를 연결하고 rs.stepDown()을 사용하여 기존 프라이머리를 강등하고 강제로 새 프라이머리에 대한 투표를 진행합니다.

      rs.stepDown()

   2. 스텝다운된 프라이머리를 종료합니다.

      rs.status()가 프라이머리가 스텝다운되고 다른 노드가 PRIMARY 상태를 맡았다고 표시하면 스텝다운된 프라이머리를 종료합니다.

      강등된 프라이머리를 종료하려면 mongosh를 사용하여 프라이머리에 연결하고 다음 명령을 실행하세요.

      db.adminCommand( { shutdown: 1 } )

   3. mongod 바이너리를 6.0 바이너리로 바꿉니다.

   4. 6.0 바이너리를 시작합니다.

      --configsvr, --replSet, --port, --bind_ip 옵션을 사용하여 6.0을 시작합니다. 이전 배포에서 사용한 모든 명령줄 옵션(선택 사항)을 포함하세요.

      mongod --configsvr --replSet <replSetName> --port <port> --dbpath <path> --bind_ip localhost,<ip address>

      구성 파일을 사용하는 경우 파일을 업데이트하여 sharding.clusterRole: configsvr, replication.replSetName, net.port 및 net.bindIp을 지정하고 6.0 바이너리를 시작합니다.

      sharding:
         clusterRole: configsvr
      replication:
         replSetName: <string>
      net:
         port: <port>
         bindIp: localhost,<ip address>
      storage:
         dbpath: <path>

      배포에 적합한 다른 구성을 포함합니다.

샤드를 업그레이드합니다.

샤드를 한 번에 하나씩 업그레이드합니다.

1. 각 샤드 복제본 세트 에 대해 복제본 세트 세트의 세컨더리 멤버를 한 번에 하나씩 업그레이드 합니다.

   1. 세컨더리 인스턴스를 종료합니다.

      mongod 프로세스를 종료하려면 mongosh를 사용하여 클러스터 노드에 연결하고 다음 명령을 실행하세요.

      db.adminCommand( { shutdown: 1 } )

   2. 5.0 바이너리를 6.0 바이너리로 교체합니다.

      --shardsvr, --replSet, --port 및 --bind_ip 옵션을 사용하여 6.0 바이너리를 시작합니다. 배포에 적합한 추가 명령줄 옵션을 포함합니다.

      mongod --shardsvr --replSet <replSetName> --port <port> --dbpath <path> --bind_ip localhost,<ip address>

      구성 파일을 사용하는 경우 sharding.clusterRole: shardsvr, replication.replSetName, net.port 및 net.bindIp를 포함하도록 파일을 업데이트한 다음 6.0 바이너리를 시작합니다.

      sharding:
         clusterRole: shardsvr
      replication:
         replSetName: <string>
      net:
         port: <port>
         bindIp: localhost,<ip address>
      storage:
         dbpath: <path>

      배포에 적합한 다른 구성을 포함합니다.

   3. 다음 세컨더리 멤버를 업그레이드하기 전에 멤버가 SECONDARY 상태 로 복구될 때까지 기다립니다.

      노드의 상태를 확인하려면 mongosh에서 rs.status()를 실행하면 됩니다.

   4. 각 세컨더리 멤버에 대해 이 과정을 반복합니다.

2. 복제본 세트 기본값을 내려놓습니다.

   프라이머리에 mongosh를 연결하고 rs.stepDown()을 사용하여 기존 프라이머리를 우선 순위에서 내려오게 하고 강제로 새 프라이머리에 대한 투표를 진행합니다.

   rs.stepDown()

3. 스텝다운 기본값을 업그레이드합니다.

   rs.status()에서 프라이머리가 스텝다운되고 다른 노드가 PRIMARY 상태를 맡았다고 표시하면 스텝다운된 프라이머리를 업그레이드합니다.

   1. 스텝다운된 프라이머리를 종료합니다.

      강등된 프라이머리를 종료하려면 mongosh를 사용하여 복제본 세트 노드에 연결하고 다음 명령을 실행하세요.

      db.adminCommand( { shutdown: 1 } )

   2. mongod 바이너리를 6.0 바이너리로 바꿉니다.

   3. 6.0 바이너리를 시작합니다.

      --shardsvr, --replSet, --port 및 --bind_ip 옵션을 사용하여 6.0 바이너리를 시작합니다. 배포에 적합한 추가 명령줄 옵션을 포함합니다.

      mongod --shardsvr --replSet <replSetName> --port <port> --dbpath <path> --bind_ip localhost,<ip address>

      구성 파일을 사용하는 경우 파일을 업데이트하여 sharding.clusterRole: shardsvr, replication.replSetName, net.port 및 net.bindIp을 지정하고 6.0 바이너리를 시작합니다.

      sharding:
         clusterRole: shardsvr
      replication:
         replSetName: <string>
      net:
         port: <port>
         bindIp: localhost,<ip address>
      storage:
         dbpath: <path>

      배포에 적합한 다른 구성을 포함합니다.

mongos 인스턴스를 업그레이드합니다.

각 mongos 인스턴스를 6.0 바이너리로 바꾸고 다시 시작하세요. 배포서버에 적합한 다른 구성을 포함하세요.

mongos --configdb csReplSet/<rsconfigsver1:port1>,<rsconfigsver2:port2>,<rsconfigsver3:port3> --bind_ip localhost,<ip address>

밸런서 다시 활성화

mongosh를 사용하여 클러스터의 mongos에 연결하고 sh.startBalancer()를 실행하여 밸런서를 다시 활성화합니다.

sh.startBalancer()

MongoDB 6.0.3부터 자동 청크 분할이 수행되지 않습니다. 이는 밸런싱 정책이 개선되었기 때문입니다. 자동 분할 명령이 여전히 존재하지만 작업을 수행하지 않습니다. 자세한 내용은 밸런싱 정책 변경을 참조하세요.

MongoDB 6.0.3 이전 버전에서 sh.startBalancer()는 샤딩된 클러스터에 대한 자동 분할도 활성화합니다.

밸런서가 활성화된 동안 자동 분할을 활성화하지 않으려면 sh.disableAutoSplit()도 실행해야 합니다.

밸런서를 다시 활성화하는 방법에 대한 자세한 내용은 밸런서 활성화를 참조하세요.

이전 버전과 호환되는 6.0 기능을 활성화합니다.

현재로서는 5.0과 호환되지 않는 6.0 기능 없이 6.0 바이너리를 실행할 수 있습니다.

이러한 6.0 기능을 활성화하려면 기능 호환성 버전(fCV)을 6.0으로 설정합니다.

mongos 인스턴스의 경우 admin 데이터베이스에서 setFeatureCompatibilityVersion 명령을 실행합니다.

db.adminCommand( { setFeatureCompatibilityVersion: "6.0" } )

featureCompatibilityVersion (fCV) : "6.0" 각 샤드 에서 replSetReconfig 를 암시적으로 수행하여 샤드 복제본 구성 문서 에 term 필드 를 추가합니다.

새 구성이 대다수의 복제본 세트 구성원에게 전파될 때까지 명령이 완료되지 않습니다.

이 명령은 내부 시스템 컬렉션에 쓰기를 수행해야 합니다. 어떤 이유로든 명령이 성공적으로 완료되지 않는 경우 작업은 멱등성이 있으므로 mongos에서 명령을 안전하게 재시도할 수 있습니다.

setFeatureCompatibilityVersion을 6.0으로 설정하면 샤드에 존재하는 모든 고아 문서가 정리됩니다. 정리 프로세스는:

• 업그레이드가 완료되는 것을 차단하지 않습니다.

• 요금이 제한되어 있습니다. 고아 문서 정리 중 성능에 대한 잠재적인 영향을 완화하려면 범위 삭제 성능 조정을 참조하세요.