Actualización de MongoDB 4.2 a versiones superiores
Introducción
En este documento se presentan las recomendaciones, consideraciones y buenas prácticas para llevar a cabo la actualización de MongoDB desde la versión 4.2 hacia una versión superior. El objetivo es proporcionar una guía técnica que permita realizar el proceso de migración de manera segura, ordenada y con el menor impacto posible en las operaciones del sistema.
La actualización de MongoDB requiere evaluar diversos aspectos técnicos, entre ellos la compatibilidad entre versiones, cambios en el motor o formato de almacenamiento, incorporación de nuevas funcionalidades, requisitos de hardware, métodos de respaldo y restauración, así como las estrategias de validación posteriores a la actualización.
Compatibilidad de versiones de MongoDB con NMIS y módulos OMK
Las diferentes versiones de NMIS y los módulos OMK tienen restricciones específicas respecto a las versiones de MongoDB que pueden utilizarse.
NMIS 8 soporta versiones de MongoDB hasta la versión 4.2.
NMIS 9 soporta oficialmente versiones de MongoDB hasta la versión 7.0.
Adicionalmente, los módulos de OMK mantienen compatibilidad con MongoDB 6.0 durante un periodo de soporte de dos años.
En el entorno de pruebas de Telmex (10.237.7.30), se ha verificado soporte para MongoDB 7.0.
De acuerdo con la matriz de compatibilidad del producto, las versiones mínimas de los módulos OMK que soportan MongoDB 6.0 y MongoDB 7.0 son las siguientes:
Componente | Versión compatible |
|---|---|
NMIS | 9.6.0 |
opCharts | 4.8.4 |
opConfig | 4.6.0 |
opEvents | 4.6.2 |
opHA | 4.1.2 |
opReports | 4.6.8 |
opFlow | 4.1.1 |
Estas versiones aseguran la compatibilidad con las versiones recientes de MongoDB y permiten aprovechar mejoras de rendimiento, seguridad y estabilidad incluidas en las versiones más actuales del motor de base de datos.
RHEL 8.10: Según la documentación oficial de compatibilidad de MongoDB, las versiones 7.x y 8.x están soportadas en esta plataforma.
Ruta recomendada en la actualización
Para reducir la complejidad del proceso y minimizar riesgos durante la actualización de MongoDB, se recomienda utilizar automatización (por ejemplo, mediante Ansible) y evitar realizar la actualización completa directamente en cada servidor.
La estrategia sugerida consiste en realizar el proceso de migración de forma controlada utilizando un host de virtualización con contenedores Docker, lo que permite ejecutar de manera secuencial las versiones intermedias requeridas por MongoDB.
Procedimiento propuesto
Configurar una máquina virtual que funcione como host de Docker.
Implementar contenedores Docker de MongoDB correspondientes a las versiones necesarias para la migración:
MongoDB 4.4
MongoDB 5.0
MongoDB 6.0
MongoDB 7.0
Configurar temporalmente los servidores para que apunten a la misma instancia de base de datos durante el proceso de migración.
Detener todos los servicios asociados a la plataforma.
Realizar un respaldo completo de la base de datos de MongoDB.
Iniciar las versiones de MongoDB de manera secuencial, ejecutando los pasos de migración correspondientes en cada etapa.
Durante el proceso de migración, los servicios asociados se actualizarán gradualmente conforme se avance entre versiones.
Ejemplo de secuencia de actualización
El proceso se ejecuta iniciando cada versión intermedia de MongoDB para permitir la actualización del formato interno de la base de datos:
Iniciar MongoDB 4.2 > actualización a MongoDB 4.4
Iniciar MongoDB 4.4 > actualización a MongoDB 5.0
Iniciar MongoDB 5.0 > actualización a MongoDB 6.0
Iniciar MongoDB 6.0 > actualización a MongoDB 7.0
Este enfoque evita tener que realizar actualizaciones secuenciales completas en cada servidor del entorno.
Validación
Después de completar la actualización, se deben realizar las siguientes verificaciones:
Revisar los logs de MongoDB para confirmar que la base de datos se ha iniciado correctamente y sin errores.
Validar que NMIS y los módulos OMK carguen correctamente la información desde la base de datos.
Confirmar el funcionamiento normal de NMIS y sus módulos asociados.
Riesgos
Tiempo de inactividad durante el proceso de migración.
Posibles incompatibilidades si los componentes del sistema no se encuentran en versiones soportadas.
Por este motivo, es obligatorio realizar un respaldo completo de la base de datos antes de iniciar cualquier proceso de migración.
Plan de reversión
En caso de presentarse una falla durante el proceso de actualización, se deberá:
Detener los servicios del sistema.
Restaurar el respaldo previamente generado de la base de datos.
Regresar a la versión original de MongoDB utilizada antes de la migración.
Migración de Mongo
La migración de la versión de MongoDB, se apoya en el procedimiento descrito en el siguiente enlace, el cual sirve como referencia primordial:
https://docs.community.firstwave.com/wiki/x/AQBh7w