| name | troubleshooting |
| description | Debug and resolve common issues in applications, Vault, Docker, OpenShift, Nexus, and GPU operators with step-by-step solutions |
Systematically troubleshoot and resolve issues:
Identify the issue category (frontend, backend, Vault, Docker, OpenShift, network)
Check logs for error messages (browser console, app logs, system logs)
Gather diagnostic information using appropriate commands
Apply the documented solution from `common-issues.md`
Verify the fix resolved the problem
Document new issues and solutions for future reference
Quick Reference: See common-issues.md for 30+ issues with solutions
Most Common Issues:
Frontend:
- Hamburger menu not visible → Add CSS visibility rules
- CORS errors → Enable CORS in Flask backend
- Components not rendering → Check browser console for errors
Backend:
- Server won't start → Check port 3001 availability
- API 500 errors → Enable debug mode and check logs
- Import errors → Activate virtual environment
Vault:
- Sealed after restart → Unseal with 3 keys (expected behavior)
- Permission denied → Fix ownership:
chown -R vault:vault /opt/vault
- Connection timeout → Check service status and firewall
Docker:
- Container won't start → Check logs:
docker logs <container>
- Image pull failed → Login to registry:
docker login
OpenShift:
- CrashLoopBackOff → Check pod logs:
oc logs <pod>
- ImagePullBackOff → Create and link pull secret
Diagnostic Commands:
journalctl -u <service>
docker logs <container>
oc logs <pod>
netstat -tlnp | grep <port>
curl http://localhost:<port>
ps aux | grep <process>
systemctl status <service>
