marionnet.org — un laboratoire de réseaux virtuel

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.