Importante
MongoDB 8.3 es la última versión menor. A partir de MongoDB 8.2, las versiones menores están disponibles para implementaciones locales (Community y EA) para casos de uso específicos. Para obtener más información, consulte Versionado de MongoDB.
Para instalar la última versión de MongoDB compatible para uso on-premises, consulta las instrucciones de instalación.
Se debe familiarizar con el contenido de este documento, incluyendo una revisión exhaustiva de los requisitos previos, antes de actualizar a MongoDB 8.3.
Los siguientes pasos describen el procedimiento para actualizar un
mongod ese es un set de réplicas desde la versión 8.0 hasta la 8.3.
Si necesitas orientación sobre cómo actualizar a la versión 8.3, Los servicios profesionales de MongoDB ofrecen soporte para actualizaciones, lo que ayuda a garantizar una transición fluida y sin interrupciones en su aplicación MongoDB.
Recomendaciones de actualizaciones y listas de verificación
Al actualizar, considere lo siguiente:
Ruta de actualización de versión
Para actualizar una implementación existente de MongoDB a 8.3, se debe estar ejecutando una versión de la serie 8.0.
Al actualizar desde una versión menor, debe actualizar sucesivamente las versiones menores hasta que haya actualizado a 8.3.
Para obtener más información, consulte Actualizar 8.2 a.8.3
Verifique la compatibilidad del controlador
Antes de actualizar MongoDB, se debe comprobar que se está usando un driver compatible con MongoDB 8.3. Se debe consultar la documentación del driver para el driver específico que se está usando y verificar la compatibilidad con MongoDB 8.3.
Las implementaciones actualizadas que se ejecutan en controladores incompatibles podrían experimentar un comportamiento inesperado o indefinido.
Preparación
Antes de actualizar, se puede consultar el documento Cambios de compatibilidad en MongoDB 8.3 para garantizar que las aplicaciones e implementaciones sean compatibles con MongoDB 8.3. Se pueden resolver las incompatibilidades en la implementación antes de comenzar la actualización.
Antes de actualizar MongoDB, siempre se debe probar la aplicación en un entorno de pruebas antes de implementar la actualización en el entorno de producción.
Consideración de reducción de versión
A partir de MongoDB 8.3, puede degradar su versión de MongoDB a la versión menor o mayor inmediatamente anterior.
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 8.0 a una 7.0. Sin embargo, no se admite una degradación posterior de esa implementación 7.0 a una implementación 6.0.
Para aprender más, consultar Degradar 8.3 a 8.0.
Requisitos previos
Versión de todos los nodos
Todos los miembros del conjunto de réplicas deben ejecutar 8.0 la versión. Para actualizar un conjunto de réplicas desde la 7.0 versión o anterior, primero actualice todos los miembros del conjunto de réplicas a la última 8.0versión de la serie y, a continuación, siga el procedimiento para actualizar 8.0 8de MongoDB3 a..
Compatibilidad de características entre versiones
El set de réplicas 8.0 debe tener featureCompatibilityVersion configurado en "8.0".
Para garantizar que todos los nodos del set de réplicas tengan featureCompatibilityVersion establecido en "8.0", conéctate a cada nodo del set de réplicas y verifica el featureCompatibilityVersion:
db.adminCommand( { getParameter: 1, featureCompatibilityVersion: 1 } )
"featureCompatibilityVersion" : { "version" : "8.0" }
Para configurar o actualizar featureCompatibilityVersion, ejecuta el siguiente comando en el primario. La mayoría de los nodos que contienen datos deben estar disponible:
db.adminCommand( { setFeatureCompatibilityVersion: "8.0" , confirm: true } )
Para obtener más información, consulta setFeatureCompatibilityVersion.
Estado del nodo del set de réplicas
Emita el comando para asegurarse de que ningún miembro replSetGetStatus ROLLBACK RECOVERING del conjunto de réplicas se encuentre en el estado o:
db.adminCommand( { replSetGetStatus: 1 } )
Descargue 8.3 Binarios
Utiliza un administrador de paquetes
Si se instaló MongoDB desde los repositorios de MongoDB apt, yum, dnf o zypper, se debería actualizar a 8.3 usando el administrador de Paquetes.
Siga las instrucciones adecuadas de instalación de8.3 para su sistema Linux. Esto requiere agregar un repositorio para la nueva versión y luego realizar el proceso de actualización real.
Manualmente
Si no se ha instalado MongoDB usando un administrador de paquetes, se pueden descargar manualmente los binarios de MongoDB desde el Centro de Descargas de MongoDB.
Consultar instrucciones de instalación 8.3 para obtener más información.
Procedimiento de actualización
Puedes actualizar de MongoDB 8.0 a 8.3 mediante una actualización "progresiva" para minimizar el tiempo de inactividad mediante la actualización de los nodos de forma individual mientras los demás nodos están disponibles.
Actualizar los miembros secundarios del conjunto de réplicas
Actualiza los secundarios del set de réplicas uno a la vez:
Reemplaza el binario 8.0 con el binario 8.3.
Reinicia el nodo.
Desciende el conjunto de réplica principal
Se debe conectar mongosh al primario y usar rs.stepDown() para degradar el primario y forzar una elección de un nuevo primario.
Actualizar el principal anterior
Cuando rs.status() muestre que el primario ha dejado su puesto y otro nodo ha asumido el estado PRIMARY, actualiza el primario que ha dejado su puesto:
Desactiva el primario degradado y reemplaza el binario
mongodcon el binario 8.3.Reinicia el nodo.
Habilitar funciones 8.3 incompatibles con versiones anteriores
Tip
Activar estas características incompatibles con versiones anteriores puede complicar el proceso de degradación, ya que se debe remover cualquier característica incompatible con versiones anteriores que persista antes de realizar la degradación.
Se recomienda que, tras la actualización, se permita que la implementación se ejecute sin habilitar estas características durante un periodo de prueba para asegurar que la probabilidad de reversión sea mínima. Cuando se esté seguro de que la probabilidad de degradación es mínima, se pueden activar estas características.
En este punto, se pueden ejecutar los binarios 8.3 sin las características 8.3 que son incompatibles con 8.0.
Para habilitar estas 8.3 características, establezca la versión de compatibilidad de características (FCV) en 8.3. También debe establecer confirm en verdadero.
Tip
Asegúrese de que no haya ninguna sincronización inicial en curso. Ejecutar setFeatureCompatibilityVersion el comando mientras se está realizando una sincronización inicial provoca que esta se reinicie.
En el primario, ejecuta el comando setFeatureCompatibilityVersion en la base de datos admin:
db.adminCommand( { setFeatureCompatibilityVersion: "8.3", confirm: true } )
La configuración de featureCompatibilityVersion (compatibilidad de características entre versiones): "8.3" realiza implícitamente un replSetReconfig para agregar el campo term al documento de configuración y se bloquea hasta que la nueva configuración se propaga a la mayoría de los nodos del set de réplicas.
Este comando debe realizar escrituras en una colección interna del sistema. Si el comando no se completa, puede volver a intentarlo sin problemas en el servidor principal, ya que la operación es idempotente.
Procedimientos de actualización adicionales
Para actualizar un sistema independiente, consulte 8.0 Actualizar sistema independiente 8.3 a.
Para actualizar un clúster fragmentado, consulte Actualizar el clúster fragmentado 8.0 8.3a.