Importante
MongoDB 8.3 es la última versión menor. A partir de MongoDB 8.2, las versiones menores están disponibles para implementaciones on-premises (Community y EA) para casos de uso específicos. Para obtener más información, consulta 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 una instancia autónomo
mongod de la versión 8.2 a la 8.3.
Si necesitas orientación sobre cómo actualizar a la versión 8.3, Servicios profesionales de MongoDB ofrecen soporte de actualización para ayudar a garantizar una transición sin problemas, sin interrupciones en tu 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, debes actualizar sucesivamente las versiones menores hasta haber actualizado 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, puedes degradar tu versión de MongoDB a la versión inmediatamente anterior, menor o mayor.
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 realizar un downgrade de una implementación 8.0 a una 7.0. Sin embargo, no se admite degradar aún más esa implementación 7.0 a una implementación 6.0.
Para aprender más, consultar Degradar 8.3 a 8.2.
Requisitos previos
Compatibilidad de características entre versiones
La instancia 8.2 debe tener featureCompatibilityVersion configurado en "8.2". Para comprobar featureCompatibilityVersion, se debe ejecutar el siguiente comando:
db.adminCommand( { getParameter: 1, featureCompatibilityVersion: 1 } )
"featureCompatibilityVersion" : { "version" : "8.2" }
Para obtener más información, consulta db.adminCommand().
Considerar convertir a set de réplicas
Antes de actualizar, se debe considerar convertir la implementación autónoma a un set de réplicas. Los sets de réplicas son la configuración de implementación recomendada para MongoDB.
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
Habilitar funcionalidades incompatibles con versiones anteriores de 8.3
En este punto, se pueden ejecutar los binarios 8.3 sin las características 8.3 que son incompatibles con 8.2.
Para activar estas 8.3 funcionalidades, establezca la compatibilidad de características entre versiones (FCV) en 8.3. También debes establecer confirm en verdadero.
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.
Ejecutar el comando setFeatureCompatibilityVersion contra la base de datos admin:
db.adminCommand( { setFeatureCompatibilityVersion: "8.3", confirm: true } )
Si se establece el valor confirm en true, la operación podrá continuar. Si se omite el parámetro confirm o se establece confirm en un valor distinto de true, el comando falla y devuelve una advertencia sobre la modificación de la compatibilidad de funcionalidades entre versiones.
Este comando debe realizar guardados en una colección interna del sistema. Si el comando no se completa con éxito, puedes volver a intentar el comando de forma segura, ya que la operación es idempotente.
Solución de problemas
Si mongod sale, MongoDB devuelve un código de error. Para solucionar problemas con tu actualización, consulta Códigos de error o Códigos de Salida y Estados para una Implementación Autogestionada.
Si experimenta problemas de inicio al actualizar, póngase en contacto con el soporte de MongoDB para obtener ayuda.
Procedimientos de actualización adicionales
Para actualizar un set de réplicas, consulta Actualizar el set de réplicas 8.2 a 8.3.
Para actualizar un clúster Sheared, consulta Actualizar el clúster Sheared de 8.2 a 8.3.