Menu Docs
Página inicial do Docs
/
Sincronização de Cluster-to-Cluster do MongoDB
/
Referência

Configuração

Nesta página

  • Arquivo de configuração
  • Configurações
  • Reconfigurar mongosync durante a sincronização
  • (Opcional) Pause os processos do mongosync
  • Pare os processos mongosync
  • (Opcional) Atualize seu arquivo de configuração
  • Inicialize os processos do mongosync
  • Inicie ou retome os processos mongosync

Você pode configurar instâncias demongosync do na inicialização utilizando opções de linha de comando ou um arquivo de configuração. O arquivo de configuração especifica valores para configurações que são equivalentes às opções de linha de comando mongosync.

Durante uma migração, é possível reconfigurar determinadas mongosync configurações do seguindo as etapas em Reconfigurar mongosync durante a sincronização.

Arquivo de configuração

Você pode escrever a maioria das opções de linha de comando mongosync em um arquivo YAML. O arquivo de configuração especifica valores para cada configuração usando o formato YAML.

Por exemplo:

cluster0: "mongodb://192.0.2.10:27017"
cluster1: "mongodb://192.0.2.20:27017"
logPath: "/var/log/mongosync"
verbosity: "WARN"

Para usar um arquivo de configuração, inicie o mongosync com a opção --config para definir o caminho para o arquivo:

mongosync --config <configPath>

Configurações

Você pode definir as seguintes configurações do mongosync usando um arquivo de configuração.

Para configurar a mongosync partir da linha de comando, consulte Opções de linha de comando.

Observação

O comando start fornece opções adicionais para recursos como reversibility e user write blocking. Para obter mais detalhes, consulte a documentação da API start.

acceptDisclaimer

Tipo: bool

Aceita isenções de responsabilidade para o verificador incorporado.

Quando o processo mongosync começa sem essa configuração, o usuário é solicitado a aceitar cada termo de responsabilidade.

Esta configuração permite que os usuários que já leram e aceitaram isenções de responsabilidade aceitem o aviso e iniciem o processo mongosync.

Para definir a configuração acceptDisclaimer na linha de comando, consulte a opção --acceptDisclaimer.

Novidades na versão 1.9.

cluster0

Tipo: string

Define o URI de conexão para o primeiro cluster. O primeiro cluster pode servir como origem ou destino no processo de sincronização. Designe os clusters de origem e de destino na chamada para o endpoint da API start.

Para obter mais informações sobre como conectar o mongosync, consulte Conexões.

Para definir a configuração cluster0 na linha de comando, consulte a opção --cluster0.

cluster1

Tipo: string

Define o URI de conexão para o segundo cluster. O segundo cluster pode servir como origem ou destino no processo de sincronização. Designe os clusters de origem e de destino na chamada para o endpoint da API start.

Para obter mais informações sobre como conectar o mongosync, consulte Conexões.

Para definir a configuração cluster1 na linha de comando, consulte a opção --cluster1.

disableTelemetry

Tipo: booleano

Novidades na versão 1,4,0.

Desabilita a collection de dados de telemetria para mongosync.

Por padrão, o mongosync coleta dados de uso agregados e anônimos para melhorar os produtos MongoDB. Ao executar mongosync, você pode desabilitar a coleta desses dados de telemetria.

Para definir a configuração disableTelemetry na linha de comando, consulte a opção --disableTelemetry.

Para mais informações, consulte Coleta de Dados do Usuário.

disableVerification

Tipo: booleano

Desabilita o Verificador incorporado. Quando desabilitado, o mongosync não verifica a migração. Para métodos de verificação alternativos, consulte Verificar transferência de dados.

Essa opção fornece uma solução alternativa para clientes que sofrem OOM kills ao executar mongosync com verificação e não podem alocar mais recursos ou tolerar reiniciar a verificação. Ele permite que a migração seja concluída com a verificação desativada. A verificação permanece desativada para reinicializações e reversões subsequentes.

Esta opção não deve ser utilizada quando mongosync for iniciado inicialmente. Em vez disso, desabilite a verificação com o parâmetro de solicitação /start, verification.enabled: false pois a verificação está ativada por padrão.

Para desativar a verificação na linha de comando, consulte a --disableVerification opção.

Novidade na versão 1.10.

id

Tipo: string

Define um identificador para a instância mongosync.

Use esta configuração ao executar várias instâncias do mongosync em um cluster fragmentado, para sincronizar os fragmentos individualmente.

O valor do identificador para esta configuração deve corresponder ao ID de fragmento do fragmento que ele sincroniza. Para localizar o ID de fragmento, utilize o comando listShards.

Para definir a configuração id na linha de comando, consulte a opção --id.

loadLevel

Tipo: inteiro

Padrão: 3

Define o nível de volume de trabalho do cluster para sincronizar dados entre os clusters de origem e destino:

  • 4, a configuração mais alta, maximiza a carga de trabalho do cluster e sincroniza os dados mais rapidamente.

  • 1, a configuração mais baixa, minimiza o volume de trabalho do cluster e sincroniza os dados de forma mais lenta.

Para definir a configuração loadLevel na linha de comando, consulte a opção --loadLevel.

Aviso

Configurar loadLevel maior que o padrão de 3 pode afetar negativamente o desempenho do cluster de destino.

Se houver gargalos de leitura no cluster de origem ou se houver gargalos de gravação no cluster de destino, diminuir loadLevel poderá melhorar o desempenho.

Novidade na versão 1.4.

logPath

Tipo: string

Define o caminho para o diretório de logs. A sincronização de cluster para cluster grava logs em arquivos neste diretório.

Para obter mais informações, consulte Registro de log.

Para definir a configuração logPath na linha de comando, consulte a opção --logPath.

port

Tipo: inteiro

Padrão: 27182

Define a porta usada pelo servidor HTTP para a API HTTP de Cluster-to-Cluster Sync.

Para definir a configuração port na linha de comando, consulte a opção --port.

verbosity

Tipo: string

Padrão: DEBUG

Define o nível de verbosidade a ser usado em mensagens de registro. A sincronização de cluster para cluster registra todas as mensagens no nível especificado e todas as mensagens em níveis inferiores.

A configuração verbosity suporta os seguintes valores:

  • TRACE

  • DEBUG

  • INFO

  • WARN

  • ERROR

  • FATAL

  • PANIC

Para definir a configuração verbosity na linha de comando, consulte a opção --verbosity.

Reconfigurar mongosync durante a sincronização

Importante

Somente as seguintes configurações podem ser ajustadas durante uma migração. Outras configurações devem permanecer inalteradas entre mongosync reinicializações.

Enquanto mongosync estiver sincronizando, você pode reconfigurar as --config --disableTelemetryopções , , --loadLevel --logPath, --port, e --verbosity executando as seguintes etapas:

1

(Opcional) Pausar os mongosync processos

Execute em pause cada mongosync processo de em execução.

Você pode retomar os processos mongosync mais tarde a partir do estado de pausa, como mostrado na etapa final.

Dica

Se você não quiser retomar imediatamente as operações de sincronização de dados após a reconfiguração, considere pausar os processos mongosync. Isso é útil se você estiver coordenando operações de vários processos do mongosync.

2

Interromper os mongosync processos

Use seu sistema operacional para interromper cada processo mongosync em execução. Para obter as etapas específicas, consulte a documentação do seu sistema operacional.

3

(Opcional) Atualize seu arquivo de configuração

Se você utilizou a opção para definir o caminho para um arquivo de configuração quando inicializou pela --config primeira mongosync vez, atualize esse arquivo de configuração com o novo valor para cada configuração.

4

Inicialize os mongosync processos

Se você atualizou um arquivo de configuração na última etapa, inicialize os mongosync processos do com a opção definida para o caminho do arquivo de configuração --config atualizado:

mongosync --config <configPath>

Se você não utilizou a opção quando inicializou pela primeira vez --config mongosync o, inicialize os mongosync processos do com as opções de linha de comando definidas para seus valores atualizados:

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

Para mais informações, consulte Inicializar mongosync.

5

Inicie ou retome os mongosync processos

Se você pausou algum mongosync processo anteriormente na primeira etapa opcional, execute resume nos mongosync processos pausados.

Se você interrompeu algum mongosync processo sem usar pause, execute nos start processos mongosync interrompidos. Para obter instruções mais detalhadas, consulte Sincronizar dados entre clusters.

mongosync retoma a sincronização aproximadamente onde estava antes de você interromper os processos anteriores. Todas as partições que estavam em andamento no momento do encerramento serão reiniciadas desde o início.

Voltar

Comportamento

Próximo

Pontos de conexão da API do mongosync