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.

Añadir procesos existentes de MongoDB a Ops Manager

Ops Manager proporciona un asistente para agregar sus implementaciones existentes de MongoDB a la supervisión y gestión. El asistente te solicita:

Las implementaciones deben tener nombres únicos dentro de los proyectos.

Importante

Los nombres de sets de réplicas, clústeres fragmentados y particiones dentro del mismo Proyecto deben ser únicos. Si no se asignan nombres únicos a las implementaciones, se producirán snapshots de copia de seguridad dañadas.

La automatización no es compatible con todas las opciones de MongoDB, lo que puede dar como resultado intentos de importación fallidos. Para aprender más, consulta Soporte de configuración y automatización de MongoDB.

Si activas TLS, el FQDN para el host que ejecuta un proceso de MongoDB debe coincidir con el SAN para el certificado TLS en ese host.

Importante

Para evitar ataques de intermediario, mantenga el alcance de los certificados TLS lo más limitado posible. Aunque puede usar un certificado TLS con muchos SANs, o un certificado TLS comodín en cada host, no debería hacerlo. Para aprender más, consulte RFC 2818, sección 3.1.

Configura un nombre de host preferido si:

  • Se requiere un nombre de host específico, FQDN, dirección IPv4 o dirección IPv6 para acceder al proceso de MongoDB, o

  • Debe especificar el nombre de host que se utilizará para hosts con múltiples alias.

Para obtener más información, consulta la configuración Preferred Hostnames en Configuración del proyecto.

Si no ha eliminado completamente un host de Ops Manager y desea restaurar ese host, puede reimportar el proceso de MongoDB eliminado.

Si ha eliminado un host del todo de Ops Manager, restáurelo antes de volver a importarlo. Para buscar un host eliminado, debes tener el rol de Global Owner.

Para localizar y restaurar un host eliminado:

  1. Navega a la vista Deployment.

  2. En el menú More, haz clic en Deleted Hosts.

  3. Seleccioná el para restaurar el host.

Después de la restauración del host, puedes importar el procedimiento del proceso existente.

Nota

Si tu host no aparece en la lista Deleted Hosts, puedes re-importar el proceso inmediatamente.

Si añades un proceso de MongoDB existente que se ejecuta como un servicio de Windows a Automatización, Automatización:

  • Detiene y deshabilita el servicio existente

  • Crea e inicia un nuevo servicio

Si el proyecto de Ops Manager tiene habilitadas configuraciones de autenticación de MongoDB para sus implementaciones, la implementación de MongoDB que importes debe ser compatible con el mecanismo de autenticación del proyecto.

Se recomienda importar a un nuevo proyecto de destino que no tenga procesos en ejecución ni autenticación habilitada.

Si el clúster de origen utiliza autenticación y el Proyecto de destino de Ops Manager no tiene procesos gestionados existentes, Ops Manager habilita la autenticación en el Proyecto de destino, importa el keyfile existente del clúster de origen y lo utiliza para autenticar al usuario que realiza el proceso de importación.

Si tanto el clúster de origen como el proyecto de Ops Manager de destino utilizan autenticación y el proyecto tiene procesos, Ops Manager intenta utilizar la configuración de autenticación existente en el proyecto de destino durante el proceso de importación. Para que el proceso de importación tenga éxito, las credenciales de autenticación en el clúster de origen y en el proyecto de destino de Ops Manager deben ser las mismas.

Para garantizar que la importación sea exitosa, antes de iniciar el proceso de importación, agregue las credenciales del proyecto de destino de Ops Manager en el clúster de origen. Para obtener más información, consulta Rotar claves para el set de réplicas o Rotar claves para clústeres particionados.

Si la implementación de MongoDB requiere autenticación, al agregar la implementación a Ops Manager para su supervisión, es necesario proporcionar las credenciales necesarias.

  • Si la implementación no utiliza automatización, pero sí utiliza copia de seguridad, supervisión o ambos, puedes encontrar esas credenciales donde estaban antes de actualizar al MongoDB Agent.

  • Si la implementación no usa automatización, pero usará copia de seguridad, supervisión o ambos:

    1. Cree las credenciales para la implementación de MongoDB. Para obtener más información, consulta Acceso requerido para el agente MongoDB para supervisión y Acceso requerido para el agente MongoDB para copia de seguridad.

    2. Agrega las credenciales que concediste a esas funciones a Ops Manager después de agregar los procesos de MongoDB. Para obtener más información, consulte Agregar credenciales para supervisión y Agregar credenciales para copia de seguridad.

  • Si la implementación utiliza automatización, Ops Manager emplea las credenciales del MongoDB Agent. Puedes borrar las credenciales de los Agentes heredados de respaldos y agentes de supervisión. El MongoDB Agent utiliza esas credenciales para sus funciones de automatización, copia de seguridad y supervisión.

  • Si la implementación utilizará automatización pero no lo utilizó antes de importarlo, añade el usuario mms-automation a los procesos de base de datos que importaste y agrega las credenciales del usuario a Ops Manager.

Para obtener más información, consulta Agregar credenciales para la automatización.

Agregar una implementación de MongoDB a la automatización puede afectar la configuración de seguridad del proyecto de Ops Manager y de la implementación de MongoDB.

  • La automatización habilita la configuración de seguridad del proyecto. Si la implementación de MongoDB requiere autenticación pero el proyecto de Ops Manager no tiene habilitadas las configuraciones de autenticación, entonces cuando agregas la implementación de MongoDB a la automatización, Ops Manager actualiza las configuraciones de seguridad del proyecto con las configuraciones de seguridad de la implementación recién importada.

    El proceso de importación solo actualiza la configuración de seguridad del proyecto en Ops Manager si la configuración de seguridad del proyecto se encuentra actualmente deshabilitada. El proceso de importación no desactiva la configuración de seguridad del proyecto ni cambia su mecanismo de autenticación habilitado.

  • Automatización importa usuarios y roles de MongoDB. Las siguientes declaraciones se aplican a situaciones en las que una implementación de MongoDB requiere autenticación o el proyecto Ops Manager tiene habilitada la configuración de autenticación.

    Si la implementación de MongoDB contiene usuarios o roles definidos por el usuario, puede optar por importar estos usuarios y roles para que Ops Manager los gestione. Los usuarios y roles importados son Synced en todas las implementaciones gestionadas del proyecto de Ops Manager.

    • Si se establece el valor Enforce Consistent Set del Proyecto en Yes, Ops Manager elimina de las implementaciones de MongoDB a aquellos usuarios y roles que no se han importado.

    • Si estableces el valor del proyecto Enforce Consistent Set en No, Ops Manager dejará de gestionar a los usuarios y roles no importados en el proyecto. Estos usuarios y roles permanecen en la implementación de MongoDB. Para gestionar estos usuarios y roles, debes conectarte directamente a la implementación de MongoDB.

    Si no deseas que el proyecto de Ops Manager gestione usuarios y roles específicos, utiliza las páginas Authentication & Users y Authentication & Roles para remover estos usuarios y roles durante la importación antes de confirmar e implementar los cambios. Para obtener más información, consulta Gestionar o eliminar la gestión de los usuarios de MongoDB.

    Si la implementación de MongoDB importada ya tiene los usuarios mms-backup-agent y mms-monitoring-agent en su base de datos admin, el proceso de importación reemplaza los roles de estos usuarios con los roles para los usuarios mms-backup-agent y mms-monitoring-agent según lo establecido en el proyecto Ops Manager.

  • La automatización se aplica a todas las implementaciones del proyecto. Los ajustes de seguridad actualizados del proyecto, que incluyen todos los usuarios y roles gestionados por el proyecto de Ops Manager, se aplican a todas las implementaciones del proyecto, incluyendo la implementación de MongoDB importada.

    Ops Manager reinicia todas las implementaciones en el proyecto con la nueva configuración, incluyendo la implementación importada de MongoDB. Después de la importación, todas las implementaciones en el proyecto utilizan el archivo de clave de automatización de Ops Manager al reiniciar.

    La implementación que importes debe usar el mismo archivo de claves que los procesos existentes en el proyecto de destino o el proceso de importación puede no continuar. Para obtener más información, consulta Credenciales de autenticación en clústeres de origen y destino.

    Si las implementaciones existentes en el proyecto requieren un perfil de seguridad diferente al del proceso importado, crea un nuevo proyecto en el que puedas importar la implementación original de MongoDB.

Los siguientes ejemplos se aplican a situaciones en las que la implementación de MongoDB requiere autenticación o el proyecto Ops Manager tiene habilitados los ajustes de autenticación.

Si importas los usuarios de MongoDB y los roles personalizados, una vez que el proyecto Ops Manager comience a gestionar la implementación de MongoDB, ocurre lo siguiente, independientemente del valor de Enforce Consistent Set:

  • El Proyecto Ops Manager habilita la autenticación, gestiona usuarios y roles importados y sincroniza los usuarios y roles nuevos con todas sus implementaciones gestionadas.

  • El control de acceso de la implementación de MongoDB está habilitado y requiere autenticación. La implementación de MongoDB tiene todos los usuarios y roles gestionados por el Proyecto Ops Manager. Estos usuarios y roles tienen Synced definido en Yes.

Si no se importan los roles personalizados y los usuarios de MongoDB, una vez que el Proyecto de Ops Manager comience a gestionar la implementación de MongoDB, ocurrirá lo siguiente:

Si Enforce Consistent Set se establece en Yes:

  • El proyecto Ops Manager habilita la autenticación y no cambia sus usuarios y roles gestionados.

  • El control de acceso de la implementación de MongoDB está habilitado y requiere autenticación.

  • Ops Manager elimina de la implementación los usuarios y roles de MongoDB que no se importaron.

  • La implementación de MongoDB tiene todos los usuarios y roles que gestiona el proyecto de Ops Manager. Estos usuarios y sus roles tienen Synced establecidos en Yes.

Si Enforce Consistent Set se establece en No:

  • El proyecto Ops Manager habilita la autenticación y no cambia su configuración de seguridad, incluidos los usuarios y roles.

  • El control de acceso de la implementación de MongoDB está habilitado y requiere autenticación.

  • Los usuarios y roles de MongoDB que no se importan permanecen en la implementación de MongoDB.

  • La implementación de MongoDB mantiene todos los usuarios y roles gestionados por el Proyecto de Ops Manager. Estos usuarios y roles tienen Synced establecido en Yes.

  • Si mongod está habilitado como servicio en la implementación, podría producirse una condición de competencia en la que systemd inicia mongod en el reinicio, en lugar de la automatización. Para evitar este problema, asegúrate de que el servicio mongod esté deshabilitado antes de agregar tu implementación a la automatización:

    1. Verifica si el servicio mongod está habilitado:

      sudo systemctl is-enabled mongod.service
    2. Si el servicio está habilitado, desactívalo:

      sudo systemctl disable mongod.service
  • Si el proyecto de Ops Manager no tiene habilitadas las configuraciones de autenticación pero el proceso de MongoDB requiere autenticación, añade el usuario MongoDB Agent para el proyecto Ops Manager con los roles adecuados. El proceso de importación muestra los roles requeridos para el usuario. El usuario añadido se convierte en el usuario MongoDB Agent del proyecto.

  • Si el Proyecto de Ops Manager tiene habilitadas las configuraciones de autenticación, añade el usuario del MongoDB Agent del Proyecto de Ops Manager al proceso de MongoDB.

    • Para encontrar el usuario del agente de MongoDB, haz clic en Deployments, luego en Security y después en Users.

    • Para encontrar la contraseña del usuario MongoDB Agent del proyecto Ops Manager, utiliza uno de los siguientes métodos:

      Sigue los pasos en el procedimiento Añadir procesos de MongoDB para iniciar el asistente en la interfaz de usuario. Cuando llegues a la ventana modal que diga Do you want to add automation to this deployment?:

      1. Seleccione Add Automation and Configure Authentication.

      2. Haga clic en Show Password.

    • En mongosh, utilizá el método db.createUser() para añadir el usuario del Agente MongoDB del proyecto de Ops Manager al proceso de MongoDB. Por ejemplo, si el proyecto de Ops Manager utiliza la autenticación Nombre de usuario/Contraseña, ejecute el siguiente comando para agregar el usuario mms-automation a la base de datos admin en la implementación de MongoDB para importar:

      db.getSiblingDB("admin").createUser( { user: "mms-automation", pwd: "<password>", roles: [ 'clusterAdmin', 'dbAdminAnyDatabase', 'readWriteAnyDatabase', 'userAdminAnyDatabase', 'restore', 'backup', 'directShardOperations' // Required for sharded clusters ] })

      Debe especificar el rol directShardOperations para la automatización del clúster particionado. Este rol permite que el agente de automatización realice operaciones de mantenimiento que requieran acceso directo a las particiones, como añadir particiones a clústeres existentes. En las implementaciones no particionadas (autónomos o de sets de réplicas), se puede omitir este rol.

  • Cuando agregas un clúster en Ops Manager, Ops Manager habilita automáticamente la rotación de registros, lo que podría entrar en conflicto con la configuración existente logRotate de los registros de mongod o mongos. Para evitar esta colisión, haz lo siguiente:

    • Desactive su configuración de logRotate para los procesos mongod o mongos.

    • Remueva las opciones systemLog.logRotate y systemLog.logAppend opciones del mongod o mongos proceso configuración para utilizar el por defecto de Ops Manager.

  • El proceso de importación requiere que las credenciales de autenticación y los archivos de claves sean los mismos en los clústeres de origen y destino. Para aprender más, consulta Credenciales de autenticación en clústeres de origen y destino.

  • Cuando importa un set de réplicas primario-secundario-árbitro (PSA), el contenido del archivo de claves del set de réplicas que importa debe coincidir con el archivo de claves que MongoDB Ops Manager gestiona en el Proyecto de destino. De lo contrario, el proceso de importación falla para el nodo árbitro debido a un error de autenticación.

    Para evitar este problema, puede remover el árbitro antes de importar el set de réplicas y, luego, volver a agregarlo una vez que se complete la importación.

  • Para importar con éxito un set de réplicas existente a Ops Manager, la instancia debe estar sana.

Importante

Si va a agregar un clúster particionado, debe crear este usuario a través de mongos y en cada partición. Es decir, cree el usuario como un usuario de todo el clúster a través de mongos y como un usuario local de partición en cada partición.

Para agregar procesos existentes de MongoDB a Ops Manager:

1
  1. Si aún no se muestra, se debe seleccionar la organización que contiene el proyecto deseado en el menú Organizations de la barra de navegación.

  2. Si aún no se muestra, se debe seleccionar el proyecto deseado en el menú Projects de la barra de navegación.

  3. Si aún no se muestra, haz clic en Deployment en la barra lateral.

2
3

Después de añadir un proceso de MongoDB existente a Ops Manager, es posible que debas añadir credenciales de autenticación para las nuevas implementaciones si la autenticación está habilitada para el proyecto en el que importaste la implementación. Consulta Casos de uso de autenticación para aprender en qué situaciones debes agregar credenciales de automatización, supervisión o copia de seguridad para tu nueva implementación.

Si estás agregando una implementación que tienes la intención de migrar en vivo a Atlas, debes agregar la implementación (y sus credenciales) solo para supervisión.

Selecciona el mecanismo de autenticación que deseas utilizar:

Para agregar credenciales para una implementación que usará la automatización pero no la usaba antes de importarla a Ops Manager:

1

El usuario del agente de MongoDB realiza tareas de automatización en tus bases de datos MongoDB. Asegúrate de que este usuario de MongoDB tenga los privilegios adecuados.

2
  1. Si aún no se muestra, se debe seleccionar la organización que contiene el proyecto deseado en el menú Organizations de la barra de navegación.

  2. Si aún no se muestra, se debe seleccionar el proyecto deseado en el menú Projects de la barra de navegación.

  3. Si aún no se muestra, haz clic en Deployment en la barra lateral.

  1. Haz clic en la pestaña Security.

  2. Haz clic en la pestaña Settings.

  3. Realiza una de las siguientes acciones:

    • Si es la primera vez que configura TLS, la autenticación o la configuración de autorización para este Proyecto, haga clic en Get Started.

    • Si ya ha configurado la autenticación TLS o la configuración de autorización para este Proyecto, haga clic en Edit.

3
4
5
Configuración
Valor

MongoDB Agent Username

Introduzca el nombre de usuario del Agente de MongoDB.

MongoDB Agent Password

Introduzca la contraseña del MongoDB Agent Nombre de usuario.

Para agregar credenciales para una implementación que no usará automatización pero sí supervisión:

1
  1. Si aún no se muestra, se debe seleccionar la organización que contiene el proyecto deseado en el menú Organizations de la barra de navegación.

  2. Si aún no se muestra, se debe seleccionar el proyecto deseado en el menú Projects de la barra de navegación.

  3. Si aún no se muestra, haz clic en Deployment en la barra lateral.

  1. Haz clic en , y luego haz clic en Monitoring Settings junto a la implementación cuyas configuraciones de supervisión deseas ver.
2
3
Configuración
Valor

Monitoring Username

Introduce el nombre de usuario de supervisión.

Monitoring Password

Introduzca la contraseña para nombre de usuario de supervisión.

Para agregar credenciales para una implementación que no utilizará Automatización pero que sí utilizará copia de seguridad:

1
  1. Si aún no se muestra, se debe seleccionar la organización que contiene el proyecto deseado en el menú Organizations de la barra de navegación.

  2. Si aún no se muestra, se debe seleccionar el proyecto deseado en el menú Project de la barra de navegación.

  3. Haz clic en Continuous Backup en la barra lateral.

2
3
Configuración
Valor

Backup Username

Introduce el nombre de usuario de la copia de seguridad.

Backup Password

Introduce la contraseña de nombre de usuario de copia de seguridad.