Para degradar su clúster Atlas Core a la versión principal anterior de MongoDB, debe haber fijado el FCV antes de la actualización. Este tutorial describe cómo degradar su clúster Atlas Core y cómo fijar y desfijar el FCV.
Para saber qué es FCV y cómo fijarlo preserva la capacidad de degradar la versión, consulte Versiones de MongoDB y rutas de actualización.
Importante
Los clústeres de Atlas Infinite no admiten el versionado manual de MongoDB.
Solo los clústeres Atlas Core admiten la actualización y la degradación de versiones de MongoDB.
Los clústeres de Atlas Infinite ejecutan MongoDB usando Latest Version With Auto Upgrades y no admiten actualizaciones de versión manuales. Atlas gestiona automáticamente el control de versiones para los clústeres de Atlas Infinite.
Limitaciones
Las siguientes limitaciones se aplican al degradar la versión de su clúster:
Sólo puedes degradar tu clúster utilizando el procedimiento de esta página si fijaste la compatibilidad de características entre versiones antes de actualizar.
Solo se puede cambiar el clúster a una versión principal que coincida con la compatibilidad de características entre versiones anclada.
Solo puedes realizar esta acción si la FCV fijada es solo una versión principal inferior a la FCV actual y no tienes Latest Version With Auto Upgrades habilitado.
Si su clúster utiliza la última versión con actualizaciones automáticas, no puede fijar su FCV ni degradar el clúster. Si desea dejar de usar las actualizaciones automáticas, puede hacerlo después del lanzamiento de la versión principal (
x.0.0) pero antes del primer lanzamiento menor de ese ciclo (x.1.0).No puedes pasarte a una versión anterior después de que haya llegado al final de su vida útil. Asegúrese de que anclar ocurra antes de que la versión actual alcance el final de su vida útil.
La fijación de compatibilidad de características entre versiones solo está disponible en clústeres dedicados.
El bloqueo deFCV no se puede extender más allá de 4 semanas desde la fecha del bloqueo.
Si es necesario realizar una degradación y no fijó la compatibilidad de características entre versiones antes de la actualización, puede:
Restaurar a un punto específico en el tiempo:
Si tienes activado Continuous Cloud Backup para tu clúster, puedes realizar una restauración PIT para devolver tu clúster a un estado anterior con una versión anterior de MongoDB:
Crea un nuevo clúster con la versión principal anterior.
Realiza una restauración PIT usando las instrucciones de Restaurar desde una copia de seguridad continua en la nube.
Restaurar desde una snapshot de Atlas:
Si tienes Respaldo en la nube activado sin copias de seguridad continuas en la nube, considera restaurar la última snapshot del clúster basada en la versión anterior a un nuevo clúster:
Crea un nuevo clúster con la versión principal anterior.
Restaure la última instantánea antes de la actualización de versión de MongoDB al nuevo clúster usando las instrucciones en Restaurar desde una instantánea programada o bajo demanda.
Acceso requerido
Para degradar un clúster a una versión principal, fijar el FCV para su clúster o desfijar el FCV para su clúster, debe tener el rol Project Owner o superior para el proyecto.
Degradar el clúster a una versión principal anterior
Para degradar el clúster en una versión principal:
En Atlas, ve a la página Clusters de tu proyecto.
Si aún no se muestra, seleccione la organización que contiene su proyecto deseado en el menú Organizations de la barra de navegación.
Si aún no aparece, selecciona el proyecto deseado en el menú Projects de la barra de navegación.
En la barra lateral, haz clic en Clusters en la sección Database.
La página de clústeres se muestra.
En la sección Additional Settings del formulario de clúster, se debe seleccionar una versión principal del menú desplegable junto a Select a Version que coincida con la compatibilidad de características entre versiones del clúster.
Aparece un banner de advertencia que indica que la versión de MongoDB del clúster será degradada.
Para degradar el clúster en una versión principal utilizando la API, se debe consultar Modificar un clúster de un proyecto.
Se debe fijar la compatibilidad de características entre versiones para el clúster
Cuando tu clúster tiene un FCV fijado, aparece un icono de chincheta junto al Version de tu clúster en la parte inferior de la tarjeta del clúster. Si colocas el cursor sobre el icono de chincheta, aparece una información emergente que muestra el FCV y la fecha de caducidad.
Atlas desancla la compatibilidad de características entre versiones del clúster en el siguiente periodo de mantenimiento que comience a partir de la fecha de expiración.
Si ya se ha actualizado la versión de MongoDB del clúster, Atlas actualiza la compatibilidad de características entre versiones para que coincida con su versión de MongoDB una vez que el pin caduca.
Advertencia
El pin FCV es una medida temporal que se mantiene hasta por 4 semanas después de la fecha del pin y no simula el comportamiento de las versiones binarias anteriores. Solo pospone la actualización de ciertas estructuras de datos internas que permiten nuevas funciones del servidor. Una vez que esté seguro de que no es necesario volver a la versión anterior, desactive el pin FCV para que coincida con la versión binaria actual.
Para fijar la compatibilidad de características entre versiones del clúster:
En Atlas, ve a la página Clusters de tu proyecto.
Si aún no se muestra, seleccione la organización que contiene su proyecto deseado en el menú Organizations de la barra de navegación.
Si aún no aparece, selecciona el proyecto deseado en el menú Projects de la barra de navegación.
En la barra lateral, haz clic en Clusters en la sección Database.
La página de clústeres se muestra.
Establece la fecha de vencimiento.
Todas las fechas se establecen como marca de tiempo en formato ISO 8601 y hora UTC, en formato MM/DD/YYYY. Establezca la fecha de vencimiento del FCV dentro de las cuatro semanas posteriores a la fecha en que lo fijó. Cuando vence la fecha de vencimiento, la información emergente muestra Expired XX/XX/XXXX. Su PIN FCV vence automáticamente después de 4 semanas.
Después de que expire el pin de compatibilidad de características entre versiones, Atlas desancla la compatibilidad de características entre versiones del clúster en el siguiente periodo de mantenimiento que comience en a partir de la fecha de vencimiento. Si ya se ha actualizado la versión de MongoDB del clúster, Atlas actualiza su compatibilidad de características entre versiones para que coincida con su versión de MongoDB.
Para fijar la compatibilidad de características entre versiones de tu clúster utilizando la API de administración de Atlas, revisa Fijar compatibilidad de características entre versiones en un clúster desde un proyecto.
Desanclar la compatibilidad de características entre versiones para el clúster
Para desanclar la compatibilidad de características entre versiones del clúster:
En Atlas, ve a la página Clusters de tu proyecto.
Si aún no se muestra, seleccione la organización que contiene su proyecto deseado en el menú Organizations de la barra de navegación.
Si aún no aparece, selecciona el proyecto deseado en el menú Projects de la barra de navegación.
En la barra lateral, haz clic en Clusters en la sección Database.
La página de clústeres se muestra.
Para desanclar la compatibilidad de características entre versiones de tu clúster usando la API de administración de Atlas, consulta Desanclar compatibilidad de características entre versiones para un solo clúster de un solo Proyecto.
Ponte en contacto con soporte
Si tienes alguna pregunta sobre el soporte de migración más allá de lo que se cubre en esta documentación, o si encuentras un error durante la migración, abre un archivo de ticket de soporte a través de la interfaz de usuario de Atlas.
Si tiene alguna pregunta o necesita más asistencia, póngase en contacto con nuestro equipo de soporte.