Maintenir l’appliance à jour

Mettez à jour l’appliance XOA-HL en quatre étapes : relevez ce qui est installé, préparez une fenêtre de maintenance, choisissez le mode de mise à jour, puis vérifiez le résultat. Vous travaillez dans le navigateur, connecté à XOA-HL en tant qu’administrateur. Quelques vérifications en lecture seule se font dans l’appliance, par sa console ou en SSH.

1. Relever l’état de départ

1. Dans le navigateur, ouvrez À propos (/#/about) en tant qu’administrateur.
2. Notez la Version de XOA-HL, la Version de la VM XOA-HL, l’adresse de l’appliance et le tag de l’image d’origine. La version de la VM identifie la construction de l’image. Mettre à jour l’application ne la change pas.

Si vous disposez d’un accès console ou SSH autorisé, exécutez ces commandes en lecture seule dans l’appliance. Utilisez les privilèges root si nécessaire.

rpm -q xoa-hl nodejs
cat /etc/xoa-hl-vm-release
timedatectl
systemctl list-timers 'xoa-hl-*'

Conservez la sortie avec la matrice des versions et les notes de version. La matrice liste les composants livrés ensemble ; elle ne prouve pas qu’ils ont été testés ensemble.

2. Préparer la fenêtre de maintenance

• Exportez la configuration XO. Conservez le fichier et sa phrase secrète hors de l’appliance.
• Notez à part vos modifications de /root/.config/xo-server/config.toml, des fichiers TLS et de /etc/xoa-hl/update.conf. L’export web ne comprend pas ces fichiers.
• Vérifiez que vous pouvez ouvrir la console de l’appliance par XO Lite, au cas où l’interface web serait indisponible.
• Vérifiez que les sauvegardes, les restaurations et les autres tâches de gestion sont terminées.
• Prévoyez une fenêtre assez longue pour un redémarrage du service et, si besoin, un redémarrage ultérieur de l’appliance.

Cette page met à jour uniquement la VM XOA-HL. La mise à jour des hôtes est une tâche distincte : voir le guide de mise à jour pour la bonne cible et les bonnes commandes.

3. Choisir le mode et le canal

Ouvrez Paramètres → Mises à jour XOA-HL (/#/settings/xoa-hl-updates). Pour une mise à jour manuelle, suivez la procédure de mise à jour pour Rechercher des mises à jour et Mettre à jour maintenant.

Choisissez un Mode :

Pour un mode planifié :

1. Vérifiez le Fuseau horaire de l’appliance. La planification utilise ce fuseau, et non celui de l’hôte ou du navigateur. Comparez-le avec la sortie de timedatectl.
2. Réglez la Fréquence, le Jour pour une planification hebdomadaire et l’Heure de début locale. L’exécution démarre à cette heure, sans délai aléatoire.
3. Sélectionnez Enregistrer les paramètres de mise à jour automatique.
4. Vérifiez les réglages enregistrés, ainsi que la liste des timers donnée par systemctl list-timers 'xoa-hl-*'.

Dans Canal de mise à jour, gardez Stable pour la maintenance habituelle. Test ajoute des paquets candidats : utilisez-le seulement sur une appliance de test jetable. Changer de canal n’installe rien et ne rétrograde pas un paquet candidat déjà installé.

La mise à jour gérée lance une mise à jour dnf complète, sauf pour nodejs. L’installation du paquet applicatif redémarre xo-server après la transaction : la page web peut donc se déconnecter. Cela seul ne signifie pas que la mise à jour a échoué.

4. Vérifier le résultat

1. Reconnectez-vous à l’interface web et ouvrez À propos. Vérifiez que la page affiche la version attendue de l’application.
2. Vérifiez que les hôtes attendus sont connectés et que leur inventaire apparaît.
3. Lisez le résultat de la mise à jour. À l’ouverture, la page affiche la dernière vérification enregistrée, y compris une vérification planifiée. Sous Résultat de la dernière exécution automatique, une exécution automatique en échec apparaît dans un bandeau rouge.

Si le résultat n’est pas clair, exécutez ces vérifications en lecture seule dans l’appliance :

systemctl status xo-server xoa-hl-update.service --no-pager
journalctl -u xoa-hl-update.service -u xo-server --since '1 hour ago' --no-pager
tail -n 100 /var/lib/xoa-hl/update.log
cat /var/lib/xoa-hl/auto-update.status
cat /run/xoa-hl/status

Une installation manuelle ne met pas à jour l’enregistrement de l’exécution automatique. Le service de vérification peut se terminer sans erreur et signaler quand même un problème : lisez donc son résultat. Conservez les journaux utiles avant de réessayer.

Vérification : À propos affiche la version attendue, les hôtes attendus sont connectés et le résultat de la mise à jour indique un succès.

Si l’opération ne se termine pas normalement

Il n’y a aucun redémarrage automatique. La vérification et l’installation gérées partagent un verrou, mais une commande dnf lancée depuis un shell échappe à ce verrou. Tant qu’une mise à jour peut être en cours, ne lancez jamais un autre processus dnf, n’arrêtez pas une transaction en cours et ne redémarrez pas pour débloquer l’outil de mise à jour.