Si vous rencontrez des problèmes pour installer un système de fichiers Managed Lustre ou vous y connecter depuis une machine cliente ou un cluster GKE, suivez ces étapes pour diagnostiquer le problème.
Vérifier que l'instance Managed Lustre est accessible
Vérifiez que votre instance Managed Lustre est accessible depuis votre environnement client.
Pour tester l'accessibilité directement à l'aide de lctl ping, vous devez disposer d'un accès SSH à votre machine cliente ou à votre nœud GKE Standard :
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 à celle-ci :
12345-0@lo
12345-10.115.0.3@tcp
Un ping ayant échoué renvoie le résultat suivant :
failed to ping 10.115.0.3@tcp: Input/output error
GKE Autopilot bloque l'accès SSH aux nœuds, ce qui empêche l'utilisation directe de lctl ping.
Si votre ping échoue ou si vous diagnostiquez la connectivité à partir d'un cluster Autopilot :
Assurez-vous que votre instance Managed Lustre et votre machine cliente ou votre cluster GKE se trouvent sur le même réseau VPC.
Pour les machines clientes Compute Engine, 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)'Pour les clusters GKE, comparez le résultat des commandes suivantes :
gcloud container clusters describe CLUSTER_NAME \ --location=LOCATION \ --format='get(networkConfig.network)' gcloud lustre instances describe INSTANCE_NAME \ --location=ZONE --format='get(network)'La sortie des commandes
gcloud compute instances describeetgcloud container clusters describeest précédée dehttps://www.googleapis.com/compute/v1/. Tout ce qui suit cette chaîne doit correspondre à la sortie de la commandegcloud lustre instances describe.Examinez 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 vos sous-réseaux clients et l'instance Managed Lustre.
Vérifier le port d'acceptation LNet pour les anciennes instances
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 d'anciennes instances existantes qui ont été créées avec cette option.
Si vous vous connectez à une ancienne instance sur laquelle la compatibilité avec GKE était activée, configurez LNet ou le pilote CSI pour qu'il utilise le port 6988 :
Pour les machines clientes Compute Engine, configurez LNet pour qu'il utilise
accept_port.Pour les clusters GKE, activez le pilote CSI avec l'option
--enable-legacy-lustre-port. Consultez Ports de communication Lustre.
Pour déterminer si une instance existante a été configurée avec cet ancien flag, 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 machines clientes ou activer l'option de port obsolète sur votre cluster GKE.
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 client Lustre. Si vos outils client Lustre échouent, vérifiez si votre instance Compute Engine a été automatiquement mise à niveau 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)
Si les versions de noyau listées par les deux commandes ne correspondent pas, 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 conjointement 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 machine cliente à plusieurs cartes d'interface réseau
Lorsqu'une machine cliente possède plusieurs contrôleurs d'interface réseau et que l'instance Managed Lustre se trouve sur un réseau VPC connecté à une carte d'interface réseau secondaire, telle que 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éseaux 172.17.0.0/16
Les machines clientes Compute Engine et les clusters 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. Pour GKE, assurez-vous que les sous-réseaux de nœuds, les plages d'adresses de pods et les plages d'adresses de services ne chevauchent pas 172.17.0.0/16.
Impossible d'accéder à Managed Lustre depuis un projet appairé
Si vos machines clientes ou vos clusters GKE résident dans un réseau VPC appairé et ne peuvent pas se connecter à votre instance Managed Lustre, vérifiez les points suivants :
L'appairage de VPC seul n'achemine pas le trafic vers la connexion d'accès aux services privés utilisée par Managed Lustre. Pour vous connecter à des réseaux VPC appairés, connectez les deux réseaux via Network Connectivity Center.
Assurez-vous que les règles de pare-feu du réseau VPC hôte et du réseau VPC appairé autorisent le trafic TCP sur les ports
988et6988entre les sous-réseaux clients et la plage d'adresses IP allouée de l'instance.
Pour obtenir des instructions de configuration détaillées et des commandes gcloud, consultez Configurer un réseau VPC.
Échec de l'installation sur les VM protégées avec démarrage sécurisé
Managed Lustre ne peut pas être installé sur des machines clientes sur lesquelles le démarrage sécurisé est activé, telles que 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, rassemblez les informations de diagnostic avant de créer une demande d'assistance. La génération de journaux de diagnostic à l'aide de sosreport nécessite un accès SSH à votre machine ou nœud client.
Nœuds Compute Engine et GKE Standard
Pour les machines clientes Compute Engine et les nœuds GKE Standard sur lesquels l'accès SSH est activé, collectez les journaux de diagnostic à l'aide de l'utilitaire sosreport. L'utilitaire sosreport collecte les journaux système et les informations de configuration, puis génère un fichier d'archive compressé.
Installer sosreport
Pour vérifier que le package sosreport est installé et inclut la compatibilité avec Lustre, connectez-vous en SSH à votre machine cliente et exécutez la commande suivante :
sudo sos report --list-plugins | grep lustre
Si la commande est introuvable ou si elle ne renvoie aucun résultat, installez ou mettez à jour sosreport pour votre système d'exploitation :
Rocky Linux et RHEL
Utilisez le gestionnaire de paquets dnf pour installer le package sos :
sudo dnf install -y sos
Ubuntu
Les machines clientes Ubuntu nécessitent sosreport du canal latest/edge dans snap pour collecter les diagnostics Lustre. Les packages installés à l'aide de apt n'incluent pas le plug-in Lustre.
Si une version antérieure de sosreport a été installée à l'aide de apt, supprimez d'abord le package :
sudo apt remove -y sosreport
Installez sosreport à l'aide de snap :
sudo snap install sosreport --classic --channel=latest/edge
Container-Optimized OS
Utilisez le gestionnaire de packages apt depuis toolbox pour installer le package sosreport :
sudo toolbox
sudo apt install sosreport -y
Générer le rapport
Pour générer un sosreport, exécutez la commande suivante :
sudo sos report --all-logs --batch --tmp-dir=/var
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.
Clusters GKE Autopilot
GKE Autopilot bloque l'accès SSH aux nœuds et limite les conteneurs de débogage privilégiés. Vous ne pouvez pas exécuter sosreport sur des nœuds Autopilot ni depuis des conteneurs de charge de travail.
Si vous rencontrez des échecs d'installation sur un cluster Autopilot, contactez Cloud Customer Care pour obtenir de l'aide.
Pour en savoir plus sur le diagnostic des erreurs de volume GKE, consultez Résoudre les problèmes liés au pilote CSI Managed Lustre.