Instale el Agente de MongoDB para administrar implementaciones

Inicia sesión en el Cloud Manager.

Comienza o administra una implementación.

Su proyecto no tiene implementaciones y ve un aviso para comenzar.

Para crear una nueva implementación:

1. Desde el menú Build New Deployment, seleccione el tipo de implementación que desea agregar:

   • Nuevo clúster fragmentado

   • Nuevo set de réplicas

   • Nuevo independiente

2. Si, en la página Create New Deployment, Cloud Manager no puede detectar ningún host con el MongoDB Agent instalado, verás un banner en la parte superior de la página Create New Deployment.

   Haz clic en el enlace see instructions.

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

4. Haga clic en Next.

Para administrar una implementación existente:

1. Haz clic en Administra tu implementación existente.

2. En el menú Install Agent, haz clic en RHEL/CentOS (7.X) Power (ppc64le) - RPM.

Descargar la última versión del MongoDB Agent.

Desde una shell en el host que ejecutará el MongoDB Agent, emita el siguiente comando curl para descargar el instalador para RHEL 7 para PowerPC:

curl -OL https://cloud.mongodb.com/download/agent/automation/mongodb-mms-automation-agent-manager-latest.ppc64le.rhel7.rpm

Edita el archivo de configuración del agente de MongoDB.

En el directorio donde instalaste el agente MongoDB, abre el archivo automation-agent.config en tu editor de texto preferido.

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

Actualice las siguientes opciones de configuración:

Opcional: configure MongoDB Agent para utilizar un servidor proxy.

Para configurar el MongoDB Agent para conectarse a Cloud Manager a través de un servidor proxy, debes especificar el servidor en la variable de entorno httpProxy.

En el directorio donde instalaste el agente MongoDB, abre el archivo automation-agent.config en tu editor de texto preferido.

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

Agregue la siguiente clave de configuración:

Prepara el directorio de datos.

El directorio de datos almacena los datos de MongoDB y debe ser propiedad del usuario mongod. Para una implementación existente de MongoDB, se debe asegurar que el directorio tenga al usuario mongod como propietario. Si no existe una implementación de MongoDB, crea el directorio y establece 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

Inicie el MongoDB Agent.

Ejecutes el siguiente comando:

sudo service mongodb-mms-automation-agent start

Finalice la instalación del Agente MongoDB.

En el modal Install Agent Instructions:

1. Haz clic en Verify Agent para asegurarte de que el MongoDB Agent pueda conectarse a Cloud Manager.

2. Haga clic en Done.

Repita el procedimiento de instalación para cada host MongoDB.

Inicia sesión en el Cloud Manager.

Comienza o administra una implementación.

Su proyecto no tiene implementaciones y ve un aviso para comenzar.

Para crear una nueva implementación:

1. Desde el menú Build New Deployment, seleccione el tipo de implementación que desea agregar:

   • Nuevo clúster fragmentado

   • Nuevo set de réplicas

   • Nuevo independiente

2. Si, en la página Create New Deployment, Cloud Manager no puede detectar ningún host con el MongoDB Agent instalado, verás un banner en la parte superior de la página Create New Deployment.

   Haz clic en el enlace see instructions.

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

4. Haga clic en Next.

Para administrar una implementación existente:

1. Haz clic en Administra tu implementación existente.

2. En el menú Install Agent, haga clic en RHEL/CentOS (7.X) Power (ppc64le) - TAR.

Descargar la última versión del MongoDB Agent.

Desde una shell en el host que ejecutará el MongoDB Agent, emita el siguiente comando curl para descargar el instalador para RHEL 7 para PowerPC:

curl -OL https://cloud.mongodb.com/download/agent/automation/mongodb-mms-automation-agent-latest.rhel7_ppc64le.tar.gz

Extrae el MongoDB Agent.

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

Para instalar el MongoDB Agent, descomprime el fichero:

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

Cambiar al directorio binario extraído.

Cambia al directorio que se creó después de extraer el binario de MongoDB Agent:

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

Edita el archivo de configuración del agente de MongoDB.

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:

Opcional: configure MongoDB Agent para utilizar un servidor proxy.

Para configurar el MongoDB Agent para conectarse a Cloud Manager a través de un servidor proxy, debes especificar el servidor en la variable de entorno httpProxy.

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:

Opcional: cree los directorios binarios, registro y directorio de datos.

Crea los siguientes directorios para almacenar los archivos que necesita el MongoDB Agent.

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

Por defecto, los binarios del agente y el archivo de copia de seguridad de la configuración de Cloud Manager se localizan 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. En MongoDB Cloud Manager, ve a la página Agents de tu proyecto.

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

   2. Si aún no aparece, selecciona el proyecto deseado en el menú Projects de la barra de navegación.

   3. En la barra lateral, haz clic en Agents en la sección Database.

   Se muestra la página Agentes.

2. Cambiar la ruta.

   1. Haga clic 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. Cambia la ruta por la nueva que desees.

   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 mmsConfigBackup a la nueva ruta para el archivo de copia de seguridad de configuración.

   mmsConfigBackup=/<newPath>/mms-cluster-config-backup.json

3. Guarda el archivo de configuración del Agente.

4. Mueve el archivo de copia de seguridad de la configuración al nuevo directorio.

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

Asignar permisos al usuario del sistema que ejecuta el agente de MongoDB.

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

Inicie el MongoDB Agent.

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 &

Finalice la instalación del Agente MongoDB.

En el modal Install Agent Instructions:

1. Haz clic en Verify Agent para asegurarte de que el MongoDB Agent pueda conectarse a Cloud Manager.

2. Haga clic en Done.

Repita el procedimiento de instalación para cada host MongoDB.

Inicia sesión en el Cloud Manager.

Comienza o administra una implementación.

Su proyecto no tiene implementaciones y ve un aviso para comenzar.

Para crear una nueva implementación:

1. Desde el menú Build New Deployment, seleccione el tipo de implementación que desea agregar:

   • Nuevo clúster fragmentado

   • Nuevo set de réplicas

   • Nuevo independiente

2. Si, en la página Create New Deployment, Cloud Manager no puede detectar ningún host con el MongoDB Agent instalado, verás un banner en la parte superior de la página Create New Deployment.

   Haz clic en el enlace see instructions.

3. Desde el menú Select Your Server's Operating System, haz clic en RHEL/CentOS (7.X/8.X/9.X), Amazon Linux2, Amazon Linux 2023 - RPM (ARM).

4. Haga clic en Next.

Para administrar una implementación existente:

1. Haz clic en Administra tu implementación existente.

2. Desde el menú Install Agent, haz clic en RHEL/CentOS (7.X/8.X/9.X), Amazon Linux2, Amazon Linux 2023 - RPM (ARM).

Descargar la última versión del MongoDB Agent.

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/9.x o Amazon Linux 2 para ARM64:

curl -OL https://cloud.mongodb.com/download/agent/automation/mongodb-mms-automation-agent-manager-latest.aarch64.amzn2.rpm

Edita el archivo de configuración del agente de MongoDB.

En el directorio donde instalaste el agente MongoDB, abre el archivo automation-agent.config en tu editor de texto preferido.

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

Actualice las siguientes opciones de configuración:

Opcional: configure MongoDB Agent para utilizar un servidor proxy.

Para configurar el MongoDB Agent para conectarse a Cloud Manager a través de un servidor proxy, debes especificar el servidor en la variable de entorno httpProxy.

En el directorio donde instalaste el agente MongoDB, abre el archivo automation-agent.config en tu editor de texto preferido.

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

Agregue la siguiente clave de configuración:

Prepara el directorio de datos.

El directorio de datos almacena los datos de MongoDB y debe ser propiedad del usuario mongod. Para una implementación existente de MongoDB, se debe asegurar que el directorio tenga al usuario mongod como propietario. Si no existe una implementación de MongoDB, crea el directorio y establece 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

Inicie el MongoDB Agent.

Ejecutes el siguiente comando:

sudo service mongodb-mms-automation-agent start

Finalice la instalación del Agente MongoDB.

En el modal Install Agent Instructions:

1. Haz clic en Verify Agent para asegurarte de que el MongoDB Agent pueda conectarse a Cloud Manager.

2. Haga clic en Done.

Repita el procedimiento de instalación para cada host MongoDB.

Inicia sesión en el Cloud Manager.

Comienza o administra una implementación.

Su proyecto no tiene implementaciones y ve un aviso para comenzar.

Para crear una nueva implementación:

1. Desde el menú Build New Deployment, seleccione el tipo de implementación que desea agregar:

   • Nuevo clúster fragmentado

   • Nuevo set de réplicas

   • Nuevo independiente

2. Si, en la página Create New Deployment, Cloud Manager no puede detectar ningún host con el MongoDB Agent instalado, verás un banner en la parte superior de la página Create New Deployment.

   Haz clic en el enlace see instructions.

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

4. Haga clic en Next.

Para administrar una implementación existente:

1. Haz clic en Administra tu implementación existente.

2. Desde el menú Install Agent, haz clic en RHEL/CentOS (8.X/9.X), Amazon Linux 2, Amazon Linux 2023 - TAR (ARM).

Descargar la última versión del MongoDB Agent.

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/9.x o Amazon Linux 2 para ARM64:

curl -OL https://cloud.mongodb.com/download/agent/automation/mongodb-mms-automation-agent-latest.amzn2_aarch64.tar.gz

Extrae el MongoDB Agent.

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

Para instalar el MongoDB Agent, descomprime el fichero:

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

Cambiar al directorio binario extraído.

Cambia al directorio que se creó después de extraer el binario de MongoDB Agent:

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

Edita el archivo de configuración del agente de MongoDB.

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:

Opcional: configure MongoDB Agent para utilizar un servidor proxy.

Para configurar el MongoDB Agent para conectarse a Cloud Manager a través de un servidor proxy, debes especificar el servidor en la variable de entorno httpProxy.

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:

Opcional: cree los directorios binarios, registro y directorio de datos.

Crea los siguientes directorios para almacenar los archivos que necesita el MongoDB Agent.

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

Por defecto, los binarios del agente y el archivo de copia de seguridad de la configuración de Cloud Manager se localizan 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. En MongoDB Cloud Manager, ve a la página Agents de tu proyecto.

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

   2. Si aún no aparece, selecciona el proyecto deseado en el menú Projects de la barra de navegación.

   3. En la barra lateral, haz clic en Agents en la sección Database.

   Se muestra la página Agentes.

2. Cambiar la ruta.

   1. Haga clic 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. Cambia la ruta por la nueva que desees.

   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 mmsConfigBackup a la nueva ruta para el archivo de copia de seguridad de configuración.

   mmsConfigBackup=/<newPath>/mms-cluster-config-backup.json

3. Guarda el archivo de configuración del Agente.

4. Mueve el archivo de copia de seguridad de la configuración al nuevo directorio.

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

Asignar permisos al usuario del sistema que ejecuta el agente de MongoDB.

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

Inicie el MongoDB Agent.

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 &

Finalice la instalación del Agente MongoDB.

En el modal Install Agent Instructions:

1. Haz clic en Verify Agent para asegurarte de que el MongoDB Agent pueda conectarse a Cloud Manager.

2. Haga clic en Done.

Repita el procedimiento de instalación para cada host MongoDB.