Instalar el agente en Windows

Genere un instalador de Windows en Agents › Install Agent, ejecútelo de forma interactiva o silenciosa y confirme que el dispositivo aparece en Sysadmin.

Qué es y cuándo usarlo

Agents › Install Agent genera un instalador para un cliente y un sitio. El instalador registra el dispositivo en ese sitio, instala el servicio del agente de SONAR y el agente de acceso remoto, y aplica las funciones opcionales que usted seleccionó. Úselo para incorporar un solo dispositivo Windows o unos pocos. Para cientos de dispositivos, reutilice un mismo instalador con su herramienta de distribución de software, o use un enlace de despliegue: vea Desplegar agentes a escala.

Antes de empezar

• Su rol tiene el permiso Install Agents en Admin Center › Roles. Sin él, el botón de generación permanece deshabilitado con You don't have permission for this action.

• El cliente y el sitio existen, y su rol le da acceso a ese sitio. Vea Clientes y sitios.

• El dispositivo cumple los Requisitos de los dispositivos: Windows 10, Windows 11 o Windows Server 2016 y posteriores, y usted tiene derechos de administrador local en él.

• El dispositivo puede alcanzar las direcciones de la API y de acceso remoto de SONAR en 443/tcp. Vea Requisitos de red.

• Las exclusiones de antivirus y EDR están configuradas para C:\Program Files\Sonar\, C:\Program Files\Mesh Agent\ y C:\ProgramData\Sonar\.

Pasos

Generar el instalador

1. Abra Agents › Install Agent desde la cabecera, o haga clic en New Agent en la lista de dispositivos de Dashboard › Sysadmin. Se abre el panel Add an agent.

2. Elija el Client y el Site.

3. En Operating system, seleccione Windows.

4. En Agent type, seleccione Workstation o Server.

5. En Architecture, seleccione 64-bit o 32-bit, según el sistema operativo del dispositivo.

6. En Optional features, active o desactive cada función. Lo que cada una cambia en el dispositivo figura en la referencia de campos más abajo.

7. En Installation method, elija Dynamic (.exe), PowerShell o Manual.

8. Para limitar durante cuánto tiempo funciona el instalador, active Enable token expiration (hours) e indique el número de horas en Hours.

9. Revise el resumen Target en la parte inferior del panel y haga clic en el botón del método elegido:

   • Download Windows installer (.exe) descarga sonar-<client>-<site>-<type>-<architecture>.exe;

   • Get Powershell install script descarga sonar-<client>-<site>-<type>.ps1;

   • View manual setup instructions abre el cuadro de diálogo Manual Installation.

Ejecutar el instalador Dynamic (.exe) de forma interactiva

1. Copie el archivo al dispositivo y ejecútelo. Acepte la solicitud de elevación de privilegios.

2. Siga las páginas del instalador. Cerca del final, el agente muestra Installation was successful! Allow a few minutes for the agent to properly display in the RMM. Haga clic en OK.

3. Cuando el instalador termina, un cuadro de estado Sonar RMM muestra el estado del agente y del agente de acceso remoto.

Ejecutar el instalador Dynamic (.exe) en modo silencioso

Ejecute el archivo con /S desde un símbolo del sistema con privilegios elevados o desde su herramienta de despliegue:

sonar-<client>-<site>-<type>-<architecture>.exe /S

/S oculta las páginas del instalador. El archivo lleva todos los ajustes elegidos en la consola, así que no hace falta ningún otro argumento.

Si se ejecuta desde una sesión interactiva, con un usuario conectado, el agente sigue mostrando su cuadro de mensaje final y espera a que se pulse OK, incluso con /S. Las herramientas que ejecutan el archivo como Local System en segundo plano, como un script de inicio de GPO o la mayoría de las herramientas de distribución de software, no muestran nada. Para una ejecución desatendida dentro de una sesión de usuario, use el script de PowerShell o el comando manual con -silent.

Ejecutar el script de PowerShell

1. Copie el archivo .ps1 al dispositivo.

2. En una ventana de PowerShell con privilegios elevados, ejecútelo:

   powershell -ExecutionPolicy Bypass -File .\sonar-<client>-<site>-<type>.ps1

El script se detiene de inmediato con Sonar RMM Is Already Installed si el servicio sonarrmm existe. Si no, espera a que la dirección de la API responda en el 443 (hasta tres intentos, mostrando Waiting for network), añade las carpetas de SONAR a las exclusiones de Microsoft Defender cuando Defender está activo, descarga el instalador, lo instala en modo silencioso y registra el agente con -silent, de modo que no aparece ningún cuadro de mensaje.

Ejecutar el comando manual

1. En el cuadro de diálogo Manual Installation, haga clic en Download Agent para descargar sonaragent-v<version>-windows-<architecture>.exe.

2. Haga clic en Copy Command Line.

3. En el dispositivo, abra un símbolo del sistema con privilegios elevados en la carpeta que contiene el archivo descargado.

4. Pegue el comando, añada los Optional Arguments que necesite (por ejemplo -silent o -desc "Front desk PC") y pulse Intro.

El comando instala el archivo descargado en modo silencioso, espera unos diez segundos y luego ejecuta el registro del agente con el cliente, el sitio, el tipo, el token y las funciones opcionales elegidos en la consola.

Qué debe ver

En el dispositivo, tres servicios cuando se selecciona el módulo de productividad, y dos en caso contrario:

Nombre del servicio	Nombre para mostrar	Qué es
sonarrmm	Sonar Agent Service	El agente de SONAR. Ejecuta C:\Program Files\Sonar\sonarrmm.exe -m svc como Local System
Mesh Agent	Mesh Agent	El agente de acceso remoto, en C:\Program Files\Mesh Agent\
SonarProductivityService	Sonar Productivity Service	El módulo de productividad, instalado solo cuando Sessions está activado. Vea El módulo de productividad

Sonar, editor DataDike®, aparece en la lista de programas instalados.

En la consola, el dispositivo aparece en Dashboard › Sysadmin, bajo su cliente y su sitio, en pocos minutos, con Agent Status Online.

Qué cambia el instalador en el dispositivo

Cambio	Cuándo
Windows Update se configura para no instalar actualizaciones automáticamente (directiva AUOptions en HKLM\SOFTWARE\Policies\Microsoft\Windows\WindowsUpdate\AU), para que la aplicación de actualizaciones se gestione desde SONAR. Al desinstalar el agente se vuelven a activar las actualizaciones automáticas	Siempre
Configuración del agente escrita en HKLM\SOFTWARE\Sonar	Siempre
Tiempos de espera de suspensión, hibernación, disco y pantalla fijados en nunca, acción al cerrar la tapa fijada en no hacer nada, inicio rápido desactivado	Disable sleep/hibernate activado
Escritorio remoto de Windows habilitado, y el grupo de reglas del cortafuegos de Escritorio remoto habilitado	Remote access activado
Regla de cortafuegos ICMP Allow incoming V4 echo request añadida	Ping activado
Servicios de ubicación de Windows activados, para que el agente pueda informar de la posición del dispositivo	Geolocation activado
Módulo de productividad instalado como SonarProductivityService	Sessions activado

Cómo verificar que funcionó

1. En el dispositivo, ejecute "C:\Program Files\Sonar\sonarrmm.exe" sin argumentos. El cuadro de estado Sonar RMM lista Agent y Mesh Agent con su estado. Ambos deben estar en ejecución. sc query sonarrmm da la misma respuesta desde un símbolo del sistema.

2. En la consola, abra Dashboard › Sysadmin, elija el cliente y busque el nombre de host. La fila muestra Agent Status Online, el Client y el Site que eligió, el Type que eligió y la fecha de hoy en First Seen.

3. Seleccione la fila. La cabecera del panel de detalles muestra la versión del agente, y ningún indicador Remote Offline una vez que el agente de acceso remoto se ha conectado.

4. En Reports & Audits › Audits, una entrada Agent Install registra el nuevo agente con su nombre de host.

Errores comunes

Síntoma	Causa	Solución
This application requires a 64-bit Windows operating system.	Se ejecutó el instalador de 64 bits en un Windows de 32 bits	Vuelva a generar el instalador con Architecture 32-bit
Installer token has expired. Please generate a new one.	El instalador se generó con Enable token expiration (hours) y ese plazo ya pasó	Genere un nuevo instalador
Old installer detected (version …). Latest version is … Please generate a new installer from the RMM	El instalador se guardó antes de que cambiara la versión del agente de SONAR	Genere un nuevo instalador
Un cuadro de mensaje dice Existing installation found, con OK para eliminarla y Cancel para cancelar	El dispositivo ya tiene un agente	Haga clic en OK para desinstalarlo y vuelva a ejecutar el instalador. Vea Retirar agentes
Una ejecución silenciosa termina de inmediato y no se instala nada; la salida dice Existing installation found and must be removed before attempting to reinstall.	El dispositivo ya tiene un agente, o lo que queda de uno	Ejecute "C:\Program Files\Sonar\uninstall.exe" /S y vuelva a ejecutar el instalador
Sonar RMM Is Already Installed (PowerShell)	El servicio sonarrmm existe	Desinstale primero y vuelva a ejecutar el script
Unable to connect to server (PowerShell)	El 443/tcp hacia la dirección de la API está bloqueado	Vea Requisitos de red
Unable to download the mesh agent from the RMM. o Failed to download mesh agent	El instalador no pudo obtener el agente de acceso remoto a través de la dirección de la API	Compruebe la conectividad con la dirección de la API y vuelva a ejecutar el instalador
El botón de generación está deshabilitado	No hay ningún cliente o sitio seleccionado, o su rol no tiene Install Agents	Seleccione ambos, o solicite el permiso
El dispositivo está instalado pero no aparece en Sysadmin	El agente no consigue mantener su conexión con la dirección de la API	Vea Solucionar problemas de los agentes

Referencia de campos

Campo	Qué hace	Valores aceptados	Valor predeterminado
Client	Cliente en el que se registra el dispositivo	Clientes a los que su rol da acceso	Primer cliente de la lista
Site	Sitio en el que se registra el dispositivo	Sitios del cliente elegido	Primer sitio del cliente
Operating system	Plataforma del instalador	Windows, Linux, macOS	Windows
Agent type	Registra el dispositivo como estación de trabajo o como servidor. Define la columna Type y la programación predeterminada de Windows Update del dispositivo	Workstation, Server	Workstation
Architecture	Arquitectura de procesador del instalador	64-bit, 32-bit	64-bit
Sessions	Instala el módulo de productividad, que informa de la actividad y las sesiones de los usuarios y aplica las políticas de acceso	Activado, desactivado	Activado
Geolocation	Activa los servicios de ubicación de Windows e informa de la posición del dispositivo aproximadamente una vez por hora	Activado, desactivado	Activado
Remote access	Habilita el Escritorio remoto de Windows en el dispositivo y sus reglas de cortafuegos. El agente de acceso remoto de SONAR se instala tanto si esta opción está activada como si no	Activado, desactivado	Activado
Ping	Añade una regla de cortafuegos para que el dispositivo responda al ping (eco ICMPv4)	Activado, desactivado	Activado
Disable sleep/hibernate	Impide que el dispositivo entre en suspensión o hibernación. Solo se muestra para Workstation	Activado, desactivado	Activado
Installation method	Salida que produce la consola	Dynamic (.exe), PowerShell, Manual	Dynamic (.exe)
Enable token expiration (hours)	Si está activado, el instalador deja de funcionar tras el número de horas indicado	Activado, desactivado; Hours de 1 a 999999	Desactivado; 24 horas al activarlo

Las funciones opcionales quedan fijadas en la instalación. Para cambiarlas en un dispositivo, genere un nuevo instalador y reinstale el agente.

Argumentos opcionales del comando manual

Argumento	Qué hace
-log debug	Salida detallada durante la instalación
-silent	Ningún cuadro de mensaje durante la instalación
-local-mesh "C:\<folder>\meshagent.exe"	Instala el agente de acceso remoto desde un archivo local en lugar de descargarlo
-meshdir "C:\Program Files\<company>\Mesh Agent"	Carpeta de un agente de acceso remoto ya instalado con marca personalizada
-nomesh	No instala el agente de acceso remoto. En ese caso, el control remoto no está disponible en el dispositivo
-cert "C:\<folder>\ca.pem"	Usa una autoridad de certificación del dominio
-desc "<text>"	Define la Description del dispositivo
-proxy "http://proxyserver:port"	Usa un proxy HTTP. Vea Requisitos de red

Páginas relacionadas

• Desplegar agentes a escala

• Requisitos de los dispositivos

• Requisitos de red

• El módulo de productividad

• Solucionar problemas de los agentes