Résoudre les problèmes de connexion client

Si vous rencontrez des problèmes lors de l'installation ou de la connexion à un système de fichiers Managed Lustre sur une VM ou une instance cliente, suivez ces étapes pour diagnostiquer le problème.

Vérifier que l'instance Managed Lustre est accessible

Tout d'abord, assurez-vous que votre instance Managed Lustre est accessible depuis votre instance cliente :

sudo lctl ping IP_ADDRESS@tcp

Pour obtenir la valeur de IP_ADDRESS, consultez Obtenir une instance.

Un ping réussi renvoie une réponse semblable à la suivante :

12345-0@lo
12345-10.115.0.3@tcp

Un ping échoué renvoie le message suivant :

failed to ping 10.115.0.3@tcp: Input/output error

Si votre ping échoue :

  • Assurez-vous que votre instance Managed Lustre et votre instance cliente se trouvent dans le même réseau VPC. Comparez le résultat des commandes suivantes :

    gcloud compute instances describe VM_NAME \
      --zone=VM_ZONE \
      --format='get(networkInterfaces[0].network)'
    
    gcloud lustre instances describe INSTANCE_NAME \
      --location=ZONE --format='get(network)'
    

    Le résultat ressemble à ceci:

    https://www.googleapis.com/compute/v1/projects/my-project/global/networks/my-network
    projects/my-project/global/networks/my-network
    

    La sortie de la commande gcloud compute instances describe est précédée de https://www.googleapis.com/compute/v1/. Tout ce qui suit cette chaîne doit correspondre à la sortie de la commande gcloud lustre instances describe.

  • Vérifiez les règles de pare-feu et les configurations de routage de votre réseau VPC pour vous assurer qu'elles autorisent le trafic entre votre instance cliente et l'instance Managed Lustre.

Vérifier le port d'acceptation LNet (instances héritées)

Bien que l'option --gke-support-enabled soit obsolète et ne soit plus requise lors de la création d'instances Managed Lustre, vous pouvez avoir des instances plus anciennes créées avec cette option.

Si vous vous connectez à une instance héritée pour laquelle la compatibilité avec GKE a été activée, vous devez configurer LNet sur toutes les instances Compute Engine clientes pour utiliser accept_port 6988. Consultez Configurer LNet pour les instancesgke-support-enabled.

Pour déterminer si une instance existante a été configurée avec cette option héritée, exécutez la commande suivante :

gcloud lustre instances describe INSTANCE_NAME \
  --location=LOCATION | grep gkeSupportEnabled

Si la commande renvoie gkeSupportEnabled: true, vous devez configurer LNet sur vos VM clientes.

Incompatibilité de la version de noyau Ubuntu avec le client Lustre

Pour les instances Compute Engine exécutant Ubuntu, la version du noyau Ubuntu doit correspondre à la version spécifique des packages clients Lustre. Si vos outils clients Lustre échouent, vérifiez si votre instance Compute Engine a été mise à niveau automatiquement vers un noyau plus récent.

Pour vérifier la version de votre noyau :

uname -r

La réponse est semblable à ce qui suit :

6.8.0-1029-gcp

Pour vérifier la version de votre package client Lustre :

dpkg -l | grep -i lustre

La réponse est semblable à ce qui suit :

ii  lustre-client-modules-6.8.0-1029-gcp 2.14.0-ddn198-1  amd64  Lustre Linux kernel module (kernel 6.8.0-1029-gcp)
ii  lustre-client-utils                  2.14.0-ddn198-1  amd64  Userspace utilities for the Lustre filesystem (client)

S'il existe une incompatibilité entre la version du noyau indiquée par les deux commandes, vous devez réinstaller les packages clients Lustre.

Vérifier les erreurs Lustre dans dmesg

De nombreux avertissements et erreurs Lustre sont consignés dans le tampon circulaire du noyau Linux. La commande dmesg affiche le tampon circulaire du noyau.

Pour rechercher des messages spécifiques à Lustre, utilisez grep en association avec dmesg :

dmesg | grep -i lustre

Vous pouvez également rechercher des erreurs plus générales qui pourraient être liées :

dmesg | grep -i error

Échec de l'installation de Lustre sur une VM à plusieurs cartes d'interface réseau

Lorsqu'une VM possède plusieurs contrôleurs d'interface réseau (NIC) et que l'instance Managed Lustre se trouve sur un VPC connecté à une carte d'interface réseau secondaire (par exemple, eth1), l'installation de l'instance peut échouer. Pour résoudre ce problème, suivez les instructions pour installer à l'aide d'une carte d'interface réseau secondaire.

Impossible de se connecter à partir de la plage de sous-réseau 172.17.0.0/16

Les clients Compute Engine et GKE dont l'adresse IP se trouve dans la plage de sous-réseau 172.17.0.0/16 ne peuvent pas installer d'instances Managed Lustre.

Impossible d'accéder à Managed Lustre à partir d'un projet appairé

Pour accéder à votre instance Managed Lustre à partir d'une VM dans un réseau VPC appairé, vous devez utiliser Network Connectivity Center (NCC). NCC vous permet de connecter plusieurs réseaux VPC et réseaux sur site à un hub central, ce qui assure la connectivité entre eux.

Pour savoir comment configurer NCC, consultez la documentation de Network Connectivity Center.

Échec de l'installation sur les VM protégées (démarrage sécurisé)

Managed Lustre ne peut pas être installé sur les VM protégées. La tentative de chargement du module de noyau Lustre dans un environnement de démarrage sécurisé échoue avec l'erreur suivante : ERROR: could not insert 'lustre': Required key not available.

Informations à inclure dans une demande d'assistance

Si vous ne parvenez pas à résoudre l'échec de l'installation, collectez des informations de diagnostic avant de créer une demande d'assistance. Vous devez disposer d'un accès SSH à votre machine cliente pour exécuter les commandes de cette section.

L'utilitaire sosreport collecte les journaux système et les informations de configuration, puis génère un fichier tar compressé.

Pour générer un sosreport, connectez-vous à votre machine cliente via SSH. Exécutez ensuite la commande suivante :

sudo sos report --all-logs --batch --tmp-dir=/var

Si la commande est introuvable :

Rocky Linux et RHEL

Utilisez le gestionnaire de packages dnf pour installer le package sos :

sudo dnf install -y sos

Ubuntu

Utilisez le gestionnaire de packages apt pour installer le package sosreport :

sudo apt update
sudo apt install -y sosreport

Container-Optimized OS

Utilisez le gestionnaire de packages apt à partir de la boîte à outils pour installer le package sosreport :

sudo toolbox
sudo apt install sosreport -y

Joignez l'archive sosreport à votre demande d'assistance.

Pour en savoir plus sur l'utilitaire sosreport, consultez Collecter des informations de débogage à l'aide de sosreport.