Docs Menu
Docs Home
/ /
Instalar

Instalar el agente MongoDB solo para supervisar o realizar copias de seguridad de las implementaciones

Tiene un proyecto y desea instalar el Agente de MongoDB para supervisar o realizar copias de seguridad de sus implementaciones de MongoDB. Por el momento, ha decidido no administrar sus implementaciones de MongoDB.

Nota

Revise primero los prerrequisitos

Por favor revise el Requisitos previos del agente MongoDB antes de instalar el agente MongoDB.

Utilice este procedimiento para instalar el Agente MongoDB en la arquitectura x86_64 que ejecuta Microsoft Windows:

1
2

Si tiene un proyecto con implementaciones existentes, puede instalar el Agente MongoDB en sus implementaciones existentes:

  1. Seleccione el Proyecto deseado de la Context menú.

  2. Haga clic en Deployment.

  3. Haga clic en Agents.

  4. Haga clic en Downloads & Settings.

  5. Desde el menú Select Your Server's Operating System, haz clic en Windows - MSI.

3

El cuadro MongoDB Agent Installation Instructions muestra la siguiente información:

  • Base URL

Necesario para vincularse a un proyecto.

  • Project ID (Necesario para vincularse a un proyecto)

  • API Key

    Si no tiene una clave API, haga clic en Generar clave.

Algunos o todos estos valores serán necesarios en un paso posterior. Cópielos y guárdelos donde pueda acceder a ellos más adelante.

4
  1. Despues de la MSI Descargas, haga doble clic:

    mongodb-mms-automation-agent-<VERSION>.windows_x86_64.msi

  2. Si aparece una advertencia de seguridad, haga clic en Run.

  3. En el paso Configuration/Log Folder

    Proporcione el directorio en el que se guardan estos archivos.

  4. En el Key Type paso, seleccione Agent API Key para vincularse a un proyecto específico.

  5. Introduzca las claves de agente apropiadas.

    Nota

    Estas claves se proporcionan en el modal MongoDB Agent Installation Instructions descrito en el paso anterior.

  • Escriba su Base URL en el campo Base URL.

  • Escriba el ID de su proyecto en el campo Project ID.

  • Escriba su clave API de agente en el campo Agent API Key.

  • Escriba su clave API de agente en el campo Agent API Key.

  1. En el paso MongoDB Paths, especifique los directorios de registro y copia de seguridad

  2. En el paso Windows Firewall Configuration, haga clic en su configuración de firewall preferida.

    Si hace clic en Configure firewall rules allowing access from only the specified |ipaddr| addresses., escriba lo necesario DireccionesIPv en el cuadro provisto.4

  3. (Condicional) Windows habilita el modo ocultoPara el Firewall de Windows predeterminado. Si no lo ha desactivado en el host MongoDB donde está instalando el Agente MongoDB, se le solicitará que lo desactive. El Modo Oculto reduce significativamente el rendimiento y la capacidad del Agente MongoDB. Haga clic Disable Stealth Mode en.

  4. (Condicional) Windows no habilita los contadores de rendimiento de disco de forma predeterminada. Si no los ha habilitado para el host de MongoDB, haga clic en. Enable Disk Performance Counters El agente de MongoDB utiliza estos contadores para algunas de sus actividades de monitorización de hardware.

  5. Haga clic en Install.

  6. Haga clic en Finish una vez completada la configuración.

Después de la MSI descarga de, puede ejecutar una instalación desatendida. Esta instalación se realiza desde la línea de comandos, ya sea con el intérprete de comandos o con PowerShell. Para obtener más información sobre las instalaciones desatendidas, consulte la documentación de Microsoft sobre las opciones de la línea de comandos del instalador estándar.

Para ejecutar el instalador MSI sin supervisión desde la línea de comandos, invoque msiexec.exe con los indicadores /q y /i y una combinación de parámetros obligatorios y opcionales:

Parameter
Necesidad
Valor

MMSAPIKEY

Requerido

Clave API del agente de su proyecto Ops Manager.

MMSBASEURL

Requerido

URL del host de Ops Manager.

MMSGROUPID

Requerido

Identificador único de su proyecto de Ops Manager.

CONFIGLOGDIR

Opcional

Ruta absoluta del archivo donde Ops Manager debe escribir el archivo de configuración del MongoDB Agent.

LOGFILE

Opcional

Ruta de archivo absoluta en la que Ops Manager debe escribir el registro del agente MongoDB

MMSCONFIGBACKUP

Opcional

Ruta de archivo absoluta al archivo JSON de respaldo de configuración de automatización de Ops Manager.

Ejemplo

Para instalar el MongoDB Agent de forma desatendida, se invoca msiexec.exe con las siguientes opciones:

msiexec.exe /q /i "C:\PATH\TO\mongodb-mms-automation-agent-<VERSION>.windows_x86_64.msi" MMSGROUPID=<GROUP.ID> MMSAPIKEY=<AGENT.API.ID> MMSBASEURL="<http://opsmanager.example.com:8080>" LOGFILE="C:\MMSData\Server\Log\automation-agent.log" MMSCONFIGBACKUP="C:\MMSData\MongoDB\mms-cluster-config-backup.json"
5

En el cuadro de diálogo Install Agent Instructions, hacer clic en Done.

6

De forma predeterminada, los archivos binarios de MongoDB y el archivo de respaldo de configuración de Ops Manager se encuentran en %SystemDrive%\MMSMongoDB\versions.

Nota

Windows establece la %SystemDrive% variable de entorno en la unidad donde instaló Windows. De forma predeterminada, se le indicará que instale Windows en la unidad.C: Para encontrar su unidad, ejecute %SystemDrive% el siguiente comando desde PowerShell:

get-childitem env:SystemDrive

Si desea almacenar estos archivos en un directorio diferente, siga estos procedimientos:

Para cambiar la ubicación de los binarios del agente MongoDB

  1. Haga clic en Deployment, luego en Agents y luego en Downloads & Settings.

  2. Debajo del Download Directory encabezado, haga clic a la derecha de la ruta que se muestra Download Directory (Windows) en.

  3. Cambie la ruta a la nueva ruta que desee.

  4. Haga clic en Save.

  5. Cree el nuevo directorio especificado en cada host que ejecute un agente de MongoDB. Use el Explorador de Windows para mover el archivo o ejecute el siguiente comando desde el símbolo del sistema o PowerShell:

    md \<newPath>

    Importante

    Asegúrese de que el usuario del sistema que ejecuta el Agente MongoDB pueda escribir en este nuevo directorio. Normalmente, este es el usuario SYSTEM, que no requiere configuración adicional a menos que lo haya cambiado.

Para cambiar la ubicación de la copia de seguridad de la configuración del agente MongoDB

  1. Abra el archivo de configuración del Agente MongoDB en su editor de texto preferido.

  2. Cambie la configuración a la nueva ruta del archivo de copia de seguridad de la configuración.mmsConfigBackup Reemplace X con la letra de la unidad donde se almacena la copia de seguridad.

    mmsConfigBackup=X:\<newPath>\mms-cluster-config-backup.json
  3. Guarde el archivo de configuración del agente MongoDB.

  4. Mueva el archivo de copia de seguridad de configuración al nuevo directorio. Use el Explorador de Windows para mover el archivo o ejecute el siguiente comando desde el Símbolo del sistema o PowerShell:

    move %SystemDrive%\MMSMongoDB\versions\mms-cluster-config-backup.json \<newPath>
7

Sigue este procedimiento para instalar el agente MongoDB:

Importante

A partir de la versión 11.0.5.6967-,1 cuando instala el Agente MongoDB usando los deb rpm paquetes o, el paquete no agrega los binarios de MongoDB a la PATH variable de entorno.

Si tu implementación depende de la presencia de binarios de MongoDB en el PATH, debes añadir manualmente las rutas a los binarios de MongoDB en el PATH. Para aprender a actualizar variables de entorno, consulta la documentación de tu sistema operativo.

En la arquitectura x86_64 que ejecuta Debian 9, Ubuntu 18.04, Ubuntu 20.04 o Ubuntu 22.04:

1
2

Si tiene un proyecto con implementaciones existentes, puede instalar el Agente MongoDB en sus implementaciones existentes:

  1. Seleccione el proyecto deseado del menú Context.

  2. Haga clic en Deployment.

  3. Haga clic en Agents.

  4. Haga clic en Downloads & Settings.

  5. Desde el menú Select Your Server's Operating System, haga clic en Debian 9, Ubuntu 16.X/18.X - DEB.

3

Para comenzar con este paso, siga el modal de instalación del Agente MongoDB y copie los comandos proporcionados en el shell de Linux.

Desde una shell del sistema en el host que ejecutará el MongoDB Agent, ejecute el siguiente comando curl para descargar el instalador para Ubuntu 18.04/20.04/22.04 o Debian 9/10/11 para x86 de 64 bits:

curl -OL https://<OpsManagerHost>:<Port>/download/agent/automation/mongodb-mms-automation-agent-manager-latest.amd64.ubuntu1604.deb

Nota

Reemplace <OpsManagerHost>:<Port> con el nombre de host y el puerto de su aplicación Ops Manager. Si está presente, reemplace <version> con la versión principal del sistema operativo. Por ejemplo, reemplace <version> con 7 para RHEL 7.x.

4

En el directorio donde instaló el Agente MongoDB, abra el archivo automation-agent.config en su editor de texto preferido:

sudo vi /etc/mongodb-mms/automation-agent.config

Actualice las siguientes opciones de configuración:

Clave
Valor

ProjectID de su proyecto.

Clave API del agente de su proyecto.

URL (nombre de host y puerto) de la aplicación Ops Manager.

Los cambios resultantes en el archivo automation-agent.config deberían verse como los siguientes:

mmsGroupId=<Project ID>
mmsApiKey=<agent API key>
mmsBaseUrl=<application URL>
5

Para configurar el Agente MongoDB para conectarse a Ops Manager a través de un servidor proxy, debe especificar el servidor en la variable de httpProxy entorno.

En el directorio donde se instaló el MongoDB Agent, abra el archivo automation-agent.config en su editor de texto preferido.

sudo vi /etc/mongodb-mms/automation-agent.config

Agregue la siguiente clave de configuración:

Clave
Valor

URL (nombre de host y puerto) de su servidor proxy.

6

El directorio de datos almacena datos de MongoDB. En una implementación de MongoDB existente, asegúrese de que el directorio sea propiedad del usuario mongodb. Si no existe ninguna implementación de MongoDB, cree el directorio y establezca el propietario.

Para crear un directorio de datos y establecer el propietario como el usuario mongodb:

sudo mkdir -p /data; sudo chown mongodb:mongodb /data
7

Emita el siguiente comando:

sudo systemctl start mongodb-mms-automation-agent.service
8

En el cuadro de diálogo Install Agent Instructions, hacer clic en Done.

9

Importante

A partir de la versión 11.0.5.6967-,1 cuando instala el Agente MongoDB usando los deb rpm paquetes o, el paquete no agrega los binarios de MongoDB a la PATH variable de entorno.

Si tu implementación depende de la presencia de binarios de MongoDB en el PATH, debes añadir manualmente las rutas a los binarios de MongoDB en el PATH. Para aprender a actualizar variables de entorno, consulta la documentación de tu sistema operativo.

En la arquitectura zSeries que ejecuta Ubuntu 18.04 usando un paquete deb:

1
2

Si tiene un proyecto con implementaciones existentes, puede instalar el Agente MongoDB en sus implementaciones existentes:

  1. Seleccione el proyecto deseado del menú Context.

  2. Haga clic en Deployment.

  3. Haga clic en Agents.

  4. Haga clic en Downloads & Settings.

  5. Desde el menú Select Your Server's Operating System, haga clic en Ubuntu 18.X Z-Series (s390x) - DEB.

3

Para comenzar con este paso, siga el modal de instalación del Agente MongoDB y copie los comandos proporcionados en el shell de Linux.

Desde un shell del sistema en el host que ejecutará el Agente MongoDB, emita el siguiente comando curl para descargar el instalador para Ubuntu 18.04 para IBM zSeries:

curl -OL https://<OpsManagerHost>:<Port>/download/agent/automation/mongodb-mms-automation-agent-manager-latest.s390x.ubuntu1804.deb

Nota

Reemplace <OpsManagerHost>:<Port> con el nombre de host y el puerto de su aplicación Ops Manager. Si está presente, reemplace <version> con la versión principal del sistema operativo. Por ejemplo, reemplace <version> con 7 para RHEL 7.x.

4

En el directorio donde instaló el Agente MongoDB, abra el archivo automation-agent.config en su editor de texto preferido:

sudo vi /etc/mongodb-mms/automation-agent.config

Actualice las siguientes opciones de configuración:

Clave
Valor

ProjectID de su proyecto.

Clave API del agente de su proyecto.

URL (nombre de host y puerto) de la aplicación Ops Manager.

Los cambios resultantes en el archivo automation-agent.config deberían verse como los siguientes:

mmsGroupId=<Project ID>
mmsApiKey=<agent API key>
mmsBaseUrl=<application URL>
5

Para configurar el Agente MongoDB para conectarse a Ops Manager a través de un servidor proxy, debe especificar el servidor en la variable de httpProxy entorno.

En el directorio donde se instaló el MongoDB Agent, abra el archivo automation-agent.config en su editor de texto preferido.

sudo vi /etc/mongodb-mms/automation-agent.config

Agregue la siguiente clave de configuración:

Clave
Valor

URL (nombre de host y puerto) de su servidor proxy.

6

El directorio de datos almacena datos de MongoDB. En una implementación de MongoDB existente, asegúrese de que el directorio sea propiedad del usuario mongodb. Si no existe ninguna implementación de MongoDB, cree el directorio y establezca el propietario.

Para crear un directorio de datos y establecer el propietario como el usuario mongodb:

sudo mkdir -p /data; sudo chown mongodb:mongodb /data
7

Emita el siguiente comando:

sudo systemctl start mongodb-mms-automation-agent.service
8

En el cuadro de diálogo Install Agent Instructions, hacer clic en Done.

9

Sigue este procedimiento para instalar el agente MongoDB:

En la arquitectura x86_64:

Importante

A partir de la versión 11.0.5.6967-,1 cuando instala el Agente MongoDB usando los deb rpm paquetes o, el paquete no agrega los binarios de MongoDB a la PATH variable de entorno.

Si tu implementación depende de la presencia de binarios de MongoDB en el PATH, debes añadir manualmente las rutas a los binarios de MongoDB en el PATH. Para aprender a actualizar variables de entorno, consulta la documentación de tu sistema operativo.

Ejecutando Amazon Linux usando un paquete rpm:

1
2

Si tiene un proyecto con implementaciones existentes, puede instalar el Agente MongoDB en sus implementaciones existentes:

  1. Seleccione el proyecto deseado del menú Context.

  2. Haga clic en Deployment.

  3. Haga clic en Agents.

  4. Haga clic en Downloads & Settings.

  5. En el menú Select Your Server's Operating System, haz clic en Amazon Linux - RPM.

3

Para comenzar con este paso, siga el modal de instalación del Agente MongoDB y copie los comandos proporcionados en el shell de Linux.

Desde un shell del sistema en el host que ejecutará el Agente MongoDB, emita el siguiente comando curl para descargar el instalador para x86 de 64bit:

curl -OL https://<OpsManagerHost>:<Port>/download/agent/automation/mongodb-mms-automation-agent-manager-latest.x86_64.rpm

Nota

Reemplace <OpsManagerHost>:<Port> con el nombre de host y el puerto de su aplicación Ops Manager. Si está presente, reemplace <version> con la versión principal del sistema operativo. Por ejemplo, reemplace <version> con 7 para RHEL 7.x.

4

En el directorio donde instaló el Agente MongoDB, abra el archivo automation-agent.config en su editor de texto preferido:

sudo vi /etc/mongodb-mms/automation-agent.config

Actualice las siguientes opciones de configuración:

Clave
Valor

ProjectID de su proyecto.

Clave API del agente de su proyecto.

URL (nombre de host y puerto) de la aplicación Ops Manager.

Los cambios resultantes en el archivo automation-agent.config deberían verse como los siguientes:

mmsGroupId=<Project ID>
mmsApiKey=<agent API key>
mmsBaseUrl=<application URL>
5

Para configurar el Agente MongoDB para conectarse a Ops Manager a través de un servidor proxy, debe especificar el servidor en la variable de httpProxy entorno.

En el directorio donde se instaló el MongoDB Agent, abra el archivo automation-agent.config en su editor de texto preferido.

sudo vi /etc/mongodb-mms/automation-agent.config

Agregue la siguiente clave de configuración:

Clave
Valor

URL (nombre de host y puerto) de su servidor proxy.

6

El directorio de datos almacena datos de MongoDB y debe ser propiedad del usuario mongod. En una implementación de MongoDB existente, asegúrese de que el usuario mongod sea el propietario del directorio. Si no existe ninguna implementación de MongoDB, cree el directorio y establezca el propietario.

Los siguientes comandos crean un directorio de datos y establecen el propietario como el usuario mongod:

sudo mkdir /data; sudo chown mongod:mongod /data
7

Emita el siguiente comando:

sudo service mongodb-mms-automation-agent start
8

En el cuadro de diálogo Install Agent Instructions, hacer clic en Done.

9

Ejecutando RHEL (7.x, 8.x o 9.x) o CentOS (7.x o 8.x), SUSE12, SUSE15 o Amazon Linux 2:

Importante

A partir de la versión 11.0.5.6967-,1 cuando instala el Agente MongoDB usando los deb rpm paquetes o, el paquete no agrega los binarios de MongoDB a la PATH variable de entorno.

Si tu implementación depende de la presencia de binarios de MongoDB en el PATH, debes añadir manualmente las rutas a los binarios de MongoDB en el PATH. Para aprender a actualizar variables de entorno, consulta la documentación de tu sistema operativo.

Usando un paquete rpm:

1
2

Si tiene un proyecto con implementaciones existentes, puede instalar el Agente MongoDB en sus implementaciones existentes:

  1. Seleccione el proyecto deseado del menú Context.

  2. Haga clic en Deployment.

  3. Haga clic en Agents.

  4. Haga clic en Downloads & Settings.

  5. En el menú Select Your Server's Operating System, haga clic en RHEL/CentOS (7.X), SUSE12, Amazon Linux2 -RPM.

3

Para comenzar con este paso, siga el modal de instalación del Agente MongoDB y copie los comandos proporcionados en el shell de Linux.

Desde un shell del sistema en el host que ejecutará el Agente MongoDB, emita el siguiente comando curl para descargar el instalador de RHEL 7 para x86 de 64bits:

curl -OL https://<OpsManagerHost>:<Port>/download/agent/automation/mongodb-mms-automation-agent-manager-latest.x86_64.rhel<version>.rpm

Nota

Reemplace <OpsManagerHost>:<Port> con el nombre de host y el puerto de su aplicación Ops Manager. Si está presente, reemplace <version> con la versión principal del sistema operativo. Por ejemplo, reemplace <version> con 7 para RHEL 7.x.

4

En el directorio donde instaló el Agente MongoDB, abra el archivo automation-agent.config en su editor de texto preferido:

sudo vi /etc/mongodb-mms/automation-agent.config

Actualice las siguientes opciones de configuración:

Clave
Valor

ProjectID de su proyecto.

Clave API del agente de su proyecto.

URL (nombre de host y puerto) de la aplicación Ops Manager.

Los cambios resultantes en el archivo automation-agent.config deberían verse como los siguientes:

mmsGroupId=<Project ID>
mmsApiKey=<agent API key>
mmsBaseUrl=<application URL>
5

Para configurar el Agente MongoDB para conectarse a Ops Manager a través de un servidor proxy, debe especificar el servidor en la variable de httpProxy entorno.

En el directorio donde se instaló el MongoDB Agent, abra el archivo automation-agent.config en su editor de texto preferido.

sudo vi /etc/mongodb-mms/automation-agent.config

Agregue la siguiente clave de configuración:

Clave
Valor

URL (nombre de host y puerto) de su servidor proxy.

6

El directorio de datos almacena datos de MongoDB y debe ser propiedad del usuario mongod. En una implementación de MongoDB existente, asegúrese de que el usuario mongod sea el propietario del directorio. Si no existe ninguna implementación de MongoDB, cree el directorio y establezca el propietario.

Los siguientes comandos crean un directorio de datos y establecen el propietario como el usuario mongod:

sudo mkdir /data; sudo chown mongod:mongod /data
7

Emita el siguiente comando:

sudo service mongodb-mms-automation-agent start
8

En el cuadro de diálogo Install Agent Instructions, hacer clic en Done.

9

Usando un archivo tar:

1
2

Si tiene un proyecto con implementaciones existentes, puede instalar el Agente MongoDB en sus implementaciones existentes:

  1. Seleccione el proyecto deseado del menú Context.

  2. Haga clic en Deployment.

  3. Haga clic en Agents.

  4. Haga clic en Downloads & Settings.

  5. En el menú Select Your Server's Operating System, haga clic en RHEL/CentOS (7.X), SUSE12, Amazon Linux 2 - TAR.

3

Para comenzar con este paso, siga el modal de instalación del Agente MongoDB y copie los comandos proporcionados en el shell de Linux.

Desde un shell del sistema en el host que ejecutará el Agente MongoDB, emita el siguiente comando curl para descargar el instalador de RHEL para x86 de 64bit:

curl -OL https://<OpsManagerHost>:<Port>/download/agent/automation/mongodb-mms-automation-agent-manager-latest.rhel7_x86_64.tar.gz

Nota

Reemplace <OpsManagerHost>:<Port> con el nombre de host y el puerto de su aplicación Ops Manager. Si está presente, reemplace <version> con la versión principal del sistema operativo. Por ejemplo, reemplace <version> con 7 para RHEL 7.x.

4

Puede instalar el Agente MongoDB en cualquier directorio. Si desea mover el archivo a otro directorio antes de extraerlo, puede hacerlo.

Para instalar el Agente MongoDB, extraiga el archivo:

tar -xvzf mongodb-mms-automation-agent-<VERSION>.rhel7_x86_64.tar.gz
5

Cambie al directorio que se creó después de extraer el binario del Agente MongoDB:

cd mongodb-mms-automation-agent-<VERSION>.rhel7_x86_64
6

En el directorio donde instaló el Agente MongoDB, abra el archivo local.config en su editor de texto preferido:

vi <install-path>/local.config

Actualice las siguientes opciones de configuración:

Clave
Valor

ProjectID de su proyecto.

Clave API del agente de su proyecto.

URL (nombre de host y puerto) de la aplicación Ops Manager.

Los cambios resultantes en el archivo local.config deberían verse como los siguientes:

mmsGroupId=<Project ID>
mmsApiKey=<agent API key>
mmsBaseUrl=<application URL>
7

Para configurar el Agente MongoDB para conectarse a Ops Manager a través de un servidor proxy, debe especificar el servidor en la variable de httpProxy entorno.

En el directorio donde instaló el Agente MongoDB, abra el archivo local.config en su editor de texto preferido.

vi <install-path>/local.config

Agregue la siguiente clave de configuración:

Clave
Valor

URL (nombre de host y puerto) de su servidor proxy.

8

Cree los siguientes directorios para almacenar los archivos que necesita el Agente MongoDB.

Nota

El uso de mongodb-mms-automation en la ruta del archivo es un artefacto heredado y no significa que el Agente MongoDB se esté instalando con la automatización configurada.

Componente
Directorio predeterminado
Descripción

Binarios

/var/lib/mongodb-mms-automation

Estos son los binarios que gestiona el Agente de MongoDB. Incluyen el Agente de MongoDB, el Conector de BI y los binarios de MongoDB.

Registros del agente de MongoDB

/var/log/mongodb-mms-automation

Estos son las entradas de registro que crea el MongoDB Agent.

Bases de datos MongoDB

/data

Estas son las bases de datos que el Agente MongoDB crea y administra.

Ejecute los siguientes comandos para crear los directorios:

sudo mkdir -m 755 -p /var/lib/mongodb-mms-automation
sudo mkdir -m 755 -p /var/log/mongodb-mms-automation
sudo mkdir -m 755 -p /data

De forma predeterminada, los archivos binarios del agente y el archivo de copia de seguridad de la configuración de Ops Manager se encuentran en /var/lib/mongodb-mms-automation. Si desea almacenar estos archivos en un directorio diferente, siga estos procedimientos:

Para cambiar la ubicación de los binarios del agente:

  1. Haga clic en Deployment, luego en Agents y luego en Downloads & Settings.

  2. Debajo del encabezado Download Directory, haga clic en el icono del lápiz a la derecha de la ruta mostrada en Download Directory (Linux).

  3. Cambie la ruta a la nueva ruta que desee.

  4. Haga clic en Save.

  5. Crear el nuevo directorio especificado en cada host que ejecute un Agente.

    sudo mkdir -m 755 -p /<newPath>

Para cambiar la ubicación de la copia de seguridad de la configuración del agente:

  1. Abra el archivo de configuración del Agente en su editor de texto preferido.

  2. Cambie la configuración a la nueva ruta para el archivo de respaldo de mmsConfigBackup configuración.

    mmsConfigBackup=/<newPath>/mms-cluster-config-backup.json
  3. Guarde el archivo de configuración del agente.

  4. Mueva el archivo de respaldo de configuración al nuevo directorio.

    sudo mv /var/lib/mongodb-mms-automation/mms-cluster-config-backup.json /<newPath>
9

Ejecute los siguientes comandos:

# Create mongod user and group if they do not exist
if ! sudo /usr/bin/id -g mongod &>/dev/null; then
sudo /usr/sbin/groupadd -r mongod
fi
# Create mongod user if they do not exist and assign
# them to the mongod group
if ! sudo /usr/bin/id mongod &>/dev/null; then
sudo /usr/sbin/useradd -M -r -g mongod \
-d /var/lib/mongo -s /bin/false \
-c mongod mongod > /dev/null 2>&1
fi
# Grant the mongod:mongod user and group permissions
# to manage deployments.
sudo chown mongod:mongod /var/lib/mongod-mms-automation
sudo chown mongod:mongod /var/log/mongod-mms-automation
sudo chown mongod:mongod /data
10

Desde el directorio en el que instalaste el MongoDB Agent y como el usuario del sistema que creaste en el último paso, ejecuta el siguiente comando:

nohup ./mongodb-mms-automation-agent \
--config=local.config \
>> /var/log/mongodb-mms-automation/automation-agent-fatal.log 2>&1 &
11

En el cuadro de diálogo Install Agent Instructions, hacer clic en Done.

12

En RHEL/CentOS (7.x) en arquitectura PowerPC (administración de implementaciones de MongoDB 3.6 o posteriores):

Importante

A partir de la versión 11.0.5.6967-,1 cuando instala el Agente MongoDB usando los deb rpm paquetes o, el paquete no agrega los binarios de MongoDB a la PATH variable de entorno.

Si tu implementación depende de la presencia de binarios de MongoDB en el PATH, debes añadir manualmente las rutas a los binarios de MongoDB en el PATH. Para aprender a actualizar variables de entorno, consulta la documentación de tu sistema operativo.

Usando un paquete rpm:

1
2

Si tiene un proyecto con implementaciones existentes, puede instalar el Agente MongoDB en sus implementaciones existentes:

  1. Seleccione el proyecto deseado del menú Context.

  2. Haga clic en Deployment.

  3. Haga clic en Agents.

  4. Haga clic en Downloads & Settings.

  5. Desde el menú Select Your Server's Operating System, haga clic en RHEL/CentOS (7.X) Energía (ppc64le) - RPM.

3

Para comenzar con este paso, siga el modal de instalación del Agente MongoDB y copie los comandos proporcionados en el shell de Linux.

Desde un shell del sistema en el host que ejecutará el Agente MongoDB, emita el siguiente comando curl para descargar el instalador de RHEL 7 para PowerPC:

curl -OL https://<OpsManagerHost>:<Port>/download/agent/automation/mongodb-mms-automation-agent-manager-latest.ppc641e.rhel<version>.rpm

Nota

Reemplace <OpsManagerHost>:<Port> con el nombre de host y el puerto de su aplicación Ops Manager. Si está presente, reemplace <version> con la versión principal del sistema operativo. Por ejemplo, reemplace <version> con 7 para RHEL 7.x.

4

En el directorio donde instaló el Agente MongoDB, abra el archivo automation-agent.config en su editor de texto preferido:

sudo vi /etc/mongodb-mms/automation-agent.config

Actualice las siguientes opciones de configuración:

Clave
Valor

ProjectID de su proyecto.

Clave API del agente de su proyecto.

URL (nombre de host y puerto) de la aplicación Ops Manager.

Los cambios resultantes en el archivo automation-agent.config deberían verse como los siguientes:

mmsGroupId=<Project ID>
mmsApiKey=<agent API key>
mmsBaseUrl=<application URL>
5

Para configurar el Agente MongoDB para conectarse a Ops Manager a través de un servidor proxy, debe especificar el servidor en la variable de httpProxy entorno.

En el directorio donde se instaló el MongoDB Agent, abra el archivo automation-agent.config en su editor de texto preferido.

sudo vi /etc/mongodb-mms/automation-agent.config

Agregue la siguiente clave de configuración:

Clave
Valor

URL (nombre de host y puerto) de su servidor proxy.

6

El directorio de datos almacena datos de MongoDB y debe ser propiedad del usuario mongod. En una implementación de MongoDB existente, asegúrese de que el usuario mongod sea el propietario del directorio. Si no existe ninguna implementación de MongoDB, cree el directorio y establezca el propietario.

Los siguientes comandos crean un directorio de datos y establecen el propietario como el usuario mongod:

sudo mkdir /data; sudo chown mongod:mongod /data
7

Emita el siguiente comando:

sudo service mongodb-mms-automation-agent start
8

En el cuadro de diálogo Install Agent Instructions, hacer clic en Done.

9

Usando un archivo tar:

1
2

Si tiene un proyecto con implementaciones existentes, puede instalar el Agente MongoDB en sus implementaciones existentes:

  1. Seleccione el proyecto deseado del menú Context.

  2. Haga clic en Deployment.

  3. Haga clic en Agents.

  4. Haga clic en Downloads & Settings.

  5. En el menú Select Your Server's Operating System, haga clic en RHEL/CentOS (7.X) Power (ppc64le) - TAR.

3

Para comenzar con este paso, siga el modal de instalación del Agente MongoDB y copie los comandos proporcionados en el shell de Linux.

Desde un shell del sistema en el host que ejecutará el Agente MongoDB, emita el siguiente comando curl para descargar el instalador de RHEL 7 para PowerPC:

curl -OL https://<OpsManagerHost>:<Port>/download/agent/automation/mongodb-mms-automation-agent-manager-latest.rhel7_ppc64le.tar.gz

Nota

Reemplace <OpsManagerHost>:<Port> con el nombre de host y el puerto de su aplicación Ops Manager. Si está presente, reemplace <version> con la versión principal del sistema operativo. Por ejemplo, reemplace <version> con 7 para RHEL 7.x.

4

Puede instalar el Agente MongoDB en cualquier directorio. Si desea mover el archivo a otro directorio antes de extraerlo, puede hacerlo.

Para instalar el Agente MongoDB, extraiga el archivo:

tar -xvzf mongodb-mms-automation-agent-<VERSION>.rhel7_ppc64le.tar.gz
5

Cambie al directorio que se creó después de extraer el binario del Agente MongoDB:

cd mongodb-mms-automation-agent-<VERSION>.rhel7_ppc64le
6

En el directorio donde instaló el Agente MongoDB, abra el archivo local.config en su editor de texto preferido:

vi <install-path>/local.config

Actualice las siguientes opciones de configuración:

Clave
Valor

ProjectID de su proyecto.

Clave API del agente de su proyecto.

URL (nombre de host y puerto) de la aplicación Ops Manager.

Los cambios resultantes en el archivo local.config deberían verse como los siguientes:

mmsGroupId=<Project ID>
mmsApiKey=<agent API key>
mmsBaseUrl=<application URL>
7

Para configurar el Agente MongoDB para conectarse a Ops Manager a través de un servidor proxy, debe especificar el servidor en la variable de httpProxy entorno.

En el directorio donde instaló el Agente MongoDB, abra el archivo local.config en su editor de texto preferido.

vi <install-path>/local.config

Agregue la siguiente clave de configuración:

Clave
Valor

URL (nombre de host y puerto) de su servidor proxy.

8

Cree los siguientes directorios para almacenar los archivos que necesita el Agente MongoDB.

Nota

El uso de mongodb-mms-automation en la ruta del archivo es un artefacto heredado y no significa que el Agente MongoDB se esté instalando con la automatización configurada.

Componente
Directorio predeterminado
Descripción

Binarios

/var/lib/mongodb-mms-automation

Estos son los binarios que gestiona el Agente de MongoDB. Incluyen el Agente de MongoDB, el Conector de BI y los binarios de MongoDB.

Registros del agente de MongoDB

/var/log/mongodb-mms-automation

Estos son las entradas de registro que crea el MongoDB Agent.

Bases de datos MongoDB

/data

Estas son las bases de datos que el Agente MongoDB crea y administra.

Ejecute los siguientes comandos para crear los directorios:

sudo mkdir -m 755 -p /var/lib/mongodb-mms-automation
sudo mkdir -m 755 -p /var/log/mongodb-mms-automation
sudo mkdir -m 755 -p /data

De forma predeterminada, los archivos binarios del agente y el archivo de copia de seguridad de la configuración de Ops Manager se encuentran en /var/lib/mongodb-mms-automation. Si desea almacenar estos archivos en un directorio diferente, siga estos procedimientos:

Para cambiar la ubicación de los binarios del agente:

  1. Haga clic en Deployment, luego en Agents y luego en Downloads & Settings.

  2. Debajo del encabezado Download Directory, haga clic en el icono del lápiz a la derecha de la ruta mostrada en Download Directory (Linux).

  3. Cambie la ruta a la nueva ruta que desee.

  4. Haga clic en Save.

  5. Crear el nuevo directorio especificado en cada host que ejecute un Agente.

    sudo mkdir -m 755 -p /<newPath>

Para cambiar la ubicación de la copia de seguridad de la configuración del agente:

  1. Abra el archivo de configuración del Agente en su editor de texto preferido.

  2. Cambie la configuración a la nueva ruta para el archivo de respaldo de mmsConfigBackup configuración.

    mmsConfigBackup=/<newPath>/mms-cluster-config-backup.json
  3. Guarde el archivo de configuración del agente.

  4. Mueva el archivo de respaldo de configuración al nuevo directorio.

    sudo mv /var/lib/mongodb-mms-automation/mms-cluster-config-backup.json /<newPath>
9

Ejecute los siguientes comandos:

# Create mongod user and group if they do not exist
if ! sudo /usr/bin/id -g mongod &>/dev/null; then
sudo /usr/sbin/groupadd -r mongod
fi
# Create mongod user if they do not exist and assign
# them to the mongod group
if ! sudo /usr/bin/id mongod &>/dev/null; then
sudo /usr/sbin/useradd -M -r -g mongod \
-d /var/lib/mongo -s /bin/false \
-c mongod mongod > /dev/null 2>&1
fi
# Grant the mongod:mongod user and group permissions
# to manage deployments.
sudo chown mongod:mongod /var/lib/mongod-mms-automation
sudo chown mongod:mongod /var/log/mongod-mms-automation
sudo chown mongod:mongod /data
10

Desde el directorio en el que instalaste el MongoDB Agent y como el usuario del sistema que creaste en el último paso, ejecuta el siguiente comando:

nohup ./mongodb-mms-automation-agent \
--config=local.config \
>> /var/log/mongodb-mms-automation/automation-agent-fatal.log 2>&1 &
11

En el cuadro de diálogo Install Agent Instructions, hacer clic en Done.

12

En la arquitectura zSeries (administración de implementaciones de MongoDB 4.0 o posteriores):

Ejecutar RHEL (7.x, 8.x o 9.x) o CentOS (7.x o 8.x) utilizando el administrador de paquetes rpm:

Importante

A partir de la versión 11.0.5.6967-,1 cuando instala el Agente MongoDB usando los deb rpm paquetes o, el paquete no agrega los binarios de MongoDB a la PATH variable de entorno.

Si tu implementación depende de la presencia de binarios de MongoDB en el PATH, debes añadir manualmente las rutas a los binarios de MongoDB en el PATH. Para aprender a actualizar variables de entorno, consulta la documentación de tu sistema operativo.

1
2

Si tiene un proyecto con implementaciones existentes, puede instalar el Agente MongoDB en sus implementaciones existentes:

  1. Seleccione el proyecto deseado del menú Context.

  2. Haga clic en Deployment.

  3. Haga clic en Agents.

  4. Haga clic en Downloads & Settings.

  5. En el menú Select Your Server's Operating System, haga clic en RHEL 7.X/8X Serie Z (s390x) - RPM.

3

Para comenzar con este paso, siga el modal de instalación del Agente MongoDB y copie los comandos proporcionados en el shell de Linux.

Desde un shell del sistema en el host que ejecutará el Agente MongoDB, emita el siguiente comando curl para descargar el instalador de RHEL 7.X/8.X para IBM zSeries:

curl -OL https://<OpsManagerHost>:<Port>/download/agent/automation/mongodb-mms-automation-agent-manager-latest.s390x.rhel<version>.rpm

Nota

Reemplace <OpsManagerHost>:<Port> con el nombre de host y el puerto de su aplicación Ops Manager. Si está presente, reemplace <version> con la versión principal del sistema operativo. Por ejemplo, reemplace <version> con 7 para RHEL 7.x.

4

En el directorio donde instaló el Agente MongoDB, abra el archivo automation-agent.config en su editor de texto preferido:

sudo vi /etc/mongodb-mms/automation-agent.config

Actualice las siguientes opciones de configuración:

Clave
Valor

ProjectID de su proyecto.

Clave API del agente de su proyecto.

URL (nombre de host y puerto) de la aplicación Ops Manager.

Los cambios resultantes en el archivo automation-agent.config deberían verse como los siguientes:

mmsGroupId=<Project ID>
mmsApiKey=<agent API key>
mmsBaseUrl=<application URL>
5

Para configurar el Agente MongoDB para conectarse a Ops Manager a través de un servidor proxy, debe especificar el servidor en la variable de httpProxy entorno.

En el directorio donde se instaló el MongoDB Agent, abra el archivo automation-agent.config en su editor de texto preferido.

sudo vi /etc/mongodb-mms/automation-agent.config

Agregue la siguiente clave de configuración:

Clave
Valor

URL (nombre de host y puerto) de su servidor proxy.

6

El directorio de datos almacena datos de MongoDB y debe ser propiedad del usuario mongod. En una implementación de MongoDB existente, asegúrese de que el usuario mongod sea el propietario del directorio. Si no existe ninguna implementación de MongoDB, cree el directorio y establezca el propietario.

Los siguientes comandos crean un directorio de datos y establecen el propietario como el usuario mongod:

sudo mkdir /data; sudo chown mongod:mongod /data
7

Emita el siguiente comando:

sudo service mongodb-mms-automation-agent start
8

En el cuadro de diálogo Install Agent Instructions, hacer clic en Done.

9

En la arquitectura ARM64 que ejecuta RHEL (8.x o 9.x) o Amazon Linux 2:

Importante

A partir de la versión 11.0.5.6967-,1 cuando instala el Agente MongoDB usando los deb rpm paquetes o, el paquete no agrega los binarios de MongoDB a la PATH variable de entorno.

Si tu implementación depende de la presencia de binarios de MongoDB en el PATH, debes añadir manualmente las rutas a los binarios de MongoDB en el PATH. Para aprender a actualizar variables de entorno, consulta la documentación de tu sistema operativo.

Ejecutar RHEL (8.x o 9.x) o Amazon Linux 2 utilizando el administrador de paquetes rpm:

1
2

Si tiene un proyecto con implementaciones existentes, puede instalar el Agente MongoDB en sus implementaciones existentes:

  1. Seleccione el proyecto deseado del menú Context.

  2. Haga clic en Deployment.

  3. Haga clic en Agents.

  4. Haga clic en Downloads & Settings.

  5. En el menú Select Your Server's Operating System, haga clic en RHEL/CentOS (8.X/9.X), Amazon Linux 2, Amazon Linux 2023 - TAR (ARM).

3

Para comenzar con este paso, siga el modal de instalación del Agente MongoDB y copie los comandos proporcionados en el shell de Linux.

Desde un shell del sistema en el host que ejecutará el Agente MongoDB, emita el siguiente comando curl para descargar el instalador para RHEL (8.x o 9.x) o Amazon Linux 2 para ARM64:

curl -OL https://<OpsManagerHost>:<Port>/download/agent/automation/mongodb-mms-automation-agent-manager-latest.aarch64.amzn2.rpm

Nota

Reemplace <OpsManagerHost>:<Port> con el nombre de host y el puerto de su aplicación Ops Manager. Si está presente, reemplace <version> con la versión principal del sistema operativo. Por ejemplo, reemplace <version> con 7 para RHEL 7.x.

4

En el directorio donde instaló el Agente MongoDB, abra el archivo automation-agent.config en su editor de texto preferido:

sudo vi /etc/mongodb-mms/automation-agent.config

Actualice las siguientes opciones de configuración:

Clave
Valor

ProjectID de su proyecto.

Clave API del agente de su proyecto.

URL (nombre de host y puerto) de la aplicación Ops Manager.

Los cambios resultantes en el archivo automation-agent.config deberían verse como los siguientes:

mmsGroupId=<Project ID>
mmsApiKey=<agent API key>
mmsBaseUrl=<application URL>
5

Para configurar el Agente MongoDB para conectarse a Ops Manager a través de un servidor proxy, debe especificar el servidor en la variable de httpProxy entorno.

En el directorio donde se instaló el MongoDB Agent, abra el archivo automation-agent.config en su editor de texto preferido.

sudo vi /etc/mongodb-mms/automation-agent.config

Agregue la siguiente clave de configuración:

Clave
Valor

URL (nombre de host y puerto) de su servidor proxy.

6

El directorio de datos almacena datos de MongoDB y debe ser propiedad del usuario mongod. En una implementación de MongoDB existente, asegúrese de que el usuario mongod sea el propietario del directorio. Si no existe ninguna implementación de MongoDB, cree el directorio y establezca el propietario.

Los siguientes comandos crean un directorio de datos y establecen el propietario como el usuario mongod:

sudo mkdir /data; sudo chown mongod:mongod /data
7

Emita el siguiente comando:

sudo service mongodb-mms-automation-agent start
8

En el cuadro de diálogo Install Agent Instructions, hacer clic en Done.

9

Ejecutando RHEL (8.x o 9.x) o Amazon Linux 2 usando un fichero tar:

1
2

Si tiene un proyecto con implementaciones existentes, puede instalar el Agente MongoDB en sus implementaciones existentes:

  1. Seleccione el proyecto deseado del menú Context.

  2. Haga clic en Deployment.

  3. Haga clic en Agents.

  4. Haga clic en Downloads & Settings.

  5. En el menú Select Your Server's Operating System, haga clic en RHEL/CentOS (8.X/9.X), Amazon Linux 2, Amazon Linux 2023 - TAR (ARM).

3

Para comenzar con este paso, siga el modal de instalación del Agente MongoDB y copie los comandos proporcionados en el shell de Linux.

Desde un shell del sistema en el host que ejecutará el Agente MongoDB, emita el siguiente comando curl para descargar el instalador para RHEL (8.x o 9.x) o Amazon Linux 2 para ARM64:

curl -OL https://<OpsManagerHost>:<Port>/download/agent/automation/mongodb-mms-automation-agent-manager-latest.amzn2_aarch64.tar.gz

Nota

Reemplace <OpsManagerHost>:<Port> con el nombre de host y el puerto de su aplicación Ops Manager. Si está presente, reemplace <version> con la versión principal del sistema operativo. Por ejemplo, reemplace <version> con 7 para RHEL 7.x.

4

Puede instalar el Agente MongoDB en cualquier directorio. Si desea mover el archivo a otro directorio antes de extraerlo, puede hacerlo.

Para instalar el Agente MongoDB, extraiga el archivo:

tar -xvzf mongodb-mms-automation-agent-<VERSION>.amzn2_aarch64.tar.gz
5

Cambie al directorio que se creó después de extraer el binario del Agente MongoDB:

cd mongodb-mms-automation-agent-<VERSION>.amzn2_aarch64
6

En el directorio donde instaló el Agente MongoDB, abra el archivo local.config en su editor de texto preferido:

vi <install-path>/local.config

Actualice las siguientes opciones de configuración:

Clave
Valor

ProjectID de su proyecto.

Clave API del agente de su proyecto.

URL (nombre de host y puerto) de la aplicación Ops Manager.

Los cambios resultantes en el archivo local.config deberían verse como los siguientes:

mmsGroupId=<Project ID>
mmsApiKey=<agent API key>
mmsBaseUrl=<application URL>
7

Para configurar el Agente MongoDB para conectarse a Ops Manager a través de un servidor proxy, debe especificar el servidor en la variable de httpProxy entorno.

En el directorio donde instaló el Agente MongoDB, abra el archivo local.config en su editor de texto preferido.

vi <install-path>/local.config

Agregue la siguiente clave de configuración:

Clave
Valor

URL (nombre de host y puerto) de su servidor proxy.

8

Cree los siguientes directorios para almacenar los archivos que necesita el Agente MongoDB.

Nota

El uso de mongodb-mms-automation en la ruta del archivo es un artefacto heredado y no significa que el Agente MongoDB se esté instalando con la automatización configurada.

Componente
Directorio predeterminado
Descripción

Binarios

/var/lib/mongodb-mms-automation

Estos son los binarios que gestiona el Agente de MongoDB. Incluyen el Agente de MongoDB, el Conector de BI y los binarios de MongoDB.

Registros del agente de MongoDB

/var/log/mongodb-mms-automation

Estos son las entradas de registro que crea el MongoDB Agent.

Bases de datos MongoDB

/data

Estas son las bases de datos que el Agente MongoDB crea y administra.

Ejecute los siguientes comandos para crear los directorios:

sudo mkdir -m 755 -p /var/lib/mongodb-mms-automation
sudo mkdir -m 755 -p /var/log/mongodb-mms-automation
sudo mkdir -m 755 -p /data

De forma predeterminada, los archivos binarios del agente y el archivo de copia de seguridad de la configuración de Ops Manager se encuentran en /var/lib/mongodb-mms-automation. Si desea almacenar estos archivos en un directorio diferente, siga estos procedimientos:

Para cambiar la ubicación de los binarios del agente:

  1. Haga clic en Deployment, luego en Agents y luego en Downloads & Settings.

  2. Debajo del encabezado Download Directory, haga clic en el icono del lápiz a la derecha de la ruta mostrada en Download Directory (Linux).

  3. Cambie la ruta a la nueva ruta que desee.

  4. Haga clic en Save.

  5. Crear el nuevo directorio especificado en cada host que ejecute un Agente.

    sudo mkdir -m 755 -p /<newPath>

Para cambiar la ubicación de la copia de seguridad de la configuración del agente:

  1. Abra el archivo de configuración del Agente en su editor de texto preferido.

  2. Cambie la configuración a la nueva ruta para el archivo de respaldo de mmsConfigBackup configuración.

    mmsConfigBackup=/<newPath>/mms-cluster-config-backup.json
  3. Guarde el archivo de configuración del agente.

  4. Mueva el archivo de respaldo de configuración al nuevo directorio.

    sudo mv /var/lib/mongodb-mms-automation/mms-cluster-config-backup.json /<newPath>
9

Ejecute los siguientes comandos:

# Create mongod user and group if they do not exist
if ! sudo /usr/bin/id -g mongod &>/dev/null; then
sudo /usr/sbin/groupadd -r mongod
fi
# Create mongod user if they do not exist and assign
# them to the mongod group
if ! sudo /usr/bin/id mongod &>/dev/null; then
sudo /usr/sbin/useradd -M -r -g mongod \
-d /var/lib/mongo -s /bin/false \
-c mongod mongod > /dev/null 2>&1
fi
# Grant the mongod:mongod user and group permissions
# to manage deployments.
sudo chown mongod:mongod /var/lib/mongod-mms-automation
sudo chown mongod:mongod /var/log/mongod-mms-automation
sudo chown mongod:mongod /data
10

Desde el directorio en el que instalaste el MongoDB Agent y como el usuario del sistema que creaste en el último paso, ejecuta el siguiente comando:

nohup ./mongodb-mms-automation-agent \
--config=local.config \
>> /var/log/mongodb-mms-automation/automation-agent-fatal.log 2>&1 &
11

En el cuadro de diálogo Install Agent Instructions, hacer clic en Done.

12

Utilice este procedimiento para instalar sistemas Linux que no utilicen paquetes deb o rpm.

1
2

Si tiene un proyecto con implementaciones existentes, puede instalar el Agente MongoDB en sus implementaciones existentes:

  1. Seleccione el proyecto deseado del menú Context.

  2. Haga clic en Deployment.

  3. Haga clic en Agents.

  4. Haga clic en Downloads & Settings.

  5. Desde el menú Select Your Server's Operating System, haga clic en Otro Linux - TAR.

3

Para comenzar con este paso, siga el modal de instalación del Agente MongoDB y copie los comandos proporcionados en el shell de Linux.

Desde un shell del sistema en el host que ejecutará el Agente MongoDB, emita el siguiente comando curl para descargar el instalador para Linux genérico de 64bits:

curl -OL https://<OpsManagerHost>:<Port>/download/agent/automation/mongodb-mms-automation-agent-manager-latest.linux_x86_64.tar.gz

Nota

Reemplace <OpsManagerHost>:<Port> con el nombre de host y el puerto de su aplicación Ops Manager. Si está presente, reemplace <version> con la versión principal del sistema operativo. Por ejemplo, reemplace <version> con 7 para RHEL 7.x.

4

Puede instalar el Agente MongoDB en cualquier directorio. Si desea mover el archivo a otro directorio antes de extraerlo, puede hacerlo.

Para instalar el Agente MongoDB, extraiga el archivo:

tar -xvzf mongodb-mms-automation-agent-<VERSION>.linux_x86_64.tar.gz
5

Cambie al directorio que se creó después de extraer el binario del Agente MongoDB:

cd mongodb-mms-automation-agent-<VERSION>.linux_x86_64
6

En el directorio donde instaló el Agente MongoDB, abra el archivo local.config en su editor de texto preferido:

vi <install-path>/local.config

Actualice las siguientes opciones de configuración:

Clave
Valor

ProjectID de su proyecto.

Clave API del agente de su proyecto.

URL (nombre de host y puerto) de la aplicación Ops Manager.

Los cambios resultantes en el archivo local.config deberían verse como los siguientes:

mmsGroupId=<Project ID>
mmsApiKey=<agent API key>
mmsBaseUrl=<application URL>
7

Para configurar el Agente MongoDB para conectarse a Ops Manager a través de un servidor proxy, debe especificar el servidor en la variable de httpProxy entorno.

En el directorio donde instaló el Agente MongoDB, abra el archivo local.config en su editor de texto preferido.

vi <install-path>/local.config

Agregue la siguiente clave de configuración:

Clave
Valor

URL (nombre de host y puerto) de su servidor proxy.

8

Cree los siguientes directorios para almacenar los archivos que necesita el Agente MongoDB.

Nota

El uso de mongodb-mms-automation en la ruta del archivo es un artefacto heredado y no significa que el Agente MongoDB se esté instalando con la automatización configurada.

Componente
Directorio predeterminado
Descripción

Binarios

/var/lib/mongodb-mms-automation

Estos son los binarios que gestiona el Agente de MongoDB. Incluyen el Agente de MongoDB, el Conector de BI y los binarios de MongoDB.

Registros del agente de MongoDB

/var/log/mongodb-mms-automation

Estos son las entradas de registro que crea el MongoDB Agent.

Bases de datos MongoDB

/data

Estas son las bases de datos que el Agente MongoDB crea y administra.

Ejecute los siguientes comandos para crear los directorios:

sudo mkdir -m 755 -p /var/lib/mongodb-mms-automation
sudo mkdir -m 755 -p /var/log/mongodb-mms-automation
sudo mkdir -m 755 -p /data

De forma predeterminada, los archivos binarios del agente y el archivo de copia de seguridad de la configuración de Ops Manager se encuentran en /var/lib/mongodb-mms-automation. Si desea almacenar estos archivos en un directorio diferente, siga estos procedimientos:

Para cambiar la ubicación de los binarios del agente:

  1. Haga clic en Deployment, luego en Agents y luego en Downloads & Settings.

  2. Debajo del encabezado Download Directory, haga clic en el icono del lápiz a la derecha de la ruta mostrada en Download Directory (Linux).

  3. Cambie la ruta a la nueva ruta que desee.

  4. Haga clic en Save.

  5. Crear el nuevo directorio especificado en cada host que ejecute un Agente.

    sudo mkdir -m 755 -p /<newPath>

Para cambiar la ubicación de la copia de seguridad de la configuración del agente:

  1. Abra el archivo de configuración del Agente en su editor de texto preferido.

  2. Cambie la configuración a la nueva ruta para el archivo de respaldo de mmsConfigBackup configuración.

    mmsConfigBackup=/<newPath>/mms-cluster-config-backup.json
  3. Guarde el archivo de configuración del agente.

  4. Mueva el archivo de respaldo de configuración al nuevo directorio.

    sudo mv /var/lib/mongodb-mms-automation/mms-cluster-config-backup.json /<newPath>
9

Ejecute los siguientes comandos:

# Create mongodb user and group if they do not exist
if ! sudo /usr/bin/id -g mongodb &>/dev/null; then
sudo /usr/sbin/groupadd -r mongodb
fi
# Create mongodb user if they do not exist and assign
# them to the mongodb group
if ! sudo /usr/bin/id mongodb &>/dev/null; then
sudo /usr/sbin/useradd -M -r -g mongodb \
-d /var/lib/mongo -s /bin/false \
-c mongodb mongodb > /dev/null 2>&1
fi
# Grant the mongodb:mongodb user and group permissions
# to manage deployments.
sudo chown mongodb:mongodb /var/lib/mongodb-mms-automation
sudo chown mongodb:mongodb /var/log/mongodb-mms-automation
sudo chown mongodb:mongodb /data
10

Desde el directorio en el que instalaste el MongoDB Agent y como el usuario del sistema que creaste en el último paso, ejecuta el siguiente comando:

nohup ./mongodb-mms-automation-agent \
--config=local.config \
>> /var/log/mongodb-mms-automation/automation-agent-fatal.log 2>&1 &
11

En el cuadro de diálogo Install Agent Instructions, hacer clic en Done.

12

Volver

Gestionar implementaciones