Se debe familiarizar con el contenido de este documento, incluyendo una revisión exhaustiva de los requisitos previos, antes de actualizar a MongoDB 5.0.
Los siguientes pasos describen el procedimiento para actualizar un sistema independiente
mongod de la versión 4.4 a la 5.0.
Si se necesita orientación sobre cómo actualizar a 5.0, los servicios profesionales de MongoDB ofrecen soporte para la actualización de versiones principales para ayudar a garantizar una transición sin problemas y sin interrupciones en la 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 la versión 5.0, es necesario ejecutar una versión 4.4.
Para actualizar desde una versión anterior a la serie 4.4, debe actualizar sucesivamente las versiones principales hasta que haya actualizado a la serie 4.4. Por ejemplo, si está ejecutando una serie 4.2, primero debe actualizar a 4.4 antes de poder actualizar a 5.0.
Verifique la compatibilidad del controlador
Antes de actualizar MongoDB, se debe comprobar que se está usando un driver compatible con MongoDB 5.0. Se debe consultar la documentación del driver para el driver específico que se está usando y verificar la compatibilidad con MongoDB 5.0.
Las implementaciones actualizadas que se ejecutan en controladores incompatibles podrían experimentar un comportamiento inesperado o indefinido.
Advertencia
Si tus drivers utilizan opcodes heredados que quedaron obsoletos en la versión 3.6, actualiza tus drivers a una versión que utilice opcodes admitidos. Los controladores que usen códigos de operación heredados ya no son compatibles.
Preparación
Antes de actualizar, se puede consultar el documento Cambios de compatibilidad en MongoDB 5.0 para garantizar que las aplicaciones e implementaciones sean compatibles con MongoDB 5.0. 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
Una vez actualizado 5.0 a, si necesita cambiar a una versión inferior, le recomendamos hacerlo a la última versión del 4.4 parche.
Requisitos previos
Antes de actualizar su versión independiente,mongod 5.0 consulte las Consideraciones de rendimiento de para conocer los posibles impactos en el rendimiento al actualizar 5.0 a.
Asegúrese de que la configuración TTL sea válida
Asegúrese de que la configuración TTL sea válida. Antes de actualizar, elimine o corrija cualquier índice TTL que tenga expireAfterSeconds establecido NaN en. En MongoDB 5.0 y versiones posteriores, establecer expireAfterSeconds en NaN tiene el mismo efecto que expireAfterSeconds establecer 0 en. Para obtener más información, consulte "Comportamiento TTL expireAfterSeconds cuando se establece en NaN ".
Confirmar apagado limpio
Antes de actualizar, confirme que su instancia se mongod haya cerrado correctamente.
Compatibilidad de características entre versiones
La instancia 4.4 debe tener featureCompatibilityVersion establecido en "4.4". Para comprobar featureCompatibilityVersion:
db.adminCommand( { getParameter: 1, featureCompatibilityVersion: 1 } )
La operación debería devolver un resultado que incluya "featureCompatibilityVersion" : { "version" : "4.4" }.
Para establecer o actualizar featureCompatibilityVersion, ejecute el siguiente comando:
db.adminCommand( { setFeatureCompatibilityVersion: "4.4" } )
Para obtener más información, consulta setFeatureCompatibilityVersion.
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 5.0 Binarios
A través del Package Manager
Si se instaló MongoDB desde los repositorios de MongoDB apt, yum, dnf o zypper, se debería actualizar a 5.0 usando el administrador de Paquetes.
Se deben seguir las instrucciones de instalación 5.0 adecuadas para el sistema Linux. Esto implicará añadir un repositorio para la nueva versión y, a continuación, realizar el proceso de actualización propiamente dicho.
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 5.0 para obtener más información.
Proceso de actualización
Advertencia
Si actualizas una instancia existente de MongoDB a MongoDB 5.0.15, es posible que esa instancia no se inicie si fork: true está configurado en el archivo mongod.conf.
El problema de actualización afecta a todas las .deb .rpm instancias de MongoDB que usan paquetes de instalación o. Las instalaciones que usan la versión tarball ().tgz u otros tipos de paquetes no se ven afectadas. Para obtener más información, consulte SERVER-.74345
Para remover la configuración de fork: true, ejecute estos comandos desde una terminal del sistema:
systemctl stop mongod.service sed -i.bak '/fork: true/d' /etc/mongod.conf systemctl start mongod.service
El segundo comando systemctl inicia la instancia actualizada después de eliminar la configuración.
Reemplace los binarios 4.4 existentes con los binarios 5.0.
Cierre la instancia. Reemplace el binario existente con mongod el 5.0 mongod binario.
Reinicie su implementación 5.0 mongod con.
Habilitar funcionalidades incompatibles con versiones anteriores 5.0.
En este punto, se pueden ejecutar los binarios 5.0 sin las características 5.0 que son incompatibles con 4.4.
Para habilitar estas 5.0 funciones, configure la versión de compatibilidad de funciones (FCV) en 5.0.
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: "5.0" } )
Este comando debe realizar guardados en una colección interna del sistema. Si por alguna razón el comando no se completa correctamente, puede volver a intentarlo con seguridad, ya que la operación es idempotente.
Nota
Tras completar la actualización, es posible que observe un aumento significativo en el tamaño del índice. Para consultarlo, consulte. Este aumento se debe a los datos relacionados con la ventana de tiempo almacenados en las claves de dbStats.indexSize índice.
Si sus índices son significativamente más grandes después de la actualización y desea reducir el tamaño de los índices, comuníquese con su representante de soporte técnico de MongoDB para analizar soluciones.
Procedimientos de actualización adicionales
Para actualizar un set de réplicas, se puede consultar Actualizar un set de réplicas a 5.0.
Para actualizar un clúster fragmentado, consulta Actualizar un clúster fragmentado a 5.0.