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 .

• 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 documentos con . o $ caracteres

MongoDB 5.0 agrega soporte para incluir los caracteres . o $ en los nombres de los campos de los documentos. Debes borrar cualquier documento que contenga nombres de campos que incluyan los caracteres . o $ antes de realizar una degradación 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. Refraccionamiento

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 resharding sigue ejecutándose mientras se reduce la versión del featureCompatibilityVersion del clúster compartido, la operación de resharding se abortará.

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 tu clúster sharded:

1. Conecte un shell mongo a la instancia mongos.

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 setFeatureCompatibilityVersion se está ejecutando en el clúster particionado, las migraciones, divisiones y combinaciones de fragmentos pueden fallar con ConflictingOperationInProgress.

   • 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 que tiene el control de acceso habilitado, para ejecutar el siguiente comando contra un miembro del set de réplicas, debes conectarte al miembro como un usuario local del shard.

   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 solo son necesarios si alguna vez se ha configurado la compatibilidad de características entre versiones 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

Remueva todas las colecciones de series de tiempo.

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

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

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

7. Remover funcionalidades de la versión 5.0

Remueva todas las funcionalidades guardadas que usen funcionalidades de la versión 5.0. Estos incluyen, pero no se limitan a:

• 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()