Агент Linux — Эксплуатация

Служба

Агент работает как служба systemd rds-agent, которая запускает графический сеанс при включении компьютера.

Операция	Команда
Состояние	`systemctl status rds-agent`
Журнал в реальном времени	`journalctl -u rds-agent -f`
Перезапуск	`sudo systemctl restart rds-agent`
Остановка	`sudo systemctl stop rds-agent`
Запуск	`sudo systemctl start rds-agent`

Конфигурация экрана хранится в /root/.config/rds-agent/config.json.

Агент подключается к RDS каждую минуту: получает режим, начальный URL, белый список, плейлист и код доступа, а также команды из панели.
Из панели можно включать и выключать дисплей, менять яркость, затемнять его в простое, очищать кэш, перезагружать сразу или по расписанию и запрашивать снимки экрана.
Агент отправляет свой журнал — он виден в Панель устройства → Logs.
Сообщает, что воспроизводит: см. Аналитика.
Обновляется из RDS: см. Обновление агента.

Web Kiosk — загружает начальный URL во весь экран; переходы разрешены только по доменам из белого списка.
Playlist — скачивает видео и изображения плейлиста, проверяет каждый файл (CRC) и воспроизводит их с диска, в том числе без связи.
Offline — воспроизводит локальный контент и контент с USB; выбирается в RDS или на самом экране (вкладка Offline).

Симптом	Что делать
Чёрный экран при запуске	`systemctl status rds-agent`. Если на компьютере был агент Python, проверьте, что `kiosk-browser` отключён.
Нет связи с RDS	В меню Status → Test internet и Test RDS: они называют причину (сеть, DNS, портал Wi-Fi, часы, лицензия, токен).
Проверка сообщает, что RDS отклоняет ключ	В панели — Разблокировать токен для этого экрана, затем привяжите его заново.
Файл не воспроизводится	Меню → Content → Delete downloaded content, чтобы файл скачался заново.
Изменения из панели не доходят	Дождитесь следующего подключения (не более 1 минуты) или нажмите Sync now на вкладке Content.
`dpkg -i` завершается со списком пакетов	Устанавливайте командой `sudo apt install ./rds-agent_….deb`, которая разрешает зависимости.