명령줄 옵션 또는 구성 파일 사용하여 스타트업 시mongosync 인스턴스를 구성할 수 있습니다. 구성 파일 mongosync
명령줄 옵션에 해당하는 설정 값을 지정합니다.
mongosync
마이그레이션중에 동기화 중 재구성의 단계에 따라 특정 mongosync
설정을 재구성할 수 있습니다.
구성 파일
대부분의 mongosync
명령줄 옵션 을 YAML 파일 에 쓰기 (write) 수 있습니다. 구성 파일 은 YAML 형식을 사용하여 각 설정에 대한 값을 지정합니다.
예를 들면 다음과 같습니다.
cluster0: "mongodb://192.0.2.10:27017" cluster1: "mongodb://192.0.2.20:27017" logPath: "/var/log/mongosync" verbosity: "WARN"
구성 파일 을 사용하려면 --config
옵션으로 mongosync
를 시작하여 파일 경로를 설정하다 합니다.
mongosync --config <configPath>
설정
구성 파일 사용하여 다음 mongosync
설정을 구성할 수 있습니다.
명령줄 에서 를 구성하려면 mongosync
명령줄 옵션을 참조하세요.
참고
start
명령은 reversibility
및 user write blocking
같은 기능에 대한 추가 옵션을 제공합니다. 자세한 내용은 시작 API 문서를 참조하세요.
acceptDisclaimer
유형: bool
내장된검증자에 대한 면책조항에 동의합니다.
이 설정 없이
mongosync
프로세스 시작되면 각 고지 사항을 수락하라는 메시지가 표시됩니다.이 설정을 사용하면 이미 고지 사항을 읽고 수락한 사용자가 고지 사항을 수락하고
mongosync
프로세스 시작할 수 있습니다.명령줄에서
acceptDisclaimer
설정을 지정하려면--acceptDisclaimer
옵션을 참조하세요.버전 1.9에 새로 추가되었습니다.
cluster0
유형: 문자열
첫 번째 클러스터에 대한 연결 URI를 설정합니다. 첫 번째 클러스터는 동기화 프로세스에서 소스 또는 대상 역할을 할 수 있습니다.
start
API 엔드포인트에 대한 호출에서 소스 및 대상 클러스터를 지정합니다.mongosync
연결에 대한 자세한 내용은 연결을 참조하세요.명령줄에서
cluster0
설정을 지정하려면--cluster0
옵션을 참조하세요.
cluster1
유형: 문자열
두 번째 클러스터에 대한 연결 URI를 설정합니다. 두 번째 클러스터는 동기화 프로세스에서 소스 또는 대상 역할을 할 수 있습니다.
start
API 엔드포인트에 대한 호출에서 소스 및 대상 클러스터를 지정합니다.mongosync
연결에 대한 자세한 내용은 연결을 참조하세요.명령줄에서
cluster1
설정을 지정하려면--cluster1
옵션을 참조하세요.
disableTelemetry
유형: 부울
버전 1.4.0에 추가되었습니다.
mongosync
에 대한 원격 분석 데이터 수집을 비활성화합니다.기본적으로
mongosync
는 MongoDB 제품을 개선하기 위해 익명의 애그리게이션된 사용 데이터를 수집합니다.mongosync
를 실행하면 이 원격 분석 데이터 수집을 사용하지 않도록 설정할 수 있습니다.명령줄에서
disableTelemetry
설정을 지정하려면--disableTelemetry
옵션을 참조하세요.자세한 내용은 사용자 데이터 컬렉션을 참고하세요.
id
유형: 문자열
mongosync
인스턴스의 식별자를 설정합니다샤딩된 클러스터에서 여러
mongosync
인스턴스를 실행할 때 이 설정을 사용하여 샤드를 개별적으로 동기화합니다.이 설정의 식별자 값은 동기화하는 샤드의 샤드 ID와 일치해야 합니다. 샤드 ID를 찾으려면
listShards
명령을 사용하세요.명령줄에서
id
설정을 지정하려면--id
옵션을 참조하세요.
loadLevel
유형: integer
기본값:
3
소스 클러스터와 대상 클러스터 간의 데이터 동기화를 위한 클러스터 워크로드 수준을 설정합니다.
4
가장 높은 설정, 클러스터 워크로드를 최대화하고 데이터를 가장 빠르게 동기화합니다.1
로 설정하면 클러스터 워크로드가 최소화되고 데이터 동기화 속도가 가장 느려집니다.
명령줄에서
loadLevel
설정을 지정하려면--loadLevel
옵션을 참조하세요.경고
loadLevel
을 기본값인3
보다 높게 설정하면 대상 클러스터 성능에 부정적인 영향을 줄 수 있습니다.소스 클러스터 에 읽기 병목 현상이 있거나 대상 클러스터 에 쓰기 (write) 병목 현상이 있는 경우
loadLevel
을(를) 낮추면 성능이 향상될 수 있습니다.버전 1.4에 새로 추가되었습니다.
logPath
유형: 문자열
로그 디렉토리 경로를 설정합니다. Mongosync는 이 디렉토리 의 파일에 로그를 씁니다.
자세한 내용은 로깅을 참조하세요.
명령줄에서
logPath
설정을 지정하려면--logPath
옵션을 참조하세요.
port
유형: integer
기본값:
27182
Mongosync HTTP API 에 HTTP 서버 가 사용하는 포트를 설정합니다.
명령줄에서
port
설정을 지정하려면--port
옵션을 참조하세요.
verbosity
유형: 문자열
기본값:
DEBUG
로그 메시지에 사용할 상세도 수준을 설정합니다. Mongosync는 지정된 수준의 모든 메시지와 하위 수준의 모든 메시지를 기록합니다.
verbosity
설정은 다음 값을 지원합니다.TRACE
DEBUG
INFO
WARN
ERROR
FATAL
PANIC
명령줄에서
verbosity
설정을 지정하려면--verbosity
옵션을 참조하세요.
mongosync
동기화 중 재구성
중요
마이그레이션 중에는 다음 설정만 조정할 수 있습니다. 다른 설정은 다시 mongosync
시작하는 사이에 변경되지 않은 상태로 유지되어야 합니다.
mongosync
이(가) 동기화되는 동안 다음 --config
단계를 수행하여 , --disableTelemetry
--verbosity
, --loadLevel
, --logPath
, --port
및 옵션을 재구성할 수 있습니다.
(선택 사항)mongosync
프로세스 일시 중지
실행 각 pause
프로세스 mongosync
에서 를 실행합니다.
마지막 단계에 표시된 대로 나중에 일시 중지된 상태에서 mongosync
프로세스를 재개할 수 있습니다.
팁
재구성 후 데이터 동기화 작업을 즉시 재개하지 않으려면 mongosync
프로세스를 일시 중지하는 것이 좋습니다. 이는 여러 mongosync
프로세스의 작업을 조정할 때 유용합니다.
(선택 사항) 구성 파일 업데이트
--config
옵션을 사용하여 를 처음 초기화할 때 구성 파일 의 mongosync
경로를 설정하다 경우, 각 설정에 대한 새 값으로 이 구성 파일 업데이트 .
프로세스 초기화 mongosync
마지막 단계에서 구성 파일 업데이트한 경우 mongosync
옵션을 --config
업데이트된 구성 파일 의 경로로 설정하다 프로세스를 초기화합니다.
mongosync --config <configPath>
를 처음 초기화할 때 옵션을 --config
사용하지 않은 경우,mongosync
mongosync
명령줄 옵션을 업데이트된 값으로 설정하다 프로세스를 초기화합니다.
mongosync \ --cluster0 "<cluster0_connection_string>" \ --cluster1 "<cluster1_connection_string>" \ --loadLevel <newLevel>
자세한 내용은 mongosync 초기화를 참조하세요.
프로세스 시작 mongosync
또는 재개
mongosync
선택적 첫 번째 단계의 앞부분에서 프로세스를 일시 중지한 resume
경우 일시 중지된 mongosync
프로세스에서 를 실행 .
사용하지 않고 mongosync
pause
프로세스를 중지한 경우 start
중지된 mongosync
프로세스에서 를 실행 . 자세한 지침은 클러스터 간 데이터 마이그레이션을 참조하세요.
mongosync
이전 프로세스를 중지하기 전의 대략적인 위치에서 동기화 다시 시작합니다. 종료 시 진행 중이던 모든 파티션이 처음부터 다시 시작됩니다.