Reducir Clúster Fragmentado 6.0 a 5.0

Crear copia de seguridad

Opcional, pero se recomienda. Crea una copia de seguridad de tu base de datos.

Para aprender cómo crear una copia de seguridad, consulta Métodos de copia de seguridad para una implementación autogestionada.

Eliminar funciones incompatibles con versiones anteriores

Para realizar una reversión de 6.0 a 5.0, es necesario remover las funcionalidades 6.0 que no son compatibles con 5.0. Para obtener una lista de funcionalidades incompatibles y cómo removerlas, consulta Consideraciones sobre la reversión.

Asegúrese de que no haya operaciones de redistribución en progreso

Asegúrese de que todas las operaciones de repartición se hayan completado correctamente. Si una operación de repartición reciente ha fallado debido a una conmutación por error principal, primero debe ejecutar el cleanupReshardCollectionComando antes de degradar el featureCompatibilityVersion de su clúster fragmentado.

Si una operación de re-fragmentación aún se está ejecutando mientras degrada el featureCompatibilityVersion de su clúster fragmentado, la operación de re-fragmentación no se completará.

Reducir la compatibilidad de características entre versiones (FCV)

Para degradar el FCV de su clúster fragmentado:

1. Asegúrate de que no haya una sincronización inicial en curso. Ejecutar el comando setFeatureCompatibilityVersion mientras se está llevando a cabo una sincronización inicial provoca que la sincronización inicial se reinicie.

2. Asegúrese de que ningún nodo tenga un newlyAdded campo en la configuración de su conjunto de réplicas. Ejecute el siguiente comando en cada nodo del conjunto de réplicas para verificarlo:

   use local
   db.system.replset.find( { "members.newlyAdded" : { $exists : true } } );

   El campo newlyAdded solo aparece en el documento de configuración del set de réplicas de un nodo durante y poco después de una sincronización inicial.

3. Asegúrese de que ningún miembro del conjunto de réplicas esté en el ROLLBACK ni en el RECOVERING estado.

4. Utiliza mongosh para conectarte a tu instancia de mongos.

5. Degrade el featureCompatibilityVersion a "5.0".

   db.adminCommand( { setFeatureCompatibilityVersion: "5.0" } )

   El setFeatureCompatibilityVersion comando realiza escrituras en una colección interna del sistema y es idempotente. Si el comando no se completa correctamente, vuelva a intentarlo en la mongos instancia.

   Nota

   Solución de problemas

   • Mientras se ejecuta en el clúster fragmentado, las migraciones, divisiones y fusiones de fragmentos pueden setFeatureCompatibilityVersion fallar ConflictingOperationInProgress con.

   • Si setFeatureCompatibilityVersion falla con un error ManualInterventionRequired, y el clúster se realizó recientemente una operación de greyshard que falló debido a una elección, debes ejecutar el comando cleanupReshardCollection antes de intentar ejecutar setFeatureCompatibilityVersion nuevamente.

6. Para garantizar que todos los miembros del conjunto de réplicas tengan el featureCompatibilityVersion actualizado, conéctese a cada miembro del conjunto de réplicas y verifique el featureCompatibilityVersion:

   db.adminCommand( { getParameter: 1, featureCompatibilityVersion: 1 } )

   Tip

   Control de acceso

   Para un clúster con acceso controlado habilitado, para ejecutar el adminCommand en un nodo de un set de réplicas de particiones, debes conectarte al nodo como usuario local de particiones.

   Todos los nodos deben devolver un resultado que incluya:

   "featureCompatibilityVersion" : { "version" : "5.0" }

   Si cualquier nodo retorna un featureCompatibilityVersion de "6.0", espera a que el nodo retorne la versión "5.0" antes de continuar.

Para obtener más información sobre el valor de featureCompatibilityVersion devuelto, consulta Obtener la Version de Compatibilidad de Características.

Descarga los binarios más recientes de la versión 5.0.

Usando un administrador de paquetes o una descarga manual, obtén la versión más reciente de la serie 5.0. Si utiliza un gestor de paquetes, añada un nuevo repositorio para los binarios de la versión 5.0 y luego realice el proceso real de degradación.

Si necesitas realizar un downgrade desde la versión 6.0, hazlo a la última versión de 5.0.

Reemplaza los binarios 6.0 por los binarios 5.0 descargados.

Asegúrate de que los binarios 5.0 estén en tu System PATH. Para confirmar tu versión binaria, ejecuta el siguiente comando:

mongod --version

La salida del comando debe indicar una versión de la serie 5.0.

Desactivar el balanceador.

Para desactivar el balanceador, conecta mongosh a una instancia mongos en el clúster particionado y ejecuta el siguiente comando:

sh.stopBalancer()

Para verificar que el balanceador esté desactivado, ejecuta el siguiente comando:

sh.getBalancerState()

sh.getBalancerState() retorna false si el balanceador está deshabilitado.

Para obtener más información sobre cómo deshabilitar el balanceador,consulte Deshabilitar el balanceador.

Degradar mongos.

1. Para detener mongos, ejecute el siguiente comando:

   db.shutdownServer()

2. Reinicia mongos con el binario 5.0.

Degrade cada partición, uno a la vez.

1. Rebajar los miembros secundarios de la partición, uno a la vez.

   1. Apaga el nodo.

      Para cerrar el mongod proceso, use para conectarse a la implementación y ejecute el siguiente mongosh comando:

      db.adminCommand( { shutdown: 1 } )

   2. Reinicia el nodo.

      Para iniciar un proceso mongod, ejecuta el siguiente comando:

      mongod --dbpath </path-to-data-folder>

   3. Espere a que el miembro ingrese al estado SECONDARY.

      Antes de degradar el siguiente secundario, espere a que el nodo se recupere al estado SECONDARY. Para verificar el estado del nodo, utiliza el método rs.status() en mongosh.

   4. Repite los pasos anteriores para revertir la versión de cada miembro secundario.

2. Degradar el árbitro de particiones, si lo hay.

   Omita este paso si el conjunto de réplicas no incluye un árbitro.

   Degradar el miembro árbitro del clúster fragmentado:

   1. Apaga el nodo.

      Para apagar el árbitro, use para conectarse al árbitro y ejecute el siguiente mongosh comando:

      db.adminCommand( { shutdown: 1 } )

   2. Borrar el contenido del directorio de datos del árbitro.

      Para encontrar el directorio de datos del árbitro mongod, revise la configuración de la storage.dbPath o la opción de línea de comandos --dbpath.

      Ejecuta el siguiente comando:

      rm -rf /path/to/mongodb/datafiles/*

   3. Reinicia el árbitro.

      Para iniciar un proceso mongod, ejecuta el siguiente comando:

      mongod --dbpath </path-to-mongodb-datafiles>

   4. Espere a que el miembro ingrese al estado ARBITER.

      Antes de hacer un downgrade, espere a que el nodo se recupere al estado ARBITER. Para verificar el estado del nodo, utiliza el método rs.status() en mongosh.

3. Degrade el primario de la partición.

   1. Degradar al primario.

      mongoshEn, use rs.stepDown() para retirar las primarias y comenzar una elección para una nueva primaria:

      rs.stepDown()

   2. Verifique que el primario haya bajado.

      Ejecuta el siguiente comando:

      rs.status()

      Verifique que el nodo principal haya renunciado y que otro nodo haya asumido el estado PRIMARY.

   3. Apaga el ex miembro principal.

      Para apagar el antiguo primario, conéctate a la implementación utilizando mongosh y ejecuta el siguiente comando:

      db.adminCommand( { shutdown: 1 } )

   4. Reinicia el mongod con el binario 5.0.

      Para iniciar un proceso mongod, ejecuta el siguiente comando:

      mongod --dbpath </path-to-mongodb-datafiles>

   5. Repita este procedimiento para los fragmentos restantes.

Realiza la degradación de los servidores de configuración.

1. Degrada los miembros secundarios de la partición del set de réplicas de los servidores de configuración (CSRS) uno a la vez:

   1. Apague el secundario.

      Conéctate al secundario y ejecuta el siguiente comando:

      db.adminCommand( { shutdown: 1 } )

   2. Reinicia el nodo.

      Para iniciar un proceso mongod, ejecuta el siguiente comando:

      mongod --dbpath </path-to-data-folder>

   3. Espere a que el miembro ingrese al estado SECONDARY.

      Antes de degradar el siguiente secundario, espere a que el nodo se recupere al estado SECONDARY. Para verificar el estado del nodo, utiliza el método rs.status() en mongosh.

   4. Repite los pasos anteriores para revertir la versión de cada miembro secundario.

2. Retrocede el primario del servidor de configuración.

   1. Degradar al primario.

      mongoshEn, ejecute rs.stepDown() para retirarse de la primaria y comenzar una elección para una nueva primaria:

      rs.stepDown()

   2. Verifique que el primario haya bajado.

      Ejecuta el siguiente comando:

      rs.status()

      Verifique que el nodo principal haya renunciado y que otro nodo haya asumido el estado PRIMARY.

   3. Apaga el ex miembro principal.

      Para apagar el antiguo primario, conéctate a la implementación utilizando mongosh y ejecuta el siguiente comando:

      db.adminCommand( { shutdown: 1 } )

   4. Reinicia el mongod con el binario 5.0.

      Para iniciar un proceso mongod, ejecuta el siguiente comando:

      mongod --dbpath </path-to-mongodb-datafiles>

Vuelva a habilitar el balanceador.

Después de degradar todos los componentes del clúster fragmentado, conéctese a un y ejecute el siguiente comando para volver a habilitar el mongos equilibrador:

sh.startBalancer()

El método sh.startBalancer() también habilita la división automática para el clúster compartido.