¶ Политики, пакеты, инвентаризация, Self Service
Эта страница поможет, если агент на связи (терминал работает), но политика не запускается, пакет не устанавливается, в инвентаризации отображается не всё ПО или Self Service пустой. Если агент не на связи, начните со страницы Агент.
¶ Политика не запускается
Политику выполняет агент: запуск создаётся по триггеру с учётом частоты и только на устройствах, где агент зарегистрирован. Возможные причины, от частых к редким:
- Ограничение частоты. Повторный запуск на устройстве блокируется, пока с момента окончания предыдущего запуска не пройдёт период частоты или интервал (больший из двух) минус 4 минуты. При частоте «Один раз на каждом устройстве» политика больше не запускается на устройстве после любого завершённого запуска, в том числе неудачного.
- Устройство не входит в область действия. Проверьте, входит ли устройство в нужную группу или смарт-группу сейчас. Смарт-группы пересчитываются раз в час.
- Политика выключена. Проверьте флажок «Включено».
- Агент не на связи. Запуск остаётся в статусе «Запланировано» (см. Статусы запуска политики).
- Нет подходящего триггера. В версии 3.x доступны два триггера: «Немедленно» и «Интервал». Политику без триггера можно запустить вручную или из Self Service, если она там опубликована.
Чтобы запустить политику повторно без учёта частоты, нажмите «Перезапустить политику».
Кнопка «Перезапустить политику» запускает политику на всех устройствах в её области действия, не учитывая ограничение частоты.
| Триггер | Когда сервер создаёт запуск |
|---|---|
| «Немедленно» | При создании политики; при сохранении изменений, если вы выбрали перезапуск (для всех устройств или только для новых в области действия); когда устройство попадает в область действия через группу или смарт-группу; после регистрации агента на новом устройстве. |
| «Интервал» | При проверке интервальных политик (каждые 5 минут), если с прошлого запуска на устройстве прошло не меньше заданного интервала. |
| Частота | Как часто политика повторяется на устройстве |
|---|---|
| «Постоянно» | Без ограничения. С интервальным триггером — один раз за интервал. |
| «Раз в день», «Раз в неделю», «Раз в месяц» | Не чаще одного раза за сутки, неделю или месяц, даже если интервал короче. |
| «Один раз на каждом устройстве» | Один раз. Неудачный запуск тоже учитывается. |
Поскольку сервер проверяет интервальные политики раз в 5 минут, запуск по интервалу может начаться с задержкой до 5 минут.
¶ Статусы запуска политики
Запуски показаны на странице политики и в карточке устройства на вкладке Управление → Политики. Там же доступен вывод скрипта. Как задача передаётся агенту и выполняется, показано на схеме в разделе Как устроен Ринго → выполнение задачи агентом.
| Статус | Что это значит | Что делать |
|---|---|---|
| Запланировано | Запуск создан, но агент его ещё не получил. | Агент не на связи. См. Агент. |
| В процессе | Агент выполняет политику. | Дождитесь завершения. Если шаг не уложится в таймаут скрипта (Настройки → Конфигурация скриптов), сервер сам завершит запуск с ошибкой. |
| Успешно | Все шаги выполнены. | — |
| Не удалось | Шаг завершился ошибкой или не уложился в таймаут. Серым отображаются ошибки, уже подтверждённые кнопкой «Подтвердить». | Откройте запуск и прочитайте вывод шага. |
| Ожидает отмены | Отмена запрошена, агент ещё не ответил. | Дождитесь подключения агента. |
| Отменен | Запуск отменён. | — |
На Mac каждая команда агента записывается в его лог между строками ### Command <id> stdout ### и ### Command <id> stderr END ###, а итог — строкой command completed <id> (см. Диагностика на устройстве → агент).
¶ Пакет не устанавливается
-
Точка распространения недоступна с устройства. Агент пробует сначала HTTP-точки, затем SMB, пока загрузка не пройдёт успешно. Порядок точек внутри каждого типа не совпадает с порядком в списке настроек, поэтому пакет должен быть доступен на одной из точек. Список точек находится в разделе Настройки → Точки распространения пакетов. Если список пуст, запуск политики сразу завершается ошибкой. Недоступная точка выглядит в логе агента так:
LOG - Downloading, trying 'http://<точка>:<порт>/<пакет>.pkg'... LOG - Downloading failed, response code: 000 LOG - curl: (6) Could not resolve host: <точка> LOG - Failed to download packageКод
000иCould not resolve hostозначают, что имя точки не разрешается в сети устройства (например, нужен внутренний DNS или VPN). Код401означает неверные учётные данные для чтения,404— пакета нет по этому пути. Проверьте доступность с устройства:- HTTP или WebDAV:
curl -sI http://<точка>:<порт>/<путь к пакету> - SMB (TCP-порт 445):
nc -vz -G 5 <точка> 445
- HTTP или WebDAV:
-
Формат пакета не подходит для ОС. Для macOS нужен
.pkg, для Linux —.deb,.rpm,.tar.gzили.tgz, для Windows —.msiили.exe. Пакет другого формата завершается ошибкой: на WindowsUnsupported installer type: <расширение>, на LinuxUnsupported package format: <расширение>. -
Ошибка установщика. На macOS агент устанавливает пакет от имени root командой
installer -pkg <файл> -target /. Загруженный пакет сохраняется в/Library/Application Support/Ringo. Повторите установку вручную на устройстве и прочитайте вывод:sudo installer -pkg "/Library/Application Support/Ringo/<пакет>.pkg" -target / -verbose -
На диске устройства недостаточно места.
¶ В инвентаризации не всё ПО
На macOS список ПО собирается командой system_profiler, которая использует индекс Spotlight. Если индексирование отключено, индекс повреждён или ещё строится, часть программ не попадает в список. Перестройте индекс на Mac.
Перестройка полностью удаляет индекс Spotlight. Пока индекс строится заново (от нескольких десятков минут до нескольких часов), поиск на Mac работает неполно, а система заметно нагружена. Выполняйте её вне рабочего времени пользователя.
sudo mdutil -a -i off
sudo rm -rf /.Spotlight-V100
sudo mdutil -a -i on
sudo mdutil -E /
Через час обновите инвентаризацию: запустите политику с действием «Обновить сведения об устройстве» и триггером «Немедленно».
¶ Self Service пустой или бесконечно загружается
Так выглядит Self Service, когда для устройства опубликованы элементы:
Если для устройства ничего не опубликовано, окно не остаётся пустым, а бесконечно показывает индикатор загрузки. Это не сбой. Список категорий слева может показывать индикатор загрузки и при опубликованных элементах.
Чтобы найти причину, откройте лог приложения на Mac: ~/Library/Application Support/Logs/app.log. В нём записаны все запросы к серверу (в виде команды curl) и ответы:
curl -X GET "https://<домен>/api/v1/self-service/entities?device_type=computer&device_id=…&page=1&limit=20"
Status Code: 200
Response Body: { "count" : 0, "entities" : [ ] }
| Запись в логе | Причина | Что делать |
|---|---|---|
200, "count" : 0 |
Для устройства ничего не опубликовано. | Опубликуйте политику («Сделать политику доступной в Self Service») или приложение с областью действия, в которую входит устройство. Затем нажмите «Обновить данные» в Self Service. |
200, "count" больше 0, а окно пустое |
Приложение не обновило данные. | Нажмите «Обновить данные» или перезапустите Self Service. |
400, «Ошибка аутентификации: …» |
Self Service входит с сертификатом агента («Ringo Agent Device Identity»), а не по логину. Сертификата нет или он не совпадает с сервером. | См. Агент на macOS → несколько сертификатов агента или отправьте Mac команду «Обновить профиль MDM». |
401, «Неверное имя пользователя или пароль» |
Устройства с таким UDID нет в Ринго (оно удалено). | Зарегистрируйте устройство заново. |
| Ответа нет, ошибка соединения | Путь /api/v1/self-service закрыт на прокси или недоступен из сети устройства. |
См. Сеть → адреса. |
¶ Нет ключа восстановления FileVault
Ключ передаётся в ответе на MDM-команду SecurityInfo. Она отправляется при регистрации, а затем дважды в сутки, в 00:00 и 12:00 по времени контейнера backend (UTC, то есть в 03:00 и 15:00 по Москве). Если FileVault включили после регистрации, ключ появится после ближайшего выполнения команды. Если ключ так и не появился, команда не доходит до устройства (см. Команды MDM и профили).
¶ Если проблема не решена
Обратитесь в техническую поддержку (см. Обращение в поддержку).
Проверено на Ринго 3.0.5, октябрь 2026. Тексты ошибок — Справочник ошибок, термины — Термины.