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.

• Ese equipo puede abrir conexiones HTTPS salientes por el puerto 443 hacia las direcciones de su SONAR. Vea Requisitos de red.

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, Instalar el agente en Linux e Instalar el agente en macOS.

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.

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.

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) 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 y Solucionar problemas de los agentes
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

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

• Instalar el agente en Windows

• Desplegar agentes a escala

• La lista de dispositivos

• Solucionar problemas de los agentes