Bajar la versión del clúster sharded 5.0 a 4.4

1. Niveles de confirmación de lectura y escritura (read and write concerns) por defecto del clúster

MongoDB 5.0 cambió el valor predeterminado para el nivel de confirmación de lectura y escritura (write concern) a nivel de clúster, y la reversión a MongoDB 4.4 podría cambiar esos valores predeterminados nuevamente. Considera configurar manualmente el nivel de confirmación de lectura y escritura (read and write concern) por defecto de tu clúster antes de realizar el downgrade:

• Para configurar manualmente un valor predeterminado para el read o nivel de confirmación de escritura (write concern) de un clúster, utiliza el setDefaultRWConcern dominio.

• Si tu clúster incluye un árbitro, y previamente habías desactivado el nivel de consistencia de lectura "Majority" para evitar la presión de caché en ciertas situaciones, puedes querer configurar --enableMajorityReadConcern false o replication.enableMajorityReadConcern: false una vez que realices el downgrade.

2. Campos de documento con . o $ caracteres

MongoDB 5.0 permite incluir los caracteres . o $ en los nombres de campo de los documentos. Debe eliminar cualquier documento que contenga nombres de campo que incluyan los caracteres . o $ antes de actualizar a MongoDB 4.4.

3. Archivos de datos de zona horaria en formato slim

MongoDB 5.0 permite el soporte de archivos de datos de zona horaria en formato reducido. Si se utilizan archivos de datos de zona horaria en formato slim en su implementación, tal como se proporciona a MongoDB con la opción de línea de comandos --timeZoneInfo o la configuración de archivo processManagement.timeZoneInfo, debe degradar a MongoDB 4.4.7 o superior, o bien revertir los archivos de datos de zona horaria para utilizar los archivos de datos anteriores en formato no slim.

4. Refragmentación

Asegúrate de que cualquier operación de refragmentación se haya completado con éxito antes de intentar cualquier procedimiento de degradación. Si una operación reciente de resharding ha fallado debido a un cambio de primario, debes ejecutar primero el comando cleanupReshardCollection antes de realizar un downgrade del featureCompatibilityVersion de tu 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 se cancelará.

5. Degradar la compatibilidad de características entre versiones (FCV)

Primero, verifica lo siguiente:

• Asegúrese de que no haya sincronización inicial en curso. Ejecutar el comando setFeatureCompatibilityVersion mientras una sincronización inicial está en curso provocará que la sincronización inicial se reinicie.

• Asegúrese de que ningún nodo tenga un campo newlyAdded en su configuración del set de réplicas. Ejecútalo siguiendo comando en cada nodo de tu clúster sharded para verificar esto:

  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.

• Asegúrate de que ningún miembro del conjunto de réplicas esté en el estado ROLLBACK o RECOVERING.

A continuación, para degradar el featureCompatibilityVersion de su clúster fragmentado:

1. Conecte un mongo shell a la mongos instancia.

2. Degrade el featureCompatibilityVersion a "4.4".

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

   El comando setFeatureCompatibilityVersion realiza operaciones de guardado en una colección del sistema interno y es idempotente. Si por alguna razón la instrucción no se completa con éxito, retrase la instrucción en la instancia mongos.

   Nota

   • 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 ha sufrido recientemente una operación de reshuffling que falló debido a una elección, debe ejecutar el comando cleanupReshardCollection antes de intentar setFeatureCompatibilityVersion de nuevo.

3. Para garantizar que todos los nodos del clúster reflejen la actualización de featureCompatibilityVersion, conéctese a cada nodo del set de réplicas de particiones y a cada nodo del set de réplicas del servidor de configuración y verifique los featureCompatibilityVersion:

   Tip

   Para un clúster fragmentado que tiene habilitado el control de acceso, para ejecutar el siguiente comando contra un miembro del conjunto de réplicas de fragmentos, debe conectarse al miembro como un usuario local de fragmentos.

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

   Todos los nodos deben devolver un resultado que incluya:

   "featureCompatibilityVersion" : { "version" : "4.4" }

   Si un nodo devuelve un featureCompatibilityVersion de "5.0", espera a que el nodo refleje la versión "4.4" antes de continuar.

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

6. Eliminar compatibilidad de características entre versiones 5.0 Funcionalidades persistentes

Los siguientes pasos son necesarios solo si FCV alguna vez se configuró en "5.0".

Remueva todas las funcionalidades persistentes de la versión 5.0 que sean incompatibles con la versión 4.4. Esto incluye:

Colección de series de tiempo

Eliminar todas las colecciones de series temporales.

Gestión de filtros de auditoría en tiempo de ejecución

• Deshabilite la administración del filtro de auditoría en tiempo de ejecución configurando auditLog.runtimeConfiguration en false en el archivo de configuración del nodo.

• Actualice los filtros de auditoría para esta mongod instancia o en el archivo de configuración local.mongos

7. Eliminar las características 5.0

Eliminar todas las funciones persistentes que utilizan funciones de la versión 5.0. Estas incluyen, entre otras:

• Si alguna definición de vista incluye operadores 5.0, como $dateAdd o $sampleRate, deben ser removidos. Consulta Nuevos operadores de agregación para la lista completa.

Degradar un clúster particionado

sh.stopBalancer()

sh.getBalancerState()

sh.startBalancer()