2020-09-21 16:30:27 +02:00
|
|
|
|
2022-11-27 23:39:48 +01: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.
|
|
|
|
|
|
2022-11-27 23:39:48 +01:00
|
|
|
## Récupération et envoi d'informations de diagnostic
|
2020-09-21 16:30:27 +02:00
|
|
|
|
2022-11-27 23:39:48 +01: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:
|
2022-11-27 23:39:48 +01:00
|
|
|
cd /opt/scodoc/tools
|
|
|
|
|
./diagnostic.sh -a -n
|
2020-09-21 16:30:27 +02:00
|
|
|
```
|
|
|
|
|
|
2022-11-27 23:39:48 +01: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
|
|
|
|
|
```
|
