Résoudre les problèmes de démarrage des VM Linux en raison d'erreurs fstab

Fstab (table de système de fichiers) est un fichier de configuration permettant de définir la façon dont les installations de partition de disque, de système de fichiers et de partage de fichiers de votre VM Linux persistent après les redémarrages du système.

Ce document décrit plusieurs conditions dans lesquelles une configuration fstab incorrecte peut entraîner des problèmes de démarrage et propose des conseils de dépannage pour les résoudre.

Voici quelques problèmes courants liés à la mauvaise configuration fstab :

  • Erreur de syntaxe dans le fichier de configuration fstab
  • UUID incorrect
  • Une entrée existe pour un appareil non associé/non disponible
  • Options d'installation obsolètes telles que nobarrier pour le type de système de fichiers xfs dans les images SUSE ou RHEL.

Avant de commencer

  • Si vous souhaitez journaliser la sortie du port série sur Cloud Logging, familiarisez-vous avec Cloud Logging.
  • Si ce n'est pas déjà fait, configurez l'authentification. L'authentification valide votre identité pour accéder aux services et aux API Google Cloud . Pour exécuter du code ou des exemples depuis un environnement de développement local, vous pouvez vous authentifier auprès de Compute Engine en sélectionnant l'une des options suivantes :

    Select the tab for how you plan to use the samples on this page:

    Console

    When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

    gcloud

    1. Installez la Google Cloud CLI. Une fois que la Google Cloud CLI est installée, initialisez-la en exécutant la commande suivante : 

      gcloud init

      Si vous utilisez un fournisseur d'identité (IdP) externe, vous devez d'abord vous connecter à la gcloud CLI avec votre identité fédérée.

    2. Set a default region and zone.

    REST

    Pour utiliser les exemples API REST de cette page dans un environnement de développement local, vous devez utiliser les identifiants que vous fournissez à la gcloud CLI.

      Installez la Google Cloud CLI. Une fois que la Google Cloud CLI est installée, initialisez-la en exécutant la commande suivante : 

      gcloud init

      Si vous utilisez un fournisseur d'identité (IdP) externe, vous devez d'abord vous connecter à la gcloud CLI avec votre identité fédérée.

    Pour en savoir plus, consultez la section S'authentifier pour utiliser REST dans la documentation sur l'authentification Google Cloud .

Identifier les problèmes liés à fstab

Pour les problèmes de démarrage, Google vous recommande vivement de vérifier les journaux de démarrage dans la console série de la VM Linux. La VM passe en mode d'urgence et un message d'erreur indique que le problème concerne fstab.

  [K[[1;31m TIME [0m] Timed out waiting for device dev-incorrect.device.
  [[1;33mDEPEND[0m] Dependency failed for /distribution.
  [[1;33mDEPEND[0m] Dependency failed for Local File Systems.
  ...
  Welcome to emergency mode! After logging in, type "journalctl -xb" to viewsystem logs, "systemctl reboot" to reboot, "systemctl default" to try again to boot into default mode.
  Give root password for maintenance
  (or type Control-D to continue)

Conformément au message d'erreur, il y a une défaillance de dépendance pour le système de fichiers /distribution. La défaillance de dépendance pour un point d'installation du système de fichiers va varier en fonction des noms de systèmes de fichiers utilisés.

Solution

Utilisez les options suivantes pour résoudre l'erreur fstab dans les VM Linux hébergées dans Google Cloud. Vous pouvez résoudre le problème plus rapidement à l'aide de la console série qu'avec la méthode manuelle.

Pour utiliser les méthodes suivantes afin de résoudre le problème fstab, vous devez activer l'accès au port série pour votre VM.

Option 1 : Se connecter à la VM en mode d'urgence à l'aide de la console série

  1. Connectez-vous à la console série de la VM depuis la console Google Cloud . Console série

  2. En mode d'urgence actuel, saisissez le mot de passe racine pour accéder à votre VM.

  3. Utilisez l'éditeur de texte de votre choix pour ouvrir le fichier fstab. Apportez les modifications nécessaires et enregistrez-les dans le fichier fstab. Dans l'exemple suivant, l'éditeur vi est utilisé.

    vi /etc/fstab

    Fichier fstab

    Dans l'exemple précédent, l'appareil de /distribution est dissocié de la VM. Commentez la ligne faisant référence au système de fichiers ou supprimez l'entrée fstab pour le point d'installation /distribution.

    Utilisez man fstab pour obtenir plus de détails sur la configuration et la syntaxe de fstab.

  4. Enregistrez le fichier et quittez l'éditeur. Si vous utilisez l'éditeur vi, appuyez sur ESC + :wq! pour enregistrer et quitter l'éditeur.

  5. Relancez le processus de démarrage en saisissant reboot lorsque vous y êtes invité.

  6. Une fois le problème résolu, le processus de démarrage de la VM doit être terminé et l'invite de connexion apparaît dans la console série.

  7. Vérifiez que vous pouvez vous reconnecter à la VM à l'aide de SSH.

Option 2 : Utiliser le mode mono-utilisateur dans la console série

Cette option peut être utilisée si le mot de passe racine n'est pas défini.

Prérequis : Le paramètre GRUB_TIMEOUT du fichier de configuration grub doit être défini sur une valeur non nulle. Généralement, ce fichier se situe sous /etc/default/grub, mais dans certaines distributions plus anciennes, il peut se trouver dans un autre répertoire.

  1. Accédez à la page "Instances de VM" de la console Google Cloud . Accéder à la page "Instances de VM"

  2. Connectez-vous à la console série de la machine virtuelle depuis la consoleGoogle Cloud . Console série2

  3. Cliquez sur Reinitialiser pour la machine virtuelle depuis la console Google Cloud.

    Fichier de réinitialisation

  4. Dans la fenêtre de la console série, interrompez le processus de démarrage en cliquant sur la touche fléchée pour mettre en pause l'écran ou le menu grub.

  5. Dans la liste des kernels sur l'écran du chargeur de démarrage grub, sélectionnez le kernels et appuyez sur la touche e du clavier.

    Fichier de bootloader

  6. Ajoutez le paramètre rd.break à la fin de la ligne du kernels, puis appuyez sur ctrl+x. Cela permet de démarrer la VM en mode "Un seul utilisateur".

    Menu du bootloader

  7. Installez le système de fichiers racine en mode lecture-écriture.

  8. Analysez le fichier fstab, apportez les modifications nécessaires et enregistrez-le. Pour plus d'informations sur la configuration et la syntaxe, utilisez man fstab. Utilisez l'éditeur de texte de votre choix pour ouvrir le fichier fstab. Dans l'exemple ci-dessous, l'éditeur vi est utilisé.

    vi /etc/fstab

    Fichier fstab2

    Dans cet exemple, l'appareil pour /distribution est dissocié de la VM. Vous devez donc commenter la ligne ou supprimer l'entrée fstab pour le point d'installation /distribution.

  9. Enregistrez le fichier et quittez l'éditeur. Si vous utilisez l'éditeur vi, utilisez ESC+:wq! pour enregistrer et quitter fstab.

  10. Relancez le processus de démarrage en saisissant reboot lorsque vous y êtes invité.

  11. Une fois le problème résolu, le processus de démarrage de la VM doit être terminé et l'invite de connexion doit s'afficher dans la console série.

  12. Vérifiez que vous pouvez vous connecter à la VM à l'aide de SSH.

Option 3 : Sauver la VM

Cette option peut être utilisée si le mot de passe racine n'est pas défini ou si vous ne pouvez pas utiliser le mode "Un seul utilisateur".

Pour en savoir plus, consultez la section Sauver une VM inaccessible.