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, en anglais. Saisir un numéro, appuyer sur Entrée. Rien à retenir.

1) Check this machine is working 2) The site will not open — find out why and fix it 3) See whether backups are working 4) Back up now 5) Update InteLIS 6) Restore from a backup 7) Change where backups are sent 8) Quit Type a number and press Enter:

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 doctor
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 pasTrouver la cause et réparer (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. Ajouter sudo exécute en tant qu'administrateur un travail qui doit s'exécuter sous le compte d'InteLIS, ce qui casse certaines commandes.

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 24.04 LTS 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. Utiliser la fiche 5. Elle installe InteLIS et charge la sauvegarde en une seule étape, 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
Installation directoryAppuyer sur Entrée pour l'emplacement standard, sauf indication contraire
What is this machine?Lab machine (LIS)
Remote STS URLL'adresse fournie par le programme. Laisser vide pour un laboratoire autonome.
New MySQL root passwordEn choisir un, le saisir deux fois et le noter en lieu sûr. Il est irrécupérable.

Une fois terminé

  1. Saisir intelis check. Aucune ligne ne doit indiquer FAIL.
  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. Aucune ligne ne doit indiquer FAIL.
AprèsSe connecter et ouvrir une page, pour vérifier qu'elle s'affiche.
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 :

Une autre machine LinuxPar le réseau. Il faut son adresse, un nom d'utilisateur et son mot de passe une fois.
Un dossier partagé WindowsPartager d'abord un dossier sur le PC Windows, et donner à l'utilisateur la permission Modifier.
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 à l'écran. 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 : backup@192.168.1.20:/home/backup/backups/... Last good backup: 2026-08-13T04:00:11Z (6 hours ago) Size on backup : 4.2G History : 2026-07-15 to 2026-08-13 (30 days) 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. Lancer intelis backup enable.

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.

InteLIS fonctionne encore sur cette machine

intelis restore

La commande se connecte là où les sauvegardes ont été envoyées, recopie le laboratoire choisi et vérifie que les fichiers sont lisibles. Elle propose ensuite de restaurer la base sur place, après une copie de sécurité des données actuelles. Pour seulement voir quelles sauvegardes existent, saisir intelis restore --list.

Remonter une machine complètement perdue

La commande intelis n'existe pas encore sur une machine neuve. Suivre l'une de ces voies à la place.

  1. Installer Ubuntu 24.04 LTS ou plus récent sur la nouvelle machine, et la connecter à internet.
  2. Lancer l'installation avec les sauvegardes, par la voie qui correspond à leur emplacement.
    Une copie de l'ancien dossier backups sur une clé USB. La brancher et saisir :
    cd ~ && wget -O setup.sh "https://raw.githubusercontent.com/deforay/intelis/master/scripts/setup.sh?v=$(date +%s)"
    sudo bash setup.sh --restore-from-backup-folder
    Avant d'appuyer sur Entrée, saisir un espace et glisser le dossier backups sur la fenêtre du terminal.
    Sauvegardes envoyées vers une autre machine Linux, un partage Windows ou un disque de sauvegarde. Saisir :
    cd ~ && wget -O restore-backup.sh https://raw.githubusercontent.com/deforay/intelis/master/scripts/restore-backup.sh
    sudo bash restore-backup.sh
    Choisir le laboratoire, puis Just the database backups. Copier la commande affichée à la fin, et la lancer.
  3. Répondre à l'installation : Lab machine (LIS), l'adresse de l'ancien STS, et un nouveau mot de passe root MySQL. Attendre Setup complete.
  4. Se connecter avec un compte administrateur de l'ancienne machine, et vérifier que les données sont là.
  5. Reconfigurer les sauvegardes avec la fiche 4. La nouvelle machine ne sauvegarde encore rien.
Si l'installation s'arrête sur « Failed to decrypt » L'installation lit la clé dans le dossier config copié avec les sauvegardes. Sans lui, l'administrateur du STS doit émettre un jeton de récupération à usage unique. Relancer la même commande d'installation en ajoutant --sts-url et --recovery-token avec les valeurs fournies.
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 doctor. La commande trouve la cause et propose de la corriger. En général une mise à jour interrompue ou une base arrêtée.
La base de données ne démarre pasLancer intelis fix-database. Rien n'est modifié sans confirmation.
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