Centre de Dépannage

Bienvenue dans le centre de dépannage de CoreSight. Cette section est dédiée à la résolution des problèmes courants que vous pourriez rencontrer lors de l'exploitation de la plateforme.

Logigramme de Résolution

Méthodologie de diagnostic

Avant de chercher une solution spécifique, voici les étapes de diagnostic de base à effectuer systématiquement en cas de dysfonctionnement.

1. Vérifier l'état du service

La commande principale pour vérifier que le backend Node.js tourne correctement :

sudo systemctl status coresight

Si le statut n'est pas active (running), le service est en erreur.

2. Consulter les journaux (Logs)

Les logs de l'application sont gérés par journald. C'est la source d'information la plus précieuse pour comprendre une erreur.

# Voir les 50 dernières lignes de logs
sudo journalctl -u coresight -n 50 --no-pager

# Suivre les logs en temps réel (pratique lors d'un test)
sudo journalctl -u coresight -f

3. Vérifier la santé de l'API (Healthcheck)

Si le service tourne mais que l'interface ne s'affiche pas, vérifiez si l'API répond localement :

curl -k https://localhost/api/health

Une réponse normale ressemble à : {"status":"ok","version":"1.1.0","uptime":3600}.

Catégories de problèmes

Choisissez la catégorie correspondant à votre problème :

• Démarrage et Service Systemd : Le service refuse de démarrer, plante en boucle, ou affiche des erreurs MODULE_NOT_FOUND.
• Base de données & Sauvegardes : Erreurs SQL, corruption de fichier, restauration d'une sauvegarde, ou problème avec la clé de chiffrement.
• Réseau et Certificats SSL : Le port 443 est inaccessible, erreurs de permission, ou certificat Let's Encrypt expiré.
• Comptes et Authentification : Perte totale de l'accès administrateur, réinitialisation de mot de passe en ligne de commande, ou blocage 2FA.