Agente Linux — Funzionamento
Servizio
L'agente gira come servizio systemd rds-agent, che avvia la sessione grafica all'accensione del computer.
| Operazione | Comando |
|---|---|
| Stato | systemctl status rds-agent |
| Registro in tempo reale | journalctl -u rds-agent -f |
| Riavviare | sudo systemctl restart rds-agent |
| Fermare | sudo systemctl stop rds-agent |
| Avviare | sudo systemctl start rds-agent |
La configurazione dello schermo si trova in /root/.config/rds-agent/config.json.
Integrazione con RDS
- L'agente si connette a RDS ogni minuto: riceve la modalità, l'URL iniziale, la whitelist, la playlist e il codice di accesso, oltre ai comandi del pannello.
- Dal pannello può accendere e spegnere lo schermo, regolare la luminosità, attenuarlo a riposo, svuotare la cache, riavviare subito o programmare il riavvio e chiedere screenshot.
- Invia il suo registro, visibile in Pannello del dispositivo → Logs.
- Segnala ciò che riproduce: veda Analytics.
- Si aggiorna da RDS: veda Aggiornare l'agente.
Modalità
- Web Kiosk — carica l'URL iniziale a schermo intero; si può navigare solo sui domini della whitelist.
- Playlist — scarica i video e le immagini della playlist, verifica ogni file (CRC) e li riproduce dal disco, anche senza connessione.
- Offline — riproduce contenuti locali e da chiavette USB; si sceglie in RDS o sullo schermo stesso (scheda Offline).
Risoluzione dei problemi
| Sintomo | Cosa fare |
|---|---|
| Schermo nero all'avvio | systemctl status rds-agent. Se il computer aveva l'agente Python, verifichi che kiosk-browser sia disattivato. |
| Non si connette a RDS | Nel menu, Stato → Prova internet e Prova RDS: indicano la causa (rete, DNS, portale Wi-Fi, orologio, licenza, token). |
| Il test dice che RDS rifiuta la chiave | Nel pannello, Sblocca token su quello schermo, poi lo associ di nuovo. |
| Un file non si riproduce | Menu → Contenuti → Elimina i contenuti scaricati, perché venga riscaricato. |
| Le modifiche del pannello non arrivano | Attenda la connessione successiva (al massimo 1 minuto) o prema Sincronizza ora in Contenuti. |
dpkg -i fallisce con un elenco di pacchetti |
Installi con sudo apt install ./rds-agent_….deb, che risolve le dipendenze. |