Guía del agente
El agente es un programa chico que corre en una computadora del sitio. Revisa las cámaras y los grabadores de la red local y se conecta hacia afuera, así que no hay puertos que abrir. Acá está cómo instalarlo, actualizarlo y qué revisar si algo no anda.
Descargas
Siempre la última versión. Elegí el archivo según la computadora donde va a correr el agente; en Linux, el comando uname -m te dice cuál es.
| Sistema | uname -m | Archivo |
|---|---|---|
| Linux 64 bits (PC o servidor) | x86_64 | sentinel-agent-linux-amd64.tar.gz |
| Linux ARM 64 bits (Raspberry Pi 4/5 con sistema de 64 bits) | aarch64 | sentinel-agent-linux-arm64.tar.gz |
| Linux ARM 32 bits (Raspberry Pi con sistema de 32 bits) | armv7l | sentinel-agent-linux-armv7.tar.gz |
| Windows 10/11 o Server 2016 en adelante | — | sentinel-agent-windows-amd64.zip |
Versión publicadaChecksums (SHA256SUMS)
Para verificar una descarga, bajá SHA256SUMS a la misma carpeta y corré:
Instalar
- Linux con systemd, o Windows 10/11 o Server 2016 en adelante.
- El reloj de la computadora sincronizado por NTP: si se adelanta más de 2 minutos o se atrasa más de 10, Sentinel descarta lo que manda el agente.
- Salida a Internet por el puerto 8883. No hace falta abrir puertos de entrada.
- Que la computadora esté en la misma red (o VLAN) que las cámaras.
Creá el agente en la app, en Monitoring → Agents → New agent. La página siguiente muestra el comando para el sistema que elijas, con el broker, el id del agente y la clave ya completos, y el secreto, una sola vez. Copiá el comando de ahí; los de abajo son el mismo con los valores marcados.
En ARM, cambiá linux-amd64 por linux-arm64 o linux-armv7. El instalador te pide el secreto, así no queda en el historial de la terminal. Después crea el servicio y lo arranca; en menos de un minuto el agente figura Online en la app. Para ver el estado en la computadora:
Actualizar
Las actualizaciones son manuales por ahora. El instalador en modo actualización reemplaza el programa y conserva el enrolamiento y la configuración. La versión de cada agente se ve en la app, en Agents.
Desinstalar
Esto borra el servicio, las credenciales, la configuración y la clave de datos de la computadora. Después revocá el agente en la app.
Red
- Salida TCP al broker de Sentinel por el puerto 8883 (MQTT con TLS).
- Multicast UDP a 239.255.255.250:3702 y sus respuestas en la LAN, para encontrar cámaras ONVIF. Los routers no pasan ese multicast entre subredes: el agente tiene que estar en la VLAN de las cámaras.
- HTTP o HTTPS al puerto ONVIF de cada cámara, y el puerto RTSP para los equipos que solo dan RTSP.
- Un proxy corporativo que inspecciona TLS corta la conexión, salvo que su certificado esté instalado en el sistema.
Problemas frecuentes
- El agente no aparece Online
Casi siempre es el reloj. El log dice «system clock is NOT synchronised» o «no configuration from Sentinel». Activá la sincronización de hora. En Windows: w32tm /resync, con el servicio Hora de Windows encendido.
- Credenciales rechazadas
Si en la app se revocó el agente o se rotaron sus credenciales, el broker lo rechaza. Rotá las credenciales en la app y corré de nuevo el comando de instalación con la clave nueva.
- No encuentra cámaras
El descubrimiento solo llega a la red del agente: las cámaras de otra subred o VLAN no aparecen. En Windows, revisá que exista la regla de firewall «Sentinel Agent (WS-Discovery replies)», que crea el instalador.
- Una cámara da auth_failed
La cámara rechazó el usuario y la contraseña cargados en la app. Corregilos antes de volver a probar: muchos equipos Hikvision y Dahua bloquean la cuenta después de varios intentos fallidos.
- Linux: el ping da not_permitted
El agente usa ping sin privilegios. Si sysctl net.ipv4.ping_group_range muestra «1 0», habilitalo con este comando y los equipos vuelven a chequearse:
Los logs están en journalctl -u sentinel-agent (Linux) y en C:\ProgramData\Sentinel Agent\logs\agent.log (Windows).