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

Esta versión de la documentación se archivó y ya no se admite. Para actualizar tu implementación de 6.0, consulta el Procedimientos de actualización de MongoDB 7.0 .

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.

Antes de comenzar

Compatibilidad de versiones

Los pasos de este tutorial requieren MongoDB 6.0 o posterior.

Autorización

La Los comandos fsync y fsyncUnlock requieren la acción de autorización fsync, la cual puede ser asignada a través del rol hostManager 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.

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 } ]
```

Convierta un clúster con una sola partición 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. Utiliza el siguiente procedimiento para convertir ese clúster en un set de réplicas no particionado:

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.
Remueve la opción --shardsvr de tu mongod.
Tip
Cambiar la opción --shardsvr cambiará el puerto en el que mongod 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.

Convierta un clúster en un set de réplicas

Siga el siguiente procedimiento para pasar de un clúster con más de una partición a un set de réplicascompletamente 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.
Reconfigura la aplicación para usar el set de réplicas no particionado en lugar de la instancia mongos.

La aplicación ahora utilizará el conjunto de réplicas sin particiones para las operaciones de lectura y escritura. Ahora puedes retirar la infraestructura restante sin usar del clúster particionado.

Próximos pasos

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

Para desbloquear el clúster y permitir que las escrituras en la base de datos se reanuden, ejecuta:
```
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