문서 메뉴

문서 홈애플리케이션 개발MongoDB 매뉴얼

4 을(를) 다운그레이드합니다.4 복제본 세트가 4 으)로 설정되었습니다.2

이 페이지의 내용

  • 다운그레이드 경로
  • 백업 생성
  • 액세스 제어
  • 전제 조건
  • 절차

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

중요

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

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

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

예를 들어 4 4 42을 다운그레이드할 수 있습니다. -series 를 로 설정합니다.4 2-series 배포. 그러나 해당 을 더 다운그레이드합니다.4 0에 시리즈 배포. -시리즈 배포는 지원되지 않습니다.

경고

다운그레이드 플로어

버전 4.4에서 다운그레이드해야 하는 경우 4.2.6 이상 버전으로 다운그레이드합니다. 4.2.5 이하 버전으로 다운그레이드할 수 없습니다.

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

복제본 세트에 액세스 제어가 활성화되어 있는 경우 다운그레이드 사용자 권한에 데이터베이스 전체에서 인덱스를 나열하고 관리할 수 있는 권한이 포함되어야 합니다. root 역할을 가진 사용자에게 필요한 권한이 있습니다.

4.2에서 4.0으로 다운그레이드하려면 지속되고 호환되지 않는 기능을 제거하거나 호환되지 않는 구성 설정을 업데이트해야 합니다.

MongoDB 4.4부터 시작됩니다:

샤딩되지 않은 collection 및 view의 네임스페이스 길이 제한은 255 바이트이며, 샤드 collection의 경우 235 바이트입니다. collection 또는 view의 경우 네임스페이스에는 데이터베이스 이름, 점(.) 구분 기호, collection/view 이름(예: <database>.<collection>)이 포함됩니다.

다운그레이드하기 전에 기능 호환성 버전(fCV) 4.2의 120바이트 네임스페이스 길이 제한을 초과하는 네임스페이스가 있는 모든 컬렉션 또는 뷰를 해결합니다.

네임스페이스가 120바이트 제한을 초과하는 collection이나 뷰가 있는지 확인하려면 mongo shell을 프라이머리 셸에 연결하고 다음을 실행합니다.

db.adminCommand("listDatabases").databases.forEach(function(d){
let mdb = db.getSiblingDB(d.name);
mdb.getCollectionInfos( ).forEach(function(c){
namespace = d.name + "." + c.name
namespacelenBytes = encodeURIComponent(namespace).length
if (namespacelenBytes > 120) {
print (c.type.toUpperCase() + " namespace exceeds 120 bytes:: " + namespace )
}
} )
})

collection 또는 뷰 네임스페이스가 120바이트를 초과하는 경우 FCV를 다운그레이드하기 전에 을(를) 사용합니다.

  • renameCollection 명령을 사용하여 collection의 이름을 변경합니다.

  • 뷰의 경우 db.createView() 를 사용하여 더 짧은 이름을 사용하여 뷰를 다시 만든 다음 원래 뷰를 삭제합니다.

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

  • 2} 또는 상태의 ROLLBACK RECOVERING 복제본 집합 구성원이 없는지 확인합니다.

  • fCV(featureCompatibilityVersion): '4.2' 로 다운그레이드 replSetReconfig 를 암시적으로 수행하여 구성 문서에서 term 필드를 제거하고 새 구성이 대부분의 복제본 세트 구성원에 전파될 때까지 차단합니다.

복제본 세트의 featureCompatibilityVersion 를 다운그레이드하려면 다음을 수행합니다.

  1. mongo 셸을 프라이머리에 연결합니다.

  2. featureCompatibilityVersion"4.2"로 다운그레이드합니다.

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

    setFeatureCompatibilityVersion 명령은 내부 시스템 collection에 대한 쓰기를 수행하며 멱등원입니다. 어떤 이유로든 명령이 성공적으로 완료되지 않으면 프라이머리에서 명령을 다시 시도합니다.

  3. 복제본 세트의 모든 멤버가 업데이트된 featureCompatibilityVersion 을 반영하도록 하려면 각 복제본 세트 멤버에 연결하여 featureCompatibilityVersion 을 확인합니다.

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

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

    "featureCompatibilityVersion" : { "version" : "4.2" }

    멤버가 "4.4"featureCompatibilityVersion 를 반환하는 경우 계속하기 전에 멤버가 버전 "4.2" 를 반영할 때까지 기다립니다.

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

참고

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

예를 들어, MongoDB 4.4 cluster의 중재자의 fCV 값은 4.2입니다.

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

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

복합 해시 인덱스

모든 복합 해시 인덱스를 제거합니다.

collection에서 복합 해시 인덱스를 식별하려면 db.collection.getIndexes() 를 사용하고 해당 인덱스를 제거하려면 db.collection.dropIndex() 를 사용합니다.

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

경고

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

1

패키지 관리자나 수동 다운로드를 사용하여 4.2 시리즈의 최신 릴리스를 다운로드합니다. 패키지 관리자를 사용하는 경우 4.2 바이너리에 대한 새 리포지토리를 추가한 다음 실제 다운그레이드 프로세스를 수행합니다.

중요

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

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

2

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

  1. mongosh 에서 다음 명령을 실행하여 완전히 종료하거나 mongod 프로세스 중지 를 참조하여 mongod 프로세스를 안전하게 종료합니다.

    db.adminCommand( { shutdown: 1 } )
  2. 4.4 바이너리를 4.2 바이너리로 교체하고 다시 시작합니다.

  3. 다음 세컨더리를 다운그레이드하기 전에 멤버가 SECONDARY 상태로 복구될 때까지 기다리세요. 멤버의 상태를 확인하려면 rs.status() mongo shell에서 메서드를 사용합니다.

  4. 멤버가 SECONDARY 단계가 되면 다음 세컨더리를 다운그레이드합니다.

3

복제본 세트에 중재자가 포함되어 있지 않으면 이 단계를 건너뛰세요.

복제본 세트의 중재자 멤버를 다운그레이드합니다.

  1. mongosh 에서 다음 명령을 실행하여 완전히 종료하거나 mongod 프로세스 중지 를 참조하여 mongod 프로세스를 안전하게 종료할 수 있습니다.

    db.adminCommand( { shutdown: 1 } )
  2. 중재자 데이터 디렉토리의 내용을 삭제합니다. storage.dbPath 구성 설정 또는 --dbpath 명령줄 옵션이 중재자 mongod 의 데이터 디렉토리를 지정합니다.

    rm -rf /path/to/mongodb/datafiles/*
  3. 4.4 바이너리를 4.2 바이너리로 교체하고 다시 시작합니다.

  4. 멤버가 ARBITER 상태로 복구될 때까지 기다립니다. 멤버의 상태를 확인하려면 mongo shell을 멤버에 연결하고 rs.status() 메서드를 실행합니다.

4

shell에서 rs.stepDown() 를 사용하여 mongo 프라이머리 를 물러나고 일반적인 페일오버 절차를 강제 실행합니다.

rs.stepDown()

rs.stepDown() 은 페일오버 절차를 신속하게 수행할 수 있으며 프라이머리를 직접 종료하는 것보다 낫습니다.

5

rs.status() 가 프라이머리가 물러나고 다른 멤버가 PRIMARY 상태를 취했음을 표시하는 경우:

  1. mongosh 에서 다음 명령을 실행하여 완전히 종료하거나 mongod 프로세스 중지 를 참조하여 mongod 프로세스를 안전하게 종료할 수 있습니다.

    db.adminCommand( { shutdown: 1 } )
  2. mongod 바이너리를 4.2 바이너리로 바꾸고 다시 시작합니다.

← 4 을(를) 다운그레이드합니다.4 4 에 대한 독립형 .2