Desplegar agentes a escala
Distribuya el agente SONAR a muchos dispositivos: instaladores reutilizables, enlaces en Agents › Deployments, GPO, distribución de software y comprobación.
Qué es y cuándo usarlo
Cada instalador que genera la consola queda vinculado a un cliente y a un sitio, y funciona en cualquier cantidad de dispositivos mientras sea válido. Llevar SONAR a un sitio entero es, por lo tanto, cuestión de generar un instalador por sitio y por tipo de dispositivo, y ejecutarlo en todos ellos con la herramienta que ya usa: directiva de grupo, una herramienta de distribución de software o de MDM, un RMM que se está sustituyendo, automatización por SSH.
Hay dos fuentes de instaladores:
Agents › Install Agent: un archivo o un comando que se descarga una vez y se distribuye, ya sea el Dynamic (.exe) o el script PowerShell de Windows, el script de Linux o el comando de macOS. Consulte las páginas de cada plataforma, enlazadas más abajo.
Agents › Deployments: un enlace de descarga reutilizable por sitio, para Windows. Cada vez que se abre el enlace, SONAR genera un instalador nuevo con la versión actual del agente, hasta la fecha fijada en Expiry en el despliegue.
Antes de empezar
Para gestionar los enlaces de despliegue, su rol tiene List Deployments y Manage Deployments en Admin Center › Roles. Para generar instaladores en Install Agent, tiene Install Agents. Ambos permisos cubren solo los sitios a los que su rol le da acceso.
Los clientes y los sitios existen. Prevea un instalador o un despliegue por sitio, por tipo de dispositivo (Server o Workstation) y por arquitectura.
Las exclusiones del antivirus y del EDR están configuradas antes de la distribución. Consulte Requisitos de los dispositivos.
Todas las redes de destino permiten la salida por 443/tcp hacia las direcciones de la API de SONAR y del acceso remoto. Consulte Requisitos de red.
Para los instaladores de Install Agent, active Enable token expiration (hours) con horas suficientes para cubrir toda la ventana de distribución. Pasado ese plazo, el instalador deja de funcionar y hace falta generar otro.
Pasos
Crear un enlace de despliegue (Windows)
Abra Agents › Deployments. El cuadro de diálogo Deployments muestra los despliegues existentes.
Haga clic en el botón + (Create Deployment). Se abre el formulario Add Deployment.
Elija el Site.
Elija el Agent Type: Server o Workstation.
Fije la fecha y la hora en Expiry.
Elija la Architecture: 64 bit o 32 bit.
Marque las Optional Features que deben recibir los dispositivos. Son las mismas que en Install Agent y se describen en Instalar el agente en Windows.
Haga clic en Create Deployment. Aparece el mensaje The deployment was added successfully y la nueva fila se añade a la lista.
En la fila, bajo Download Link, haga clic en Copy. El mensaje Link copied to clipboard lo confirma.
Al abrir el enlace se descarga el archivo sonar-<client>-<site>-<type>-<architecture>.exe, el mismo instalador Dynamic que genera Install Agent, que se ejecuta en modo silencioso con /S.
Desplegar con un script de inicio de directiva de grupo (Windows)
Un script de inicio del equipo se ejecuta como Local System, antes de que nadie inicie sesión, que es el contexto que espera el instalador silencioso.
Guarde un script como este, con su enlace de despliegue, en un recurso compartido que los equipos del dominio puedan leer:
La comprobación del servicio hace que el script no haga nada en los dispositivos que ya tienen el agente. En lugar de descargar desde un enlace, el script puede igualmente ejecutar un instalador Dynamic (.exe) copiado en el recurso compartido.
En Group Policy Management, cree o edite un GPO vinculado a la unidad organizativa de los equipos de destino.
En Computer Configuration › Policies › Windows Settings › Scripts (Startup/Shutdown), añada el script como script de PowerShell de Startup.
Reinicie los equipos de destino, o espere a su próximo reinicio.
Desplegar con una herramienta de distribución de software o de MDM (Windows)
Empaquete como aplicación el instalador Dynamic (.exe) obtenido en Install Agent o en un enlace de despliegue:
Comando de instalación
sonar-<client>-<site>-<type>-<architecture>.exe /S
Comando de desinstalación
"C:\Program Files\Sonar\uninstall.exe" /S
Ejecutar como
System
Detección
El servicio sonarrmm existe, o el archivo C:\Program Files\Sonar\sonarrmm.exe existe
El script de PowerShell de Install Agent puede distribuirse de la misma manera: él mismo comprueba si existe el servicio sonarrmm y termina si el agente ya está instalado.
Desplegar en Linux y macOS
Linux: ejecute el script de Install Agent como root en cada máquina mediante su automatización (SSH, gestión de la configuración, un bucle desde un jump host):
sudo bash ./sonar-<client>-<site>-<type>.sh. El script elimina cualquier agente anterior antes de instalar. Consulte Instalar el agente en Linux.macOS: ejecute el comando de Install Agent como root mediante su MDM o un shell remoto. Si los operadores necesitan las carpetas protegidas del usuario desde la ventana de acceso remoto, conceda Full Disk Access con un perfil de privacidad del MDM. Consulte Instalar el agente en macOS.
Qué debe ver
Los dispositivos aparecen en Dashboard › Sysadmin, bajo su cliente y su sitio, a medida que termina cada instalación, con Agent Status Online. En la vista Clients overview, la tarjeta del cliente muestra cómo crece el número de dispositivos.
Cómo verificar que funcionó
Abra Dashboard › Sysadmin y haga clic en la tarjeta del cliente.
Ordene la lista de dispositivos por First Seen, de los más recientes a los más antiguos: los dispositivos de la distribución quedan arriba, con la fecha en que se registraron.
Abra Filters y, en Availability, elija Online; en Device Type, elija Servers o Workstations, según el lote. Compare el número con la lista de dispositivos que tenía previstos.
Para los dispositivos de su lista que falten, revise el resultado que registró la propia herramienta de despliegue en esos dispositivos y, a continuación, siga Solucionar problemas de los agentes.
En Reports & Audits › Audits, cada registro de dispositivo es una entrada Agent Install con el nombre del host, lo que da el orden y la hora de llegada.
Errores comunes
expire date is invalid al crear un despliegue
Expiry está vacío o incompleto
Rellene la fecha y la hora
Los instaladores se detienen con Installer token has expired. Please generate a new one.
El despliegue superó su fecha de Expiry, el despliegue se eliminó, o el instalador de Install Agent superó la expiración de su token
Cree un nuevo despliegue o un nuevo instalador y actualice el enlace o el paquete en su herramienta
Instaladores guardados antes de la distribución se detienen con Old installer detected
La versión del agente SONAR cambió después de generar el archivo
Genere el archivo de nuevo, o use un enlace de despliegue, que siempre genera la versión actual
La instalación silenciosa informa éxito, pero el dispositivo nunca aparece
El dispositivo ya tenía un agente, o lo que quedaba de uno; el instalador muestra Existing installation found and must be removed before attempting to reinstall. y termina
Ejecute "C:\Program Files\Sonar\uninstall.exe" /S en el dispositivo y vuelva a instalar
Una instalación ejecutada dentro de la sesión de un usuario conectado no termina
El cuadro de mensaje final del agente está esperando el OK
Ejecute el instalador como Local System, o use el script de PowerShell, que se ejecuta sin cuadros de mensaje
Los dispositivos llegan a un sitio equivocado
Se usó el instalador o el enlace de otro sitio
Mueva los dispositivos al sitio correcto y compruebe qué archivo usa cada paquete
El botón +, Copy o Delete no hace nada
Su rol no tiene Manage Deployments
Solicite el permiso
Referencia de campos
Add Deployment
Site
Sitio bajo el que se registran los dispositivos
Los sitios a los que su rol tiene acceso, agrupados por cliente
El primer sitio de la lista
Agent Type
Registra los dispositivos como servidores o como estaciones de trabajo
Server, Workstation
Server
Expiry
Fecha y hora a partir de las cuales los instaladores de este enlace dejan de funcionar
Una fecha y una hora
30 días a partir del momento actual
Architecture
Arquitectura de Windows del instalador
64 bit, 32 bit
64 bit
Optional Features
Las mismas funciones que en Install Agent: Sessions, Geolocation, Remote access, Ping y, para estaciones de trabajo, Disable sleep/hibernate
Marcada o no
Ninguna marcada
Lista de despliegues
Client
Cliente del sitio del despliegue
Site
Sitio bajo el que se registran los dispositivos
Type
server o workstation
Arch
amd64 (64 bit) o 386 (32 bit)
Expiry
Cuándo el enlace deja de producir instaladores que funcionan
Created
Cuándo se creó el despliegue
Flags
View Flags; pase el ratón por encima para ver las funciones opcionales
Download Link
Copy copia el enlace al portapapeles
Para quitar un despliegue, haga clic con el botón derecho en su fila, elija Delete y confirme Delete deployment?. Los instaladores ya descargados desde ese enlace también dejan de funcionar.
Páginas relacionadas
Atualizado
Isto foi útil?