> 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/remove-agents.md). # Retirar agentes Quite el agente SONAR desde el menú de acciones del dispositivo, desinstálelo localmente en Windows, Linux o macOS, o archive el dispositivo para conservar su historial. ## Qué es y cuándo usarlo Retirar un agente desinstala SONAR del dispositivo y saca el dispositivo de la consola. Úselo cuando un dispositivo se da de baja, se sustituye o deja de estar bajo su gestión. Hay tres maneras de hacerlo, con resultados distintos: | Acción | Desinstala del dispositivo | Registro del dispositivo en la consola | | ---------------------------------------------------- | --------------------------------------- | -------------------------------------------------------------------------------- | | **Remove Agent** (menú de acciones del dispositivo) | Sí, cuando el dispositivo está en línea | Eliminado, con sus datos | | **Archive Agent** (menú de acciones del dispositivo) | Sí, cuando el dispositivo está en línea | Conservado, con su historial, marcado como archivado | | Desinstalación local en el dispositivo | Sí | Conservado; el dispositivo queda fuera de línea hasta que lo quite en la consola | ## Antes de empezar * **Remove Agent** requiere **Uninstall Agents** en **Admin Center › Roles**. **Archive Agent** requiere **Edit Agent**. Ambas acciones solo funcionan en dispositivos de sitios a los que su rol le da acceso. * Decida si aún necesita el historial del dispositivo en la consola. **Remove Agent** lo elimina; **Archive Agent** lo conserva. * Para una desinstalación local, necesita derechos de administrador en Windows o `root` en Linux y macOS. ## Pasos ### Retirar un agente desde la consola 1. En **Dashboard › Sysadmin**, seleccione el dispositivo. 2. Abra el menú de acciones del dispositivo (**Other actions**, en la cabecera del panel de detalles) y elija **Remove Agent**. 3. SONAR comprueba primero si el dispositivo responde. * Si no responde, el cuadro de diálogo **Agent offline** muestra *… cannot be contacted. Would you like to continue with the uninstall? If so, the agent will need to be manually uninstalled from the computer.* Haga clic en **Yes** para continuar o en **No** para detenerse. 4. En **Remove \**, escriba el **Reason**. Es obligatorio y se guarda en el registro de auditoría. 5. Haga clic en **Remove Agent**. ### Archivar un agente 1. Seleccione el dispositivo y abra el menú de acciones del dispositivo. 2. Elija **Archive Agent**. 3. En **Archive Agent**, escriba `yes` para confirmar y haga clic en **Archive**. **Archive Agent** desinstala el agente del dispositivo igual que **Remove Agent**, pero el registro del dispositivo y su historial permanecen en la consola. SONAR no genera alertas para un dispositivo archivado, y los dispositivos archivados no se cuentan entre los dispositivos en línea, fuera de línea o con retraso. **Unarchive Agent**, en el mismo menú, quita la marca de archivado. No reinstala nada: para volver a gestionar el dispositivo, instale el agente en él. El dispositivo entra entonces como un nuevo registro de dispositivo. ### Desinstalar localmente en Windows En un símbolo del sistema con privilegios elevados: ``` "C:\Program Files\Sonar\uninstall.exe" /S ``` Para un agente de 32 bits en un Windows de 64 bits, el desinstalador es `C:\Program Files (x86)\Sonar\uninstall.exe`. El agente también se puede quitar como **Sonar** desde la lista de programas instalados de Windows. ### Desinstalar localmente en Linux Ejecute como root el script de instalación de Linux obtenido en **Agents › Install Agent**, con el argumento `uninstall`: ```bash sudo bash ./sonar---.sh uninstall ``` Cualquier script de Linux generado por la consola sirve para esto, sean cuales sean su cliente, su sitio o su expiración. El script se borra a sí mismo al terminar. ### Desinstalar localmente en macOS Como administrador, en Terminal: ```bash sudo /opt/sonarmesh/meshagent -fulluninstall sudo launchctl bootout system /Library/LaunchDaemons/sonaragent.plist sudo rm -rf /opt/sonarmesh /opt/sonaragent /usr/local/mesh_services sudo rm -f /etc/sonaragent.json /Library/LaunchDaemons/sonaragent.plist ``` ## Qué debe ver **Remove Agent** termina con *\ will now be uninstalled.* y el dispositivo sale de la lista de dispositivos. **Archive Agent** termina con *Archived was enabled on \*. Lo que la desinstalación quita del dispositivo: | Plataforma | Se quita | | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Windows | El servicio `sonarrmm`; el servicio del módulo de productividad, `SonarProductivityService`; el agente de acceso remoto; la configuración en `HKLM\SOFTWARE\Sonar`; `C:\ProgramData\Sonar\` y las tareas programadas creadas por SONAR; las carpetas `C:\Program Files\Sonar\` y `C:\Program Files\Mesh Agent\`; la entrada **Sonar** de la lista de programas instalados. La directiva de Windows Update fijada en la instalación se revierte, de modo que Windows vuelve a instalar las actualizaciones automáticamente | | Linux | `sonaragent.service` y su archivo de unidad, `/usr/local/bin/sonaragent`, `/opt/sonaragent/`, `/etc/sonaragent.json`; el agente de acceso remoto, `meshagent.service` y `/opt/sonarmesh/` | | macOS | El launch daemon `sonaragent` y su plist, `/opt/sonaragent/`, `/etc/sonaragent.json`; el agente de acceso remoto y `/opt/sonarmesh/` | Con **Remove Agent** y **Archive Agent**, el dispositivo también se quita del servicio de acceso remoto, de modo que ya no se ofrece el control remoto para él. ## Cómo verificar que funcionó 1. **Consola, Remove Agent:** el dispositivo ya no aparece en **Dashboard › Sysadmin** cuando busca su nombre de host. En **Reports & Audits › Audits**, una entrada **Delete** dice *\ deleted agent \ - \*. 2. **Consola, Archive Agent:** el menú de acciones del dispositivo ofrece ahora **Unarchive Agent**. 3. **Dispositivo Windows:** `sc query sonarrmm` devuelve *The specified service does not exist as an installed service*, y `C:\Program Files\Sonar\` ya no existe. 4. **Dispositivo Linux:** `systemctl status sonaragent` indica que no se encontró la unidad. 5. **Dispositivo macOS:** `sudo launchctl print system/sonaragent` indica que no se encontró el servicio. ## Errores comunes | Síntoma | Causa | Solución | | ---------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Aparece el cuadro de diálogo **Agent offline** | El dispositivo está apagado o no puede llegar a SONAR, así que no se puede entregar el comando de desinstalación | Haga clic en **Yes** para quitar el registro y luego desinstale localmente en el dispositivo; o haga clic en **No** y vuelva a intentarlo cuando el dispositivo esté en línea | | El dispositivo se quitó en la consola pero el agente sigue en el equipo | El dispositivo estaba fuera de línea cuando se quitó | Desinstale localmente con los comandos anteriores | | Un dispositivo desinstalado localmente sigue en la lista como fuera de línea | Una desinstalación local no toca la consola | Quítelo con **Remove Agent** y responda **Yes** en **Agent offline** | | **Remove Agent** sigue deshabilitado en **Remove \** | El **Reason** está vacío | Escriba un motivo | | **Remove Agent** o **Archive Agent** muestra *You don't have permission for this action* | Su rol no tiene **Uninstall Agents** o **Edit Agent** | Solicite el permiso | | Tras reinstalar, el dispositivo aparece dos veces | Se conservó el registro antiguo (archivado, o desinstalado localmente) y la reinstalación registró uno nuevo | Quite el registro antiguo con **Remove Agent** | ## Páginas relacionadas * [La lista de dispositivos](/es/sonar/administration/devices/device-list.md) * [Instalar el agente en Windows](/es/sonar/deploy-operate/install-agent-windows.md) * [Instalar el agente en Linux](/es/sonar/deploy-operate/install-agent-linux.md) * [Instalar el agente en macOS](/es/sonar/deploy-operate/install-agent-macos.md) * [Registro de auditoría](/es/sonar/administration/audit/audit-trail.md)