Degradar el set de réplicas 6.0 a 5.0

Esta versión de la documentación se archivó y ya no se admite. Para actualizar tu implementación de 6.0, consulta el Procedimientos de actualización de MongoDB.7.0

Antes de intentar realizar una degradación, familiarízate con el contenido de esta página.

Ruta de degradación

Importante

Antes de actualizar o degradar un Set de réplicas, asegúrate de que todos los miembros del Set de réplicas estén en funcionamiento. De lo contrario, la actualización o degradación no se completará hasta que se inicien todos los miembros.

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

MongoDB solamente soporta degradaciones de una única versión. No se puede retroceder a una versión que esté varias versiones por detrás de la versión actual.

Por ejemplo, puede degradar una implementación de la serie 6.0 a una de la serie 5.0. Sin embargo, no se admite degradar esa implementación de la serie 5.0 a una de la serie 4.4.

Control de acceso

Si su conjunto de réplicas tiene habilitado el control de acceso, sus privilegios de usuario de degradación deben incluir privilegios para enumerar y administrar índices en las bases de datos. Un usuario con root El rol tiene los privilegios requeridos.

Requisitos previos

Antes de comenzar con el procedimiento de degradación, debes completar los siguientes pasos previos.

Crear copia de seguridad

Opcional pero recomendado: crea una copia de seguridad de tu base de datos.

Para aprender a crear una copia de seguridad,consulte Métodos de copia de seguridad para una implementación autoadministrada.

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.

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

Para degradar el compatibilidad de características entre versiones de tu set de réplicas:

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.
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.
Asegúrese de que ningún miembro del conjunto de réplicas esté en el ROLLBACK ni en el RECOVERING estado.
Use mongosh para conectarse a su principal.
Degrade el featureCompatibilityVersion a "5.0".
```
db.adminCommand( { setFeatureCompatibilityVersion: "5.0" } )
```
El comando setFeatureCompatibilityVersion realiza operaciones de guardado en una colección del sistema interno y es idempotente. Si el comando no se completa correctamente, vuelve a intentarlo en primaria.
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 } )
```
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.

Procedimiento de reversión

Advertencia

Antes de proceder con el procedimiento de degradación, asegúrate de que todos los miembros del set de réplicas, incluidos los miembros retardados del set de réplicas, hayan realizado los cambios previos requeridos. Para hacer eso, verifica el featureCompatibilityVersion y luego remueve las funcionalidades incompatibles de cada nodo antes de hacer la rebaja de versión.

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.

Importante

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.

Degradar los miembros secundarios del conjunto de réplicas.

Degradar cada miembro secundario del conjunto de réplicas, uno a la vez:

Apaga el nodo.
Para cerrar el proceso mongod, utiliza mongosh para conectarte al secundario y ejecuta el siguiente comando:
```
db.adminCommand( { shutdown: 1 } )
```
Reinicia el nodo.
Para iniciar un proceso mongod, ejecuta el siguiente comando:
```
mongod --dbpath </path-to-data-folder>
```
Para obtener más información sobre cómo iniciar un proceso mongod, consulta Inicia procesos mongod.
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.
Después de que el nodo esté en la etapa SECONDARY, se debe degradar el siguiente secundario.

Degradar el miembro del set de réplicas árbitro, si corresponde.

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

Degradar al árbitro nodo del set de réplicas:

Apaga el nodo.
Para apagar el árbitro, use para conectarse al árbitro y ejecute el siguiente mongosh comando:
```
db.adminCommand( { shutdown: 1 } )
```
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/*
```
Reinicia el árbitro.
Para iniciar un proceso mongod, ejecuta el siguiente comando:
```
mongod --dbpath </path-to-mongodb-datafiles>
```
Para obtener más información sobre cómo iniciar un proceso mongod, consulta Inicia procesos mongod.
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.

Degradar la primaria.

Degradar al primario.
En mongosh, utilice rs.stepDown() para dejar de ser primario y forzar el procedimiento normal de conmutación por falla.
```
rs.stepDown()
```
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.
Reemplace y reinicie el disco primario anterior mongod.
1. Apaga el nodo.
  Para realizar un apagado del principal, utilice mongosh para conectarse al principal y ejecute el siguiente comando:
  db.adminCommand( { shutdown: 1 } )
2. Reinicie mongod con el binario 5.0.
  Para iniciar un proceso mongod, ejecuta el siguiente comando:
  mongod --dbpath </path-to-mongodb-datafiles>
  Para obtener más información sobre cómo iniciar un proceso mongod, consulta Inicia procesos mongod.

Volver

Autónomo

Clúster fragmentado