Debian 13 : tutoriel / Diagnostiquer le démarrage et préparer une récupération avec GRUB et initramfs

Diagnostiquez une panne de démarrage de Debian 13 en identifiant la dernière étape fonctionnelle : firmware, chargeur d'amorçage, noyau, système de fichiers initial ou systemd. Ne concluez pas à une panne de démarrage uniquement parce que la connexion SSH échoue ; vous devez vérifier la console, les partitions root et boot réelles, et le noyau installé. Cette leçon explique comment créer et inspecter un initramfs séparé sur un système normal, ainsi que le champ des modifications et les cibles des procédures de secours à appliquer lors d'une panne réelle.

Identifier l’étape de démarrage et distinguer les échecs SSH

L'interface micrologicielle extensible unifiée (UEFI, Unified Extensible Firmware Interface) est un micrologiciel qui initialise le matériel et trouve le programme de démarrage. Le chargeur de démarrage GNU GRand Unified Bootloader (GRUB) est un chargeur de démarrage qui lit et exécute le noyau et le système de fichiers RAM initial, initramfs. L'espace utilisateur initial d'initramfs aide à trouver le périphérique racine et à passer à la racine réelle. Après cela, systemd configure les services et l'environnement de connexion.

État visible sur la console Enquêtes initiales Tâches à ne pas faire immédiatement
Impossible de trouver le périphérique de démarrage Connexions de disque, ordre de démarrage du micrologiciel, partition système EFI Ne pas réinitialiser le système de fichiers racine.
Menu GRUB ou ligne de commande Chemins des fichiers de démarrage, configuration et identité des périphériques Ne pas appliquer indifféremment les commandes BIOS à l'UEFI.
Messages du noyau ou shell initramfs Noyau sélectionné, UUID de la racine, modules de stockage et chiffrement/LVM Ne pas considérer le noyau de l'environnement en cours comme la version cible de récupération.
Mode d'urgence ou défaillance d'un service fstab, points de montage, unité affectée et journal Ne pas considérer la réinstallation de GRUB comme une réparation universelle.
Il y a un écran de connexion, mais SSH échoue. Adresse, chemin, pare-feu, sshd, authentification Ne déduisez pas un échec de démarrage du noyau à partir d'un échec SSH.

Enregistrez le texte sur l'écran d'erreur, le noyau sélectionné, ainsi que les actions et les horaires juste avant le changement. Pour les VM comme VirtualBox, vérifiez si vous pouvez accéder directement à la console de la VM. Dans cette VM de test, l'invite de connexion de la console et le SSH normal ont été confirmés, donc les opérations n'ont pas été effectuées dans un état rendant le système inbootable.

Vérifier le noyau actif et les montages de démarrage réels

Pendant que le système démarre normalement, conservez séparément les informations suivantes. uname -r est le noyau actuellement en cours d'exécution, pas une liste de tous les noyaux installés. Le ii dans la sortie de dpkg-query indique un état installé, et les entrées comme un ne sont pas comptées comme des noyaux installés.

uname -r
dpkg-query -W -f='${binary:Package} ${db:Status-Abbrev} ${Version}\n' 'linux-image*'
ls -l /boot/vmlinuz-* /boot/initrd.img-*
ls /usr/lib/modules
test -d /sys/firmware/efi && echo 'Booted with UEFI'
findmnt --target / -o TARGET,SOURCE,FSTYPE,OPTIONS
findmnt --target /boot -o TARGET,SOURCE,FSTYPE,OPTIONS
findmnt --mountpoint /boot/efi -o TARGET,SOURCE,FSTYPE,OPTIONS
df -hT /boot /boot/efi /var/tmp
readlink -f /vmlinuz /initrd.img

Lors d'un démarrage BIOS, le test du répertoire EFI peut renvoyer une valeur non nulle et un montage EFI dédié peut ne pas exister. Interprétez ces points comme des observations de disposition, et non comme une preuve d'échec de démarrage. Un UUID (Universally Unique Identifier) identifie ici un système de fichiers indépendamment du nom du périphérique ; après clonage ou recréation, vérifiez aussi les valeurs dupliquées ou modifiées ; vérifiez-le par rapport aux périphériques réels plutôt que de copier les noms de ce laboratoire.

La VM de test utilisait UEFI, GRUB 2.12, le noyau 6.12.107+deb13-amd64, initramfs-tools 0.148.4. /boot était inclus dans la racine ext4, pas une partition séparée, et seul /boot/efi était un vfat séparé. Même si /boot est le même, les serveurs peuvent avoir différentes partitions séparées, LVM, ou chiffrement, donc les noms de périphériques ne sont pas copiés pour être utilisés.

Le menu GRUB permet la vérification de la syntaxe et l’inspection des éléments sur un système normal comme suit. La réussite de la syntaxe ne garantit pas le démarrage du firmware, la lecture du disque ou l’exécution du noyau.

sudo grub-script-check /boot/grub/grub.cfg
sudo grep -E "^(menuentry|submenu)|^[[:space:]]+menuentry " /boot/grub/grub.cfg

Le manuel grub-script-check décrit la vérification de la syntaxe de la configuration. grub.cfg est un fichier de sortie généré ; pour des modifications permanentes, il faut examiner la configuration source et le processus de génération au lieu de modifier directement ce fichier de sortie.

Préparer l'accès à la console et vérifier la présence d'un ancien noyau

Si un problème survient après le nouveau noyau et que le noyau précédent est effectivement installé, vous pouvez consulter comment démarrer sur la version précédente en ouvrant « Advanced options for Debian GNU/Linux » (options avancées pour Debian GNU/Linux) dans la console GRUB. Selon le firmware de la machine virtuelle et les paramètres, la touche d'accès au menu et le temps d'affichage peuvent varier, donc vérifiez la méthode d'accès en état normal.

La machine virtuelle de vérification n'avait qu'un seul noyau effectivement installé, et les éléments standard et de récupération dans GRUB étaient tous deux de la version 6.12.107. L'entrée en mode récupération n'est pas le noyau précédent. S'il n'y a pas d'autre version, cela n'indique pas que la sélection du noyau précédent résoudra le problème.

Si vous avez démarré sur le noyau précédent, vérifiez uname -r, les services, le réseau et les données, et conservez le noyau problématique ainsi que les journaux. Ne supprimez pas d’abord le noyau dont le bon fonctionnement est établi. S'il est impossible de démarrer sur un quelconque noyau, préparez-vous à un accès console et à une récupération depuis l'ISO d'installation et effectuez des sauvegardes. Ici, nous procédons avec la pratique d'image séparée suivante sans remplacer aucun fichier de démarrage normal.

Conservez les fichiers de démarrage et créez un initramfs séparé

mkinitramfs crée une image de système de fichiers initiale pour le noyau spécifié. Cet exercice enregistre les résultats dans un chemin de sauvegarde accessible uniquement à root sans écraser /boot. /var/tmp peut être utilisé comme espace de travail temporaire par défaut, il faut donc vérifier l'espace disponible et les permissions pour exécuter. Les conditions pour les chemins temporaires des outils réels peuvent être trouvées dans la documentation mkinitramfs.

Le bloc complet suivant est exécuté depuis un terminal d'un système Debian normal avec des privilèges sudo. L'exécution s'arrête si un chemin portant le même nom existe, et les enregistrements existants ne sont pas écrasés.

sudo bash <<'ROOT'
set -euo pipefail
dest=/var/backups/lf-debian13-32
if test -e "$dest"; then echo "Destination already exists." >&2; exit 1; fi
install -d -m 700 "$dest"
kernel=$(uname -r)
test -f "/boot/vmlinuz-$kernel"
test -f "/boot/initrd.img-$kernel"
test -d "/usr/lib/modules/$kernel"
sha256sum "/boot/vmlinuz-$kernel" "/boot/initrd.img-$kernel" /boot/grub/grub.cfg > "$dest/boot-before.sha256"
cp -a /etc/fstab /etc/default/grub /etc/initramfs-tools/initramfs.conf "$dest/"
mkinitramfs -o "$dest/initrd-lab.img" "$kernel"
lsinitramfs "$dest/initrd-lab.img" > "$dest/initrd-lab-files.txt"
grep -Fx init "$dest/initrd-lab-files.txt"
grep -F "usr/lib/modules/$kernel/" "$dest/initrd-lab-files.txt" > "$dest/kernel-module-files.txt"
test -s "$dest/kernel-module-files.txt"
stat -c 'image bytes=%s' "$dest/initrd-lab.img"
sha256sum -c "$dest/boot-before.sha256"
ROOT

Les résultats de l'exécution ont confirmé l'entrée init et le chemin du module du noyau correspondant, et la taille de l'image distincte était de 38 975 420 octets. La taille peut varier en fonction des conditions de création et des paquets. Les hachages des fichiers vmlinuz, initrd.img et grub.cfg d'origine étaient tous corrects. La création d'une image distincte et la vérification de la liste se distinguent du fait de démarrer réellement avec cette image.

Les rôles et le champ d'application pris en charge de l'outil de listing sont détaillés dans la documentation lsinitramfs. Une vérification supplémentaire est nécessaire sur la configuration réelle du système pour s'assurer que le pilote du périphérique de stockage souhaité, l'UUID racine et les paramètres LVM/chiffrement sont corrects. Le simple fait d'avoir un grand nombre de fichiers ne détermine pas si l'image est récupérable.

Vérifiez l'environnement de secours et la racine cible lors d'une panne réelle

Cette section est une procédure de récupération qui détermine les conditions applicables lorsqu'une panne de démarrage réelle est confirmée. Sur la VM ci-dessus, les fichiers de démarrage normaux n'ont pas été modifiés, et aucun remplacement réel de fichier n'a été effectué en mode de secours. Comme décrit dans la section de récupération du manuel d’installation Debian, sélectionnez rescue dans le menu du support d’installation ou utilisez rescue/enable=true pour sélectionner la racine à récupérer.

  1. Sécurisez la console du serveur et les moyens de sauvegarde/restauration, et démarrez avec les médias d'installation correspondant au disque existant et à la méthode de démarrage EFI.
  2. Sélectionnez le mode de secours, passez les vérifications de langue et de matériel, et sélectionnez le système de fichiers racine réellement installé. Ne passez pas à l'étape d'initialisation des partitions d'une nouvelle installation.
  3. Vérifiez s'il s'agit d'un shell à l'intérieur de la racine sélectionnée ou du shell propre de l'installateur. S'il s'agit d'un shell à l'intérieur de la racine sélectionnée, vous travaillez déjà dans cet environnement, donc ne faites pas de chroot vers /target à nouveau.
  4. Dans le shell de l'installateur, la racine sélectionnée peut être montée sur /target. Comparez le système d'exploitation et le fstab dans ce répertoire avec les périphériques réels, et s'il y a un /boot ou EFI séparé, connectez-les correctement, puis travaillez dans l'environnement cible.

Les commandes suivantes sont exécutées dans le shell root de l'environnement d'installation pour vérifier la cible. Comme il s'agit du shell root, n'utilisez pas le préfixe sudo. Cela n'a de sens que lorsque /target est le root réellement sélectionné.

lsblk -f
findmnt -R /target
cat /target/etc/os-release
cat /target/etc/fstab
ls /target/usr/lib/modules
ls -l /target/boot

Le chiffrement, le RAID et le LVM doivent d'abord pouvoir utiliser les couches de stockage correspondantes. N’appliquez pas cet exemple simple d'ext4 et d'UEFI tel quel à ces configurations de stockage. Si le root lui-même ne peut pas être lu à cause d'une corruption, déterminez d'abord les conditions pour la vérification du système de fichiers et la restauration de la sauvegarde, et n'appliquez pas e2fsck à un root monté.

Si un chroot manuel est nécessaire dans le shell de l'installateur, /target doit être la racine correcte et capable d'exécuter le shell cible. S'il existe une partition /boot séparée, montez-la d'abord sur le /target/boot cible, et la partition système EFI doit être montée sur /target/boot/efi en utilisant l'UUID réel. Ne dupliquez pas les éléments déjà connectés et vérifiez avec les résultats de findmnt.

Le bloc suivant lie les systèmes de fichiers d'exécution après avoir identifié et monté les partitions de démarrage correctes. Arrêtez-vous sur toute commande de montage échouée et inspectez findmnt -R /target avant de continuer. La propagation esclave récursive empêche les opérations de démontage sous la cible de se propager à l'environnement de secours. Un chroot change la racine apparente du système de fichiers ; il ne démarre pas le noyau installé ni n'établit une frontière de sécurité.

Ci-dessous se trouve un exemple de connexion des montages d'exécution et d'entrée dans l'environnement cible. Cette commande ne remplace pas l'identification du disque. Si des montages comme /target/dev sont déjà préparés, il est recommandé d'utiliser d'abord le shell cible fourni par l'installateur.

for p in dev proc sys run; do
    mount --rbind "/$p" "/target/$p"
    mount --make-rslave "/target/$p"
done
chroot /target /bin/bash

Spécifiez le noyau cible installé avant la réparation

Même à l'intérieur du chroot, uname -r affiche le noyau exécuté depuis le média de secours. Comparez la liste des noyaux installés sur la cible, le répertoire des modules et le fichier vmlinuz pour spécifier la version. Ce qui suit est une vérification effectuée depuis le shell root de la racine cible.

cat /etc/os-release
ls /usr/lib/modules
dpkg-query -W -f='${binary:Package} ${db:Status-Abbrev} ${Version}\n' 'linux-image*'
findmnt --target /boot
findmnt --target /boot/efi
df -hT /boot /boot/efi /var/tmp
read -r -p "Installed kernel version to repair: " target_kernel
test -d "/usr/lib/modules/$target_kernel"
test -f "/boot/vmlinuz-$target_kernel"

Vérifiez également les outils de génération installés. La procédure suivante pour un environnement comme cette VM utilisant initramfs-tools ne s'applique pas telle quelle à un environnement dracut. Avant la récupération, stockez les cibles nécessaires telles que les fichiers de démarrage, la configuration et le contenu EFI dans un emplacement séparé et à accès restreint. Attribuez un nouveau nom à la sauvegarde et n’écrasez pas la copie existante en bon état.

Mettez à jour l'initramfs réel uniquement après avoir corrigé les causes ci-dessus et confirmé l'espace de stockage, les montages root/boot, la version cible et les sauvegardes. Dans le bloc shell root suivant, sélectionnez -u s'il existe une image pour le noyau cible, ou -c s'il n'y en a pas. Cette opération modifie réellement /boot.

set -e
test -n "$target_kernel"
test -d "/usr/lib/modules/$target_kernel"
test -f "/boot/vmlinuz-$target_kernel"
repair_record=$(mktemp -d /var/backups/lf-boot-repair.XXXXXX)
for path in "/boot/vmlinuz-$target_kernel" "/boot/initrd.img-$target_kernel" /boot/grub/grub.cfg /etc/fstab /etc/default/grub; do
    if test -f "$path"; then cp -a -- "$path" "$repair_record/"; fi
done
printf 'backup: %s\n' "$repair_record"
if test -f "/boot/initrd.img-$target_kernel"; then
    update-initramfs -u -k "$target_kernel"
else
    update-initramfs -c -k "$target_kernel"
fi
listing=$(mktemp /var/tmp/lf-repair-initrd.XXXXXX)
lsinitramfs "/boot/initrd.img-$target_kernel" > "$listing"
grep -Fx init "$listing"
rm -- "$listing"
update-grub
grub-script-check /boot/grub/grub.cfg

Le manuel update-initramfs distingue la mise à jour d'une image existante de la création d'une nouvelle. Le manuel update-grub décrit la génération de la configuration GRUB, une opération différente de la réinstallation du chargeur d'amorçage ou de la réparation des entrées de démarrage du firmware.

Si le problème concerne les fichiers EFI ou l'enregistrement du firmware lui-même, un processus de récupération séparé est nécessaire pour vérifier l'architecture cible, l'UEFI/BIOS, le Secure Boot, le montage EFI et les paquets grub/shim installés. Ne réinstallez pas automatiquement le chargeur d'amorçage lorsque GRUB peut lire le noyau, et ne copiez pas les commandes d'exemple de disque BIOS vers l'UEFI.

Vérifiez la récupération et conservez l'image de laboratoire séparée

Lors de la récupération réelle, quittez le chroot, démontez les montages subordonnés que vous avez connectés dans l'ordre inverse, détachez les supports d'installation, puis démarrez depuis le disque. Lors du démontage, n'utilisez pas de commandes générales qui incluent d'autres montages en cours d'utilisation ; vérifiez la hiérarchie réelle avec findmnt -R /target. En cas d'échec du démarrage, conservez les messages de la console, les versions sélectionnées et l'historique des modifications, et répondez en utilisant les procédures de sauvegarde et de restauration préparées.

Si le système démarre, vérifiez uname -r, les montages root et boot, systemctl --failed ainsi que les services nécessaires, les nouvelles connexions SSH, les réponses réelles et les données. Distinguez entre le fait que l'écran de connexion est apparu et le fait que les fonctions fournies à l'origine ont été restaurées.

uname -r
findmnt --target /
findmnt --target /boot
findmnt --mountpoint /boot/efi
sudo systemctl --failed --no-pager
systemctl is-active ssh
ip -brief address
ip route

Les exercices d'image séparés effectués dans un état normal n'ont pas modifié le /boot d'origine, donc la restauration des fichiers de démarrage n'est pas nécessaire. Les images séparées et les copies des listes, hachages et configurations ont été conservées dans /var/backups/lf-debian13-32. Lors de la suppression uniquement des images d'exercice inutiles, assurez-vous de ne pas confondre le /boot/initrd.img d'origine et son chemin, et décidez d'abord si vous souhaitez conserver les enregistrements de récupération.