El control de versiones de MongoDB tiene la forma
X.Y.Z Donde Z se refiere al número de revisión/parche. Las revisiones 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 revisión de su serie de lanzamientos.
Para obtener más información sobre el control de versiones, consulte Control de versiones de MongoDB.
Antes de actualizar
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:
Las notas de la versión, se encuentran en Notas de la versión.
Importante
A partir de MongODB 4.2, MongoDB elimina el soporte para Ubuntu 16.04 PPCLE.
A partir de MongoDB 3.6.13, La serie MongoDB 3.6 elimina el soporte para Ubuntu 16.04 PPCLE.
A partir de MongoDB 3.4.21, la serie MongoDB 3.4elimina el soporte para Ubuntu 16.04 PPCLE.
Periodo de mantenimiento
Si su instalación incluye conjuntos de réplicas, planifique la actualización durante una ventana de mantenimiento predefinida.
Flujos de cambio
A partir de MongoDB 4.0.7, los flujos de cambios usan tokens de reanudación de la versión 1 v1. Las versiones de MongoDB anteriores a 4.0.7 usan tokens de reanudación de v0.
Al actualizar de MongoDB 4.0.6 o anterior a MongoDB 4.0.7 o posterior, un cliente podría intentar reanudar los flujos de cambios utilizando el nuevo token de reanudación v1 al conectarse a un miembro no actualizado (es decir, que solo acepta el token v0 o BinData) y fallar. En tales casos, el cliente debe esperar a que se complete la actualización antes de reanudar los flujos de cambios.
Comprobación del entorno de staging
Antes de actualizar un entorno de producción, utilice los procedimientos de este documento para actualizar un entorno de prueba que reproduzca su entorno de producción, para garantizar que su configuración de producción sea compatible con todos los cambios.
Procedimiento de actualización
Importante
Siempre haga una copia de seguridad de todos sus datos antes de actualizar MongoDB.
Actualice cada mongod binario y por separado, siguiendo el procedimiento descrito aquí.mongos Al actualizar un binario, siga el procedimiento "Actualizar una instancia de MongoDB".
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.
Actualice los clústeres particionados, como se describe en Actualización de clústeres particionados.
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 una instancia de MongoDB
Para actualizar una instancia o, utilice uno de estos mongod mongos enfoques:
Actualice la instancia usando la herramienta de gestión de paquetes del sistema operativo y los paquetes oficiales de MongoDB. Este es el método recomendado.Consulte Instalar MongoDB.
Actualiza la instancia reemplazando los binarios existentes por nuevos. Consulta Reemplazar los binarios existentes.
Realice los cambios necesarios en el archivo de configuración antes de reiniciar la instancia.
Reemplace los binarios existentes
Importante
Siempre haga una copia de seguridad de todos sus datos antes de actualizar MongoDB.
Esta sección describe cómo actualizar MongoDB reemplazando los binarios existentes. La mejor manera de actualizar es usar la herramienta de gestión de paquetes del sistema operativo y los paquetes oficiales de MongoDB, como se describe en Instalar MongoDB.
Para actualizar una instancia de mongod o mongos reemplazando los binarios existentes:
Descargue los binarios de la última revisión de MongoDB desde la página de descargas de MongoDB y guárdelos temporalmente. 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 conjunto de réplicas, actualice cada miembro individualmente, comenzando con los secundarios y finalizando con el primario. Planifique la 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.
Nota
A partir de MongoDB,4.0.7 los flujos de cambios usan 1 v1 tokens de reanudación de la versión. Las versiones de MongoDB anteriores a 4.0.7 usan v0 tokens de reanudación o tokens de reanudación de BinData.
Al actualizar de MongoDB 4.0.0-4.0.6 a MongoDB 4.0.7 o posterior, un cliente podría intentar reanudar los flujos de cambios utilizando el nuevo token de reanudación v1 al conectarse a un miembro no actualizado (es decir, que solo acepta el token v0 o BinData) y fallar. En tales casos, el cliente debe esperar a que se complete la actualización antes de reanudar los flujos de cambios.
Actualiza los secundarios
Actualiza cada secundario por separado de la siguiente manera:
Actualice el binario del
mongodsecundario siguiendo las instrucciones en Actualizar una instancia de MongoDB.Después de actualizar un secundario, espera a que el secundario vuelva al estado
SECONDARYantes de actualizar la siguiente instancia. Para comprobar el estado del nodo, emiters.status()enmongosh.El secundario puede ir brevemente a
STARTUP2oRECOVERING. Esto es normal. Asegúrate de esperar a que el secundario se recupere completamente aSECONDARYantes 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()enmongosh.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()desdemongoshhasta que veas que otro nodo ha asumido el estadoPRIMARY.Se debe apagar el primario original y actualiza la instancia siguiendo las instrucciones en Actualizar una instancia de MongoDB.
Actualice clústeres fragmentados
Modificado en la 3.4 versión: El procedimiento se aplica a la 6.0 versión. Para realizar actualizaciones de revisión para otras versiones de clústeres fragmentados de MongoDB, consulte la versión correspondiente del manual.
Nota
A partir de MongoDB,4.0.7 los flujos de cambios usan 1 v1 tokens de reanudación de la versión. Las versiones de MongoDB anteriores a 4.0.7 usan v0 tokens de reanudación o tokens de reanudación de BinData.
Al actualizar de MongoDB 4.0.6 o anterior a 4.0.7 o posterior, los miembros de los clústeres fragmentados seguirán generando v0 tokens de reanudación o BinData hasta que mongos se actualicen las mongos instancias. Las instancias actualizadas empezarán a generar v1 tokens de reanudación de flujo de cambios. Estos tokens no se pueden usar para reanudar un flujo en un que aún no se haya mongos actualizado 4 a,0 7 o posterior.
Para actualizar un clúster fragmentado 6.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
mongossiguiendo las instrucciones de Actualizar una instancia de MongoDB. Puedes actualizar las instancias demongosen cualquier orden.Vuelve a activar el balanceador, como se describe en Activar el balanceador.