Join us Sept 17 at .local NYC! Use code WEB50 to save 50% on tickets. Learn more >
MongoDB Event
Docs Menu
Docs Home
/
MongoDB Mongosync
/
참조

구성

명령줄 옵션 또는 구성 파일 사용하여 스타트업 시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 옵션을 참조하세요.

disableMetricsLogging

유형: 부울

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

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

경고: 효과적인 문제 해결 및 지원 용이하게 하려면 지표 로깅을 활성화된 상태로 유지하는 것이 좋습니다.

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

명령줄에서 disableMetricsLogging 설정을 지정하려면 --disableMetricsLogging 옵션을 참조하세요.

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

disableTelemetry

유형: 부울

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

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

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

명령줄에서 disableTelemetry 설정을 지정하려면 --disableTelemetry 옵션을 참조하세요.

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

disableVerification

유형: 부울

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

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

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

명령줄에서 확인을 비활성화하려면 옵션을 --disableVerification 참조하세요.

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

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 옵션을 참조하세요.

metricsLoggingFilepath

유형: 문자열

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

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

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

명령줄에서 metricsLoggingFilepath 설정을 지정하려면 --metricsLoggingFilepath 옵션을 참조하세요.

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 및 옵션을 재구성할 수 있습니다.

1

(선택 사항)mongosync 프로세스 일시 중지

실행 각 pause 프로세스 mongosync 에서 를 실행합니다.

마지막 단계에 표시된 대로 나중에 일시 중지된 상태에서 mongosync 프로세스를 재개할 수 있습니다.

팁

재구성 후 데이터 동기화 작업을 즉시 재개하지 않으려면 mongosync 프로세스를 일시 중지하는 것이 좋습니다. 이는 여러 mongosync 프로세스의 작업을 조정할 때 유용합니다.

2

프로세스 중지 mongosync

운영 체제를 사용하여 실행 각 mongosync 프로세스 중지합니다. 구체적인 단계는 운영 체제 설명서를 참조하세요.

3

(선택 사항) 구성 파일 업데이트

--config 옵션을 사용하여 를 처음 초기화할 때 구성 파일 의 mongosync 경로를 설정하다 경우, 각 설정에 대한 새 값으로 이 구성 파일 업데이트 .

4

프로세스 초기화 mongosync

마지막 단계에서 구성 파일 업데이트한 경우 mongosync 옵션을 --config 업데이트된 구성 파일 의 경로로 설정하다 프로세스를 초기화합니다.

mongosync --config <configPath>

를 처음 초기화할 때 옵션을 --config 사용하지 않은 경우,mongosync mongosync 명령줄 옵션을 업데이트된 값으로 설정하다 프로세스를 초기화합니다.

mongosync \
      --cluster0 "<cluster0_connection_string>" \
      --cluster1 "<cluster1_connection_string>" \
      --loadLevel <newLevel>

자세한 내용은 mongosync 초기화를 참조하세요.

5

프로세스 시작 mongosync 또는 재개

mongosync 선택적 첫 번째 단계의 앞부분에서 프로세스를 일시 중지한 resume 경우 일시 중지된 mongosync 프로세스에서 를 실행 .

사용하지 않고 mongosync pause 프로세스를 중지한 경우 start 중지된 mongosync 프로세스에서 를 실행 . 자세한 지침은 클러스터 간 데이터 마이그레이션을 참조하세요.

mongosync 이전 프로세스를 중지하기 전의 대략적인 위치에서 동기화 다시 시작합니다. 종료 시 진행 중이던 모든 파티션이 처음부터 다시 시작됩니다.

돌아가기

행동

다음

시작하기

이 페이지의 내용