문서 메뉴
문서 홈
/
MongoDB 아틀라스
/
데이터 마이그레이션 또는 가져오기
/
레거시 마이그레이션(6.0 이전)
/
Atlas로 이동

실시간 마이그레이션(끌어오기) 문제 해결

이 페이지의 내용

  • 일반적인 실시간 마이그레이션(끌어오기) 유효성 검사 오류
  • 일반적인 유효성 검사 후 오류

실시간 마이그레이션(끌어오기) 프로세스가 시작되기 전에 Atlas는 필요한 모든 양식 필드와 매개 변수가 제대로 작동하고 올바른지 확인하기 위해 유효성 검사를 수행합니다. 매개변수가 유효하지 않으면 Atlas에서 오류를 반환하고 실시간 마이그레이션이 진행되지 않습니다.

이 섹션에서는 일반적인 실시간 마이그레이션(끌어오기) 유효성 검사 오류를 설명하고, 이러한 오류가 발생할 경우 확인해야 할 사항을 제시합니다.

일반적인 실시간 마이그레이션(끌어오기) 유효성 검사 오류

오류
수정
지정된 소스에 연결할 수 없습니다.

  • 소스 클러스터의 IP 액세스 목록에 올바른 서브넷 범위가 추가되었는지 확인하세요. 4가지 필수 서브넷 범위는 실시간 마이그레이션 모달 창에서 확인할 수 있습니다.

  • 지정된 호스트 이름이 공용 IP 주소로 연결되는지 확인하세요. 명령 프롬프트에서 다음 명령 중 하나를 입력하세요.

    nslookup <hostname>
    ping <hostname>

  • 풀 live migration과 호환되지 않는 VPC Peering 연결 을 사용하고 있지 않은지 확인하세요. VPC Peering 연결이 유일한 옵션인 경우 대신 mongomirror 를 사용하세요.

호스트 이름을 확인할 수 없습니다.
지정된 호스트 이름에 해당하는 IP 주소를 찾을 수 없습니다. 지정된 호스트 이름이 정확하며 공개적으로 액세스할 수 있는지 확인하세요.
잘못된 SSL 옵션이 제공되었습니다.

SSL을 사용하는 경우:

  • SSL 인증서가 완전하고 실시간 마이그레이션(끌어오기) 모달 창으로 올바르게 복사되었는지 확인하세요.

  • Is encryption in transit enabled? 토글 스위치가 Yes 위치에 있는지 확인합니다.

SSL을 사용하지 않는 경우:

  • 연결 문자열을 확인하고 ssl 쿼리 매개변수가 없는지 확인합니다. --ssl 연결 문자열의 일부인 경우 cluster에 SSL 연결이 필요합니다.

  • Is encryption in transit enabled? 토글 스위치가 No 위치에 있는지 확인합니다.

사용자 이름 또는 비밀번호가 올바르지 않습니다.

다음 명령을 사용하여 mongosh 에서 자격 증명을 확인합니다.

use admin
db.getUser("<username>");

문제가 지속되면 MongoDB 사용자의 비밀번호를 업데이트 하세요.

사용자에게 명령을 실행할 수 있는 권한이 없습니다.
실시간 마이그레이션(끌어오기) 프로세스를 실행하려면 MongoDB 사용자에게 충분한 시스템 권한이 있어야 합니다. 자세한 내용은 소스 클러스터 보안을 참조하세요.
디스크 스토리지 정보를 사용할 수 없습니다.
실시간 마이그레이션(끌어오기) 프로세스를 실행하려면 MongoDB 사용자에게 소스 클러스터의 MongoDB 인스턴스에 대한 권한이 있어야 합니다. 자세한 내용은 소스 클러스터 보안을 참조하세요.
소스 디스크 사용량이 대상에 비해 너무 큽니다.
Atlas 서비스 계층마다 사용 가능한 디스크 공간의 용량이 다릅니다. Atlas cluster의 디스크 공간이 소스 클러스터의 모든 데이터를 저장하기에 충분한지 확인하세요. 클러스터 크기 조정에 대해 자세히 알아보려면 새 클러스터 생성을 참조하세요.
소스가 독립형인 경우
소스 배포는 MongoDB 복제본 세트 여야 합니다. 소스 배포가 현재 독립형 노드인 경우, 실시간 마이그레이션(끌어오기)을 실행하기 전에 단일 노드 복제본 세트 로 변환합니다 .
제공된 CA 파일을 처리할 수 없습니다.
CA 파일이 완전하고 실시간 마이그레이션(끌어오기) 모달 창으로 올바르게 붙여 넣어졌는지 확인하세요.

일반적인 유효성 검사 후 오류

오류
수정
소스에서 최신 oplog 항목을 조회할 수 없습니다: 찾을 수 없음
--호스트가 복제본 세트인지 확인할 수 없습니다: 오류 db 서버에 연결 중: 연결 가능한 서버 없음

  • 실시간 마이그레이션(풀) 서비스에 필요한 모든 IP 주소를 소스 클러스터의 IP 액세스 목록 에 추가했는지 확인하세요.

  • 입력한 IP 주소 또는 DNS 호스트 이름 확인 공개적으로 액세스할 수 있는 IP 주소로 확인됩니다.

초기 동기화 중 oplog 항목 적용 오류: 초기 동기화 중 renameCollection 명령이 발생했습니다. mongomirror 을(를) 다시 시작하세요.

실시간 마이그레이션(끌어오기) 중에 소스 클러스터의 컬렉션 이름을 변경하면 이 오류가 발생할 수 있습니다.

  • 실시간 마이그레이션(끌어오기)이 진행되는 동안 사용자 또는 애플리케이션이 어떤 컬렉션 이름도 변경하지 않게 하세요.

  • $out 을 사용하는 애그리게이션 작업에서 이 오류가 발생할 수 trigger . 실시간 마이그레이션(끌어오기) 절차 중에 $out 작업이 발생하지 않도록 합니다.

지원되지 않는 인덱스 오류
이전 버전의 MongoDB에서 허용되었던 인덱스의 특정 유형 및 구성은 더 이상 최신 버전에서 지원되지 않습니다. 발생 가능한 충돌에 대해서는 대상 클러스터의 MongoDB 버전에 관한 릴리스 노트를 참조하세요. 필요한 경우, 실시간 마이그레이션 프로세스가 완료된 후에 오류를 유발할 수 있는 인덱스를 삭제했다가 다시 구축하세요.
소스에서 oplog를 테일링하는 동안 오류가 발생했습니다: oplog에서 사용 가능한 체크포인트 없음

실시간 마이그레이션(끌어오기)은 소스 oplog 를 사용하여 풀 실시간 마이그레이션 절차 중에 소스 클러스터에서 발생하는 작업을 동기화합니다. 소스 클러스터 oplog 크기가 너무 작으면 동기화 중에 소스 클러스터에서 발생하는 모든 작업을 기록하지 못할 수 있으며, 실시간 마이그레이션(끌어오기)이 너무 뒤쳐져 따라잡을 수 없게 됩니다.

이 오류가 표시되는 경우:

  • rs.printReplicationInfo() 명령을 사용하여 소스 클러스터 oplog 의 크기를 확인합니다. mongomirror 를 호스팅하는 서버에는 마이그레이션 프로세스 중에 생성된 oplog 데이터를 포함할 수 있는 충분한 디스크 공간이 있어야 합니다.

  • 필요한 경우 실시간 마이그레이션 절차를 완료할 수 있을 만큼 충분한 복제 기간을 지원 하도록 소스 oplog의 크기를 늘립니다 .

  • 을(를) 직접 실행할 때 오류가 mongomirror 발생하면 마이그레이션 중에 을(를) 사용하여 을(를) 다시 시작하여 mongomirror --oplogPath oplog 데이터를 디스크에 버퍼링합니다.

돌아가기

샤딩된 클러스터

다음

Cloud Manager 또는 Ops Manager에서 푸시

이 페이지의 내용