Degradar 8.3 clúster a 8.2

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, consulte Métodos de copia de seguridad para una implementación autogestionada.

Remover funcionalidades incompatibles con versiones anteriores

Para pasar de la versión 8.3 a 8.2 la, debe eliminar 8.3 las funciones de la versión que son incompatibles con la 8.2 versión. Para obtener una lista de las funciones incompatibles y cómo eliminarlas, consulte Consideraciones sobre la actualización a una versión anterior.

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

Asegúrese de que todas las operaciones de resharding se hayan completado con éxito. Si una operación reciente de reasignación de repartición ha fallado debido a un traspaso principal, primero debes ejecutar el cleanupReshardCollection el comando antes de degradar featureCompatibilityVersion de tu clúster con fragmentación.

Si una operación de cambio de partición sigue en ejecución mientras se realiza una degradación de featureCompatibilityVersion en tu clúster particionado, la operación de cambio de partición no se completará.

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

Para rebajar el compatibilidad de características entre versiones de tu clúster:

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úrate de que ningún nodo tenga un campo newlyAdded en su configuración del set de réplicas. Ejecuta el siguiente comando en cada nodo de tu set de réplicas 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.

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

4. Usar mongosh para conectarse a su mongos instancia.

5. Degrade el featureCompatibilityVersion a "8.2".

   Importante

   Verifique que haya eliminado todas las funciones incompatibles con versiones anteriores antes de degradar la versión binaria. Asegúrese de evaluar su ruta de actualización antes de continuar.

   db.adminCommand( { setFeatureCompatibilityVersion: "8.2", confirm: true } )

   El comando setFeatureCompatibilityVersion realiza escrituras en una colección interna del sistema y es idempotente. Si la orden no se completa correctamente, intenta nuevamente la orden en la instancia de mongos.

   Nota

   Solución de problemas

   • 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 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 set de réplicas tengan el featureCompatibilityVersion actualizado, conecte con cada miembro del set de réplicas y verifique el featureCompatibilityVersion:

   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.

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

   OCULTAR SALIDA

   "featureCompatibilityVersion" : { "version" : "8.2" }

   Si cualquier nodo retorna un featureCompatibilityVersion de "8.3", espera a que el nodo retorne la versión "8.2" 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 últimos binarios 8.2

Mediante un gestor de paquetes o una descarga manual, obtenga la última versión de 8.2. Si utiliza un gestor de paquetes, añada un nuevo repositorio para los binarios de 8.2 y, a continuación, realice el proceso de degradación.

Si necesita degradar desde 8.3, degrade a la última versión parcheada de 8.2.

Reemplace los binarios 8.3 con los binarios 8.2 descargados.

Asegúrese de que los binarios 8.2 estén en la ruta de acceso del sistema. Para confirmar la versión de su binario, ejecute el siguiente comando:

mongod --version

La salida del comando debería indicar una liberación 8.2.

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, consulta Deshabilitar el balanceador.

Versión anterior mongos

1. Para detener mongos, ejecute el siguiente comando:

   db.shutdownServer()

2. Reiniciar mongos con el binario 8.2.

Degradación de cada fragmento, uno por uno.

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

   1. Apaga el nodo.

      Para apagar el proceso mongod, utiliza mongosh para conectarte a la implementación y ejecutar 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 nodo entre en el 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.

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

   Degradar el árbitro nodo del clúster:

   1. Apaga el nodo.

      Para apagar el árbitro, utiliza mongosh para conectarte al árbitro y ejecutar el siguiente 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 nodo entre en el 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.

      En mongosh, se usa rs.stepDown() para desocupar el primario y comenzar una elección para un nuevo primario:

      rs.stepDown()

   2. Verifique que el primario se haya desactivado.

      Ejecuta el siguiente comando:

      rs.status()

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

   3. Apague el antiguo 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 8.2.

      Para iniciar un proceso mongod, ejecuta el siguiente comando:

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

   5. Repita para las particiones restantes.

Rebajar la configuración de los servidores

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. Apaga 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 nodo entre en el 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.

      En mongosh, ejecuta rs.stepDown() para descender al primario e iniciar una elección para un nuevo primario:

      rs.stepDown()

   2. Verifique que el primario se haya desactivado.

      Ejecuta el siguiente comando:

      rs.status()

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

   3. Apague el antiguo 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 8.2.

      Para iniciar un proceso mongod, ejecuta el siguiente comando:

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

Vuelva a habilitar el equilibrador

Después de bajar la versión de todos los componentes del clúster con particionado, conéctese a un mongos y ejecute el siguiente comando para volver a habilitar el balanceador:

sh.startBalancer()

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