DocScoDoc/docs/ProblemesEtBugs.md

42 lines
1.5 KiB
Markdown
Raw Normal View History

2020-09-21 16:30:27 +02:00
# En cas de problèmes avec ScoDoc
## Envoi des données "assistance"
Cette fonction est accessible via un lien en bas de la page d'accueil des
départements. Elle déclenche la copie de la base de données, son anonymisation
(suppression des informations permettant d'identifier les étudiants: les champs
sont effacés ou remplacés par des valeurs aléatoires), et son envoi vers le
serveur des développeurs ScoDoc pour analyse. Il est recommandé d'indiquer les
circonstances du problème rencontré ou de contacter les développeurs sur le salon
Discord.
## Diagnostic détaillé (pour les administrateurs)
2020-09-21 16:30:27 +02:00
Informations destinées aux administrateurs ayant un accès direct (ssh, root) au serveur.
## Récupération et envoi d'informations de diagnostic
2020-09-21 16:30:27 +02:00
Un script permet de générer quelques informations sur votre configuration pour
les envoyer aux développeurs: logs, modifications du code source, version Linux
installée etc.
2020-09-21 16:30:27 +02:00
```
# en tant que root sur le serveur:
cd /opt/scodoc/tools
./diagnostic.sh -a -n
2020-09-21 16:30:27 +02:00
```
Ce script génère un fichier `tgz`.
Si on n'indique pas l'option `-n`, il essaie immédiatement de l'envoyer par mail aux
développeurs. Il est fréquent que l'envoi de mail ne fonctionne pas: fichier
trop volumineux ou filtrage des mails. Dans ce cas, le copier et le transmettre
par un autre moyen (cloud, ...).
Ce fichier est dans `/tmp` et son nom exact est affiché par le script:
2020-09-21 16:30:27 +02:00
```ScoDoc diagnostic: informations about your system will be sent to emmanuel.viennet@univ-paris13.fr
and left in /tmp/scodoc-2016-09-05-1504631964
```