> For the complete documentation index, see [llms.txt](https://wiki.datadike.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.datadike.com/es/sonar/deploy-operate/agent-updates.md). # 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](/es/sonar/deploy-operate/network-requirements.md). ## 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 \**. 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 \*, 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 \** 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: \*. 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](/es/sonar/deploy-operate/troubleshooting.md#registros-del-agente) | | 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](/es/sonar/deploy-operate/troubleshooting.md) | | 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 * [Solucionar problemas de los agentes](/es/sonar/deploy-operate/troubleshooting.md) * [Desplegar agentes a escala](/es/sonar/deploy-operate/mass-deployment.md) * [Requisitos de red](/es/sonar/deploy-operate/network-requirements.md) * [Configuración general](/es/sonar/administration/settings/general.md) * [Notas de versión](/es/sonar/release-notes.md)