Advanced Troubleshooting

v0.81.2

Common issues and how to resolve them.

Common Issues

SymptomLikely CauseResolution
Agent fails to connectWrong token / network / TLSCheck journalctl + curl /health
Audits not startingScheduler stoppedRestart server or check job queue
Reports emptyNo scan completed yetTrigger manual audit
High CPU on agentInterval too lowSet minimum 4 hours
401 UnauthorizedToken expiredGenerate new enrollment token

Log Locations

  • Server (Linux): journalctl -u vigilprism-server -f
  • Agent (Linux): journalctl -u vigilprism-agent -f
  • Windows: Event Viewer or C:\ProgramData\VigilPrism\agent.log

Reset Admin Password

python -c "..."  # see full command in docs/troubleshooting.md