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 remueve 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.4 elimina la compatibilidad con Ubuntu 16.04 PPCLE.
Periodo de mantenimiento
Si tu instalación incluye set de réplicas, planifica la actualización durante un periodo de mantenimiento predefinido.
Flujos de cambio
A partir de MongoDB 4.0.7, los flujos de cambios utilizan versiones 1 de v1 tokens de reanudación. Las versiones de MongoDB inferiores a la 4.0.7 utilizan v0 tokens de reanudación.
Al actualizar de MongoDB 4.0.6 o anterior a MongoDB 4.0.7 o posterior, un cliente puede intentar reanudar los flujos de cambios utilizando el nuevo token de reanudación v1 cuando se conecta a un nodo que no se ha actualizado (es decir, " solo acepta el token v0 o BinData) y falla. En tales casos, el cliente debe esperar a que la actualización se complete 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 realiza una copia de seguridad de todos tus datos antes de actualizar MongoDB.
Actualice cada mongod y mongos binario por separado, utilizando el procedimiento descrito aquí. Al actualizar un binario, utiliza 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 mongod o mongos, utiliza uno de estos enfoques:
Actualice la instancia utilizando la herramienta de gestión de paquetes del sistema operativo y los paquetes oficiales de MongoDB. Este es el enfoque preferido. Consulta Instalar MongoDB.
Actualiza la instancia reemplazando los binarios existentes por nuevos. Consulta Reemplazar los binarios existentes.
Realiza todos los cambios necesarios en los archivos de configuración antes de reiniciar la instancia.
Reemplace los binarios existentes
Importante
Siempre realiza una copia de seguridad de todos tus datos antes de actualizar MongoDB.
Esta sección describe cómo actualizar MongoDB reemplazando los binarios existentes. El enfoque preferido para una actualización 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 almacene los binarios 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 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 utilizan v1 tokens de reanudación de la versión 1. Las versiones de MongoDB anteriores a la 4.0.7 utilizan v0 tokens de reanudación o tokens de reanudación BinData.
Cuando se actualiza de MongoDB 4.0.0-4.0.6 a MongoDB 4.0.7 o posterior, un cliente puede intentar reanudar streams de cambios usando el nuevo token de reanudación v1 al conectarse a un miembro que no se ha actualizado (es decir, solo acepta el token v0 o BinData) y falla. En tales casos, el cliente debe esperar a que la actualización finalice antes de reanudar los streams 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
Cambiado en la versión 3.4: El procedimiento se aplica a 6.0. 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 utilizan v1 tokens de reanudación de la versión 1. Las versiones de MongoDB anteriores a la 4.0.7 utilizan v0 tokens de reanudación o tokens de reanudación 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 tokens v0 de reanudación o BinData hasta que mongos se actualicen las instancias. Las instancias actualizadas empezarán mongos a generar tokens de reanudación de flujo de v1 cambios. Estos tokens no se pueden usar para reanudar un flujo en un que aún no se haya actualizado a 4.0.7 o mongos 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.