Actualiza a la última versión del parche autogestionado de MongoDB

Los números de versión de MongoDB tienen el formato X.Y.Z Donde Z se refiere al número de la versión del parche. Las versiones de parches incluyen parches de seguridad, correcciones de errores y funciones nuevas o modificadas que, por lo general, no contienen cambios que afecten a versiones anteriores. Actualice siempre a la última versión de su serie de lanzamientos.

Para obtener más información sobre las versiones, incluidas las actualizaciones principales y secundarias de Atlas, consulte Control de versiones de MongoDB.

Acerca de esta tarea

Esta página describe los procedimientos de actualización para la serie de lanzamientos de MongoDB 8.0. Para actualizar una serie de versiones diferente, consulta la versión correspondiente del manual.

Antes de comenzar

Se deben revisar las siguientes secciones para garantizar que la implementación esté lista para actualizarse.

Backup

Asegúrese de tener una copia de seguridad actualizada de su conjunto de datos. Consulte Métodos de copia de seguridad para una implementación autogestionada.

Consideraciones sobre la compatibilidad

Consultar los siguientes documentos para cualquier consideración especial o problema de compatibilidad específico de la versión de MongoDB:

Periodo de mantenimiento

Si la instalación incluye sets de réplicas, se debe configurar la actualización para que tenga lugar durante un periodo de mantenimiento predefinido.

Comprobación del entorno de staging

Antes de actualizar un entorno de producción, se deben usar los procedimientos en este documento para actualizar un entorno de ensayo que reproduzca el entorno de producción. Es necesario garantizar que la configuración de producción sea compatible con todos los cambios antes de actualizar.

Pasos

Actualiza cada mongod y mongos binario por separado. Sigue este procedimiento de actualización:

Para las implementaciones que utilizan autenticación, primero actualiza todos los controladores de MongoDB. Para actualizar, consulta la documentación del controlador.
Actualiza cualquier instancia autónoma. Consulta Actualizar una instancia de MongoDB.
Actualiza los sets de réplicas que no forman parte de un clúster, como se describe en Actualizar sets de réplicas.
Actualice los clústeres particionados, como se describe en Actualización de clústeres particionados.

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

Antes de actualizar los binarios, se debe confirmar que featureCompatibilityVersion se ha actualizado por completo en todos los componentes relevantes de la implementación. Si la actualización anterior de la compatibilidad de características entre versiones no se completó correctamente, reiniciar el binario con una versión superior puede provocar que el nodo se bloquee.

Para Set de réplicas:

Para verificar la compatibilidad de características entre versiones, conecta cada nodo del Set de réplicas y ejecuta el siguiente comando:

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

Todos los nodos deberían devolver un resultado que incluya lo siguiente:

"featureCompatibilityVersion" : { "version" : "8.0" }

Para clústeres fragmentados:

Realice la misma comprobación en todos los servidores de configuración y fragmentos:

Para las particiones que son Sets de réplicas, verifica la compatibilidad de características entre versiones en cada nodo del Set de réplicas.
Para instancias de particiones autónomas, ejecuta el comando en la instancia.

Espera a que todos los nodos informen la compatibilidad de características entre versiones requerida antes de avanzar con la actualización binaria.

Actualice una instancia de MongoDB

Para actualizar una instancia 8.0 mongod o mongos, utilice uno de estos métodos:

Actualice la instancia usando la herramienta de gestión de paquetes del sistema operativo y los paquetes oficiales de MongoDB. Este es el enfoque preferido. Vea 8.2 Procedimientos de actualización.
Actualiza la instancia reemplazando los binarios existentes por nuevos. Consulta Reemplazar los binarios existentes.

Reemplace los binarios existentes

Esta sección describe cómo actualizar MongoDB reemplazando los binarios existentes. El enfoque preferido para actualizar es utilizar la herramienta de gestión de paquetes del sistema operativo y los paquetes oficiales de MongoDB, como se describe en 8.2 Procedimientos de actualización.

Para actualizar una instancia de mongod o mongos reemplazando los binarios existentes:

Descarga los binarios de la última versión del parche de MongoDB desde la página MongoDB Download y almacénalos en una ubicación temporal. Los binarios se descargan como archivos comprimidos que se descomprimen en la estructura de directorios utilizada por la instalación de MongoDB.
Apaga la instancia.
Sustituye los archivos binarios de MongoDB existentes por los binarios descargados.
Realiza los cambios necesarios en los archivos de configuración.
Reinicie la instancia.

Actualizar Set de réplicas

Para actualizar un set de réplicas 8.0, actualiza cada nodo individualmente, comenzando por los secundarios y terminando con el primario. Planifica el actualización durante un periodo de mantenimiento predefinido.

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.

Actualiza los secundarios

Actualiza cada secundario por separado de la siguiente manera:

Actualice el binario del mongod secundario siguiendo las instrucciones en Actualizar una instancia de MongoDB.
Después de actualizar un secundario, espera a que el secundario vuelva al estado SECONDARY antes de actualizar la siguiente instancia. Para comprobar el estado del nodo, emite rs.status() en mongosh.
El secundario puede ir brevemente a STARTUP2 o RECOVERING. Esto es normal. Asegúrate de esperar a que el secundario se recupere completamente a SECONDARY antes de continuar actualizando.

Actualiza el primario

Degrada el primario para iniciar el procedimiento normal de conmutación por error con uno de los siguientes:
- El asistente rs.stepDown() en mongosh.
- El comando de base de datos replSetStepDown.
Durante la conmutación por error, el set no puede aceptar operaciones de guardado. Normalmente, esto tarda entre 10 y 20 segundos. Planifica el actualización durante un periodo de mantenimiento predefinido.
Nota
Es preferible degradar el primario que apagarlo. La degradación acelera el procedimiento de conmutación por error.
Una vez que el primario se haya despromovido, llama al método rs.status() desde mongosh hasta que veas que otro nodo ha asumido el estado PRIMARY.
Se debe apagar el primario original y actualiza la instancia siguiendo las instrucciones en Actualizar una instancia de MongoDB.

Actualice clústeres fragmentados

Para actualizar un clúster fragmentado 8.0:

Desactiva el balanceador del clúster como se describe en Desactivar el balanceador.
Actualiza los servidores de configuración.
Para actualizar el set de réplicas del servidor de configuración, utiliza los procedimientos en Actualizar los sets de réplicas.
Actualiza cada partición.
- Si una partición es un set de réplicas, actualiza la partición utilizando el procedimiento titulado Actualizar sets de réplicas.
- Si una partición es una instancia autónoma, actualiza la partición según el procedimiento titulado Actualizar una instancia de MongoDB.
Una vez que se hayan actualizado los servidores de configuración y las particiones, actualiza cada instancia de mongos siguiendo las instrucciones de Actualizar una instancia de MongoDB. Puedes actualizar las instancias de mongos en cualquier orden.
Vuelve a activar el balanceador, como se describe en Activar el balanceador.

Obtén más información

Volver

Configuración de la base de datos en tiempo de ejecución

Gestiona procesos de mongod