/
Actualización de MongoDB desde versión 4.2 a 8.0 en RedHat

Actualización de MongoDB desde versión 4.2 a 8.0 en RedHat

Introducción

MongoDB es una base de datos NoSQL orientada a documentos que NMIS utiliza para almacenar información como eventos, flujos, reportes y datos históricos de monitoreo. Mantener MongoDB actualizado es importante para garantizar compatibilidad con nuevas versiones de NMIS, además de mejorar seguridad, estabilidad y rendimiento.

La actualización debe realizarse de forma progresiva entre versiones mayores y validando el parámetro Feature Compatibility Version (FCV). Este documento describe el proceso para actualizar MongoDB hasta la versión 8.0 asegurando la integridad de los datos y el correcto funcionamiento del sistema.

Consideraciones importantes antes de actualizar

La actualización de MongoDB desde una versión 4.x hasta la versión 8.x no puede realizarse de manera directa. MongoDB no permite saltar múltiples versiones mayores durante el proceso de actualización, por lo que es necesario realizarlo de forma progresiva, pasando por cada versión intermedia.

La ruta correcta de actualización es la siguiente: 4.2 → 4.4 → 5.0 → 6.0 → 7.0 → 8.0

Intentar actualizar directamente desde MongoDB 4.2 a MongoDB 8.0 generará errores de compatibilidad, principalmente relacionados con el parámetro featureCompatibilityVersion (FCV), el cual controla qué funcionalidades de la base de datos están habilitadas según la versión en uso.

Este documento describe el procedimiento completo para actualizar MongoDB desde la versión 4.2 hasta la versión 8.0 en un servidor que ejecuta NMIS 9, asegurando la integridad de los datos y la continuidad operativa del sistema.

Obtención de credenciales de MongoDB

Antes de iniciar el proceso de actualización, es necesario identificar las credenciales configuradas en NMIS para acceder a la base de datos MongoDB.

Para obtener esta información, ejecute el siguiente comando en el servidor:

egrep "[^_]db_username|db_password" /usr/local/omk/conf/opCommon.json

Este comando mostrará el usuario y la contraseña configurados en NMIS para la conexión con MongoDB. Estos datos serán necesarios para realizar verificaciones y tareas administrativas durante el proceso de actualización.

image-20260310-223554.png

Ejemplo:

db_username: opUserRW db_password: op42flow42

Actualización de MongoDB de la versión 4.2 a 4.4

Todos los comandos de Linux incluidos en este documento deben ejecutarse como usuario root o con privilegios administrativos.

Si su sesión no cuenta con estos permisos, puede obtenerlos utilizando alguno de los siguientes comandos:

sudo -i su -

Prerrequisitos

Antes de iniciar la actualización se deben validar los siguientes puntos.

Antes de iniciar el proceso de actualización, es necesario validar los siguientes puntos.

a) Validar el sistema operativo

En este ejemplo, el servidor utiliza el siguiente sistema operativo: Red Hat Enterprise Linux 8.10.

De acuerdo con la documentación oficial de MongoDB, esta versión del sistema operativo es compatible con MongoDB hasta la versión 8.0, por lo que permite realizar todo el proceso de actualización descrito en este documento.

b) Validar que MongoDB 4.2 esté en funcionamiento

Antes de comenzar la actualización, es importante verificar que la instancia actual de MongoDB 4.2 esté funcionando correctamente y que sea posible conectarse a la base de datos.

Nota: en las versiones 4.2.x y 5.0.x se utiliza el comando mongo para acceder a la consola de la base de datos; a partir de MongoDB 6.0, el cliente utilizado es mongosh.

Para validar el acceso a MongoDB, ejecute el siguiente comando:

mongo

Una vez dentro, ejecute:

use admin db.auth("opUserRW","op42flow42") db.adminCommand({ listDatabases: 1 }).databases.map(function(db) { return db.name; }); exit

Si el comando devuelve la lista de bases de datos, MongoDB está funcionando correctamente.

image-20260310-230810.png

c) Verificar el motor de almacenamiento

MongoDB debe estar utilizando el motor de almacenamiento WiredTiger, ya que este es el motor soportado para las versiones modernas de MongoDB y es un requisito para realizar las actualizaciones entre versiones mayores.

Para validar qué motor de almacenamiento está en uso, ejecute el siguiente comando:

mongo -u opUserRW -p 'op42flow42' --authenticationDatabase admin --quiet --eval 'db.serverStatus().storageEngine'

El resultado debe indicar que el motor de almacenamiento configurado es WiredTiger.

"name" : "wiredTiger"
image-20260310-231134.png

Si se muestra otro motor de almacenamiento, será necesario revisarlo antes de continuar con el proceso de actualización.

d) Validar versiones de NMIS y módulos

Antes de actualizar MongoDB, se recomienda verificar que NMIS y sus módulos se encuentren en versiones compatibles. En caso necesario, estos componentes deberán actualizarse previamente para garantizar el correcto funcionamiento del sistema con versiones recientes de MongoDB.

Las versiones mínimas compatibles con MongoDB 6, 7 y 8 son las siguientes:

  • NMIS 9.5.0

  • opAddress 2.4.0

  • opCharts 4.8.0

  • opConfig 4.6.0

  • opEvents 4.4.0

  • opHA 4.1.0

  • opReports 4.6.0

  • opFlow 4.1.0

Para verificar las versiones instaladas en su sistema, acceda a la interfaz web de FirstWave desde un navegador utilizando la siguiente dirección:

https://<IP_DEL_SERVIDOR>/omk

Dentro de la interfaz podrá consultar las versiones de NMIS y de los módulos instalados, lo que permitirá confirmar si el entorno se encuentra preparado para continuar con el proceso de actualización de MongoDB.

Preparación para la actualización

La preparación para la actualización incluye tres pasos obligatorios que deben realizarse antes de iniciar el proceso.

1. Crear snapshot o respaldo del sistema

Antes de realizar cualquier actualización, se recomienda crear un snapshot de la máquina virtual o un respaldo completo del sistema.

Esto permitirá restaurar el servidor a su estado original en caso de que ocurra algún problema durante el proceso de actualización.

Nota: el procedimiento para crear snapshots o respaldos depende de la plataforma de virtualización utilizada (por ejemplo: VMware, Hyper-V, VirtualBox, entre otras), así como de las políticas y herramientas del entorno de infraestructura de cada cliente.

2. Actualizar el sistema operativo

Se recomienda actualizar todos los paquetes del sistema operativo Red Hat Enterprise Linux antes de continuar con la actualización de MongoDB.

Para realizar la actualización, ejecute el siguiente comando:

dnf upgrade -y

Este paso requiere que el sistema tenga una suscripción activa de Red Hat, ya que el gestor de paquetes utilizará los repositorios oficiales para descargar las actualizaciones disponibles.

image-20260310-231738.png
image-20260310-231808.png

Una vez finalizada la actualización de los paquetes del sistema operativo, se recomienda reiniciar el servidor, siempre que sea posible, para asegurar que todos los componentes actualizados se carguen correctamente y el sistema opere de manera estable antes de continuar con el proceso de actualización de MongoDB.

3. Detener los servicios de NMIS y OMK

Antes de iniciar la actualización de MongoDB, es necesario detener todos los procesos asociados a NMIS y sus módulos. Esto evita que el sistema realice escrituras en la base de datos durante el proceso de actualización.

Para detener los servicios, ejecute los siguientes comandos:

systemctl stop nmis9d /usr/local/omk/bin/checkomkdaemons.sh stop

Verificar que todos los servicios estén detenidos, ejecutando:

systemctl status nmis9d /usr/local/omk/bin/checkomkdaemons.sh status
image-20260313-195501.png
image-20260310-232038.png

Verificación de Feature Compatibility Version

Antes de iniciar la actualización, es necesario verificar la Feature Compatibility Version (FCV) configurada en la base de datos. Este parámetro define qué conjunto de funcionalidades de MongoDB está habilitado y debe estar alineado con la versión instalada.

Para verificar este valor, primero conéctese a la consola de MongoDB ejecutando el siguiente comando:

mongo

Una vez dentro de la consola de MongoDB, ejecute el siguiente proceso para consultar la Feature Compatibility Version (FCV):

use admin db.auth("opUserRW","op42flow42") db.adminCommand({ getParameter: 1, featureCompatibilityVersion: 1 })

El resultado del comando debe mostrar que la Feature Compatibility Version (FCV) está configurada en:

version: "4.2"
image-20260310-232231.png

Esto confirma que la base de datos se encuentra utilizando las funcionalidades correspondientes a MongoDB 4.2, lo cual es el estado esperado antes de iniciar la actualización.

Una vez realizada la verificación, puede salir de la consola de MongoDB ejecutando el siguiente comando:

exit

Detener el servicio de MongoDB

Una vez verificada la versión actual de la base de datos, el siguiente paso es detener el servicio de MongoDB antes de realizar la actualización.

Para detener el servicio, ejecute el siguiente comando:

systemctl stop mongod

Configurar el repositorio de MongoDB 4.4

Para instalar la nueva versión, es necesario configurar el repositorio oficial de MongoDB 4.4 en el sistema.

Para ello, se debe crear el archivo de repositorio correspondiente utilizando el siguiente comando:

vi /etc/yum.repos.d/mongodb-org-4.4.repo
image-20260310-232649.png

Una vez creado el archivo, copie y pegue las siguientes líneas dentro del mismo y guarde los cambios. Este archivo permitirá al sistema acceder al repositorio oficial de MongoDB 4.4, desde donde se instalarán los paquetes necesarios para la actualización.

[mongodb-org-4.4] name=MongoDB Repository baseurl=https://repo.mongodb.org/yum/redhat/8/mongodb-org/4.4/x86_64/ gpgcheck=1 enabled=1 gpgkey=https://www.mongodb.org/static/pgp/server-4.4.asc
image-20260310-233006.png

Desactivar el repositorio anterior

Para evitar conflictos o mezclas de versiones durante la actualización, es necesario desactivar el repositorio actual de MongoDB.

En este procedimiento, el repositorio existente se moverá a una ubicación diferente para mantener un respaldo del archivo original. De esta forma, si fuera necesario, podrá restaurarse posteriormente.

Para realizar esta acción, ejecute el siguiente comando, el cual moverá el archivo del repositorio a la ruta /tmp/dbm (esta ruta es un ejemplo, ajustarla a conveniencia):

mv /etc/yum.repos.d/mongodb-org-4.2.repo /tmp/dbm
image-20260310-233224.png

Limpiar la caché del gestor de paquetes

Antes de instalar la nueva versión de MongoDB, se recomienda limpiar la caché del gestor de paquetes. Esto permite eliminar metadatos y archivos temporales asociados a la versión anterior, evitando posibles conflictos durante la instalación.

Para realizar esta limpieza, ejecute los siguientes comandos:

dnf clean all dnf makecache
image-20260310-233501.png

Instalar la nueva versión

Una vez que el entorno ha sido preparado, el repositorio configurado y la caché del gestor de paquetes limpiada, se puede proceder con la instalación de la nueva versión de MongoDB.

Para instalar MongoDB 4.4, ejecute el siguiente comando:

dnf install -y mongodb-org*
image-20260310-233714.png

Verificar la versión instalada

Una vez finalizado el proceso de descarga e instalación de los paquetes, es recomendable verificar que la nueva versión de MongoDB se haya instalado correctamente.

Para comprobar la versión instalada, ejecute el siguiente comando:

mongod --version
image-20260310-233855.png

Reiniciar el servicio de MongoDB

Después de completar la instalación, es necesario reiniciar el servicio de MongoDB para que el sistema cargue la nueva versión instalada.

Ejecute los siguientes comandos en el orden indicado:

systemctl stop mongod systemctl start mongod systemctl daemon-reload systemctl status mongod
image-20260313-200543.png

Nota: si se omite la secuencia de detener e iniciar el servicio, el siguiente paso del procedimiento podría fallar.

Actualizar la Feature Compatibility Version (FCV)

Una vez instalada la nueva versión de MongoDB, es indispensable actualizar el parámetro Feature Compatibility Version (FCV). Este paso permite habilitar las funcionalidades correspondientes a la nueva versión y asegurar que la base de datos opere correctamente.

Para realizar esta actualización, primero conéctese a la consola de MongoDB ejecutando:

mongo

Una vez dentro de la consola, ejecute lo siguiente:

use admin db.auth("opUserRW","op42flow42") db.adminCommand({ setFeatureCompatibilityVersion: "4.4" }) db.adminCommand({ getParameter: 1, featureCompatibilityVersion: 1 }) exit
image-20260310-234154.png

Con este paso se asegura que la Feature Compatibility Version (FCV) quede alineada con la versión de MongoDB recientemente instalada, permitiendo que la base de datos utilice correctamente las funcionalidades disponibles en dicha versión.

Reiniciar nuevamente MongoDB

Después de actualizar el FCV, es necesario reiniciar nuevamente el servicio de MongoDB para que el sistema cargue los parámetros actualizados.

Para ello, ejecute los siguientes comandos:

systemctl stop mongod systemctl start mongod systemctl status mongod
image-20260310-234511.png

Validar los servicios de NMIS

Una vez completada la actualización de MongoDB, es necesario verificar que NMIS y sus módulos funcionen correctamente.

Primero, se deben iniciar nuevamente los servicios de NMIS y sus módulos, ejecutando lo siguiente:

systemctl restart nmis9d /usr/local/omk/bin/checkomkdaemons.sh start

Verificamos el estado de los servicios con el siguiente comando:

systemctl status nmis9d /usr/local/omk/bin/checkomkdaemons.sh status
image-20260313-201034.png
image-20260310-234730.png

Una vez que los servicios se encuentren iniciados y en ejecución, se recomienda verificar que NMIS y sus módulos estén funcionando correctamente desde la interfaz web.

image-20260310-234855.png
image-20260310-234914.png
image-20260310-234930.png

Una vez confirmada la correcta operación de NMIS y sus módulos, se puede proceder con la siguiente etapa del proceso de actualización de MongoDB, siguiendo la misma metodología descrita en este documento para las versiones posteriores.

Actualización de MongoDB de la versión 4.4 a 6.0

Para las actualizaciones posteriores hasta MongoDB 6.0.x, se deben seguir exactamente los mismos pasos descritos en el procedimiento de actualización de la versión 4.2 a 4.4, sin omitir ninguno de ellos.

Durante cada actualización es importante considerar los siguientes puntos:

  • Actualizar el repositorio para que corresponda a la versión de MongoDB que se desea instalar.

  • Desactivar el repositorio de la versión actual antes de configurar el nuevo repositorio.

  • Actualizar la Feature Compatibility Version (FCV) para que coincida con la versión recién instalada.

Asimismo, es fundamental recordar que las actualizaciones deben realizarse de forma progresiva, sin omitir ninguna versión intermedia.

La ruta de actualización para este tramo es: 4.4 → 5.0 → 6.0

A continuación, se muestran los tres puntos del procedimiento que deben modificarse en cada actualización para adaptarlos a la versión correspondiente.

Actualizar MongoDB 4.4 → 5.0

Configurar el repositorio de MongoDB 5.0

Para realizar la actualización a MongoDB 5.0, es necesario configurar el repositorio correspondiente a esta versión en el sistema.

Para ello, se debe crear el archivo de repositorio de MongoDB 5.0 utilizando el siguiente comando:

vi /etc/yum.repos.d/mongodb-org-5.0.repo

Una vez creado el archivo, copie y pegue las siguientes líneas dentro del mismo y guarde los cambios. Esto permitirá que el sistema utilice el repositorio oficial de MongoDB 5.0 para descargar e instalar los paquetes correspondientes durante el proceso de actualización.

[mongodb-org-5.0] name=MongoDB Repository baseurl=https://repo.mongodb.org/yum/redhat/8/mongodb-org/5.0/x86_64/ gpgcheck=1 enabled=1 gpgkey=https://www.mongodb.org/static/pgp/server-5.0.asc
image-20260311-174949.png

Desactivar el repositorio anterior

Para evitar conflictos o mezclas de versiones durante la actualización, es necesario desactivar el repositorio actual de MongoDB. En este procedimiento, el repositorio existente se moverá a una ubicación diferente para conservar un respaldo del archivo original. Esto permitirá restaurarlo fácilmente en caso de ser necesario.

Para realizar esta acción, ejecute el siguiente comando, el cual moverá el archivo del repositorio a la ruta /tmp/dbm (esta ruta es un ejemplo, ajustarla a conveniencia):

mv /etc/yum.repos.d/mongodb-org-4.4.repo /tmp/dbm
image-20260311-175014.png

A continuación, se deben seguir los mismos pasos descritos anteriormente para continuar con la instalación de la nueva versión de MongoDB. Cuando el procedimiento llegue al paso de actualizar la Feature Compatibility Version (FCV), es importante verificar que se configure la versión correspondiente a MongoDB 5.0.

Actualizar Feature Compatibility Version (FCV)

Una vez completada la instalación, es indispensable actualizar la Feature Compatibility Version (FCV) para que la base de datos pueda operar correctamente con la nueva versión.

Para realizar esta configuración, conéctese a MongoDB ejecutando:

mongo

Una vez dentro de la consola de MongoDB, ejecute lo siguiente:

use admin db.auth("opUserRW","op42flow42") db.adminCommand({ setFeatureCompatibilityVersion: "5.0" }) db.adminCommand({ getParameter: 1, featureCompatibilityVersion: 1 }) exit
image-20260311-175354.png

Con este paso se asegura que la Feature Compatibility Version (FCV) quede configurada de forma totalmente compatible con la versión de MongoDB recién instalada.

Una vez realizado este ajuste, se debe continuar con los pasos finales del procedimiento, correspondientes al reinicio del servicio y la validación del funcionamiento del sistema, descritos en la sección "Reiniciar nuevamente MongoDB". En esta etapa se reinicia el servicio de MongoDB y posteriormente se valida que NMIS y sus módulos operen correctamente, confirmando que la base de datos funciona de manera normal después de la actualización.

Actualizar MongoDB 5.0 → 6.0

Configurar el repositorio de MongoDB 6.0

Para realizar la actualización a MongoDB 6.0, es necesario configurar el repositorio correspondiente a esta versión en el sistema.

Para ello, se debe crear el archivo de repositorio de MongoDB 6.0 utilizando el siguiente comando:

vi /etc/yum.repos.d/mongodb-org-6.0.repo

Una vez creado el archivo, copie y pegue las siguientes líneas dentro del mismo y guarde los cambios. Esto permitirá que el sistema utilice el repositorio oficial de MongoDB 6.0 para descargar e instalar los paquetes correspondientes durante el proceso de actualización.

[mongodb-org-6.0] name=MongoDB Repository baseurl=https://repo.mongodb.org/yum/redhat/8/mongodb-org/6.0/x86_64/ gpgcheck=1 enabled=1 gpgkey=https://www.mongodb.org/static/pgp/server-6.0.asc
image-20260311-184755.png

Desactivar el repositorio anterior

Para evitar conflictos o mezclas de versiones durante la actualización, es necesario desactivar el repositorio actual de MongoDB. En este procedimiento, el repositorio existente se moverá a una ubicación diferente para conservar un respaldo del archivo original. Esto permitirá restaurarlo fácilmente en caso de ser necesario.

Para realizar esta acción, ejecute el siguiente comando, el cual moverá el archivo del repositorio a la ruta /tmp/dbm (esta ruta es un ejemplo, ajustarla a conveniencia):

mv /etc/yum.repos.d/mongodb-org-5.0.repo /tmp/dbm
image-20260311-184841.png

A continuación, se deben seguir los mismos pasos descritos anteriormente para continuar con la instalación de la nueva versión de MongoDB. Cuando el procedimiento llegue al paso de actualizar la Feature Compatibility Version (FCV), es importante verificar que se configure la versión correspondiente a MongoDB 6.0.

Actualizar Feature Compatibility Version (FCV)

Una vez completada la instalación, es indispensable actualizar la Feature Compatibility Version (FCV) para que la base de datos pueda operar correctamente con la nueva versión.

Para realizar esta configuración, conéctese a MongoDB ejecutando:

mongosh

Una vez dentro de la consola de MongoDB, ejecute lo siguiente:

use admin db.auth("opUserRW","op42flow42") db.adminCommand({ setFeatureCompatibilityVersion: "6.0" }) db.adminCommand({ getParameter: 1, featureCompatibilityVersion: 1 }) exit
image-20260311-184956.png

Con este paso se asegura que la Feature Compatibility Version (FCV) quede configurada de forma totalmente compatible con la versión de MongoDB recién instalada.

Una vez realizado este ajuste, se debe continuar con los pasos finales del procedimiento, correspondientes al reinicio del servicio y la validación del funcionamiento del sistema, descritos en la sección "Reiniciar nuevamente MongoDB". En esta etapa se reinicia el servicio de MongoDB y posteriormente se valida que NMIS y sus módulos operen correctamente, confirmando que la base de datos funciona de manera normal después de la actualización.

Actualización de MongoDB de la versión 6.0 a 8.0

Para actualizar MongoDB desde la versión 6.0.x hasta la versión 8.0.x, se deben seguir exactamente los mismos pasos descritos en el procedimiento de actualización de la versión 4.2 a 4.4.

Durante cada actualización es importante tener en cuenta lo siguiente:

  • Configurar el repositorio correspondiente a la versión de MongoDB que se va a instalar.

  • Desactivar el repositorio de la versión actual antes de habilitar el nuevo.

  • Actualizar la Feature Compatibility Version (FCV) para que coincida con la versión recién instalada.

Además del procedimiento ya descrito, a partir de MongoDB 7.0 es necesario realizar una verificación adicional en el archivo de configuración. MongoDB 7.0 utiliza el motor WiredTiger con journaling obligatorio y no configurable, por lo que cualquier configuración manual relacionada con journal ya no es necesaria. Por esta razón, inmediatamente después de finalizar la instalación de los paquetes y antes del primer reinicio del servicio, se debe revisar el archivo de configuración:

/etc/mongod.conf

Si dentro del archivo existe una sección relacionada con journal, esta debe eliminarse, ya que puede generar conflictos con la configuración predeterminada de MongoDB 7.0 o superior.

Asimismo, es importante recordar que las actualizaciones deben realizarse de manera progresiva, sin omitir versiones intermedias: 6.0 → 7.0 → 8.0

A continuación, se presentan los tres puntos del procedimiento que deben modificarse en cada actualización, así como la verificación adicional del archivo mencionado.

Actualizar MongoDB 6.0 → 7.0

Configurar el repositorio de MongoDB 7.0

Para realizar la actualización a MongoDB 7.0, es necesario configurar el repositorio correspondiente a esta versión en el sistema.

Para ello, se debe crear el archivo de repositorio de MongoDB 7.0 utilizando el siguiente comando:

vi /etc/yum.repos.d/mongodb-org-7.0.repo
image-20260311-191744.png

Una vez creado el archivo, copie y pegue las siguientes líneas dentro del mismo y guarde los cambios. Esto permitirá que el sistema utilice el repositorio oficial de MongoDB 6.0 para descargar e instalar los paquetes correspondientes durante el proceso de actualización.

[mongodb-org-7.0] name=MongoDB Repository baseurl=https://repo.mongodb.org/yum/redhat/8/mongodb-org/7.0/x86_64/ gpgcheck=1 enabled=1 gpgkey=https://www.mongodb.org/static/pgp/server-7.0.asc
image-20260311-192027.png

Desactivar el repositorio anterior

Para evitar conflictos o mezclas de versiones durante la actualización, es necesario desactivar el repositorio actual de MongoDB. En este procedimiento, el repositorio existente se moverá a una ubicación diferente para conservar un respaldo del archivo original. Esto permitirá restaurarlo fácilmente en caso de ser necesario.

Para realizar esta acción, ejecute el siguiente comando, el cual moverá el archivo del repositorio a la ruta /tmp/dbm (esta ruta es un ejemplo, ajustarla a conveniencia):

mv /etc/yum.repos.d/mongodb-org-6.0.repo /tmp/dbm
image-20260311-192051.png

A continuación, se deben seguir los mismos pasos descritos anteriormente para continuar con la instalación de la nueva versión de MongoDB.

Sin embargo, inmediatamente después de finalizar la actualización de los paquetes y antes del primer reinicio del servicio, es necesario revisar el archivo de configuración para confirmar que no existan parámetros incompatibles con las versiones más recientes de MongoDB.

Ejemplo de modificación en el archivo mongod.conf

Primero, acceda al archivo de configuración ejecutando el siguiente comando:

vi /etc/mongod.conf

Dentro del archivo puede encontrarse una sección similar a la siguiente, donde aparece la configuración de journal:

... security:   authorization: enabled storage:   dbPath: /var/lib/mongo   journal:     enabled: true systemLog:   destination: file ...

En MongoDB 7.0 y versiones posteriores, el journaling es obligatorio y ya no es configurable, por lo que esta sección debe eliminarse. Después de realizar el ajuste, el contenido debe quedar de forma similar a lo siguiente:

... security:   authorization: enabled storage:   dbPath: /var/lib/mongo systemLog:   destination: file ...

Una vez realizado el cambio, guarde el archivo. El archivo mongod.conf debe conservar una estructura similar al ejemplo anterior, sin la sección journal dentro del bloque storage.

image-20260311-195048.png

Una vez verificado o modificado correctamente el archivo mongod.conf, se debe detener y recargar el servicio de MongoDB, y posteriormente verificar la versión instalada. Este paso permite confirmar que el servicio se encuentra ejecutando la nueva versión de MongoDB antes de continuar con el procedimiento. Una vez validado que la versión es correcta, se puede proceder con el paso de actualizar la Feature Compatibility Version (FCV), asegurando que se configure la versión correspondiente a MongoDB recién instalada, siguiendo el procedimiento descrito anteriormente.

Nota: es importante detener y reiniciar el servicio de MongoDB, así como verificar la versión instalada, antes de realizar la actualización de FCV. Esto garantiza que la base de datos esté ejecutando la versión correcta antes de habilitar las nuevas funcionalidades.

Actualizar Feature Compatibility Version (FCV)

Una vez completada la instalación, es indispensable actualizar la Feature Compatibility Version (FCV) para que la base de datos pueda operar correctamente con la nueva versión.

Para realizar esta configuración, conéctese a MongoDB ejecutando:

mongosh

Una vez dentro de la consola de MongoDB, ejecute lo siguiente:

Use admin db.auth("opUserRW","op42flow42") db.adminCommand({ setFeatureCompatibilityVersion: "7.0", confirm: true})  db.adminCommand({ getParameter: 1, featureCompatibilityVersion: 1 }) exit
image-20260311-195421.png

Con este paso se asegura que la Feature Compatibility Version (FCV) quede configurada de forma totalmente compatible con la versión de MongoDB recién instalada.

Una vez realizado este ajuste, se debe continuar con los pasos finales del procedimiento, correspondientes al reinicio del servicio y la validación del funcionamiento del sistema, descritos en la sección "Reiniciar nuevamente MongoDB". En esta etapa se reinicia el servicio de MongoDB y posteriormente se valida que NMIS y sus módulos operen correctamente, confirmando que la base de datos funciona de manera normal después de la actualización.

Actualizar MongoDB 7.0 → 8.0

Configurar el repositorio de MongoDB 8.0

Para realizar la actualización a MongoDB 8.0, es necesario configurar el repositorio correspondiente a esta versión en el sistema.

Para ello, se debe crear el archivo de repositorio de MongoDB 8.0 utilizando el siguiente comando:

vi /etc/yum.repos.d/mongodb-org-8.0.repo
image-20260311-201822.png

Una vez creado el archivo, copie y pegue las siguientes líneas dentro del mismo y guarde los cambios. Esto permitirá que el sistema utilice el repositorio oficial de MongoDB 8.0 para descargar e instalar los paquetes correspondientes durante el proceso de actualización.

[mongodb-org-8.0] name=MongoDB Repository baseurl=https://repo.mongodb.org/yum/redhat/8/mongodb-org/8.0/x86_64/ gpgcheck=1 enabled=1 gpgkey=https://www.mongodb.org/static/pgp/server-8.0.asc
image-20260311-201902.png

Desactivar repositorio anterior

Para evitar conflictos o mezclas de versiones durante la actualización, es necesario desactivar el repositorio actual de MongoDB. En este procedimiento, el repositorio existente se moverá a una ubicación diferente para conservar un respaldo del archivo original. Esto permitirá restaurarlo fácilmente en caso de ser necesario.

Para realizar esta acción, ejecute el siguiente comando, el cual moverá el archivo del repositorio a la ruta /tmp/dbm (esta ruta es un ejemplo, ajustarla a conveniencia):

mv /etc/yum.repos.d/mongodb-org-7.0.repo /tmp/dbm
image-20260311-201936.png

A continuación, se deben seguir los mismos pasos descritos anteriormente para continuar con la instalación de la nueva versión de MongoDB. Cuando el procedimiento llegue al paso de actualizar la Feature Compatibility Version (FCV), es importante verificar que se configure la versión correspondiente a MongoDB 7.0.

Actualizar Feature Compatibility Version (FCV)

Una vez completada la instalación, es indispensable actualizar la Feature Compatibility Version (FCV) para que la base de datos pueda operar correctamente con la nueva versión.

Para realizar esta configuración, conéctese a MongoDB ejecutando:

mongosh

Una vez dentro de la consola de MongoDB, ejecute lo siguiente:

Use admin db.auth("opUserRW","op42flow42") db.adminCommand({ setFeatureCompatibilityVersion: "8.0", confirm: true}) db.adminCommand({ getParameter: 1, featureCompatibilityVersion: 1 }) exit
image-20260311-202252.png

Con este paso se asegura que la Feature Compatibility Version (FCV) quede configurada de forma totalmente compatible con la versión de MongoDB recién instalada.

Una vez realizado este ajuste, se debe continuar con los pasos finales del procedimiento, correspondientes al reinicio del servicio y la validación del funcionamiento del sistema, descritos en la sección "Reiniciar nuevamente MongoDB". En esta etapa se reinicia el servicio de MongoDB y posteriormente se valida que NMIS y sus módulos operen correctamente, confirmando que la base de datos funciona de manera normal después de la actualización.

Validaciones finales

Una vez concluida la actualización a MongoDB 8.0, se deben de realizar las validaciones pertinentes para verificar que el sistema funciona de manera correcta.

En consola, se recomienda la ejecución de lo siguiente:

systemctl status mongod
image-20260313-213659.png
mongod --version
image-20260313-212022.png

Desde la interfaz web, acceda a los diferentes módulos del sistema para verificar que todos operen de manera normal. Durante esta validación se recomienda confirmar que NMIS y los módulos de FirstWave carguen correctamente, que los datos de monitoreo se visualicen sin errores y que no existan alertas o fallos relacionados con la base de datos después de la actualización.

image-20260313-221243.png
image-20260313-213406.png
image-20260313-221329.png
image-20260313-221227.png