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

Inicia sesión en el Cloud Manager.

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

La 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 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 la configuración deseada en el Setting cuadro y el valor correspondiente en el Value cuadro.

   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. Haga clic en View Agent Install Instructions. Se abrirá el cuadro de diálogo Install Agent Instructions.

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

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

Instalar el MongoDB Agent.

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

• Project ID (Necesario para vincularse 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"

Finalice la instalación del Agente MongoDB. En el cuadro de diálogo Install Agent Instructions, haga 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.

Tus políticas o prácticas del sistema pueden requerir que los binarios de MongoDB y el archivo de copia de seguridad de la configuración de Cloud Manager se ubiquen en una ubicación diferente al valor 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. 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 encabezado Download Directory, haz clic en a la derecha de la ruta mostrada en Download Directory (Windows).

4. Cambia la ruta por la nueva que desees.

5. Haga clic en Save.

6. 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ú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 MongoDB Agent

1. Abre el archivo de configuración de MongoDB Agent en tu 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. 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>

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

Inicia sesión en el Cloud Manager.

Desde el banner de notificaciones, haz 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 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 la configuración deseada en el Setting cuadro y el valor correspondiente en el Value cuadro.

   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. Haga clic en View Agent Install Instructions. Se abrirá el cuadro de diálogo Install Agent Instructions.

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

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

Descargar la última versión del MongoDB Agent.

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://cloud.mongodb.com/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 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.

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

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.