Instalar el agente MongoDB para administrar implementaciones

Inicie sesión en Cloud Manager.

Iniciar o administrar 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 conjunto de réplicas

   • Nuevo independiente

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

   Haga clic en el enlace see instructions.

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

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, haga clic en RHEL/CentOS (7.X) Energía (ppc64le) - RPM.

Descargue la última versión del Agente MongoDB.

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://cloud.mongodb.com/download/agent/automation/mongodb-mms-automation-agent-manager-latest.ppc64le.rhel7.rpm

Edite el archivo de configuración del agente MongoDB.

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:

Opcional: configure el agente MongoDB para utilizar un servidor proxy.

Para configurar el Agente MongoDB para conectarse a Cloud 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 automation-agent.config en su 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 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

Inicie el agente MongoDB.

Emita el siguiente comando:

sudo service mongodb-mms-automation-agent start

Finalice la instalación del Agente MongoDB.

En el modal Install Agent Instructions:

1. Haga clic en Verify Agent para asegurarse de que el Agente MongoDB pueda conectarse a Cloud Manager.

2. Haga clic en Done.

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

Inicie sesión en Cloud Manager.

Iniciar o administrar 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 conjunto de réplicas

   • Nuevo independiente

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

   Haga 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.

Descargue la última versión del Agente MongoDB.

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://cloud.mongodb.com/download/agent/automation/mongodb-mms-automation-agent-latest.rhel7_ppc64le.tar.gz

Extraiga el agente MongoDB.

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

Cambie al directorio binario extraído.

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

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

Edite el archivo de configuración del agente 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 el agente MongoDB para utilizar un servidor proxy.

Para configurar el Agente MongoDB para conectarse a Cloud 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:

Opcional: Cree los directorios binarios, de registro y de datos.

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

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 Cloud 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. 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. 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>

Asignar permisos al usuario del sistema que ejecuta el Agente 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 agente MongoDB.

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. Haga clic en Verify Agent para asegurarse de que el Agente MongoDB pueda conectarse a Cloud Manager.

2. Haga clic en Done.

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

Inicie sesión en Cloud Manager.

Iniciar o administrar 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 conjunto de réplicas

   • Nuevo independiente

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

   Haga clic en el enlace see instructions.

3. En el menú Select Your Server's Operating System, haga 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. En el menú Install Agent, haga clic en RHEL/CentOS (7.X/8.X/9.X), Amazon Linux2, Amazon Linux 2023 - RPM (ARM).

Descargue la última versión del Agente MongoDB.

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

Edite el archivo de configuración del agente MongoDB.

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:

Opcional: configure el agente MongoDB para utilizar un servidor proxy.

Para configurar el Agente MongoDB para conectarse a Cloud 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 automation-agent.config en su 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 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

Inicie el agente MongoDB.

Emita el siguiente comando:

sudo service mongodb-mms-automation-agent start

Finalice la instalación del Agente MongoDB.

En el modal Install Agent Instructions:

1. Haga clic en Verify Agent para asegurarse de que el Agente MongoDB pueda conectarse a Cloud Manager.

2. Haga clic en Done.

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

Inicie sesión en Cloud Manager.

Iniciar o administrar 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 conjunto de réplicas

   • Nuevo independiente

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

   Haga clic en el enlace see instructions.

3. 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).

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 (8.X/9.X), Amazon Linux 2, Amazon Linux 2023 - TAR (ARM).

Descargue la última versión del Agente MongoDB.

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

Extraiga el agente MongoDB.

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

Cambie al directorio binario extraído.

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

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

Edite el archivo de configuración del agente 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 el agente MongoDB para utilizar un servidor proxy.

Para configurar el Agente MongoDB para conectarse a Cloud 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:

Opcional: Cree los directorios binarios, de registro y de datos.

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

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 Cloud 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. 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. 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>

Asignar permisos al usuario del sistema que ejecuta el Agente 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 agente MongoDB.

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. Haga clic en Verify Agent para asegurarse de que el Agente MongoDB pueda conectarse a Cloud Manager.

2. Haga clic en Done.

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