Degradar 5.0 clúster a 4.4

1. Problemas de lectura y escritura predeterminados del clúster

MongoDB 5.0 cambió el valor predeterminado para las preocupaciones de lectura y escritura a nivel de clúster, y al revertir a MongoDB 4.4, podría restablecer esos valores predeterminados. Considere configurar manualmente la preocupación de lectura y escritura predeterminada de su clúster antes de revertir a la versión anterior:

• Para configurar manualmente un valor predeterminado para la preocupación de lectura o escritura de un clúster, utilice el setDefaultRWConcern dominio.

• Si su clúster incluye un árbitro y anteriormente había deshabilitado la "Majority" preocupación de lectura para evitar la presión de caché en ciertas situaciones, es posible que desee configurar --enableMajorityReadConcern false o replication.enableMajorityReadConcern: false una vez que baje de versión.

2. Campos de documento con . o $ caracteres

MongoDB 5.0 ahora admite la inclusión de 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 de formato reducido

MongoDB 5.0 habilita la compatibilidad con archivos de datos de zona horaria en formato slim. Si utiliza archivos de datos de zona horaria en formato slim en su implementación, como se proporciona a MongoDB con la --timeZoneInfo opción de línea de comandos o processManagement.timeZoneInfo la configuración del archivo de configuración, debe actualizar a MongoDB.4.4 7 o posterior, o bien revertir sus archivos de datos de zona horaria para que utilicen los archivos de datos anteriores sin formato slim.

4. Redistribución

Asegúrese de que todas las operaciones de repartición se hayan completado correctamente antes de intentar cualquier procedimiento de degradación. Si una operación de repartición reciente ha fallado debido a una conmutación por error principal, primero debe ejecutar el cleanupReshardCollection comando 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 se cancelará.

5. Versión de compatibilidad de funciones de degradación (FCV)

Primero, verifique 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 newlyAdded campo en la configuración de su conjunto de réplicas. Ejecute el siguiente comando en cada nodo del clúster fragmentado para verificarlo:

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

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

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

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

1. Conecte un mongo shell a la mongos instancia.

2. Bajar de featureCompatibilityVersion a "4.4".

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

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

   Nota

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

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

3. Para garantizar que todos los miembros del clúster fragmentado reflejen el featureCompatibilityVersion actualizado, conéctese a cada miembro del conjunto de réplicas de fragmentos y a cada miembro del conjunto de réplicas del servidor de configuración y verifique el 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 miembros 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 featureCompatibilityVersion valor devuelto,consulte Obtener FeatureCompatibilityVersion.

6. Eliminar funciones persistentes de FCV 5.0

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

Elimine todas las 5.0 funciones persistentes que sean incompatibles 4.4 con. Estas incluyen:

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 5.0 funciones

Eliminar todas las funciones persistentes que utilizan 5.0 funciones. Estas incluyen, entre otras:

• Si alguna definición de vista incluye 5.0 operadores, como o, debe eliminarse.Consulte "Nuevos $dateAdd operadores $sampleRate de agregación" para ver la lista completa.

Degradar un clúster fragmentado

sh.stopBalancer()

sh.getBalancerState()

sh.startBalancer()