> 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/install-agent-windows.md). # 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](/es/sonar/deploy-operate/mass-deployment.md). ## 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](/es/sonar/administration/devices/clients-and-sites.md). * El dispositivo cumple los [Requisitos de los dispositivos](/es/sonar/deploy-operate/requirements.md): 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](/es/sonar/deploy-operate/network-requirements.md). * 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----.exe`; * **Get Powershell install script** descarga `sonar---.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----.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. {% hint style="info" %} 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`. {% endhint %} ### 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---.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-windows-.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](/es/sonar/deploy-operate/productivity-module.md) | **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](/es/sonar/deploy-operate/remove-agents.md) | | 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](/es/sonar/deploy-operate/network-requirements.md) | | *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](/es/sonar/deploy-operate/troubleshooting.md) | ## 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:\\meshagent.exe"` | Instala el agente de acceso remoto desde un archivo local en lugar de descargarlo | | `-meshdir "C:\Program Files\\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:\\ca.pem"` | Usa una autoridad de certificación del dominio | | `-desc ""` | Define la **Description** del dispositivo | | `-proxy "http://proxyserver:port"` | Usa un proxy HTTP. Vea [Requisitos de red](/es/sonar/deploy-operate/network-requirements.md#proxies) | ## Páginas relacionadas * [Desplegar agentes a escala](/es/sonar/deploy-operate/mass-deployment.md) * [Requisitos de los dispositivos](/es/sonar/deploy-operate/requirements.md) * [Requisitos de red](/es/sonar/deploy-operate/network-requirements.md) * [El módulo de productividad](/es/sonar/deploy-operate/productivity-module.md) * [Solucionar problemas de los agentes](/es/sonar/deploy-operate/troubleshooting.md)