10. Foire aux questions - FAQ

10.1. Utilisation

10.1.1. Problème de jeton

🔹 Comment obtenir mon jeton pour me connecter ?

La méthode est décrite dans la section 2.2. Récupérer votre jeton. Avant l'envoi vérifiez bien qu'il n'y a pas d'erreur dans votre adresse e-mail.

🔹 Que faire si je ne reçois pas le e-mail avec mon jeton de connexion ?

Il peut y avoir une erreur dans votre adresse e-mail, ou un problème au niveau de votre boîte mail (boîte pleine, mauvaise redirection,...) ; regardez également dans votre dossier Spam.

Si après quelques essais vous n'avez toujours rien reçu, contactez votre département.

10.1.2. Enseignements absents

🔹 Je n'ai pas trouvé certains de mes enseignements dans GDEP, comment les déclarer ?

Commencez par élargir la recherche aux autres départements et aux UEs fermées, en paramétrant le filtre dans l'onglet Synthèse avec Charge : tous, Dispo : toutes et Bilan : tous, et dans Matière le code APOGÉE ou un mot du titre.

Si vous ne trouvez pas votre enseignement, consultez la section 3.4.3. Matière absente.

10.2. Administration

À faire ...

10.3. À propos de GDEP

10.3.1. Licence

🔹 Quelle est la licence de GDEP ?

GDEP est un logiciel libre, dont la licence est la GPL version 3.

10.3.2. Auteur

🔹 Quel est l'auteur de GDEP ?

L'auteur du code, du design et de la philosophie de GDEP est Edouard Thiel <Edouard.Thiel@univ-amu.fr>.

Il s'agit d'un travail entièrement bénévole.

10.3.3. Codes sources

🔹 Les codes sources sont-ils disponibles ?

Les codes sources ne sont pour le moment pas encore disponibles, car :

• le code est fortement lié au WS ARES et ne peut pas fonctionner sans ; une réécriture sous la forme de greffons est nécessaire pour que le logiciel puisse être diffusé de manière indépendante pour d'autres universités.

• Certaines parties du code sont insuffisament documentées, ou présentent une dette technique.

• Il manque encore une documentation pour l'installation, le paramétrage et l'administration d'une instance.

10.3.4. Langages utilisés

🔹 En quels langages est écrit GDEP ? Quelle est la taille des sources ?

GDEP utilise le framework Django et est principalement écrit en Python.

L'unité de mesure habituelle étant la ligne de code, la version actuelle de GDEP occupe :

• 33100 lignes de python ;
• 8700 lignes de templates html ;
• 370 lignes de javascript (en jquery) ;
• 2000 lignes de css ;
• 2500 lignes de scripts Bash.

10.3.5. Sauvegardes

🔹 La base de données est-elle régulièrement sauvegardée ?

Oui et de plusieurs façons :

• au niveau du serveur virtuel, l'image disque (dont la base de données de chaque instance) est sauvegardée plusieurs fois par jour par le DataCenter ;
• de plus, un crontab effectue une sauvegarde de la base de données de chaque instance toutes les 4 heures, et envoie ces sauvegardes sur des machines extérieures ;
• enfin, avant chaque opération sur une instance, une sauvegarde multiple est réalisée.

10.3.6. Architecture du serveur

🔹 Quelle est l'architecture du serveur de GDEP ?

Les instances de GDEP sont hébergées dans un serveur virtuel dans le DataCenter Sud d'AMU.

Ce serveur n'est pas accessible de l'extérieur, il est placé derrière un double HAProxy, qui entre autres est chargé de la gestion de https avec des certificats Let's Encrypt.

10.3.7. État de santé

🔹 Avec quel outil peut-on tester l'état de santé des instances ?

L'outil en ligne Ping de GDEP permet d'observer en temps réel l'état des instances en production.

Toutes les 30 secondes, cet outil effectue un ping sur chaque instance puis affiche le temps de réponse sur un graphique ; différents codes de couleurs permettent de connaître la nature des erreurs éventuelles.

Le ping en question consiste à faire un GET sur une URL dédiée à cet effet, qui doit immédiatement répondre par alive. Ce système très simple permet de mesurer un aller-retour complet, y compris l'interrogation du DNS, la validation des certificats pour https et la disponibilité du serveur. Il est effectué sur une machine située en dehors du DataCenter (l'ancien serveur sol de GDEP).

10.3.8. GDEP ne répond pas

🔹 Que faire si GDEP ne répond pas ?

Il arrive que GDEP ne réponde pas pendant quelques minutes, environ 1 à 2 fois par semaines, généralement vers 20:03.

La raison n'est pas connue, il s'agit probablement d'une mise à jour ou d'un redémarrage d'un équipement réseau quelque part entre les HAProxy et Renater, qui produit une erreur de résolution DNS.

Il suffit de patienter quelques minutes ; pendant ce temps vous pouvez consulter la section 10.3.7. État de santé, ou encore jouer avec la commande dig pour effectuer des tests !

10.4. À propos du tutoriel

10.4.1. Outil utilisé

🔹 Avec quel outil est écrit ce Tutoriel ?

Ce Tutoriel est écrit en MarkDown, qui est le langage utilisé pour Wikipedia.

Le logiciel utilisé pour générer les pages HTML est le script Mkdocs-et, du même auteur que GDEP. Ce script a initialement été créé pour écrire des cours, et les faire apparaître progressivement. Il s'appuie sur le logiciel libre Mkdocs et le thème Material for Mkdocs, avec tout un ensemble de plugins ; ils sont tous écrits en Python.

Ce système de documentation a été choisi pour ses performances : la génération de toutes les pages du Tutoriel et la recopie sur le serveur (avec rsync) prend environ 1,5s ; le chargement des pages est très rapide, s'affiche très bien sur un ordiphone, et enfin, la recherche d'un terme dans la boîte 🔍 Rechercher est quasi instantanée.

10.4.2. Personnages

🔹 Quels sont les personnages dans les captures d'écran du Tutoriel ?

Les captures d'écran font intervenir divers personnages célèbres que voici, rangés dans l'ordre alphabétique avec un lien vers leur fiche wikipédia :

• Backus John : informaticien ayant créé le langage Fortran et la notation de grammaire BNF.

• Collins Michael : pilote du vaisseau Columbia du programme Apollo 11.

• Connor John : chef de la résistance dans Terminator, aidé par un T-800 reprogrammé pour combattre Skynet.

• Connor Sarrah : mère de John Connor, héroïne de la série de films Terminator.

• Hamilton Margaret : directrice du département génie logiciel au MIT, qui conçut le logiciel embarqué du programme Apollo.

• Hopper Grace : informaticienne et Générale de la Navy, inventrice du premier compilateur et du langage Cobol.

• Kernighan Brian : informaticien, co-inventeur des langages C, Awk et M4, a forgé le terme Unix.

• Lamport Leslie : informaticien, spécialiste de l'algorithmique répartie, auteur de LaTeX.

• Leblanc Richard : cuisinier et écrivain, maître d'hôtel du Duc de Guise au 16e siècle.

• Peddle Chuck : ingénieur, inventeur du microprocesseur 6502 en 1975.

• Ritchie Dennis : informaticien, inventeur du langage C et co-développeur de Unix.

• Seldon Hari : mathématicien, personnage principal du Cycle de Fondation, imaginé par Isaac Asimov.

• Stroustrup Bjarne : informaticien, auteur du langage C++.

• Thompson Ken : informaticien, concepteur des systèmes Unix et Plan 9 ainsi que des langages B et Go.

• Watel Fritz Karl : alias François Vatel, maître d'Hôtel, organisateur de fêtes et de festins d’exception au temps de Louis XIV.

10.4.3. Clin d'œil

🔹 Est-ce qu'il y a de l'humour caché dans l'interface ?

Il y a en effet un petit clin d'œil dans le choix des notations, lire ceci.