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 <hostname>, 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:

sudo bash ./sonar-<client>-<site>-<type>.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:

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 <hostname> will now be uninstalled. y el dispositivo sale de la lista de dispositivos. Archive Agent termina con Archived was enabled on <hostname>.

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 <user> deleted agent <hostname> - <reason>.

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

• Instalar el agente en Windows

• Instalar el agente en Linux

• Instalar el agente en macOS

• Registro de auditoría