Para agentes de IA: hay un índice de documentación disponible en https://www.mongodb.com/es/docs/llms.txt — versiones en markdown de todas las páginas están disponibles agregando .md a cualquier ruta URL.

Actualizar Ops Manager

Este tutorial describe cómo actualizar una instalación existente de Ops Manager.

Advertencia

Actualizar las bases de datos administradas a MongoDB 4.4 o posterior

Ops Manager 8.0 no es compatible con MongoDB 4.2 ni versiones anteriores. Si está utilizando MongoDB 4.2 o una versión anterior y desea actualizar a Ops Manager 8.0, debe actualizar al menos a MongoDB 4.4. Si no actualizas al menos a MongoDB 4.4, Ops Manager no supera las comprobaciones previas y no se iniciará. Después de actualizar a al menos MongoDB 4.4, todavía recomendamos que actualice a al menos MongoDB 6.0 antes de actualizar a Ops Manager 8.0.

La versión de su instalación actual de Ops Manager determina la ruta de actualización que debe seguir para actualizar a Ops Manager 6.0 o posterior.

Importante

  • Si tienes una instalación de Ops Manager 6.0 o posterior con más de un host de Ops Manager apuntando a la misma base de datos de la aplicación, puedes actualizar Ops Manager sin incurrir en tiempo de inactividad para la supervisión. Durante esta actualización, Ops Manager entra en un estado conocido como Modo de actualización. Consulta Modo de actualización para obtener más información.

  • Para garantizar una actualización exitosa,debes seguir la ruta de actualización para tu versión actual a fin de realizar las migraciones de base de datos necesarias.

  • Para proteger sus datos, MongoDB Ops Manager se niega a iniciar actualizaciones directas desde las versiones 1.8.x y 2.0.x a la versión 6.0 o posterior.

  • No hay rutas de degradación compatibles para Ops Manager.

Nota

Todas las actualizaciones para las versiones de Ops Manager 6.0.x y posteriores utilizan el mismo procedimiento. Para actualizar a una versión superior, primero debes usar este procedimiento para actualizar a la última actualización disponible de tu versión inicial, y luego usar nuevamente el procedimiento para actualizar a la siguiente versión. Si la siguiente tabla contiene información adicional relacionada con el procedimiento de actualización para una versión determinada, revísala primero.

Importante

Migración en vivo (push) obsoleta o no compatible para implementaciones de origen gestionadas o supervisadas por Ops Manager

  • Para implementaciones de origen que ejecuten cualquier MongoDB 6.0.+ versiones en las que las implementaciones son gestionadas o supervisadas por Ops Manager, no se admite la Migración en vivo (push).

  • Para las implementaciones de origen que ejecutan cualquier versión de MongoDB 5.0 y anteriores, donde las implementaciones son gestionadas o supervisadas por Ops Manager, la Migración en vivo (push) está obsoleta.

  • Para implementaciones de origen que ejecutan MongoDB 6.0.+, donde las implementaciones son supervisadas por Cloud Manager, se admite la migración en vivo (push). Para obtener más información, se debe consultar Migrar en vivo el clúster de MongoDB supervisado por Cloud Manager a Atlas.

La siguiente tabla lista las rutas de actualización para todas las versiones:

Versión existente
Ruta de actualización

9.0.x

Actualice de MongoDB Ops Manager 9.0.x a la última versión de parche disponible de 9.0 utilizando este procedimiento.

Para obtener más información, consulte las notas de versión de Ops Manager 9.0.

8.0.x

Actualice de Ops Manager 8.0.x a la última versión de parche disponible de 8.0. Luego, actualice a la última versión disponible de 9.0. Utilice este procedimiento para ambas actualizaciones.

Para obtener más información, consulte las notas de versión de Ops Manager 8.0.

7.0.x

Actualice de Ops Manager 7.0.x a la última versión de parche disponible de 7.0. Luego, actualice a la última versión disponible de 8.0. Utilice este procedimiento para ambas actualizaciones.

Para obtener más información, consulte las notas de versión de Ops Manager 7.0.

6.0.x

Actualice de Ops Manager 6.0.x a la última versión de parche disponible de 6.0. Luego, actualice a la última versión disponible de 7.0. Utilice este procedimiento para ambas actualizaciones.

Para obtener más información, consulte las notas de versión de Ops Manager 6.0.

5.0.x

Actualización de Ops Manager 5.0.x a la última versión de parche disponible de 5.0. Luego, actualiza a la última versión disponible de 6.0. Use este procedimiento para ambos procesos.

Para obtener más información, consulte las notas de versión de Ops Manager 5.0.

4.4.x

Actualización de Ops Manager 4.4.x a la última versión de parche disponible de 4.4. Luego, actualiza a la última versión disponible de 5.0. Use este procedimiento para ambos procesos.

IMPORTANTE: Ops Manager versión 4.4.13 corrige un error que volvería a habilitar las instancias de Ops Manager para API escrituras durante una actualización.

Para obtener más información, consulta:

4.2.x

Actualización de Ops Manager 4.2.x a la última versión de parche disponible de 4.2. Luego, actualiza a la última versión disponible de 4.4. Use este procedimiento para ambos procesos.

Una deshabilitación involuntaria y temporal de TLS se produce al actualizar a versiones anteriores a 4.2.24. Actualizar a 4.2.24 o posterior en primer lugar evita este resultado.

Para obtener más información, consulta:

4.0.x

Utilice el tutorial de actualización v4.2 para actualizar de MongoDB Ops Manager 4.0.x a la versión 4.2.24 o posterior. Luego, utilice este procedimiento para actualizar a la última versión disponible de 4.2.

Una deshabilitación involuntaria y temporal de TLS se produce al actualizar a versiones anteriores a 4.2.24. Actualizar a 4.2.24 o posterior en primer lugar evita este resultado.

Para obtener más información, consulta:

3.6.x

Utiliza el Tutorial de actualización v4.0 para actualizar desde la versión Ops Manager 3.6.x a la versión 4.0.x.

3.4.x

Utiliza el Tutorial de actualización v3.6 para actualizar desde la versión Ops Manager 3.4.x a la versión 3.6.x.

2.x o anteriores.

Utilice el tutorial de actualización v3.4 para actualizar desde Ops Manager 2.x o anteriores.

Advertencia

Para mantener la configuración y disponibilidad existentes, haga una copia de seguridad de lo siguiente en su instancia actual de Ops Manager:

  • conf-mms.properties y gen.key archivos en una ubicación segura. El conf-mms.properties almacena la configuración de la instancia de Ops Manager. La gen.key proporciona detalles para cifrar y descifrar las bases de datos de respaldo y las credenciales de usuario de Ops Managers. Es posible que Ops Manager borre estos archivos como parte del proceso de actualización.

Como precaución adicional, se puede usar mongodump para crear una exportación binaria de la Base de Datos de la Aplicación. No existe un método de copia de seguridad oficialmente compatible para la Base de datos de la aplicación. Si la actualización falla, contacta al Soporte de MongoDB para obtener ayuda y solucionar el inconveniente con la versión de Ops Manager.

Antes de actualizar Ops Manager de 7.0 a 8.0, revise las siguientes consideraciones:

Ops Manager 8.0.0 requiere un mínimo de MongoDB 6.0.0 para las bases de datos de respaldo de Ops Manager.

Nota

La versión de MongoDB para las bases de datos de respaldo de Ops Manager no puede ser posterior a tu versión de Ops Manager.

Si MongoDB Ops Manager gestiona sus herramientas MongoDB, MongoDB Ops Manager actualiza las versiones de las herramientas automáticamente cuando actualiza MongoDB Ops Manager.

Si ejecuta MongoDB Ops Manager 8.0.x en moda local, debe descargar e instalar la última versión de mongosh y la versión del paquete TGZ de MongoDB Database Tools que aparece en la tabla de compatibilidad de Database Tools en el directorio versions.

La página de descarga solo ofrece la última versión de Database Tools. Para descargar la versión compatible en su lugar, consulte versiones archivadas.

  • Remueve el soporte de Ops Manager para RedHat Enterprise Linux 7.

  • Elimina el soporte de Ops Manager para SUSE Linux Enterprise 12.

  • Remueve el soporte de Ops Manager para Ubuntu 20.04 LTS.

Importante

  • Se descontinúa el soporte de Ops Manager para Amazon Linux v2 LTS.

  • Se descontinúa el soporte de Ops Manager para Debian 11.

  • Remover el soporte para la automatización, la supervisión y el respaldo de versiones de MongoDB 4.2 y anteriores. Ops Manager solo puede administrar bases de datos que ejecutan MongoDB 4.4 o superior.

Importante

  • Se descontinúa el soporte para automatizar, supervisión y respaldar versiones de MongoDB 5.0 y anteriores.

Tus servidores deben cumplir con los Requisitos del sistema de Ops Manager.

Advertencia

Potencial de fallo de producción

Tu instancia de Ops Manager puede fallar en producción si no configuras lo siguiente:

Asegúrate de que todos los nodos con datos estén en funcionamiento antes de iniciar el proceso de actualización. Para determinar el estado de los miembros del conjunto de réplicas, ejecute replSetGetStatus.

Si sus bases de datos de respaldo ejecutan el motor de almacenamiento MMAPv1, el proceso de actualización falla. Ops Manager le solicita que actualice el motor de almacenamiento de esas bases de datos de respaldo a WiredTiger.

Debe tener privilegios de administrador en los servidores donde realice la actualización.

Para descargar el software, haga clic en el enlace de descarga disponible en la página de descargas del cliente. MongoDB proporciona la URL de esa página a sus clientes.

  • Si no puedes acceder a este enlace, visita la página de descargas para obtener una copia de evaluación actual del software Ops Manager.

  • Si necesitas una versión anterior de Ops Manager, visita el Archivo de versiones.

Si planeas ejecutar Ops Manager en Modo Local, descarga el software de MongoDB en tu directorio de la biblioteca de versiones. El software requerido incluye:

Antes de actualizar Ops Manager, asegúrese de:

Si actualizaste la plataforma para los hosts del Agente MongoDB, actualiza los agentes MongoDB antes de actualizar Ops Manager.

Nota

En MongoDB Ops Manager 9.0, el BI Connector está deshabilitado por defecto para nuevas implementaciones. El BI Connector alcanzó el final de su vida útil el 30 de septiembre de 2026, pero las instancias existentes de BI Connector siguen estando disponibles y se pueden gestionar en MongoDB Ops Manager. MongoDB recomienda utilizar la Interfaz SQL en su lugar.

Nota

Modo de actualización para aplicaciones altamente disponibles

Si tienes una instalación de Ops Manager 4.2 o posterior con más de un host de Ops Manager apuntando a la misma base de datos de la aplicación, puedes actualizar Ops Manager sin incurrir en tiempo de inactividad de la supervisión. Durante esta actualización, Ops Manager entra en un estado conocido como Modo de actualización. Este modo permite los siguientes beneficios durante todo el proceso de actualización:

  • Las alertas y la supervisión funcionan

  • Las instancias de Ops Manager permanecen activas

  • La aplicación Ops Manager puede ser accedida en modo de solo lectura

  • Las APIde Ops Manager que guardan o borran datos están deshabilitadas

La instancia de Ops Manager permanecerá en modo de actualización hasta que todos los hosts de Ops Manager se hayan actualizado y reiniciado.

No debes actualizar más de un host de Ops Manager a la vez.

Cuando el Ops Manager entra en modo de actualización, los daemons de copias de seguridad intentan detenerse a sí mismos. Este proceso puede fallar si los demonios están en medio de una tarea de copia de seguridad prolongada. En este caso, realice una de las siguientes acciones:

  • Reinicia la primera instancia de Ops Manager una vez que los daemons de copias de seguridad terminen la tarea.

  • Detén manualmente el daemon de copias de seguridad.

Para detener manualmente tus daemons de copias de seguridad:

  1. Inicie sesión en el primer host que sirve un daemon de copias de seguridad.

  2. Ejecutes el siguiente comando:

    sudo service mongodb-mms-backup-daemon stop
  3. Verifica que hayas apagado el daemon de copias de seguridad:

    ps -ef | grep mongodb-mms-backup-daemon

    Si el daemon de copias de seguridad continúa ejecutándose, emita este comando:

    sudo /etc/init.d/mongodb-mms-backup-daemon stop
  4. Repita los pasos 2 y 3 con todos los demás hosts del Daemon de copia de seguridad.

Si está ejecutando su Aplicación Ops Manager en una configuración de alta disponibilidad, complete este procedimiento en un host de Ops Manager a la vez.

Utiliza este procedimiento para actualizar la Aplicación de Ops Manager en los hosts instalados utilizando los paquetes de deb:

1
  1. Abre tu navegador preferido y ve al MongoDB Centro de descargar.

  2. En el menú desplegable Platforms, haz clic en Debian 12, 13 / Ubuntu 22.04, 24.04.

  3. En el menú desplegable Packages, haz clic en DEB para la arquitectura x86_64.

  4. Haga clic en Download.

    El paquete descargado se denomina mongodb-mms-<version>.x86_64.deb, donde <version> es el número de versión.

2

Emite el siguiente comando para detener la aplicación Ops Manager:

sudo service mongodb-mms stop
3

Nota

Modo de actualización para aplicaciones de Ops Manager altamente disponibles

Si tiene una instalación de MongoDB Ops Manager 6.0 con más de un host de MongoDB Ops Manager que apunte a la misma base de datos de la aplicación, esta implementación de MongoDB Ops Manager se ejecuta con alta disponibilidad. Después de actualizar un host de MongoDB Ops Manager de una implementación de alta disponibilidad de MongoDB Ops Manager, esa implementación entra en moda de actualización.

  1. Instale el paquete .deb en cada host de la aplicación Ops Manager y daemon de copias de seguridad. Ejecuta el siguiente comando, en donde <version> es la versión del paquete .deb:

    sudo dpkg -i mongodb-mms_<version>_x86_64.deb
  2. Cuando se le pregunte si desea sobrescribir la versión actualmente instalada de mms.conf, debe escribir Y para reemplazar el archivo existente.

  3. Si modificaste los puertos o la configuración de JVM que utiliza Ops Manager, debes volver a aplicar esos cambios al archivo mms.conf después de actualizar Ops Manager.

    Advertencia

    No añada contraseñas o secretos a los argumentos de JVM en el archivo mms.conf. MongoDB Ops Manager los expone como texto sin formato en los ficheros de diagnóstico.

  4. Al actualizar a MongoDB Ops Manager 6.0, Ops Manager solicita que se elija qué versión del archivo /opt/mongodb/mms/conf/conf-mms.properties debe usar Ops Manager. Para evitar tener que reconfigurar manualmente Ops Manager, elija el archivo actual.

4
sudo service mongodb-mms start

Nota

En las instancias de alta disponibilidad de Ops Manager, el inicio del servicio de Ops Manager espera a que todos los servidores se actualicen antes de iniciar.

Inicia sesión en tu host Ops Manager actualizado después de que se reinicie. Si tu inicio de sesión es exitoso, la actualización fue exitosa.

5

Ops Manager permanece en Modo de actualización hasta que se hayan actualizado todos los hosts. Para configuraciones de alta disponibilidad, esto significa:

  • Tus hosts podrían no estar completamente operativos hasta que la actualización se complete en todo el clúster. Si tu primera actualización de host toma más tiempo de lo esperado, continúa actualizando los demás hosts.

  • No detenga ni cancele los procesos que parecen estar atascados, ya que esto podría interrumpir la actualización.

  • Los registros que genera Ops Manager durante el inicio pueden pausarse temporalmente en Starting pre-flight checks mientras Ops Manager actualiza todos sus servidores a la misma versión.

  • Para actualizaciones de varias versiones, no se deben omitir las versiones principales. Debes actualizar cada nodo del clúster a la última versión menor de cada versión principal una vez. Por ejemplo, para actualizar de 6.0.26 a 8.0.3, realiza los siguientes pasos en cada nodo:

    1. Detén el servicio en un nodo (ejecutando 6.0.26).

    2. Actualice a la versión más reciente de la versión menor de 7.0.x.

    3. Inicia el host actualizado antes de pasar al siguiente nodo.

    4. Repita para todos los demás nodos.

    5. Repetir este proceso para actualizar cada nodo de 7.0.x a 8.0.3.

6

Una vez que finalice la actualización, inicia sesión en tu instancia de Ops Manager. Ops Manager muestra una notificación que dice One or more agents are out of date.

Haz clic en Update Software Components y luego confirma los cambios.

Importante

Si Ops Manager gestiona tus MongoDB Tools, las versiones de las herramientas se actualizan con los agentes.

En MongoDB Ops Manager 9.0, el BI Connector está deshabilitado por defecto. No interprete el procedimiento de actualización de MongoDB Agent como una instrucción de que MongoDB Ops Manager aprovisionará o actualizará el BI Connector para nuevas implementaciones.

La salida de la verificación previa al vuelo o el registro de inicio debe incluir un error como Unrecognized VM option 'UseParNewGC'. Este error puede ocurrir si cualquiera de los siguientes archivos ha sido editado:

  • /etc/rc.d/init.d/mongodb-mms

  • mms.conf

  • conf-mms.properties

Remueve -XX:+UseParNewGC de los archivos de configuración para resolver este problema.

Dependiendo de tu distribución de Linux y configuraciones locales, Ops Manager puede reemplazar cualquier cambio realizado en tu archivo de configuración durante la actualización. En Ops Manager 5.0 y versiones posteriores, si utilizas paquetes RPM, Ops Manager ya no actualiza el archivo de configuración al actualizar. Si una nueva versión de Ops Manager requiere nuevas propiedades en el archivo de configuración, debes agregarlas al archivo durante la actualización.

Al actualizar, actualiza el valor de mongo.mongoUri para incluir los nuevos parámetros introducidos con el MongoDB Java driver. Por defecto, este driver activa las lecturas y escrituras reintentables. Si estableces lógica personalizada para reintentar operaciones de lectura y guardados, los intentos pueden llevar demasiado tiempo. Para desactivar estos valores por defecto, añada lo siguiente a su cadena de conexión:

Ejemplo

mongodb://SERVIDOR:PUERTO/?maxPoolSize=150&retryWrites=false&retryReads=false

Esta advertencia se muestra debido a la versión de la Guice librería que utiliza Ops Manager. Puedes ignorar esta advertencia de forma segura.