Устранение неполадок

Что делать, если платформа не запускается или работает со сбоями. Проблемам с DefectDojo посвящён отдельный раздел: Настройка DefectDojo.

Запустите диагностику

Начните с неё. Команда doctor проверяет сервер и установку: Docker и плагин Compose, порты, свободное место, расхождение часов с вашим NTP-сервером, файл лицензии, сертификат, настройки в .env, базу данных и Redis. Затем она показывает, какие сервисы не работают, проверяет, открывается ли через nginx страница входа, и выводит недавние ошибки из журналов:

cd /opt/scansuite && ./scansuite doctor

Команда выполняет все проверки, а не останавливается на первой неудачной, поэтому обычно одного запуска хватает, чтобы понять, что чинить. Прикладывайте её вывод к любому обращению в поддержку.

Сразу после запуска среди недавних ошибок могут встретиться строки connection refused от seaweedfs. Части файлового хранилища поднимаются по очереди и пытаются соединиться, пока не найдут друг друга. Если такие строки пропадают в течение минуты, а doctor заканчивает работу сообщением No problems found, всё в порядке.

Перезапуск ScanSuite

cd /opt/scansuite && ./scansuite restart

Команда считает перезапуск успешным, только если все сервисы сообщили о готовности; иначе она назовёт сервис, который не поднялся. Если контейнер не просто работает со сбоями, а завис, пересоздайте все контейнеры:

cd /opt/scansuite && ./scansuite restart --hard

Журналы контейнеров

Укажите нужный сервис или ничего не указывайте, чтобы увидеть журналы всех сервисов; команда выводит последние 200 строк. За что отвечает каждый сервис, описано в разделе Параметры настройки и сервисы.

./scansuite logs web
./scansuite logs worker
./scansuite logs worker_admin
./scansuite logs celery_beat

Журнал самого приложения записывается на сервер:

cat /var/tmp/scansuite.log

Что на самом деле запущено на узле

Прежде чем сообщать о проблеме, проверьте, какие релиз, лицензия и образы на самом деле запущены. Они могут отличаться от установленного релиза, если сервер не перезапускали после обновления:

cd /opt/scansuite && ./scansuite version

Перезапуск Docker

Если контейнеры не запускаются вообще, перезапустите сам сервис Docker:

sudo service docker restart

Удаление ScanSuite с сервера

Чтобы убрать ScanSuite с сервера, например перед установкой с нуля, остановите его и удалите сервис автозапуска. Параметр --purge удаляет ещё и базу данных и сохранённые файлы; без него они останутся:

cd /opt/scansuite && ./scansuite uninstall --purge

DefectDojo — отдельная установка, и он продолжит работать. Удалите его вместе с данными из его собственного каталога:

cd /opt/scansuite/defectdojo && docker compose down -v

Образы и каталог установки остаются на сервере. Чтобы освободить место, удалите и их. Для каталога понадобится sudo: часть файлов в нём сервисы записывают от имени root.

docker images -q 'appsec4u/*' | sort -u | xargs -r docker rmi -f
sudo rm -rf /opt/scansuite