Actualiza un set de réplicas a 8.0

Ruta de actualización de versión

Para actualizar una implementación existente de MongoDB a 8.0, se debe estar ejecutando una versión de la serie 7.0.

Para actualizar desde una versión anterior a la serie 7.0, debe actualizar sucesivamente las versiones principales hasta que se haya actualizado a la serie 7.0. Por ejemplo, si se está ejecutando una serie 6.0, primero se debe actualizar a 7.0 antes de poder actualizar a 8.0.

Verifique la compatibilidad del controlador

Antes de actualizar MongoDB, compruebe que está utilizando un controlador compatible con MongoDB 8.0. Consulte la documentación del controlador específico para verificar la compatibilidad con MongoDB 8.0.

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.2 para garantizar que las aplicaciones e implementaciones sean compatibles con MongoDB 8.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

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, puedes degradar una implementación de la serie 8.0 a una de la serie 7.0. Sin embargo, no se brinda soporte a seguir degradando esa implementación de la serie 7.0 a una implementación de la serie 6.0.

Para aprender más, consultar Degradar 8.0 a 7.0.

Versión de todos los nodos

Todos los nodos del set de réplicas deben estar ejecutando la versión 7.0. Para actualizar un set de réplicas de la serie 6.0 y anteriores, primero se deben actualizar todos los miembros del set de réplicas a la versión más reciente de la serie 7.0 y, a continuación, se debe seguir el procedimiento para actualizar de MongoDB 7.0 a 8.0.

Compatibilidad de características entre versiones

El set de réplicas 7.0 debe tener featureCompatibilityVersion configurado en "8.3".

Para garantizar que todos los nodos del set de réplicas tengan featureCompatibilityVersion establecido en "8.3", conéctate a cada nodo del set de réplicas y verifica el featureCompatibilityVersion:

db.adminCommand( { getParameter: 1, featureCompatibilityVersion: 1 } )

Todos los nodos deben devolver un resultado que incluya "featureCompatibilityVersion" : { "version" : "7.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: "7.0" , confirm: true } )

Para obtener más información, consulta setFeatureCompatibilityVersion.

Estado del nodo del set de réplicas

Asegúrate de que ningún nodo del set de réplicas esté en el estado ROLLBACK o RECOVERING emitiendo el comando replSetGetStatus:

db.adminCommand( { replSetGetStatus: 1 } )

Remover colecciones system.buckets no válidas

Al actualizar a 9.0, si tienes alguna colección system.buckets que no sea de series de tiempo, es posible que necesites drop o rename esas colecciones antes de actualizar, dependiendo de la versión del parche 8.0:

MongoDB 8.0.5 y posterior

No es necesario descartar las colecciones system.buckets que no sean colecciones de serie de tiempo antes de actualizar. Sin embargo, debes descartarlas o renombrarlas después de completar la actualización.

MongoDB 8.0.4 y versiones anteriores

Debe descartar o cambiar el nombre de system.buckets colecciones que no sean colecciones de series temporales antes de realizar la actualización. Todas las colecciones system.buckets deben tener opciones válidas de series de tiempo configuradas antes de actualizar a las versiones 8.0.0 - 8.0.4.

Para determinar si tienes colecciones system.buckets que no sean colecciones de series de tiempo, usa el método db.getCollectionInfos() con un filtro:

db.getCollectionInfos(
   {
      $and: [
         { name: { $regex: /^system\.buckets/ } },
         { 'options.timeseries': { $exists: false } }
      ]
   }
)

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.0 usando el administrador de Paquetes.

Siga las instrucciones adecuadas de instalación de9.0 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.0 para obtener más información.