Actualización de los agentes de respaldo y monitoreo heredados

Inicie sesión en Cloud Manager.

Desde el banner de notificación, haga clic en Actualizar todos los agentes.

El Update to MongoDB Agent Se abre la página para iniciar el proceso de actualización. Se muestra el paso Introducing the MongoDB Agent. Cuando haya terminado de leer este paso, haga clic en Next.

Agregue cualquier opción de configuración existente para sus agentes heredados.

Si Automation no administró sus agentes de respaldo o monitoreo, puede agregar cualquier configuración de respaldo o monitoreo que tuviera antes en el paso Add Custom Configuration Options for your MongoDB Agent (Optional).

Para agregar las opciones que tenía para su Agente de respaldo y Agente de monitoreo:

1. En la sección Backup Configurations:

   1. Escriba la configuración deseada en el Setting cuadro y su valor correspondiente en el Value cuadro.

   2. Para agregar más de un Setting, haga clic en el enlace + Add Setting. Aparecerá otra fila.

   3. Repita hasta que se hayan agregado todas las configuraciones.

2. En la sección Monitoring Configurations:

   1. Escriba la configuración deseada en el Setting cuadro y el valor correspondiente en el Value cuadro.

   2. Para agregar más de un Setting, haga clic en el enlace + Add Setting. Aparecerá otra fila.

   3. Repita hasta que se hayan agregado todas las configuraciones.

3. Una vez que haya agregado todas las configuraciones necesarias para su implementación, haga clic en Next.

Puede hacer clic para eliminar cualquier configuración que haya agregado.

Instalar el agente MongoDB.

1. Haga clic en View Agent Install Instructions. Se abrirá el cuadro de diálogo Install Agent Instructions.

2. Desde el menú Select Your Server's Operating System, seleccione Windows - MSI.

3. Haga clic en Next. Se abrirá el cuadro de diálogo Install New MongoDB Agent.

Instalar el agente MongoDB.

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

• Project ID (Necesario para vincularse a un proyecto)

• API Key

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

Ejecute el instalador de Windows del agente MongoDB.

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"

Finalice la instalación del Agente MongoDB. En el cuadro de diálogo Install Agent Instructions, haga clic en Done.

Verifique que el agente MongoDB se esté ejecutando.

En el modal Install Agent Instructions, espere a que cada implementación muestre Verified en el paso Install the MongoDB Agent.

Haga clic en Next.

(Opcional) Cambie la ubicación de los archivos binarios y de respaldo de configuración del Agente MongoDB.

Es posible que las políticas o prácticas de su sistema requieran que los archivos binarios de MongoDB y el archivo de respaldo de configuración de Cloud Manager se ubiquen en algún lugar distinto de la ubicación predeterminada de %SystemDrive%\MMSMongoDB\versions.

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. 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. Haz clic en la pestaña Downloads & Settings.

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

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

5. Haga clic en Save.

6. 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 mmsConfigBackup configuración.X En el siguiente ejemplo, reemplace 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>

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

Inicie sesión en Cloud Manager.

Desde el banner de notificación, haga clic en Actualizar todos los agentes.

Se abre la página Update to MongoDB Agent para iniciar el proceso de actualización. Se muestra el paso Introducing the MongoDB Agent. Cuando termine de leer este paso, haga clic en Next.

Opcional: agregue cualquier opción de configuración existente para sus agentes heredados.

Si Automation no administró sus agentes de respaldo o monitoreo, puede agregar cualquier configuración de respaldo o monitoreo que tuviera antes en el paso Add Custom Configuration Options for your MongoDB Agent (Optional).

Para agregar las opciones que tenía para su Agente de respaldo y Agente de monitoreo:

1. En la sección Backup Configurations:

   1. Escriba la configuración deseada en el Setting cuadro y su valor correspondiente en el Value cuadro.

   2. Para agregar más de un Setting, haga clic en el enlace + Add Setting. Aparecerá otra fila.

   3. Repita hasta que se hayan agregado todas las configuraciones.

2. En la sección Monitoring Configurations:

   1. Escriba la configuración deseada en el Setting cuadro y el valor correspondiente en el Value cuadro.

   2. Para agregar más de un Setting, haga clic en el enlace + Add Setting. Aparecerá otra fila.

   3. Repita hasta que se hayan agregado todas las configuraciones.

3. Una vez que haya agregado todas las configuraciones necesarias para su implementación, haga clic en Next.

Puede hacer clic para eliminar cualquier configuración que haya agregado.

Instalar el agente MongoDB.

1. Haga clic en View Agent Install Instructions. Se abrirá el cuadro de diálogo Install Agent Instructions.

2. Desde el menú Select Your Server's Operating System, seleccione Otro Linux - TAR.

3. Haga clic en Next. Se abrirá el cuadro de diálogo Install New MongoDB Agent.

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 Linux genérico de 64bits:

curl -OL https://cloud.mongodb.com/download/agent/automation/mongodb-mms-automation-agent-manager-latest.linux_x86_64.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>.linux_x86_64.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>.linux_x86_64

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.

Si tiene usuarios de Agente de Monitoreo y/o Agente de Respaldo existentes y no planea activar la Automatización, solo necesita crear el directorio de registro.

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

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 &

Verifique que el agente MongoDB se esté ejecutando.

En el modal Install Agent Instructions, espere a que cada implementación muestre Verified en el paso Install the MongoDB Agent.

Haga clic en Next.

Finalice la instalación del Agente MongoDB.

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

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