> 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/get-started/first-device.md). # Incorpore su primer dispositivo De una consola vacía a un primer dispositivo en línea: cree un cliente y un sitio, genere el instalador del agente, ejecútelo y confirme que el dispositivo informa. ## Qué es y cuándo usarlo Un dispositivo aparece en SONAR en cuanto el agente se instala en él, y el agente siempre se instala en un **sitio** de un **cliente**. Esta página recorre el camino completo una vez (cliente, sitio, instalador, instalación, verificación) para que conozca cada pantalla antes de desplegar agentes a escala. ## Antes de empezar * Un usuario de SONAR cuyo rol conceda **Manage Clients** y **Manage Sites** (para crear el cliente y el sitio), **Install Agents** (para generar el instalador) y **List Agents** (para ver el dispositivo en Sysadmin). Si su rol está limitado a algunos clientes, un cliente que usted cree se añade a los **Allowed Clients** de su rol. * Un equipo con una versión compatible de Windows, Linux o macOS, y una cuenta con derechos de administrador en él (root en Linux y macOS). Vea [Requisitos de los dispositivos](/es/sonar/deploy-operate/requirements.md). * Ese equipo puede abrir conexiones HTTPS salientes por el puerto 443 hacia las direcciones de su SONAR. Vea [Requisitos de red](/es/sonar/deploy-operate/network-requirements.md). ## Pasos 1. Abra **Management › Create › Client**. 2. En **Name**, escriba el nombre del cliente, por ejemplo `CLIENT-A`. 3. En **Default first site**, escriba el nombre de su primer sitio, por ejemplo `SITE-01`, y haga clic en **Save**. El cliente y su sitio se crean a la vez. 4. Para añadir más sitios después, abra **Management › Create › Site**, elija el **Client**, escriba el **Name** y guarde. 5. Abra **Agents › Install Agent**. Se abre la ventana **Add an agent**. 6. Elija el **Client** y el **Site** a los que pertenece el dispositivo. 7. Elija el **Operating system**, el **Agent type** (**Workstation** o **Server**) y la **Architecture** del equipo. 8. En Windows, revise las **Optional features** y elija el **Installation method**. **Dynamic (.exe)** es el más sencillo. 9. Deje **Enable token expiration (hours)** desactivado para una primera prueba, o actívelo y fije cuántas horas sigue siendo válido el instalador. 10. Haga clic en el botón de la parte inferior de la ventana (por ejemplo, **Download Windows installer (.exe)**) y lleve el archivo o el comando al equipo. 11. Ejecute el instalador en el equipo con derechos de administrador. Los pasos para cada sistema están en [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) e [Instalar el agente en macOS](/es/sonar/deploy-operate/install-agent-macos.md). 12. En la consola, abra **Dashboard › Sysadmin** y haga clic en la tarjeta de su cliente en el **Clients overview**. 13. Busque el dispositivo por su nombre de host, o escríbalo en **Search devices...**, y seleccione la fila. {% hint style="info" %} Si la consola todavía no tiene ningún cliente, al abrir **Dashboard › Sysadmin** se muestra **Initial Setup** en lugar del Clients overview. Esa pantalla crea el primer cliente y el primer sitio en un solo formulario: rellene **Add Client** y **Add Site**, elija el **Default timezone for agents** y haga clic en **Finish**. Después continúe desde el paso 5. {% endhint %} ## Qué debe ver * Tras **Save**, el mensaje `CLIENT-A was added`, y el cliente aparece como una tarjeta en el **Clients overview**. Un sitio añadido por separado devuelve `Site SITE-02 was added!`. * Con **Dynamic (.exe)**, un mensaje que indica que ahora se descargará el instalador de su cliente y su sitio, si caduca, y que no hacen falta argumentos de línea de comandos. El archivo lleva el nombre del cliente, del sitio, del tipo de agente y de la arquitectura, por ejemplo `sonar-clienta-SITE-01-workstation-amd64.exe`. * Con los otros métodos, un script para descargar o un comando para copiar. * En Sysadmin, la tarjeta del cliente cuenta un dispositivo, y la lista de dispositivos muestra una fila para el equipo nuevo. ## Cómo verificar que funcionó En **Dashboard › Sysadmin**, en la fila del dispositivo: * **Agent Status** muestra **ONLINE**. * **Last Response** muestra una hora del último minuto o de los dos últimos, y **First Seen** muestra cuándo se registró el agente. * **Client**, **Site** y **Type** coinciden con lo que eligió en el instalador. Seleccione la fila. En la pestaña **Home** del panel del dispositivo: * la barra superior muestra **Online** y, una vez que el agente de acceso remoto se ha conectado, **Remote Online**; * **Hardware Details** está completo (modelo, procesador, sistema operativo, memoria, red) a los pocos minutos de la instalación. En Linux y macOS, los campos que el sistema no comunica muestran `Not available`. Después abra **Reports & Audits › Audits**: hay una entrada **Agent Install** para el nombre de host del dispositivo. En el propio equipo, el servicio del agente está en ejecución: **Sonar Agent Service** (`sonarrmm`) en Windows, `sonaragent` en Linux y macOS. El dashboard **Home** cuenta el dispositivo nuevo en pocos minutos, la próxima vez que se recalculan sus cifras. ## Errores comunes | Síntoma | Causa | Solución | | --------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Create** › **Client**, **Install Agent** o **New Agent** aparece atenuado con `You don't have permission for this action` | Al rol le falta **Manage Clients**, **Manage Sites** o **Install Agents** | Pida a un administrador que conceda el permiso en **Admin Center › Roles** | | `client with this name already exists.` | Los nombres de cliente son únicos en toda la consola | Elija otro nombre, o añada un sitio al cliente existente | | `Client name cannot contain the \| character` o `Site name cannot contain the \| character` | El nombre contiene una barra vertical | Quite el carácter | | El botón de descarga sigue deshabilitado | No hay ningún cliente o sitio seleccionado | Elija ambos en la ventana **Add an agent** | | `Please enter a valid number of hours` | La caducidad del token está activada con un número de horas no válido | Introduzca un número entero de horas, o desactive la caducidad | | `Installer token has expired. Please generate a new one.` en el equipo | El instalador se generó con una caducidad que ya ha vencido | Genere un instalador nuevo | | `Old installer detected` en el equipo | El instalador se generó antes de que se actualizaran los agentes del servidor | Genere un instalador nuevo | | `Existing installation found` en un equipo Windows | El agente ya está instalado en él | Retire primero el agente existente (vea [Retirar agentes](/es/sonar/deploy-operate/remove-agents.md)) y vuelva a ejecutar el instalador | | La instalación terminó, pero no aparece ningún dispositivo | El equipo no puede alcanzar las direcciones de SONAR por el puerto 443 | Revise [Requisitos de red](/es/sonar/deploy-operate/network-requirements.md) y [Solucionar problemas de los agentes](/es/sonar/deploy-operate/troubleshooting.md) | | El dispositivo aparece pero muestra **Remote Offline** | El agente de acceso remoto aún no se ha conectado | Espere unos minutos; si sigue fuera de línea, vea [Control remoto](/es/sonar/administration/remote-access/remote-control.md) | ## Referencia de campos ### Create Client | Campo | Qué hace | Valores aceptados | Valor predeterminado | | ---------------------- | -------------------------------------------------------------------------------------------------------------------------- | -------------------------------------- | -------------------- | | **Name** | El nombre del cliente, que se muestra en el árbol, en las tarjetas y en todas las listas | Obligatorio. Único. Sin barra vertical | (sin valor) | | **Default first site** | El nombre del sitio que se crea junto con el cliente | Obligatorio. Sin barra vertical | (sin valor) | | **Custom Fields** | Valores de los campos personalizados de cliente, cuando hay alguno definido en **Admin Center › Settings › Custom Fields** | Depende del campo | Según el campo | ### Create Site | Campo | Qué hace | Valores aceptados | Valor predeterminado | | ----------------- | ------------------------------------------------------------------------- | --------------------------------------------------------- | -------------------- | | **Client** | El cliente al que pertenece el sitio | Un cliente existente | (sin valor) | | **Name** | El nombre del sitio | Obligatorio. Único dentro del cliente. Sin barra vertical | (sin valor) | | **Custom Fields** | Valores de los campos personalizados de sitio, cuando hay alguno definido | Depende del campo | Según el campo | ### Add an agent | Campo | Qué hace | Valores aceptados | Valor predeterminado | | --------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------- | | **Client** | El cliente al que pertenece el dispositivo nuevo | Un cliente que su rol permite | (sin valor) | | **Site** | El sitio al que pertenece el dispositivo nuevo | Un sitio del cliente elegido | (sin valor) | | **Operating system** | El sistema para el que se genera el instalador | **Windows**, **Linux**, **macOS** | **Windows** | | **Agent type** | Si el dispositivo es una estación de trabajo o un servidor. Decide qué política de automatización para estaciones de trabajo o para servidores se le aplica | **Workstation**, **Server** | **Workstation** | | **Architecture** | La arquitectura del procesador del equipo | Windows: **64-bit**, **32-bit**. Linux: **64-bit**, **32-bit**, **ARM 64-bit**, **ARM 32-bit**. macOS: **Intel 64-bit**, **Apple Silicon** | **64-bit** (**Intel 64-bit** en macOS) | | **Optional features** › **Sessions** | Windows. Instala el módulo de productividad, que registra la actividad de los usuarios y aplica las políticas de acceso | Activado, desactivado | Activado | | **Optional features** › **Geolocation** | Windows. El dispositivo comunica su posición, que se muestra en la pestaña **Location** y en **Observability › Geolocation** | Activado, desactivado | Activado | | **Optional features** › **Remote access** | Windows. Activa el Escritorio remoto de Windows en el equipo | Activado, desactivado | Activado | | **Optional features** › **Ping** | Windows. Permite que el equipo responda al ping a través del Firewall de Windows | Activado, desactivado | Activado | | **Optional features** › **Disable sleep/hibernate** | Estaciones de trabajo. Desactiva la suspensión y la hibernación para que el dispositivo siga siendo accesible. Se aplica en Windows | Activado, desactivado | Activado | | **Installation method** | Windows. Cómo se entrega el instalador: **Dynamic (.exe)**, un instalador listo para ejecutar; **PowerShell**, un script; **Manual**, un comando que usted mismo ejecuta. Linux recibe un script de instalación (`.sh`) y macOS un comando, sin nada que elegir | **Dynamic (.exe)**, **PowerShell**, **Manual** | **Dynamic (.exe)** | | **Enable token expiration (hours)** | Limita durante cuánto tiempo el instalador puede registrar dispositivos nuevos. Desactivado, el instalador no caduca | Desactivado, o un número de horas | Desactivado; 24 horas al activarlo | ## Páginas relacionadas * [Clientes y sitios](/es/sonar/administration/devices/clients-and-sites.md) * [Instalar el agente en Windows](/es/sonar/deploy-operate/install-agent-windows.md) * [Desplegar agentes a escala](/es/sonar/deploy-operate/mass-deployment.md) * [La lista de dispositivos](/es/sonar/administration/devices/device-list.md) * [Solucionar problemas de los agentes](/es/sonar/deploy-operate/troubleshooting.md)