mongosync 바이너리

글로벌 옵션

--acceptDisclaimer

내장된검증자에 대한 면책조항에 동의합니다.

이 옵션 없이 mongosync 프로세스 시작되면 각 고지 사항을 수락하라는 메시지가 표시됩니다.

이 옵션을 사용하면 이미 고지 사항을 읽고 수락한 사용자가 고지 사항을 수락하고 mongosync 프로세스 시작할 수 있습니다.

구성 파일에서 --acceptDisclaimer 옵션을 설정하려면 acceptDisclaimer 설정을 참조하십시오.

버전 1.9에 추가 되었습니다.

--cluster0 <uri>

Sets the connection URI for the first cluster. The first cluster can serve as either the source or the destination in the sync process. Designate the source and destination clusters in the call to the start API endpoint.

mongosync 연결에 대한 자세한 내용은 연결을 참조하세요.

구성 파일에서 --cluster0 옵션을 설정하려면 cluster0 설정을 참조하십시오.

경고

일부 시스템에서는 연결 문자열에 --cluster0 또는 --cluster1 옵션과 함께 비밀번호를 제공하면 다른 사용자가 호출할 수 있는 ps 등의 시스템 상태 프로그램에 비밀번호가 표시될 수 있습니다.

대신 옵션을 사용하여 비밀번호가 포함된 구성 파일 지정하는 것이 좋습니다.--config

--cluster1 <uri>

두 번째 클러스터 에 대한 연결 URI를 설정합니다. 두 번째 클러스터 동기화 프로세스 에서 소스 또는 대상 제공 을 할 수 있습니다. API 엔드포인트에 대한 호출에서 소스 및 대상 클러스터를 지정합니다.start

mongosync 연결에 대한 자세한 내용은 연결을 참조하세요.

구성 파일에서 --cluster1 옵션을 설정하려면 cluster1 설정을 참조하십시오.

경고

일부 시스템에서는 연결 문자열에 --cluster0 또는 --cluster1 옵션과 함께 비밀번호를 제공하면 다른 사용자가 호출할 수 있는 ps 등의 시스템 상태 프로그램에 비밀번호가 표시될 수 있습니다.

대신 옵션을 사용하여 비밀번호가 포함된 구성 파일 지정하는 것이 좋습니다.--config

--config <filename>

구성 파일의 경로를 설정합니다.

마이그레이션 중 설정 파일 경로를 설정하려면 동기화 중 mongosync 재구성을 참조하세요.

자세한 내용은 구성 파일을 참조하세요.

--createIndexesBatchSize <number>

버전 1 의 새로운 기능입니다.19.0.

유형: integer

최소: 1

최대값: 64

대상 클러스터에서 인덱스 생성의 배치 크기를 명시적으로 설정하다. 기본값 으로 mongosync 은(는) Atlas 대상 클러스터에서 이 값을 프로그래밍 방식으로 최적화합니다.

경고

인덱스 당 100 MB-1 GB 의 메모리를 할당했는지 확인합니다. 또한 동시 인덱스 생성에 사용되는 총 메모리가 대상 클러스터 RAM 의 20% 미만으로 유지되는지 확인합니다. 인덱스 생성에 대상 RAM 의 20% 이상을 할당하면 파일 시스템 캐시 방해하여 대상 클러스터 에 대한 쓰기 버퍼링에 사용할 수 있는 메모리가 줄어들 수 있습니다.

자세한 내용은 인덱스 생성 최적화를 참조하세요.

구성 파일에서 --createIndexesBatchSize 옵션을 설정하려면 createIndexesBatchSize 설정을 참조하십시오.

--disableMetricsLogging

버전 1 의 새로운 기능입니다.16.0.

Mongosync 바이너리를 실행 때 지표 로깅을 비활성화합니다.

경고

효과적인 문제 해결 및 지원 위해 지표 로깅을 활성화된 상태로 유지하는 것이 좋습니다.

자세한 내용은 Mongosync 지표를 참조하세요.

구성 파일에서 --disableMetricsLogging 옵션을 설정하려면 disableMetricsLogging 설정을 참조하십시오.

--disableTelemetry

버전 1 의 새로운 기능입니다.4.0.

mongosync에 대한 원격 분석 데이터 수집을 비활성화합니다.

기본적으로 mongosync는 MongoDB 제품을 개선하기 위해 익명의 애그리게이션된 사용 데이터를 수집합니다. mongosync를 실행하면 이 원격 분석 데이터 수집을 사용하지 않도록 설정할 수 있습니다.

구성 파일에서 --disableTelemetry 옵션을 설정하려면 disableTelemetry 설정을 참조하십시오.

마이그레이션 중 원격 분석 데이터 수집을 비활성화하려면 동기화 중 mongosync 재구성을 참조하세요.

자세한 내용은 사용자 데이터 컬렉션을 참고하세요.

--disableVerification

내장된 검증 도구를 비활성화합니다. 비활성화하면 mongosync 는 마이그레이션 확인하지 않습니다. 다른 확인 방법은 데이터 전송 확인을 참조하세요.

이 옵션은 확인과 함께 mongosync 를 실행 때 OOM 종료를 경험하고 더 많은 리소스를 할당할 수 없거나 확인 재시작을 허용하지 않는 고객을 위한 해결 방법을 제공합니다. 확인을 비활성화한 상태에서 마이그레이션 완료할 수 있습니다. 후속 재시작 및 되돌리기를 위해 인증은 비활성화된 상태로 유지됩니다.

mongosync 이 처음 시작될 때는 이 옵션을 사용하면 안 됩니다. 대신 기본값 으로 확인이 활성화되어 있으므로 /start 요청 매개변수 verification.enabled: false 을(를) 사용하여 확인을 비활성화합니다.

설정 파일에서 검증을 비활성화하려면 disableVerification 설정을 참조하세요.

버전 1.10에 추가 되었습니다.

--enableCappedCollectionHandling

mongosync 마이그레이션 중에 새 고정 사이즈 컬렉션을 활성화 려면 이 플래그를 전달해야 합니다.

구성 파일에서 --enableCappedCollectionHandling 옵션을 설정하려면 enableCappedCollectionHandling 설정을 참조하십시오.

버전 1.20에 추가 되었습니다.

--help, -h

stdout에 사용 정보를 인쇄합니다.

--hotDocIDs

핫 문서 또는 소스 클러스터에서 매우 자주 업데이트 문서의 식별자를 설정합니다. 그런 다음 mongosync 는 마이그레이션 커밋 단계에서 이러한 문서를 복사합니다.

mongosync를 실행할 때 핫 문서로 인해 복제 지연 발생하는 마이그레이션에 이 옵션을 사용합니다.

다음 형식으로 식별자를 제공합니다.

{
   “db”: <string>, // the name of the database
   "collection" : <string>, // name of the collection
   "ids"    : [ {“_id”:<Object>”}, ...],
}

ids 필드의 객체는 유효한 표준 모드 확장 JSON 문자열이어야 합니다.

이 옵션을 여러 번 사용하여 여러 컬렉션의 문서 식별자를 제공할 수 있습니다. 다음은 컬렉션 coll1 및 coll2에서 두 개의 핫 문서 식별자를 제공하는 예시 입니다.

mongosync \
--hotDocIDs '{"db":"db1","collection":"coll1","ids":[{"_id":{"$oid":"doc1"}},{"_id":{"$oid":"6aa23c249cef3cd958e43785"}}]}' \
--hotDocIDs '{"db":"db2","collection":"coll2","ids":[{"_id":{"$oid":"70023c249cef3cd958e43269"}},{"_id":{"$oid":"7aa23c249cef3cd958e43785"}}]}' \
... other CLI arguments ...

일단 시작되면 핫 문서 식별자를 제거 할 수 없습니다. 식별자를 잘못 설정하다 경우 올바른 식별자를 사용하여 mongosync 를 다시 시작합니다.

참고

mongosync 역방향 동기화에서 핫 문서를 유지하지 않습니다. 역방향 동기화 중 핫 문서로 인해 복제 지연이 발생하면 mongosync 프로세스를 다시 시작하고 역방향에 대한 핫 문서 식별자를 지정합니다. 마이그레이션을 처음부터 다시 시작하지 마세요.

구성 파일에서 --hotDocIDs 옵션을 설정하려면 hotDocIDs 설정을 참조하십시오.

버전 1.18에 추가 되었습니다.

--id <id>

mongosync 인스턴스의 식별자를 설정합니다

샤딩된 클러스터에서 여러 mongosync 인스턴스를 실행할 때 이 옵션을 사용하여 샤드를 개별적으로 동기화합니다.

이 옵션의 식별자 값은 동기화하는 샤드 의 샤드 ID 와 일치해야 합니다. 샤드 ID 찾으려면 명령을 listShards 사용합니다.

구성 파일에서 --id 옵션을 설정하려면 id 설정을 참조하십시오.

--loadLevel <level>

유형: integer

기본값: 3

소스 클러스터와 대상 클러스터 간의 데이터 동기화를 위한 클러스터 워크로드 수준을 설정합니다.

• 4가장 높은 설정, 클러스터 워크로드를 최대화하고 데이터를 가장 빠르게 동기화합니다.

• 1로 설정하면 클러스터 워크로드가 최소화되고 데이터 동기화 속도가 가장 느려집니다.

구성 파일에서 --loadLevel 옵션을 설정하려면 loadLevel 설정을 참조하십시오.

마이그레이션 중 로드 수준을 변경하려면 동기화 중 mongosync 재구성을 참조하세요.

경고

loadLevel을 기본값인 3보다 높게 설정하면 대상 클러스터 성능에 부정적인 영향을 줄 수 있습니다.

소스 클러스터 에 읽기 병목 현상이 있거나 대상 클러스터 에 쓰기 (write) 병목 현상이 있는 경우 loadLevel 을(를) 낮추면 성능이 향상될 수 있습니다.

버전 1.4에 추가 되었습니다.

--logPath <directory>

로그 디렉토리 경로를 설정합니다. Mongosync는 이 디렉토리 의 파일에 로그를 씁니다.

자세한 내용은 로깅을 참조하세요.

구성 파일에서 --logPath 옵션을 설정하려면 logPath 설정을 참조하십시오.

마이그레이션 중 로그 디렉토리 경로를 변경하려면 동기화 중 mongosync 재구성을 참조하세요.

참고

--logPath 옵션으로 mongosync 를 시작하는 경우 mongosync 프로세스에 USR1 신호를 보내 로그 파일을 회전할 수 있습니다.

kill -s USR1 $mongosync_pid

$mongosync_pid mongosync 프로세스 ID입니다.

--metricsLoggingFilepath <directory>

버전 1 의 새로운 기능입니다.16.0.

지표 로그 디렉토리 경로를 설정합니다. Mongosync는 이 디렉토리 의 파일에 지표 로그를 기록합니다.

자세한 내용은 Mongosync 지표를 참조하세요.

구성 파일에서 --metricsLoggingFilepath 옵션을 설정하려면 metricsLoggingFilepath 설정을 참조하십시오.

--port

기본값: 27182

Mongosync HTTP API 에 HTTP 서버 가 사용하는 포트를 설정합니다.

구성 파일에서 --port 옵션을 설정하려면 port 설정을 참조하십시오.

마이그레이션 중 포트를 변경하려면 동기화 중 mongosync 재구성을 참조하세요.

--verbosity <level>

기본값: DEBUG

로그 메시지에 사용할 상세도 수준을 설정합니다. Mongosync는 지정된 수준의 모든 메시지와 하위 수준의 모든 메시지를 기록합니다.

--verbosity 옵션은 다음 값을 지원합니다.

• TRACE

• DEBUG

• INFO

• WARN

• ERROR

• FATAL

• PANIC

구성 파일에서 --verbosity 옵션을 설정하려면 verbosity 설정을 참조하십시오.

마이그레이션 중 상세 수준을 변경하려면 동기화 중 mongosync 재구성을 참조하세요.

--version, -v

mongosync 버전 정보를 stdout에 출력합니다.