Actualización desde los agentes heredados de copia de seguridad y monitoreo

Inicia sesión en la aplicación de Ops Manager.

Desde el banner de notificaciones, haz clic en Actualizar todos los agentes.

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

Opcional: agrega cualquier opción de configuración existente para tus agentes heredados.

Si la Automatización no gestionó tus agentes de copia de seguridad o supervisión, puedes añadir cualquier configuración de copia de seguridad o supervisión que tuvieras previamente en el paso Add Custom Configuration Options for your MongoDB Agent (Optional).

Para agregar opciones que tenías para tu agente de copias de seguridad y agente de supervisión:

1. En la sección Backup Configurations:

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

   2. Para añadir más de uno Setting, haga clic en el enlace + Add Setting. Aparece otra fila.

   3. Repita hasta que se hayan agregado todos los ajustes.

2. En la sección Monitoring Configurations:

   1. Escriba el ajuste deseado en el cuadro Setting y el valor correspondiente en el cuadro Value.

   2. Para añadir más de uno Setting, haga clic en el enlace + Add Setting. Aparece otra fila.

   3. Repita hasta que se hayan agregado todos los ajustes.

3. Una vez que hayas agregado todos los ajustes necesarios para tu implementación, haz clic en Next.

Puedes hacer clic en el para remover cualquier configuración que hayas añadido.

Descargue el MongoDB Agent.

1. Haz clic en View Agent Install Instructions. El modal Install Agent Instructions se abre.

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

3. Haz clic en Next. El modal Install New MongoDB Agent se abre.

Instalar el MongoDB Agent.

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

• Base URL

  Requerido para la vinculación a un proyecto.

• Project ID (Requerido para vinculación a un proyecto)

• API Key

  Si no tienes una clave de API, haz clic en Generar clave.

Ejecute el instalador de Windows del MongoDB Agent.

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"

Completa la instalación de MongoDB Agent.

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

Verifica que el MongoDB Agent esté en funcionamiento.

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

Haga clic en Next.

(Opcional) Cambia la ubicación de los binarios del MongoDB Agent y de los archivos de copia de seguridad de configuración.

Sus políticas o prácticas del sistema pueden requerir que los binarios de MongoDB y el archivo de copia de seguridad de configuración de Ops Manager se encuentren en un lugar diferente de la ubicación por defecto 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 Binaries de MongoDB Agent

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

2. Debajo del encabezado Download Directory, haz clic en a la derecha de la ruta mostrada en Download Directory (Windows).

3. Cambia la ruta por la nueva que desees.

4. Haga clic en Save.

5. Crea el nuevo directorio que especificaste en cada host que ejecuta un MongoDB Agent. Utiliza el Explorador de Windows para mover el archivo o emite el siguiente comando desde un símbolo del sistema o PowerShell:

   md \<newPath>

   Importante

   Asegúrate de que el usuario del sistema que ejecuta el MongoDB Agent pueda guardar en este nuevo directorio. Normalmente, este es el usuario SYSTEM, que no requiere ninguna configuración adicional a menos que hayas cambiado el usuario.

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

1. Abre el archivo de configuración de MongoDB Agent en tu editor de texto preferido.

2. Cambia la mmsConfigBackup opción a la nueva ruta del archivo de copia de seguridad de la configuración. Reemplaza X en el siguiente ejemplo con la letra de la unidad en la que está almacenada tu copia de seguridad.

   mmsConfigBackup=X:\<newPath>\mms-cluster-config-backup.json

3. Guarda el archivo de configuración del agente MongoDB.

4. Mueve el archivo de copia de seguridad de la configuración al nuevo directorio. Utiliza Windows Explorer para mover el archivo o ejecuta el siguiente comando desde el símbolo del sistema o PowerShell:

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

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

Inicia sesión en la aplicación de Ops Manager.

Desde el banner de notificaciones, haz clic en Actualizar todos los agentes.

La página Update to MongoDB Agent se abre para iniciar el proceso de actualización. Se muestra el paso Introducing the MongoDB Agent. Cuando hayas terminado de leer este paso, haz clic en Next.

Opcional: agrega cualquier opción de configuración existente para tus agentes heredados.

Si la Automatización no gestionó tus agentes de copia de seguridad o supervisión, puedes añadir cualquier configuración de copia de seguridad o supervisión que tuvieras previamente en el paso Add Custom Configuration Options for your MongoDB Agent (Optional).

Para agregar opciones que tenías para tu agente de copias de seguridad y agente de supervisión:

1. En la sección Backup Configurations:

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

   2. Para añadir más de uno Setting, haga clic en el enlace + Add Setting. Aparece otra fila.

   3. Repita hasta que se hayan agregado todos los ajustes.

2. En la sección Monitoring Configurations:

   1. Escriba el ajuste deseado en el cuadro Setting y el valor correspondiente en el cuadro Value.

   2. Para añadir más de uno Setting, haga clic en el enlace + Add Setting. Aparece otra fila.

   3. Repita hasta que se hayan agregado todos los ajustes.

3. Una vez que hayas agregado todos los ajustes necesarios para tu implementación, haz clic en Next.

Puedes hacer clic en el para remover cualquier configuración que hayas añadido.

Instalar el MongoDB Agent.

1. Haz clic en View Agent Install Instructions. El modal Install Agent Instructions se abre.

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

3. Haz clic en Next. El modal Install New MongoDB Agent se abre.

Descargar la última versión del MongoDB Agent.

A partir de este paso, siga el modal de instalación de MongoDB Agent y copie los comandos proporcionados en la shell de Linux.

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

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

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

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

vi <install-path>/local.config

Actualiza las siguientes opciones de configuración:

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

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

Opcional: configure MongoDB Agent para utilizar un servidor proxy.

Para configurar el MongoDB Agent para conectarse a Ops 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 de MongoDB, abre el archivo local.config en tu 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.

Si tienes usuarios existentes de agente de supervisión y/o agente de copias de seguridad y no planeas activar la automatización, solo necesitas crear el directorio de registros.

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 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. Haz 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. 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 textos 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 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 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 &

Verifica que el MongoDB Agent esté en funcionamiento.

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

Haga clic en Next.

Completa la instalación de MongoDB Agent.

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

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