Agente Linux — Operación
Servicio
El agente corre como servicio systemd rds-agent, que arranca la sesión gráfica al encender el equipo.
| Operación | Comando |
|---|---|
| Ver estado | systemctl status rds-agent |
| Registro en vivo | journalctl -u rds-agent -f |
| Reiniciar | sudo systemctl restart rds-agent |
| Parar | sudo systemctl stop rds-agent |
| Arrancar | sudo systemctl start rds-agent |
La configuración de la pantalla está en /root/.config/rds-agent/config.json.
Integración con RDS
- El agente conecta con RDS cada minuto: recibe el modo, la URL de inicio, la lista blanca, la playlist y el código de acceso, y las órdenes del panel.
- Desde el panel puedes encender y apagar la pantalla, ajustar el brillo, atenuarla en reposo, vaciar la caché, reiniciar al momento o programar el reinicio y pedir capturas de pantalla.
- Envía su registro, que ves en Panel del dispositivo → Logs.
- Informa de lo que reproduce: ver Analytics.
- Se actualiza desde RDS: ver Actualizar el agente.
Modos
- Web Kiosk — carga la URL de inicio a pantalla completa; solo se puede navegar por los dominios de la lista blanca.
- Playlist — descarga los vídeos e imágenes de la playlist, comprueba cada archivo (CRC) y los reproduce desde el disco, también sin conexión.
- Offline — reproduce contenido local y de memorias USB; se elige en RDS o en la propia pantalla (pestaña Offline).
Resolución de problemas
| Síntoma | Qué hacer |
|---|---|
| Pantalla en negro al arrancar | systemctl status rds-agent. Si el equipo tenía el agente Python, comprueba que kiosk-browser está desactivado. |
| No conecta con RDS | En el menú, Estado → Probar internet y Probar RDS: indican la causa (red, DNS, portal Wi-Fi, reloj, licencia, token). |
| La prueba dice que RDS rechaza la clave | En el panel, Desbloquear token en esa pantalla, y vuelve a vincularla. |
| Un archivo no se reproduce | Menú → Contenido → Borrar contenido descargado, para que se descargue de nuevo. |
| Los cambios del panel no llegan | Espera a la siguiente conexión (1 minuto como máximo) o pulsa Sincronizar ahora en Contenido. |
dpkg -i falla con una lista de paquetes |
Instala con sudo apt install ./rds-agent_….deb, que resuelve las dependencias. |