mongosync Binario

Opciones Globales

--acceptDisclaimer

Acepta las exenciones de responsabilidad para el verificador integrado.

Cuando el proceso de mongosync comienza sin esta opción, se le pide al usuario que acepte cada aviso legal.

Esta opción permite a los usuarios que ya han leído y aceptado las exenciones de responsabilidad aceptar la exención de responsabilidad y comenzar el proceso de mongosync.

Para establecer la opción --acceptDisclaimer desde un archivo de configuración, consulta la configuración deacceptDisclaimer.

Nuevo en la versión 1.9.

--cluster0 <uri>

Establece la URI de conexión para el primer clúster. El primer clúster puede servir como el origen o el destino en el proceso de sincronización. Designa los clústeres de origen y destino en la llamada al endpoint start de la API.

Para obtener más información sobre cómo conectar mongosync, consulta Conexiones.

Para establecer la opción --cluster0 desde un archivo de configuración, consulta la configuración decluster0.

Advertencia

En algunos sistemas, proporcionar una contraseña en una cadena de conexión con las opciones --cluster0 o --cluster1 puede hacer que la contraseña sea visible para los programas de estado del sistema, como ps, que pueden ser invocados por otros usuarios.

Considera utilizar la opción --config para especificar un archivo de configuración que contenga la contraseña en su lugar.

--cluster1 <uri>

Establece la URI de conexión para el segundo clúster. El segundo clúster puede servir como origen o destino en el proceso de sincronización. Designa los clústeres de origen y destino en la llamada al start del endpoint de la API.

Para obtener más información sobre cómo conectar mongosync, consulta Conexiones.

Para establecer la opción --cluster1 desde un archivo de configuración, consulta la configuración decluster1.

Advertencia

En algunos sistemas, proporcionar una contraseña en una cadena de conexión con las opciones --cluster0 o --cluster1 puede hacer que la contraseña sea visible para los programas de estado del sistema, como ps, que pueden ser invocados por otros usuarios.

Considera utilizar la opción --config para especificar un archivo de configuración que contenga la contraseña en su lugar.

--config <filename>

Establece la ruta al archivo de configuración.

Para establecer la ruta del archivo de configuración durante una migración, consulta Reconfiguración de mongosync durante la Sincronización.

Para obtener más información, consulta Archivo de configuración.

--createIndexesBatchSize <number>

Nuevo en la versión 1.19.0.

Tipo: entero

Mínimo: 1

Máximo: 64

Establezca explícitamente el tamaño del lote para las compilaciones de índices en los clústeres de destino. De forma predeterminada, mongosync optimiza este valor programáticamente en los clústeres de destino de Atlas.

Advertencia

Asegúrese de haber asignado entre 100 MB y1 GB de memoria por índice. Además, asegúrese de que la memoria total utilizada por las compilaciones de índices simultáneas se mantenga por debajo del 20% de la RAM del clúster de destino. Asignar más del 20% de la RAM de destino a las compilaciones de índices puede interferir con la caché del sistema de archivos, lo que reduce la memoria disponible para almacenar en búfer las escrituras en el clúster de destino.

Para obtener más información,consulte Optimizaciones de creación de índices.

Para establecer la opción --createIndexesBatchSize desde un archivo de configuración, consulta la configuración decreateIndexesBatchSize.

--disableMetricsLogging

Nuevo en la versión 1.16.0.

Desactiva el registro de métricas cuando ejecutas el binario de Mongosync.

Advertencia

Se recomienda encarecidamente mantener habilitado el registro de métricas para facilitar la resolución de problemas y el soporte efectivos.

Para obtener más información, consulta Mongosync métricas.

Para establecer la opción --disableMetricsLogging desde un archivo de configuración, consulta la configuración dedisableMetricsLogging.

--disableTelemetry

Nuevo en la versión 1.4.0.

Deshabilita la colección de datos de telemetría para mongosync.

Por defecto, mongosync recopila datos de uso anónimos y agregados para mejorar los productos de MongoDB. Cuando ejecutas mongosync, puedes desactivar la colección de estos datos de telemetría.

Para establecer la opción --disableTelemetry desde un archivo de configuración, consulta la configuración dedisableTelemetry.

Para desactivar la colección de datos de telemetría durante una migración, consulta Reconfiguración de mongosync durante la Sincronización.

Para obtener más información, consulte colección de datos de usuario.

--disableVerification

Deshabilita el Verificador Integrado. Cuando está desactivado, mongosync no verifica la migración. Para métodos de verificación alternativos, ve Verificar transferencia de datos.

Esta opción proporciona una solución alternativa para los clientes que experimentan fallos por OOM al ejecutar mongosync con verificación y no pueden asignar más recursos ni tolerar reiniciar la verificación. Permite que la migración se complete con la verificación desactivada. La verificación permanece desactivada para reinicios y reversiones posteriores.

Esta opción no debería utilizarse cuando mongosync se inicia inicialmente. En su lugar, desactiva la verificación con el parámetro de solicitud /start verification.enabled: false, ya que la verificación está activada por defecto.

Para desactivar la verificación desde el archivo de configuración, consulta la configuración de disableVerification.

Nuevo en la versión 1.10.

--help, -h

Imprime la información de uso en stdout.

--hotDocIDs

Establece un identificador para documentos activos o documentos que se actualizan con mucha frecuencia en los clústeres de origen. Luego, mongosync copia estos documentos durante la etapa de confirmación de la migración.

Utiliza esta opción para las migraciones que tienen un Atraso de la replicación debido a documentos activos al ejecutar mongosync.

Proporcione los identificadores en el siguiente formato:

{
   “db”: <string>, // the name of the database
   "collection" : <string>, // name of the collection
   "ids"    : [ {“_id”:<Object>”}, ...],
}

Los objetos en el campo ids deben ser cadenas JSON extendidas válidas en modo canónico.

Puedes usar esta opción varias veces para proporcionar identificadores de documentos destacados de varias colecciones. El siguiente es un ejemplo que proporciona dos identificadores de documentos destacados de las colecciones coll1 y coll2:

mongosync \
--hotDocIDs '{"db":"db1","collection":"coll1","ids":[{"_id":{"$oid":"doc1"}},{"_id":{"$oid":"6aa23c249cef3cd958e43785"}}]}' \
--hotDocIDs '{"db":"db2","collection":"coll2","ids":[{"_id":{"$oid":"70023c249cef3cd958e43269"}},{"_id":{"$oid":"7aa23c249cef3cd958e43785"}}]}' \
... other CLI arguments ...

Una vez iniciado, no puedes Remover un identificador de documento activo. Si configuras uno incorrectamente, reinicia mongosync con los identificadores correctos.

Para establecer la opción --hotDocIDs desde un archivo de configuración, consulta la configuración dehotDocIDs.

Nuevo en la versión 1.18.

--id <id>

Establece un identificador para la instancia mongosync.

Utiliza esta opción cuando ejecuta varias instancias de mongosync en un clúster particionado, para sincronizar las particiones individualmente.

El valor del identificador para esta opción debe corresponder al ID de la partición con el que se sincroniza. Para encontrar el ID de la partición, utiliza el comando listShards.

Para establecer la opción --id desde un archivo de configuración, consulta la configuración deid.

--loadLevel <level>

Tipo: entero

Por defecto: 3

Establece el nivel de carga de trabajo del clúster para sincronizar datos entre los clústeres de origen y destino:

• 4, la configuración más alta maximiza la carga de trabajo del clúster y sincroniza los datos más rápidamente.

• 1, la configuración más baja, minimiza la carga de trabajo del clúster y sincroniza los datos más lentamente.

Para establecer la opción --loadLevel desde un archivo de configuración, consulta la configuración deloadLevel.

Para cambiar el nivel de carga durante una migración, consulte Reconfigurar mongosync Durante la Sincronización.

Advertencia

Configurar loadLevel por encima de la configuración por defecto de 3 puede afectar negativamente el rendimiento del clúster de destino.

Si existen cuellos de botella de lectura en el clúster de origen o cuellos de botella de escritura en el clúster de destino, disminuir loadLevel podría mejorar el rendimiento.

Nuevo en la versión 1.4.

--logPath <directory>

Establece la ruta al directorio de registro. Mongosync escribe registros en archivos de este directorio.

Para obtener más información, consulta Registro.

Para establecer la opción --logPath desde un archivo de configuración, consulta la configuración delogPath.

Para cambiar la ruta al directorio de registros durante una migración, consulta Reconfiguración de mongosync durante la Sincronización.

Nota

Si se inicia mongosync con la opción --logPath, se puede enviar una señal USR1 al proceso mongosync para rotar la entrada de registro:

kill -s USR1 $mongosync_pid

$mongosync_pid es el ID de proceso mongosync.

--metricsLoggingFilepath <directory>

Nuevo en la versión 1.16.0.

Establece la ruta al directorio de registros de métricas. Mongosync guarda registros de métricas en archivos en este directorio.

Para obtener más información, consulta Mongosync métricas.

Para establecer la opción --metricsLoggingFilepath desde un archivo de configuración, consulta la configuración demetricsLoggingFilepath.

--port

Por defecto: 27182

Configura el puerto utilizado por el servidor HTTP para la API HTTP de Mongosync.

Para establecer la opción --port desde un archivo de configuración, consulta la configuración deport.

Para cambiar el puerto durante una migración, consulta Reconfiguración de mongosync durante la Sincronización.

--verbosity <level>

Por defecto: DEBUG

Establece el nivel de verbosidad que se utilizará en los mensajes de registro. Mongosync registra todos los mensajes en el nivel especificado y cualquier mensaje en niveles inferiores.

La opción --verbosity es compatible con los siguientes valores:

• TRACE

• DEBUG

• INFO

• WARN

• ERROR

• FATAL

• PANIC

Para establecer la opción --verbosity desde un archivo de configuración, consulta la configuración deverbosity.

Para cambiar el nivel de verbosidad durante una migración, consulta Reconfiguración de mongosync durante la Sincronización.

--version, -v

Imprime la información de la versión mongosync en la salida estándar.