mongosync

글로벌 옵션

--acceptDisclaimer

내장된 검증자 및 mongosync beta 를 사용하는 경우 beta 기능에 대한 면책 조항을 수락합니다.

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

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

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

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

--cluster0 <uri>

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

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

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

경고

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

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

--cluster1 <uri>

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

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

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

경고

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

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

--config <filename>

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

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

--disableTelemetry

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

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

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

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

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

--help, -h

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

--id <id>

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

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

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

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

--loadLevel <level>

유형: integer

기본값: 3

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

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

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

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

경고

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

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

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

--logPath <directory>

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

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

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

참고

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

kill -s USR1 $mongosync_pid

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

--migrationName <name>

중요

Cluster-to-Cluster Sync beta 프로그램

이 기능 은 mongosync beta 에서만 사용할 수 있습니다. 학습 내용은 Cluster-to-Cluster Sync beta 프로그램을 참조하세요.

mongosync-beta 1.8부터 동기화 작업에 대한 마이그레이션 이름을 설정합니다. 예를 들어 여러 소스 클러스터에서 하나의 대상 클러스터로 각 동기화 작업을 식별하는 마이그레이션 이름을 설정할 수 있습니다.

migrationName 문자열은 최대 44자의 영숫자 및 밑줄 문자를 포함할 수 있습니다. 마이그레이션 메타데이터 데이터베이스 이름을 설정하기 위해 문자열 "mongosync_internal_"에 migrationName이 추가됩니다.

예를 들어 migrationName 을 "cluster_27000_to_cluster_35000_sync"로 설정하면 결과로 생성되는 mongosync 메타데이터 데이터베이스 이름은 "mongosync_internal_cluster_27000_to_cluster_35000_sync"입니다.

전체 예제는 다대일 마이그레이션 또는 A->B->C 마이그레이션을 참조하세요.

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

--port

기본값: 27182

Cluster-to-Cluster Sync HTTP API에 HTTP 서버가 사용하는 포트를 설정합니다.

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

--verbosity <level>

기본값: DEBUG

로그 메시지에 사용할 상세도 수준을 설정합니다.Cluster-to-Cluster Sync는 지정된 수준의 모든 메시지 및 더 낮은 수준의 메시지를 기록합니다.

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

• TRACE

• DEBUG

• INFO

• WARN

• ERROR

• FATAL

• PANIC

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

--version, -v

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