Le mode examen
Ce texte fait foi ; la version anglaise en est la traduction.
En mode examen, Marionnet enregistre ce que l’étudiant a fait sur ses machines virtuelles et l’archive dans le fichier du projet, qui devient ainsi sa copie ; il interdit par ailleurs les opérations qui feraient perdre cette copie avant qu’elle soit archivée. Ce mode est conçu pour des projets dont les machines sont des Debian 13 (trixie) : avec les anciennes images, ainsi qu’avec les routeurs, une partie de la copie manque (cf. § 5).
1. Le déroulement d’une épreuve
Vous fournissez aux étudiants l’énoncé de l’épreuve, par exemple sous la forme d’un PDF, et, si
vous le souhaitez, un projet de départ, c’est-à-dire un fichier .mar qui contient déjà une partie
du réseau.
Chaque étudiant doit impérativement lancer Marionnet avec l’option --exam :
marionnet --exam
La fenêtre s’intitule alors Marionnet (EXAM) ; pour le reste, l’étudiant travaille comme
d’habitude. Deux cas de figure se présentent :
- sans projet de départ, l’étudiant crée un nouveau projet par le menu Projet › Nouveau, et
Marionnet lui demande aussitôt le nom du fichier
.mar; - avec un projet de départ, l’étudiant l’ouvre par le menu Projet › Ouvrir. Notons que ce fichier doit être modifiable, puisque c’est lui qui recevra la copie : chaque étudiant doit donc disposer de sa propre copie du fichier fourni (dans son répertoire personnel, par exemple), et non d’un fichier partagé en lecture seule, que la fenêtre Ouvrir refuserait d’ailleurs.
Dans les deux cas, les machines doivent être des Debian 13, ce qui se choisit dans le champ
Distribution de la fenêtre Ajouter d’une machine (image debian-trixie), et se vérifie
dans la fenêtre Modifier d’une machine existante : pensez à le préciser dans l’énoncé si les
étudiants créent eux-mêmes leurs machines.
À la fin de l’épreuve, l’étudiant quitte Marionnet par le menu Projet › Quitter ou par la croix
de la fenêtre. En mode examen, Marionnet arrête alors proprement toutes les machines, attend
qu’elles soient effectivement arrêtées, puis enregistre le projet sans poser de question, ce qui
peut demander quelques secondes. L’étudiant vous remet enfin son fichier .mar, qui contient la
copie complète ; Marionnet n’offre pas de moyen de collecte, de sorte que vous utiliserez celui de
la salle (un répertoire de dépôt partagé, une clef USB ou votre plateforme pédagogique, par
exemple).
2. Ce que le mode --exam interdit
La copie est archivée dans le projet au moment de l’arrêt propre de chaque machine ; une coupure de courant, en revanche, la fait perdre. En mode examen, les opérations qui mettraient la copie en danger sont donc interdites :
| Opération | Avec --exam |
|---|---|
| Éteindre un composant, bouton Tout débrancher | interdites : le bouton est grisé et son info-bulle en donne la raison |
| Quitter, croix de la fenêtre, Fermer, Nouveau, Ouvrir | sans question : Marionnet arrête proprement les machines, attend qu’elles soient arrêtées, puis enregistre le projet ; l’étudiant ne peut donc pas perdre sa copie en répondant « non » par réflexe |
| Supprimer un composant qui a déjà été démarré | interdite, car elle emporterait ses disques et ses documents ; un composant qui n’a jamais été démarré reste en revanche supprimable, de façon que l’étudiant puisse corriger une erreur de construction |
Le menu Options signale cette dernière interdiction par une case cochée et grisée, Mode examen : interdire la suppression des composants qui ont tourné ; un étudiant qui trouve vide le sous-menu Supprimer comprend ainsi que l’outil refuse l’opération, plutôt que de penser à un dysfonctionnement. Si vous préparez vous-même un projet de départ en mode examen, vous pouvez lever cette interdiction :
marionnet --exam --exam-allow-delete
Suggestion : des icônes de lancement dans la salle de TP
Plutôt que de faire taper ces commandes, vous pouvez demander à l’administrateur de la salle de TP
d’ajouter sur chaque poste une icône qui lance Marionnet en mode examen, voire une seconde, sur
votre poste, pour le mode examen avec suppression permise. Marionnet fournit lui-même l’icône de
l’examen, dans le sous-répertoire share/marionnet/images/launcher-icons/ de son installation
(par exemple /usr/local/share/marionnet/images/launcher-icons/marionnet-exam-launcher.png).
Sous GNU/Linux, il suffit pour cela d’un petit fichier texte, déposé dans /usr/share/applications/
(pour tous les utilisateurs du poste) ou dans ~/.local/share/applications/ (pour un seul
utilisateur), par exemple marionnet-examen.desktop :
[Desktop Entry]
Type=Application
Name=Marionnet (examen)
Exec=marionnet --exam
Icon=/usr/local/share/marionnet/images/launcher-icons/marionnet-exam-launcher.png
Terminal=false
Categories=Education;
La seconde icône ne diffère de la première que par son nom et par sa commande :
Exec=marionnet --exam --exam-allow-delete.
3. Corriger les copies
Ouvrez le fichier .mar d’un étudiant dans Marionnet, sans l’option --exam. Dans l’onglet
Documents, chaque machine et chaque routeur ont laissé jusqu’à quatre documents : Rapport
sur …, Historique de …, Console de … et Terminal de …. Un document s’ouvre par un double
clic, et les rapports s’affichent mis en forme dans votre navigateur.
Le contenu des quatre documents
| Document | Écrit par | Contenu |
|---|---|---|
| Rapport | la machine virtuelle, à son arrêt | l’état final de la machine : interfaces, couche liaison, tables de routage (IPv4 et IPv6), voisins ARP, transfert de paquets (forwarding), résolution de noms, configuration persistante, pare-feu (iptables, ip6tables, nftables), sockets en écoute, services en échec, processus et points de montage |
| Historique | la machine virtuelle, au fil de la session | toutes les commandes tapées, chacune précédée de sa date |
| Console | Marionnet, sur l’hôte | la console de la machine virtuelle, autrement dit les messages de son noyau et de son init, depuis la première ligne |
| Terminal | Marionnet, sur l’hôte | l’enregistrement du terminal, c’est-à-dire les commandes et leurs sorties, telles que l’étudiant les a vues |
Chaque section du rapport reproduit la sortie de la commande qui l’a produite. Si une commande
manque sur la machine (iptables sur une image minimale, par exemple), le rapport le signale,
au lieu de laisser la section vide.
Annoter un rapport
Un clic droit sur un document, puis Afficher et modifier la source de ce document, ouvre sa
source dans un éditeur, et le bouton OK enregistre la modification dans le projet. Cette
possibilité est réservée à la correction : pendant l’examen, c’est-à-dire avec un Marionnet
lancé par --exam, la source s’ouvre en lecture seule (Afficher la source de ce document),
de sorte que l’étudiant ne peut pas retoucher sa copie depuis l’interface.
Sur quels documents s’appuyer pour noter
Le rapport et l’historique sont écrits par la machine virtuelle elle-même, dans un répertoire où l’étudiant a le droit d’écrire : un étudiant averti pourrait donc les modifier, et la note ne doit pas reposer sur eux seuls.
La console et le terminal, en revanche, sont écrits par Marionnet sur l’hôte, hors de portée de la machine virtuelle. Le terminal contenant les commandes accompagnées de leurs sorties, c’est donc sur lui que la notation peut s’appuyer en toute confiance.
4. Deux options voisines de --exam
Les deux enregistrements effectués par Marionnet, celui de la console et celui du terminal, peuvent aussi être activés séparément, sans le mode examen, par exemple pour une démonstration ou pour la recherche d’un bogue :
marionnet --console-log # enregistre la console de chaque machine
marionnet --terminal-log # enregistre le terminal de chaque machine
L’option --exam active ces deux enregistrements, et y ajoute l’archivage des documents dans le
projet ainsi que les interdictions du § 2.
5. Limites
- Les anciennes images ne produisent pas de rapport. Antérieures à systemd (elles démarrent selon le modèle SysV), elles n’ont pas de véritable séquence d’arrêt, de sorte que le script qui écrit le rapport ne s’exécute jamais. Leur historique, leur console et leur terminal sont en revanche bien enregistrés.
- Les routeurs ne produisent pas de rapport non plus. La seule image de routeur livrée aujourd’hui date de 2014, et elle est elle aussi de type SysV : un routeur archive son historique, sa console et son terminal, mais pas de rapport. Pour juger de sa configuration, appuyez-vous sur ces trois documents, ou bien sur le rapport des machines voisines (leurs routes, leurs voisins ARP).
- Une machine arrêtée dans les toutes premières secondes de son démarrage n’a pas de rapport. Une telle machine n’a, de fait, servi à rien, et son historique est vide.
Détails techniques : l'affichage des rapports
Les rapports sont écrits en Markdown et s’affichent dans le navigateur que Marionnet est configuré
pour utiliser (MARIONNET_HTML_READER, par défaut xdg-open). La conversion en HTML est réalisée
par Marionnet lui-même, et non par un convertisseur installé sur l’hôte : la page affichée est
donc la même partout, sur la machine de l’étudiant, sur la vôtre, et sur celle de quiconque
ouvrira l’archive plus tard.
Par ailleurs, cette page n’est écrite dans aucun fichier : Marionnet la sert sur 127.0.0.1, à
une adresse impossible à deviner, pendant le temps (une ou deux minutes) nécessaire au navigateur
pour la récupérer. C’est ce qui permet d’utiliser un navigateur installé en snap ou en flatpak,
lequel, étant confiné, ne verrait pas un fichier déposé dans /tmp. En contrepartie, un onglet
rechargé longtemps après affiche une erreur : il suffit alors de rouvrir le document.
Le rapport étant écrit sur une machine que l’étudiant contrôle, le HTML qu’il pourrait contenir n’est pas transmis au navigateur : il est retiré, et la page signale en rouge l’endroit où il se trouvait. Autrement dit, rien de ce qui est écrit dans un rapport ne peut s’exécuter dans la page que vous lisez ; le texte retiré reste toutefois visible dans la source.
Si vous préférez un autre convertisseur (pandoc, par exemple, pour un rendu plus riche), indiquez
la commande dans la variable MARIONNET_MARKDOWN_TO_HTML, dans marionnet.conf ou dans
l’environnement ; elle reçoit le Markdown sur son entrée standard. Vous renoncez alors aux deux
garanties précédentes, et Marionnet revient à sa propre conversion si la commande est absente,
échoue, ou ne produit rien.
