September 22 — Documentation updated for compatibility with the latest PAM version (5.3.0).
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Actualizar agentes

Cómo los agentes SONAR se actualizan solos cada hora, el ajuste que lo controla, qué hace el dispositivo durante la actualización y cómo comprobar la versión.

Qué es y cuándo usarlo

Cuando SONAR pasa a una nueva versión del agente, los agentes ya instalados se actualizan solos: no hace falta reinstalarlos. Esta página explica cómo llega esa actualización a cada dispositivo, qué hace el dispositivo mientras se actualiza, cómo seguir las actualizaciones en la consola y cómo comprobar qué versión ejecuta un dispositivo.

Antes de empezar

  • Para ver el ajuste de actualización automática, su rol tiene View Core Settings en Admin Center › Roles.

  • Para seguir las actualizaciones en Agents › Pending Actions, tiene List Pending Actions.

  • Los dispositivos deben poder descargar desde la dirección de la API de SONAR por 443/tcp, a través del proxy configurado en la instalación, si lo hay. Consulte Requisitos de red.

Cómo llegan las actualizaciones a los dispositivos

  1. La actualización automática se controla con Enable agent automatic self update en Admin Center › Settings, pestaña General (texto de ayuda Runs at 35mins past every hour). La consola muestra la opción en modo de solo lectura; se activa o desactiva con el soporte de implantación de DataDike.

  2. Mientras está activada, a los 35 minutos de cada hora SONAR busca los agentes que ejecutan una versión anterior a la versión actual del agente y envía a cada uno un comando de actualización por su conexión.

  3. Para cada uno de esos dispositivos se registra una acción pendiente Agent update to <version>. La columna Due muestra la hora del próximo ciclo de actualización.

  4. El dispositivo descarga el nuevo agente desde la dirección de la API y lo instala (vea más abajo). Su servicio se reinicia ya con la nueva versión.

  5. En cuanto el dispositivo vuelve a estar Online e informa de la nueva versión, SONAR marca la acción pendiente como completada, en un par de minutos.

Un dispositivo apagado o desconectado a los 35 minutos de la hora no recibe el comando. El ciclo de la hora siguiente lo vuelve a enviar, de modo que el dispositivo se actualiza en el primer ciclo después de reconectarse. No hay nada que programar por dispositivo.

Qué hace el dispositivo durante una actualización

Plataforma
Pasos

Windows

Espera un tiempo aleatorio de 1 a 15 segundos, descarga el instalador de la actualización en C:\ProgramData\Sonar\ y lo ejecuta en modo silencioso. El instalador detiene el servicio sonarrmm, reemplaza sonarrmm.exe, vuelve a registrar el servicio y lo inicia

Linux

Descarga el nuevo agente junto a /usr/local/bin/sonaragent, reemplaza el archivo, restaura su contexto SELinux donde SELinux está en modo enforcing y reinicia sonaragent.service

macOS

Descarga el nuevo agente junto a /opt/sonaragent/sonaragent, reemplaza el archivo y reinicia el launch daemon sonaragent

Lo que no cambia:

  • la configuración del agente, es decir, el cliente, el sitio, el tipo y las funciones opcionales elegidas en la instalación;

  • el agente de acceso remoto;

  • en Windows, el módulo de productividad (SonarProductivityService).

El dispositivo solo queda inalcanzable desde la consola durante los segundos que tarda el servicio en reiniciarse.

Qué debe ver

  • En Agents › Pending Actions (All Pending Actions), filas con el icono de actualización, Description Agent update to <version>, y el Agent, el Client y el Site de cada dispositivo que espera la actualización. Salen de la lista a medida que los dispositivos completan la actualización; Show N Completed las vuelve a mostrar.

  • En Dashboard › Sysadmin, la columna Pending Actions cuenta las acciones pendientes de cada dispositivo, incluida la actualización.

  • En un dispositivo, Pending Agent Actions, en el menú de acciones del dispositivo, abre Pending Actions for <hostname> con la misma información, solo para ese dispositivo.

Cómo verificar que funcionó

  1. En Dashboard › Sysadmin, seleccione el dispositivo. La cabecera del panel de detalles muestra la versión del agente junto al nombre del host.

  2. En Agents › Pending Actions, el dispositivo ya no tiene una fila Agent update pendiente. Con Show N Completed, su actualización aparece como Completed.

  3. En el propio dispositivo:

    • Windows: ejecute "C:\Program Files\Sonar\sonarrmm.exe" -version; la primera línea dice Sonar RMM Agent: <version>. Ejecutar "C:\Program Files\Sonar\sonarrmm.exe" sin argumentos muestra la versión en el título del cuadro de estado Sonar RMM.

    • Linux: /usr/local/bin/sonaragent -version.

    • macOS: /opt/sonaragent/sonaragent -version.

Errores comunes

Síntoma
Causa
Solución

La acción pendiente Agent update de un dispositivo sigue ahí durante varios ciclos

El dispositivo está fuera de línea, o no puede descargar desde la dirección de la API

Revise Agent Status y Last Response. Si el dispositivo está en línea, compruebe que alcanza la dirección de la API por 443/tcp y luego busque errores de descarga en el registro del agente. Consulte Solucionar problemas de los agentes

Un dispositivo Windows deja de informar tras un ciclo de actualización

El servicio sonarrmm no se está ejecutando en el dispositivo

En el dispositivo, inicie el servicio sonarrmm; si no existe, reinstale el agente. Consulte Solucionar problemas de los agentes

No aparece ninguna fila Agent update aunque hay dispositivos con una versión anterior

Enable agent automatic self update está desactivado en la instancia

Contacte con el soporte de implantación de DataDike

Un instalador guardado antes de la nueva versión se detiene con Old installer detected

Los instaladores llevan la versión del agente con la que se generaron

Genere un nuevo instalador. Los agentes ya instalados no se ven afectados, porque se actualizan solos

Páginas relacionadas

Atualizado

Isto foi útil?