6.0 샤드 클러스터를 5.0으로 다운그레이드하기

1. 백업 생성

선택 사항이지만 권장됩니다. 데이터베이스의 백업을 만듭니다.

백업을 만드는 방법을 알아보려면 MongoDB 백업 메서드를 참조하세요.

2. 이전 버전과 호환되지 않는 기능 제거

6.0에서 5.0으로 다운그레이드하려면 5.0과 호환되지 않는 6.0 기능을 제거해야 합니다. 호환되지 않는 기능 목록과 해당 기능을 제거하는 방법은 다운그레이드 고려 사항을 참조하세요.

3. 진행 중인 리샤딩 작업이 없는지 확인

모든 리샤딩 작업 이 성공적으로 완료되었는지 확인합니다. 프라이머리 failover로 인해 최근의 리샤딩 작업이 실패한 경우 sharded cluster의 featureCompatibilityVersion 를 다운그레이드하기 전에 먼저 cleanupReshardCollection 명령을 실행해야 합니다.

샤드 cluster의 featureCompatibilityVersion 를 다운그레이드하는 동안 리샤딩 작업이 여전히 실행 중이면 리샤딩 작업이 완료되지 않습니다.

4. 기능 호환성 버전(fCV) 다운그레이드

샤드 cluster의 FCV 를 다운그레이드하려면 다음을 수행합니다.

1. 초기 동기화가 진행 중이 아닌지 확인합니다. 초기 동기화가 진행 중일 때 setFeatureCompatibilityVersion 명령을 실행하면 초기 동기화가 다시 시작됩니다.

2. 복제본 세트 구성 에 newlyAdded 필드가 있는 노드가 없는지 확인합니다. 복제본 세트의 각 노드에서 다음 명령을 실행하여 이를 확인합니다.

   use local
   db.system.replset.find( { "members.newlyAdded" : { $exists : true } } );

   newlyAdded 필드는 초기 동기화 중과 초기 동기화 직후 노드의 복제본 세트 구성 문서에 나타납니다.

3. ROLLBACK 또는 RECOVERING 상태에 있는 복제본 세트 멤버가 없는지 확인합니다.

4. mongosh 를 사용하여 mongos 인스턴스에 연결합니다.

5. featureCompatibilityVersion을 "5.0"로 다운그레이드합니다.

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

   setFeatureCompatibilityVersion 명령은 내부 시스템 컬렉션에 대한 쓰기를 수행하며 멱등원입니다. 명령이 성공적으로 완료되지 않으면 mongos 인스턴스에서 명령을 다시 시도합니다.

   참고

   문제 해결

   • setFeatureCompatibilityVersion 가 샤드 클러스터에서 실행되는 동안 청크 마이그레이션, 분할 및 병합이 ConflictingOperationInProgress 실패할 수 있습니다.

   • setFeatureCompatibilityVersion 가 ManualInterventionRequired 오류와 함께 실패하고 클러스터가 최근에 투표로 인해 실패한 리샤딩 작업을 거친 경우 setFeatureCompatibilityVersion 실행을 다시 시도하기 전에 cleanupReshardCollection 명령을 실행해야 합니다.

6. 복제본 세트의 모든 멤버에 업데이트된 featureCompatibilityVersion 이(가) 있는지 확인하려면 각 복제본 세트 멤버에 연결하여 featureCompatibilityVersion 을(를) 확인합니다.

   db.adminCommand( { getParameter: 1, featureCompatibilityVersion: 1 } )

   팁

   액세스 제어

   액세스 제어가 활성화된 shard cluster의 경우 shard 복제본 세트 멤버에서 adminCommand 를 실행하려면 샤드 로컬 사용자로 멤버에 연결해야 합니다.

   모든 멤버는 다음을 포함하는 결과를 반환해야 합니다.

   "featureCompatibilityVersion" : { "version" : "5.0" }

   멤버가 "6.0" 의 featureCompatibilityVersion 를 반환하는 경우 계속하기 전에 멤버가 버전 "5.0" 을 반환할 때까지 기다립니다.

반환된 featureCompatibilityVersion 값에 대한 자세한 내용은 FeatureCompatibilityVersion 가져오기를 참조하세요.