Convertir el clúster autogestionado a un set de réplicas

Este tutorial describe cómo convertir un Clúster fragmentado en un conjunto de réplicas no fragmentado. Para convertir un conjunto de réplicas en un clúster fragmentado, consulte "Convertir un conjunto de réplicas autoadministrado en un clúster fragmentado". Consulte la documentación sobre fragmentación para obtener más información sobre los clústeres fragmentados.

Este tutorial te guía a través de las siguientes tareas:

Deshabilite el balanceador y bloquee el clúster.
Convertir un clúster único o fragmentado en un set de réplicas
Desbloquee el clúster después de convertirlo a un conjunto de réplicas.

Antes de comenzar

A partir de MongoDB 8.0, puedes usar el directShardOperations rol para realizar operaciones de mantenimiento que requieren ejecutar comandos directamente en una partición.

Advertencia

Ejecutar comandos usando el rol directShardOperations puede hacer que su clúster deje de funcionar correctamente y puede causar corrupción de datos. Utiliza el rol directShardOperations únicamente con fines de mantenimiento o bajo la orientación del soporte de MongoDB. Deja de usar el rol directShardOperations cuando termines de realizar operaciones de mantenimiento.

Compatibilidad de versiones

Los pasos de este tutorial requieren MongoDB 6.0 o posterior.

Autorización

Los comandos fsync y fsyncUnlock requieren la acción de autorización fsync, la cual puede asignarse mediante el hostManager rol o un rol personalizado.

Programar la conversión del clúster

Convierta el clúster cuando las migraciones de fragmentos, el resharding y las transformaciones de esquemas no se realicen normalmente.

Pasos

Deshabilitar el balanceador y bloquear el clúster

Para deshabilitar el equilibrador y bloquear el clúster:

Conectar mongosh a una instancia en el clúster mongos fragmentado.
Para detener el balanceador, ejecute:
```
sh.stopBalancer()
```
Para verificar que el balanceador esté deshabilitado, ejecute el siguiente comando y asegúrese de que la salida sea false:
```
sh.getBalancerState()
```
Para bloquear el clúster fragmentado, lo que impide la escritura en la base de datos, ejecute:
```
db.getSiblingDB( "admin" ).fsyncLock()
```

Para confirmar el bloqueo, ejecute:

db.getSiblingDB( "admin" ).aggregate( [
   { $currentOp: { } },
   { $facet: {
      "locked": [
         { $match: { $and: [
            { fsyncLock: { $exists: true } }
         ] } }
      ],
      "unlocked": [
         { $match: { fsyncLock: { $exists: false } } }
      ]
   } },
   { $project: {
      "fsyncLocked": { $gt: [ { $size: "$locked" }, 0 ] },
      "fsyncUnlocked": { $gt: [ { $size: "$unlocked" }, 0 ] }
   } }
] )

Asegúrese de que la salida muestre que fsyncLocked es true, lo que significa que el clúster está bloqueado:
```
[ { fsyncLocked: true }, { fsyncUnlocked: false } ]
```

Convertir un clúster único o fragmentado en un set de réplicas

En el caso de un cluster fragmentado con solo una partición, esa partición contiene el conjunto completo de datos. Para convertir ese clúster en un set de réplicas no fragmentado:

Reconfigurar la aplicación para conectarse con el miembro primario del set de réplicas que aloja la única partición; ese sistema será el nuevo set de réplicas.
Elimina la opción --shardsvr de mongod tu.
Tip
Cambiar la opción cambiará --shardsvr mongod el puerto en el que escucha las conexiones entrantes.

El clúster de réplica única ahora es un conjunto de réplicas no particionado que aceptará operaciones de lectura y escritura en el conjunto de datos.

Utilice el siguiente procedimiento para realizar la transición de un clúster fragmentado con más de un fragmento a un conjunto de réplicas completamente nuevo.

Con el clúster bloqueado y el balanceador deshabilitado, implementa un nuevo set de réplicas además de tu clúster. El set de réplicas debe tener la capacidad suficiente para alojar todos los archivos de datos de todas las particiones actuales combinadas. No configures la aplicación para conectarse al nuevo set de réplicas hasta que se complete la transferencia de datos.
Reconfigure su aplicación o detenga todas las instancias de mongos. Si detiene todas las instancias de mongos, las aplicaciones no podrán leer desde la base de datos. Si detiene todas las instancias mongos, inicie una instancia temporal mongos a la que las aplicaciones no pueden acceder para el procedimiento de migración de datos.
Utiliza mongodump y mongorestore para migrar los datos de la mongos instancia al nuevo conjunto de réplicas.
Excluya la base de datos config cuando ejecute mongorestore. Usa la opción --nsExclude como se muestra en este ejemplo:
```
mongorestore --nsExclude="config.*" <connection-string> /data/backup
```
Nota
No todas las colecciones en todas las bases de datos están necesariamente particionadas. No migres únicamente las colecciones particionadas. Asegúrese de que todas las bases de datos y todas las colecciones se migren correctamente.
Reconfigure la aplicación para utilizar el conjunto de réplicas no fragmentadas en lugar de la mongos instancia.
Después de convertir el clúster en un set de réplicas, actualice la cadena de conexión utilizada por sus aplicaciones a la cadena de conexión del set de réplicas. Luego, reinicia tus aplicaciones.

La aplicación ahora utiliza el set de réplicas sin particiones para lecturas y escrituras. Ahora puedes retirar la infraestructura de clúster sharded no utilizada restante.

Desbloquear el clúster después de convertirlo en un set de réplicas

Después de convertir el clúster fragmentado en un conjunto de réplicas, realice los siguientes pasos para desbloquear el clúster:

Para desbloquear el clúster y permitir que se reanuden las escrituras en la base de datos, ejecute:
```
db.getSiblingDB( "admin" ).fsyncLock()
```

Para confirmar el desbloqueo, ejecuta:

db.getSiblingDB("admin").aggregate( [
   { $currentOp: { } },
   { $facet: {
      "locked": [
         { $match: { $and: [
            { fsyncLock: { $exists: true } }
         ] } } ],
         "unlocked": [
         { $match: { fsyncLock: { $exists: false } } }
      ]
   } },
   { $project: {
      "fsyncLocked": { $gt: [ { $size: "$locked" }, 0 ] },
      "fsyncUnlocked": { $gt: [ { $size: "$unlocked" }, 0 ] }
   } }
] )

Asegúrese de que la salida muestre que fsyncLocked es false, lo que significa que el clúster está desbloqueado:
```
[ { fsyncLocked: false }, { fsyncUnlocked: true } ]
```

Obtén más información

Gestionar balanceador de clúster fragmentado

Volver

Respaldar metadatos del clúster

Convertir un set de réplicas en un clúster particionado