5.0 샤딩된 클러스터를 4.4로 다운그레이드

이 페이지의 내용

다운그레이드 경로

백업 생성
전제 조건
절차

다운그레이드를 시도하기 전에 이 문서의 내용을 숙지하세요.

다운그레이드 경로

중요

복제본 세트를 업그레이드하거나 다운그레이드하기 전에 모든 복제본 세트 멤버가 실행 중인지 확인하세요. 그렇지 않으면 모든 구성원이 시작될 때까지 업그레이드 또는 다운그레이드가 완료되지 않습니다.

5.0에서 다운그레이드해야 하는 경우 최신 패치 릴리스인 4.4로 다운그레이드합니다.

MongoDB는 단일 버전 다운그레이드만 지원합니다. 현재 릴리스보다 이전 버전인 릴리스로 다운그레이드할 수 없습니다.

예를 들어, 5.0 시리즈를 4.4 시리즈 배포로 다운그레이드할 수 있습니다. 하지만 4.4 시리즈 배포를 4.2 시리즈 배포로 한 단계 더 다운그레이드하는 것은 지원되지 않습니다.

백업 생성

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

전제 조건

5.0에서 4.4로 다운그레이드하려면 지속되고 호환되지 않는 기능을 제거하거나 호환되지 않는 구성 설정을 업데이트해야 합니다. 여기에는 다음이 포함됩니다.

1. 클러스터 기본 읽기 및 쓰기 고려

MongoDB 5.0에서는 클러스터 전체 읽기 및 쓰기 고려 기본값이 변경되었으며, MongoDB 4.4로 다운그레이드하면 이러한 기본값이 다시 변경될 수 있습니다. 다운그레이드하기 전에 클러스터의 기본 읽기 및 쓰기 고려를 수동으로 구성하는 것이 좋습니다.

클러스터의 읽기 또는 쓰기 고려 (write concern) 에 대한 기본값 을 수동으로 구성하려면 setDefaultRWConcern 명령을 사용합니다.
클러스터에 중재자가 포함되어 있고 특정 상황에서 캐시 압력을 방지하기 위해 이전에 "Majority" 읽기 고려를 비활성화했다면, 다운그레이드 후 --enableMajorityReadConcern false 또는 replication.enableMajorityReadConcern: false를 구성할 수 있습니다.

2. 또는 `.` `$` 문자가 포함된 문서 필드

MongoDB 5.0은 문서 필드 이름에 . 또는 $ 문자를 포함하는 기능을 지원합니다. MongoDB 4.4로 다운그레이드하기 전에 . 또는 $ 문자가 포함된 필드 이름이 포함된 문서를 모두 삭제해야 합니다.

3. 슬림형 시간대 데이터 파일

MongoDB 5.0은 슬림형 시간대 데이터 파일을 지원합니다. --timeZoneInfo 명령줄 옵션 또는 processManagement.timeZoneInfo 구성 파일 설정으로 MongoDB에 제공된 대로 배포에서 슬림형 시간대 데이터 파일을 사용하는 경우, MongoDB 4.4.7 이상으로 다운그레이드하거나, 그렇지 않으면 이전의 비슬림형 데이터 파일을 사용하도록 시간대 데이터 파일을 되돌려야 합니다.

4. 리샤딩

다운그레이드 절차를 시도하기 전에 리샤딩 작업 이 성공적으로 완료되었는지 확인합니다. 프라이머리 페일오버로 인해 최근의 리샤딩 작업이 실패한 경우 샤딩된 클러스터의 featureCompatibilityVersion 를 다운그레이드하기 전에 먼저 cleanupReshardCollection 명령을 실행해야 합니다.

샤드 cluster의 featureCompatibilityVersion 를 다운그레이드하는 동안 리샤딩 작업이 여전히 실행 중이면 리샤딩 작업이 중단됩니다.

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

먼저 다음을 확인합니다.

초기 동기화가 진행 중이 아닌지 확인합니다. 초기 동기화가 진행 중일 때 setFeatureCompatibilityVersion 명령을 실행하면 초기 동기화가 다시 시작됩니다.
복제본 세트 구성 에 newlyAdded 필드가 있는 노드가 없는지 확인합니다. 샤드 cluster의 각 노드에서 다음 명령을 실행하여 이를 확인합니다.
```
use local
db.system.replset.find( { "members.newlyAdded" : { $exists : true } } );
```
newlyAdded 필드는 초기 동기화 중과 초기 동기화 직후 노드의 복제본 세트 구성 문서에 나타납니다.
2} 또는 상태의 ROLLBACK RECOVERING 복제본 집합 구성원이 없는지 확인합니다.

다음으로 샤드 클러스터의 featureCompatibilityVersion 를 다운그레이드합니다.

mongo shell을 mongos 인스턴스에 연결합니다.
featureCompatibilityVersion을 "4.4"로 다운그레이드합니다.
```
db.adminCommand({setFeatureCompatibilityVersion: "4.4"})
```
setFeatureCompatibilityVersion 명령은 내부 시스템 컬렉션에 대한 쓰기를 수행하며 멱등원입니다. 어떤 이유로든 명령이 성공적으로 완료되지 않으면 mongos 인스턴스에서 명령을 다시 시도합니다.
참고
- 샤딩된 클러스터에서 setFeatureCompatibilityVersion가 실행되는 동안 청크 마이그레이션, 분할 및 병합은 ConflictingOperationInProgress로 인해 실패할 수 있습니다.
- setFeatureCompatibilityVersion 가 ManualInterventionRequired 오류와 함께 실패하고 cluster가 최근에 election로 인해 실패한 리샤딩 작업을 거친 경우 cleanupReshardCollection 명령을 실행한 후 setFeatureCompatibilityVersion 를 다시 시도해야 합니다.
샤딩된 cluster의 모든 멤버가 업데이트된 featureCompatibilityVersion 을 반영하도록 하려면 각 shard 복제본 세트 멤버와 각 config 서버 복제본 세트 멤버에 연결하여 featureCompatibilityVersion 을 확인합니다.
팁
액세스 제어가 활성화된 샤딩된 클러스터의 경우, 복제본 세트 노드에 다음을 명령하려면 반드시 노드를 샤드 로컬 사용자로 연결해야 합니다.
```
db.adminCommand( { getParameter: 1, featureCompatibilityVersion: 1 } )
```
모든 멤버는 다음을 포함하는 결과를 반환해야 합니다.
```
"featureCompatibilityVersion" : { "version" : "4.4" }
```
멤버가 "5.0" 의 featureCompatibilityVersion 를 반환하는 경우 계속하기 전에 멤버가 버전 "4.4" 를 반영할 때까지 기다립니다.

참고

중재자는 admin.system.version 컬렉션을 복제하지 않습니다. 이로 인해 중재자는 복제본 세트의 FCV 값에 관계없이 바이너리의 다운그레이드 버전과 동일한 기능 호환성 버전을 항상 갖게 됩니다.

그 예로 MongoDB 5.0 클러스터에 속한 중재자의 FCV 값은 4.4입니다.

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

6. fCV 5.0 영구 기능 제거

다음 단계는 fCV가 "5.0"로 설정된 적이 있는 경우에만 필요합니다.

4.4와 호환되지 않는 영구적인 5.0 기능을 모두 제거합니다. 여기에는 다음이 포함됩니다.

time series 컬렉션

모든 time series 컬렉션을 제거합니다.

런타임 감사 필터 관리

노드 구성 파일에서 auditLog.runtimeConfiguration을 false로 설정하여 런타임 감사 필터 관리를 비활성화합니다.
로컬 구성 파일에서 이 mongod 또는 mongos 인스턴스에 대한 감사 필터를 업데이트합니다.

7. 5.0 기능 제거

5.0 기능을 사용하는 모든 영구 기능을 제거합니다. 여기에는 다음이 포함되지만 이에 국한되지는 않습니다.

뷰 정의에 $dateAdd 또는 $sampleRate와 같은 5.0 연산자가 포함된 경우 해당 연산자를 제거해야 합니다. 전체 목록은 새 집계 연산자를 참조하세요.

절차

샤드 cluster 다운그레이드

경고

다운그레이드 절차를 진행하기 전에 cluster의 지연된 복제본 세트 멤버를 포함한 모든 멤버가 필수 변경 사항을 반영하는지 확인합니다. 즉, 다운그레이드하기 전에 featureCompatibilityVersion 및 각 노드에 대해 호환되지 않는 기능 제거를 확인합니다.

중요

5.0에서 다운그레이드해야 하는 경우 최신 패치 릴리스인 4.4로 다운그레이드합니다.

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

mongosh 를 샤드 클러스터의 mongos 인스턴스에 연결하고 sh.stopBalancer() 를 실행하여 밸런서를 비활성화합니다.

sh.stopBalancer()

참고

마이그레이션이 진행 중인 경우 시스템은 밸런서를 중지하기 전에 진행 중인 마이그레이션을 완료합니다. sh.isBalancerRunning()을 실행하여 밸런서의 현재 상태를 확인할 수 있습니다.

밸런서가 비활성화되었는지 확인하려면 sh.getBalancerState()를 실행하면 밸런서가 비활성화된 경우 false를 반환합니다.

sh.getBalancerState()

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

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

바이너리를 다운그레이드하고 다시 시작합니다.

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

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

샤드의 세컨더리 멤버를 한 번에 하나씩 다운그레이드합니다.
1. mongosh에서 다음 명령을 실행하여 완전히 종료하거나 mongod 프로세스를 안전하게 종료하는 추가 방법을 보려면 mongod 프로세스 중지를 참조합니다.
  db.adminCommand( { shutdown: 1 } )
2. 5.0 바이너리를 4.4 바이너리로 바꾸고 다시 시작합니다.
3. 다음 세컨더리 멤버를 다운그레이드하기 전에 멤버가 SECONDARY 상태로 복구될 때까지 기다립니다. 멤버의 상태를 확인하려면 mongosh 를 샤드에 연결하고 rs.status() 메서드를 실행합니다.
  각 세컨더리 멤버에 대해 다운그레이드하려면 이 과정을 반복합니다.
샤드 중재자(있는 경우)를 다운그레이드합니다.
복제본 세트에 중재자가 포함되어 있지 않으면 이 단계를 건너뛰세요.
1. mongosh에서 다음 명령을 실행하여 완전히 종료하거나 mongod 프로세스를 안전하게 종료하는 추가 방법을 보려면 mongod 프로세스 중지를 참조합니다.
  db.adminCommand( { shutdown: 1 } )
2. 중재자 데이터 디렉토리의 내용을 삭제합니다. storage.dbPath 구성 설정 또는 --dbpath 명령줄 옵션이 중재자 mongod 의 데이터 디렉토리를 지정합니다.
  rm -rf /path/to/mongodb/datafiles/*
3. 5.0 바이너리를 4.4 바이너리로 바꾸고 다시 시작합니다.
4. 멤버가 ARBITER 상태로 복구될 때까지 기다립니다. 멤버의 상태를 확인하려면 mongosh 를 멤버에 연결하고 rs.status() 메서드를 실행합니다.
샤드의 프라이머리를 다운그레이드합니다.
1. 복제본 세트 프라이머리를 단계적으로 낮춥니다. mongosh 를 프라이머리에 연결하고 rs.stepDown() 를 사용하여 프라이머리를 물러나고 새 프라이머리를 강제로 선출합니다.
  rs.stepDown()
2. rs.status() 을(를) 실행합니다.
  rs.status()
  상태가 프라이머리가 물러나고 다른 멤버가 PRIMARY 상태를 취했다고 표시되면 계속 진행합니다.
3. mongosh 에서 다음 명령을 실행하여 강등된 프라이머리를 완전히 종료하거나 mongod 프로세스 중지 를 참조하여 mongod 프로세스를 안전하게 종료합니다.
  db.adminCommand( { shutdown: 1 } )
4. 5.0 바이너리를 4.4 바이너리로 바꾸고 다시 시작합니다.

나머지 샤드에 대해서도 이 과정을 반복합니다.

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

config 서버의 복제본 세트(CSRS)의 세컨더리 멤버를 한 번에 하나씩 다운그레이드합니다.
1. mongosh에서 다음 명령을 실행하여 완전히 종료하거나 mongod 프로세스를 안전하게 종료하는 추가 방법을 보려면 mongod 프로세스 중지를 참조합니다.
  db.adminCommand( { shutdown: 1 } )
2. 5.0 바이너리를 4.4 바이너리로 바꾸고 다시 시작합니다.
3. 다음 세컨더리 멤버를 다운그레이드하기 전에 멤버가 SECONDARY 상태로 복구될 때까지 기다립니다. 멤버의 상태를 확인하려면 mongosh 를 샤드에 연결하고 rs.status() 메서드를 실행합니다.
  각 세컨더리 멤버에 대해 다운그레이드하려면 이 과정을 반복합니다.
config 서버 프라이머리를 단계적으로 낮춥니다.
1. 프라이머리에 mongosh를 연결하고 rs.stepDown()을 사용하여 기존 프라이머리를 우선 순위에서 내려오게 하고 강제로 새 프라이머리에 대한 투표를 진행합니다.
  rs.stepDown()
2. rs.status() 을(를) 실행합니다.
  rs.status()
  상태가 프라이머리가 물러나고 다른 멤버가 PRIMARY 상태를 취했다고 표시되면 계속 진행합니다.
3. mongosh 에서 다음 명령을 실행하여 강등된 프라이머리를 완전히 종료하거나 mongod 프로세스 중지 를 참조하여 mongod 프로세스를 안전하게 종료합니다.
  db.adminCommand( { shutdown: 1 } )
4. 5.0 바이너리를 4.4 바이너리로 바꾸고 다시 시작합니다.

밸런서 다시 활성화

샤드 클러스터 구성 요소의 다운그레이드가 완료되면 mongosh 를 mongos 에 연결 하고 밸런서를 다시 활성화합니다.

sh.startBalancer()

mongosh 메서드 sh.startBalancer() 도 샤드 클러스터에 대한 자동 분할을 활성화합니다.

돌아가기

복제본 세트

ChangeLog