InteLIS — aide-mémoires machine

Six fiches d'une page pour la personne qui s'occupe de la machine. Les imprimer et les garder près d'elle.

Aide-mémoire 1 sur 6

Une seule commande pilote la machine

Tout ce qui figure sur ces fiches commence de la même façon.

Ouvrir la fenêtre noire du terminal sur la machine InteLIS et saisir :

intelis

Une liste numérotée s'affiche. Saisir un numéro, appuyer sur Entrée. Rien à retenir.

1) Vérifier que cette machine fonctionne 2) Le site ne s'ouvre pas — trouver la cause et réparer 3) Voir si les sauvegardes fonctionnent 4) Sauvegarder maintenant 5) Mettre à jour InteLIS 6) Restaurer depuis une sauvegarde 7) Changer la destination des sauvegardes 8) Quitter Saisir un numéro et appuyer sur Entrée :

Ou saisir les mots, si c'est plus rapide

Pour faire ceciSaisir
Vérifier que la machine fonctionneintelis check
Le site ne s'ouvre pasintelis fix-database
Vérifier disque, base et sauvegardes maintenantintelis health
Voir si les sauvegardes fonctionnentintelis backup status
Sauvegarder tout de suiteintelis backup
Mettre à jour InteLISintelis update
Restaurer depuis une sauvegardeintelis restore
Changer la destination des sauvegardesintelis backup setup

À quelle fréquence

QuandQuoi
Chaque lundiVérifier que les sauvegardes fonctionnent (menu 3). Dix secondes.
Sur demandeMettre à jour InteLIS (menu 5).
Quand quelque chose clocheVérifier la machine (menu 1) avant d'appeler qui que ce soit.
Quand le site ne s'ouvre pasRéparer la base (menu 2). Rien n'est modifié sans confirmation.
Jamais, normalementSauvegarder à la main. La machine se sauvegarde toutes les 8 heures.
Ne jamais saisir sudo devant intelis La commande demande elle-même les droits d'administrateur, uniquement pour les étapes qui en ont besoin, et c'est seulement à ce moment-là qu'elle demande le mot de passe. Ajouter sudo est inutile et, pour certaines commandes, aggrave les choses : cela exécute en tant qu'administrateur un travail qui doit s'exécuter sous le compte qu'utilise InteLIS.

Si la saisie de intelis répond « command not found »

La machine est une installation ancienne. Lancer la mise à jour une fois avec la commande longue de la fiche 3 ; la commande courte fonctionne ensuite.

Aide-mémoire 2 sur 6

Installer InteLIS sur une machine neuve

Une machine avec Ubuntu et rien d'autre.

Avant de commencer

Ubuntu installéUbuntu 22.04 ou plus récent
InternetNécessaire pendant toute l'installation. Le volume téléchargé est important.
Mot de passe administrateurCelui utilisé pour ouvrir la session sur la machine
TempsPrévoir une heure. Ne pas lancer dix minutes avant de partir.
Il s'agit de remettre un ancien laboratoire sur une machine neuve ? Ne pas utiliser cette fiche. Aller à la fiche 5 et lancer d'abord la restauration. Elle affiche la commande d'installation exacte, avec la sauvegarde déjà rattachée, pour que la machine revienne avec ses données au lieu d'être vide.

Saisir ces trois lignes, une à la fois

cd ~
wget -O setup.sh "https://raw.githubusercontent.com/deforay/intelis/master/scripts/setup.sh?v=$(date +%s)"
sudo bash setup.sh
Toujours télécharger le fichier d'abord Ne jamais réunir ces lignes en une seule qui enverrait le téléchargement directement dans le shell. L'installateur pose des questions, et dans ce cas il y répondrait avec son propre texte. Il refuse de démarrer ainsi, volontairement.

Ce qui sera demandé

QuestionRéponse
Où installerAppuyer sur Entrée pour l'emplacement standard, sauf indication contraire
Mot de passe de la baseEn choisir un et le noter en lieu sûr. Il est irrécupérable.
Adresse du STSL'adresse fournie par le programme. Laisser vide pour un laboratoire autonome.
Quels modulesLes tests réalisés par ce laboratoire

Une fois terminé

  1. Saisir intelis check. Chaque ligne doit indiquer PASS.
  2. Ouvrir un navigateur sur la machine et se connecter.
  3. Configurer les sauvegardes immédiatement, avec la fiche 4. Une machine sans sauvegarde est à une panne de disque de tout perdre.
Aide-mémoire 3 sur 6

Mettre à jour InteLIS

À faire lorsque le programme le demande.

Une fois par machine, la première fois seulement

Cette ligne met à jour les commandes de la machine elle-même. La sauter si cela a déjà été fait sur cette machine.

sudo bash -c "$(curl -fsSL https://raw.githubusercontent.com/deforay/intelis/master/scripts/bootstrap.sh)"

Ensuite, à chaque fois

intelis update

C'est toute la procédure. Laisser la fenêtre ouverte jusqu'à ce qu'elle annonce la fin.

Ce qui se passe pendant l'exécution

1Télécharge la nouvelle version
2Prend un instantané de secours
3Met les nouveaux fichiers en place
4Met à jour la base de données
5Redémarre le serveur web

Avant et après

AvantPrévenir le laboratoire. Les pages peuvent ne pas s'afficher pendant un court moment.
AvantVérifier que les sauvegardes sont à jour : intelis backup status
AprèsLancer intelis check. Chaque ligne doit indiquer PASS.
AprèsSe connecter et ouvrir une page, pour le constater de ses propres yeux.
Ne pas fermer la fenêtre, débrancher ni redémarrer Une mise à jour interrompue laisse du code neuf face à une base ancienne. Si la fenêtre est fermée par accident, relancer la même commande plutôt qu'autre chose. Elle peut être relancée sans risque.

En cas d'échec

La mise à jour conserve un instantané et indique ce qui n'a pas fonctionné. Ne pas tenter de réparer la machine à la main. Lancer intelis check et envoyer la totalité du résultat au support.

Aide-mémoire 4 sur 6

Les sauvegardes

À configurer une fois. À vérifier chaque semaine.

La configuration, une fois par machine

intelis backup setup

La commande demande où doivent aller les sauvegardes, et teste la connexion avant d'enregistrer quoi que ce soit :

1 — Une autre machine LinuxPar le réseau. Il faut son adresse, un nom d'utilisateur et son mot de passe une fois.
2 — Un dossier partagé WindowsPartager d'abord un dossier sur le PC Windows, et donner à l'utilisateur la permission Modifier.
3 — Un disque USB ou externeLe brancher d'abord. Le plus simple, mais quelqu'un doit garder le disque en lieu sûr.

La première sauvegarde est ensuite lancée sous vos yeux. Si elle échoue, elle le dit au lieu de faire croire que tout s'est bien passé.

Ensuite, elle se lance toute seule

Toutes les 8 heures, et après chaque redémarrage. Personne n'a à y penser.

Les dix secondes hebdomadaires

intelis backup status
Lab : kigali-central (kigali-central-a1b2c3d4) Backing up to : labstore@192.168.1.20:/home/labstore/backups/... Last good backup: 2026-08-13T04:00:11Z (6 hours ago) Size on backup : 4.2G Last attempt : succeeded in 143s Schedule : every 8 hours and after every restart
Ce qui est affichéQue faire
Last good backup : il y a quelques heuresRien. C'est exactement ce qu'il faut voir.
Last good backup : neverElle n'a jamais fonctionné. Lancer intelis backup test.
Plus d'un jourLancer intelis backup test pour en connaître la raison.
Last attempt : FAILEDLire la raison à la ligne suivante. En général, l'autre machine est éteinte.
Schedule : OFFLes sauvegardes ne sont pas programmées. Appeler le support.

Les deux autres commandes

intelis backup testVérifie la connexion et indique ce qui serait copié. Ne modifie rien. Sans risque à tout moment.
intelis backupSauvegarde tout de suite, sur cette machine et en dehors. À utiliser avant une mise à jour ou un déménagement.
Une sauvegarde jamais restaurée n'est pas une sauvegarde C'est un espoir. Une fois par an, en restaurer une sur une machine de réserve et vérifier que les données sont bien là. La fiche 5 explique comment.
Aide-mémoire 5 sur 6

Restaurer depuis une sauvegarde

Pour une machine en panne, ou des données perdues.

S'arrêter et réfléchir d'abord Restaurer remplace les données actuelles par des données plus anciennes. Tout ce qui a été saisi depuis cette sauvegarde est perdu. Si la machine fonctionne encore, appeler le support avant de restaurer.

Voir quelles sauvegardes existent

intelis restore --list

En restaurer une

intelis restore

La commande se connecte là où les sauvegardes ont été envoyées, affiche chaque laboratoire qui s'y trouve, recopie celui qui est choisi, et vérifie que les fichiers sont lisibles avant d'en faire quoi que ce soit.

La suite dépend de l'état de la machine

SituationCe qui se passe
InteLIS est installé et fonctionneLa restauration de la base est proposée sur place. Une copie de sécurité des données actuelles est prise d'abord, ce qui permet de revenir en arrière.
La machine est vierge ou vient d'être réinstalléeUne seule commande est affichée : elle installe InteLIS et charge la sauvegarde dans la même étape. Copier cette ligne et la lancer.

Remonter une machine complètement perdue

  1. Installer Ubuntu sur la nouvelle machine.
  2. La raccorder au même réseau que la destination des sauvegardes, ou brancher le disque de sauvegarde.
  3. Lancer intelis restore et choisir le laboratoire.
  4. Copier la commande affichée et la lancer. Prévoir une heure.
  5. Lancer intelis check, puis se connecter et vérifier que les données sont là.
  6. Reconfigurer les sauvegardes avec la fiche 4. La nouvelle machine ne sauvegarde encore rien.
Si les sauvegardes sont chiffrées La commande affichée suffit lorsque la nouvelle machine utilise le même mot de passe de base de données que l'ancienne. Sinon, l'administrateur du STS doit d'abord émettre un jeton de récupération. Le demander avant de commencer, pas à mi-parcours.
Aide-mémoire 6 sur 6

Quand quelque chose ne va pas

À faire avant d'appeler qui que ce soit. Cela répond souvent à la question.

intelis check

La commande examine la machine et affiche une ligne par élément vérifié. Elle fonctionne même quand InteLIS refuse de démarrer, c'est-à-dire précisément quand on en a besoin.

PASS PHP version 8.4.5 PASS Database host localhost WARN Apache post_max_size 8M — large imports will be truncated FAIL Schema version database is at 5.6.3, migrations go to 5.6.5 run: intelis migrate

Comment la lire

PASSCorrect. Ne rien faire.
WARNFonctionne, mais quelque chose posera problème plus tard. À signaler.
FAILCassé. C'est la ligne qui compte.
La ligne en retraitLa commande exacte qui corrige le problème. La saisir telle quelle.

L'autre vérification

intelis health

L'espace disque, la vitesse de la base de données, et si les sauvegardes sont à jour. À utiliser quand la machine fonctionne mais paraît lente ou pleine.

Les cas les plus courants

SymptômeCause probable
Pages blanches ou qui ne chargent pasLancer intelis check. En général une mise à jour interrompue ou une base arrêtée.
Disque utilisé à plus de 90 %Le disque se remplit. Appeler le support avant d'arriver à 100 %, pas après.
Tout est lentLancer intelis health et signaler la latence de la base de données.
Les résultats n'arrivent pas au programmeVérifier les lignes STS URL et STS token dans intelis check.
En appelant le support, envoyer le résultat Lancer intelis check, sélectionner tout le texte de la fenêtre, le copier et l'envoyer. Cela répond à la plupart des questions que le support devrait sinon poser, et transforme deux jours d'échanges en un seul message.

Ce qu'il ne faut pas faire