mongosync

Opções globais

--acceptDisclaimer

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

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

Esta opçã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 opção --acceptDisclaimer a partir de um arquivo de configuração, consulte a configuração acceptDisclaimer.

Novidades na versão 1.9.

--cluster0 <uri>

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 opção --cluster0 a partir de um arquivo de configuração, consulte a configuração cluster0.

Aviso

Em alguns sistemas, fornecer uma senha em uma string de conexão com as opções --cluster0 ou --cluster1 pode tornar a senha visível para programas de status do sistema, como ps, que podem ser invocados por outros usuários.

Considere utilizar a opção --config para especificar um arquivo de configuração contendo a senha.

--cluster1 <uri>

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 opção --cluster1 a partir de um arquivo de configuração, consulte a configuração cluster1.

Aviso

Em alguns sistemas, fornecer uma senha em uma string de conexão com as opções --cluster0 ou --cluster1 pode tornar a senha visível para programas de status do sistema, como ps, que podem ser invocados por outros usuários.

Considere utilizar a opção --config para especificar um arquivo de configuração contendo a senha.

--config <filename>

Define o caminho para o arquivo de configuração.

Para definir o caminho do arquivo de configuração durante uma migração, veja Reconfigurar mongosync Durante a Sincronização.

Para obter mais informações, consulte Arquivo de configuração.

--disableMetricsLogging

Novidades na versão 1.16.0.

Desativa o registro de métricas quando você executa o binário Mongosync.

AVISO: é altamente recomendável manter o registro de métricas ativado para facilitar a solução de problemas e o suporte eficazes.

Para obter mais informações, consulte Métricas do Mongosync.

Para definir a opção --disableMetricsLogging a partir de um arquivo de configuração, consulte a configuração disableMetricsLogging.

--disableTelemetry

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 opção --disableTelemetry a partir de um arquivo de configuração, consulte a configuração disableTelemetry.

Para desativar a coleção de dados de telemetria durante uma migração, consulte Reconfigurar mongosync Durante a Sincronização.

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

--disableVerification

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 desabilitar a verificação no arquivo de configuração, consulte a configuração disableVerification.

Novidade na versão 1.10.

--help, -h

Imprime informações de uso em stdout.

--id <id>

Define um identificador para a instância mongosync.

Use esta opção ao executar múltiplas instâncias de mongosync em um cluster fragmentado, para sincronizar os fragmentos individualmente.

O valor do identificador para esta opçã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 opção --id a partir de um arquivo de configuração, consulte a configuração id.

--loadLevel <level>

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 opção --loadLevel a partir de um arquivo de configuração, consulte a configuração loadLevel.

Para alterar o nível de carga durante uma migração, consulte Reconfigurar mongosync Durante a Sincronização.

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 <directory>

Define o caminho para o diretório de logs. O Mongosync grava registros em arquivos neste diretório.

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

Para definir a opção --logPath a partir de um arquivo de configuração, consulte a configuração logPath.

Para alterar o caminho para o diretório de registros durante uma migração, consulte Reconfigurar mongosync Durante a Sincronização.

Observação

Se você iniciar o mongosync com a opção --logPath , você poderá enviar um sinal do USR1 para o processo do mongosync para girar seu arquivo de log:

kill -s USR1 $mongosync_pid

$mongosync_pid é o ID do processo mongosync .

--metricsLoggingFilepath <directory>

Novidades na versão 1.16.0.

Define o caminho para o diretório de registro de métricas. O Mongosync grava registros de métricas em arquivos neste diretório.

Para obter mais informações, consulte Métricas do Mongosync.

Para definir a opção --metricsLoggingFilepath a partir de um arquivo de configuração, consulte a configuração metricsLoggingFilepath.

--port

Padrão: 27182

Define a porta usada pelo servidor HTTP para a API HTTP do Mongosync.

Para definir a opção --port a partir de um arquivo de configuração, consulte a configuração port.

Para mudar a porta durante uma migração, veja Reconfigurar mongosync Durante a Sincronização.

--verbosity <level>

Padrão: DEBUG

Define o nível de verbosidade a ser usado em mensagens de registro. O Mongosync registra todas as mensagens no nível especificado e quaisquer mensagens em níveis inferiores.

A opção --verbosity suporta os seguintes valores:

• TRACE

• DEBUG

• INFO

• WARN

• ERROR

• FATAL

• PANIC

Para definir a opção --verbosity a partir de um arquivo de configuração, consulte a configuração verbosity.

Para alterar o nível de detalhamento durante uma migração, veja Reconfigurar mongosync Durante a Sincronização.

--version, -v

Imprime informações da versão mongosync em stdout.