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

Este tutorial describe cómo convertir un clúster a un set de réplicas no particionado. Para convertir un set de réplicas en un clúster, consulta Convertir un set de réplicas autogestionado en un clúster. Consulta la documentación de particionado para obtener más información sobre los clústeres.

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

Desactivar el balanceador.
Convierta el clúster en un set de réplicas.
Desbloquee el clúster (solo clúster de varias particiones).

Antes de comenzar

A partir de MongoDB 8.0, puedes utilizar 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

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:

Desactivar el balanceador

Para desactivar el balanceador:

Conectar mongosh a una mongos instancia en el clúster particionado.
Para detener el balanceador, ejecute:
```
sh.stopBalancer()
```
Para verificar que el balanceador está desactivado, ejecute el siguiente comando y asegúrese de que la salida sea false:
```
sh.getBalancerState()
```

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

Detenga todas las instancias de mongos.
Reconfigure la aplicación para conectarse directamente a los nodos del set de réplicas de la partición que se convertirá en el nuevo set de réplicas.
Realice un reinicio en secuencia del set de réplicas para remover la opción --shardsvr de mongod.
Tip
Cambiar la opción --shardsvr cambia el puerto en el que mongod escucha las conexiones entrantes.

El clúster de partición única ahora es un set de réplicas no particionado que acepta operaciones de lectura y escritura en el conjunto de datos. Puede desmantelar los servidores de configuración según sea necesario.

Siga el siguiente procedimiento para pasar de un clúster con más de una partición a un set de réplicascompletamente nuevo.

Desactive el balanceador y bloquee el clúster

Para deshabilitar el equilibrador y bloquear el clúster:

Conecte mongosh a una instancia mongos en el clúster particionado.
Para detener el balanceador, ejecute:
```
sh.stopBalancer()
```
Para verificar que el balanceador está desactivado, 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, ejecuta:
```
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úrate de que la salida muestre que fsyncLocked es true, lo que significa que el clúster está bloqueado:
```
[ { fsyncLocked: true }, { fsyncUnlocked: false } ]
```

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

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.
Vuelva a configurar su aplicación o detenga todas las instancias de mongos. Si detiene todas las instancias de mongos, las aplicaciones no podrán leer de la base de datos. Si detiene todas las instancias de mongos, inicie una instancia temporal de mongos a la que las aplicaciones no puedan 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.
Reconfigura la aplicación para usar el set de réplicas no particionado en lugar de la instancia mongos.
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 no particionado para lecturas y escrituras. Ahora puede desmantelar la infraestructura restante del clúster particionado sin usar.

Desbloquea el clúster

Después de convertir el clúster particionado en un set de réplicas, desbloquee el clúster:

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

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

Antes de comenzar

Advertencia

Compatibilidad de versiones

Autorización

Programar la conversión del clúster

Pasos

Desactivar el balanceador

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

Tip

Desactive el balanceador y bloquee el clúster

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

Nota

Desbloquea el clúster

Obtén más información