Стартовая точка при проблеме: найдите симптом в таблице, перейдите в профильный раздел. Общие инструменты диагностики — в конце страницы.
Установка и сервер
| Симптом |
Вероятная причина |
Где решается |
curl /api/v1/health не отвечает |
Firewall, порт не слушается, контейнер nginx/app не поднялся |
Развёртывание: health-проверки |
connection refused на 443 |
Контейнер приложения упал — смотрите docker compose ps и журналы |
Справочник портов |
| Клиент не подключается к серверу |
Неверный server_url/порт, сертификат, backpressure 503 |
Клиент LSUS, backpressure |
| Веб-админка недоступна, нужен патч |
Прикладная ошибка сервера |
Патчи: офлайн-применение |
Обновления
| Симптом |
Вероятная причина |
Где решается |
| Хост не появляется в кампании |
Не в целевой коллекции, пауза, агент не опрашивает сервер |
Кампании Linux, Хосты |
| Прогон висит в «выполняется» |
Клиент не докачал пакеты, завис WUSA (Windows) |
Тестирование обновлений |
| OVAL-находки не обновляются |
Автосинк не настроен/нет доступа к источнику |
OVAL\MSRC |
| Снапшот перед обновлением не создаётся |
Хост без LVM или мало места в VG |
Снапшоты: неполадки |
Сетевая установка (PXE)
| Симптом |
Вероятная причина |
Где решается |
| Машина не грузится по сети |
DHCP не направляет PXE-запросы на точку |
Сетевой runbook |
| «Не грузится» без видимой причины |
У EFI нет сетевой BootEntry или включён Secure Boot |
Secure Boot |
| Загрузка идёт, установка не начинается |
Истёк boot-token (TTL) |
Создайте задание заново или увеличьте TTL — Задания |
| MAC не появляется в очереди PXE |
Подсеть не прописана в карточке точки |
PXE-точки |
| Разобрать DHCP-обмен по MAC |
— |
Журнал «Диагностика DHCP» на вкладке точек |
Хосты и доступ
| Симптом |
Вероятная причина |
Где решается |
| Хост «не в сети» хотя работает |
Пропущены heartbeat'ы, firewall, время на хосте |
Центр отладки хоста |
| Нужно посмотреть файлы/логи на хосте |
— |
Центр отладки хоста |
| Пользователь не видит раздел/хосты |
Не хватает права или scoped RBAC ограничивает |
RBAC |
| LDAP-объекты «зависли» в orphaned |
Объект исчез из каталога, но привязан к политике |
Каталог и политики |
Общие инструменты
- Центр отладки хоста — SSH-подобный доступ из карточки хоста: терминал, файлы, журналы агента. См. руководство.
- Журналы на сервере:
docker logs lsus-master, lsus-master-worker; логи приложения в data/master/log/.
- Журнал агента на хосте:
journalctl -u lsus-client -n 50 --no-pager.
- Сбор логов для поддержки: кнопка «Скачать логи за сутки» — Патчи и поддержка.
- Состояние БД/миграций: Docker и образы.
Связанные страницы