Wenn beim Bereitstellen oder Verbinden mit einem Managed Lustre-Dateisystem von einem Clientcomputer oder GKE-Cluster Probleme auftreten, führen Sie die folgenden Schritte aus, um das Problem zu diagnostizieren.
Prüfen, ob die Managed Lustre-Instanz erreichbar ist
Prüfen Sie, ob Ihre Managed Lustre-Instanz von Ihrer Clientumgebung aus erreichbar ist.
Wenn Sie die Erreichbarkeit direkt mit lctl ping testen möchten, benötigen Sie SSH-Zugriff auf Ihren Clientcomputer oder GKE Standard-Knoten:
sudo lctl ping IP_ADDRESS@tcp
Informationen zum Abrufen des Werts von IP_ADDRESS finden Sie unter Instanz abrufen.
Ein erfolgreicher Ping gibt eine Antwort ähnlich der folgenden zurück:
12345-0@lo
12345-10.115.0.3@tcp
Ein fehlgeschlagener Ping-Befehl gibt Folgendes zurück:
failed to ping 10.115.0.3@tcp: Input/output error
GKE Autopilot blockiert den SSH-Zugriff auf Knoten und verhindert so die direkte Verwendung von lctl ping.
Wenn der Ping fehlschlägt oder Sie die Verbindung von einem Autopilot-Cluster aus diagnostizieren:
Achten Sie darauf, dass sich Ihre Managed Lustre-Instanz und Ihr Clientcomputer oder GKE-Cluster im selben VPC-Netzwerk befinden.
Vergleichen Sie für Compute Engine-Clientcomputer die Ausgabe der folgenden Befehle:
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)'Vergleichen Sie für GKE-Cluster die Ausgabe der folgenden Befehle:
gcloud container clusters describe CLUSTER_NAME \ --location=LOCATION \ --format='get(networkConfig.network)' gcloud lustre instances describe INSTANCE_NAME \ --location=ZONE --format='get(network)'Die Ausgabe der Befehle
gcloud compute instances describeundgcloud container clusters describewird mit dem Präfixhttps://www.googleapis.com/compute/v1/versehen. Alles, was auf diesen String folgt, muss mit der Ausgabe des Befehlsgcloud lustre instances describeübereinstimmen.Prüfen Sie die Firewallregeln und Routingkonfigurationen Ihres VPC-Netzwerk, um sicherzustellen, dass Traffic zwischen Ihren Client-Subnetzen und der Managed Lustre-Instanz zugelassen wird.
LNet-Annahmeport für Legacy-Instanzen prüfen
Das Flag --gke-support-enabled ist zwar veraltet und wird beim Erstellen neuer Managed Lustre-Instanzen nicht mehr benötigt, aber Sie haben möglicherweise vorhandene ältere Instanzen, die mit diesem Flag erstellt wurden.
Wenn Sie eine Verbindung zu einer Legacy-Instanz herstellen, für die GKE-Unterstützung aktiviert wurde, konfigurieren Sie LNet oder den CSI-Treiber für die Verwendung von Port 6988:
Konfigurieren Sie für Compute Engine-Clientmaschinen LNet für die Verwendung von
accept_port.- Weitere Informationen finden Sie unter LNet für
gke-support-enabled-Instanzen konfigurieren.
- Weitere Informationen finden Sie unter LNet für
Aktivieren Sie für GKE-Cluster den CSI-Treiber mit dem Flag
--enable-legacy-lustre-port. Weitere Informationen finden Sie unter Lustre-Kommunikationsports.
Führen Sie den folgenden Befehl aus, um festzustellen, ob eine vorhandene Instanz mit diesem Legacy-Flag konfiguriert wurde:
gcloud lustre instances describe INSTANCE_NAME \
--location=LOCATION | grep gkeSupportEnabled
Wenn der Befehl gkeSupportEnabled: true zurückgibt, müssen Sie LNet auf Ihren Clientcomputern konfigurieren oder das Legacy-Port-Flag in Ihrem GKE-Cluster aktivieren.
Ubuntu-Kernel-Version stimmt nicht mit Lustre-Client überein
Bei Compute Engine-Instanzen, auf denen Ubuntu ausgeführt wird, muss die Ubuntu-Kernel-Version mit der spezifischen Version der Lustre-Clientpakete übereinstimmen. Wenn Ihre Lustre-Clienttools fehlschlagen, prüfen Sie, ob Ihre Compute Engine-Instanz automatisch auf einen neueren Kernel aktualisiert wurde.
So prüfen Sie die Kernel-Version:
uname -r
Die Antwort sieht in etwa so aus:
6.8.0-1029-gcp
So prüfen Sie die Version Ihres Lustre-Clientpakets:
dpkg -l | grep -i lustre
Die Antwort sieht in etwa so aus:
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)
Wenn die Kernel-Versionen der beiden Befehle nicht übereinstimmen, müssen Sie die Lustre-Clientpakete neu installieren.
dmesg auf Lustre-Fehler prüfen
Viele Lustre-Warnungen und -Fehler werden im Linux-Kernel-Ringpuffer protokolliert. Mit dem Befehl dmesg wird der Kernel-Ringpuffer ausgegeben.
Wenn Sie nach Lustre-spezifischen Nachrichten suchen möchten, verwenden Sie grep in Verbindung mit dmesg:
dmesg | grep -i lustre
Oder suchen Sie nach allgemeineren Fehlern, die damit zusammenhängen könnten:
dmesg | grep -i error
Lustre kann auf einem Clientcomputer mit mehreren NICs nicht bereitgestellt werden
Wenn ein Clientcomputer mehrere Netzwerkschnittstellen-Controller hat und sich die Managed Lustre-Instanz in einem VPC-Netzwerk befindet, das mit einer sekundären NIC wie eth1 verbunden ist, kann das Bereitstellen der Instanz fehlschlagen. Folgen Sie der Anleitung zum Bereitstellen mit einer sekundären NIC, um dieses Problem zu beheben.
Verbindung über den Subnetzbereich 172.17.0.0/16 nicht möglich
Compute Engine-Clientmaschinen und GKE-Cluster mit einer IP-Adresse im Subnetzbereich 172.17.0.0/16 können keine Managed Lustre-Instanzen bereitstellen. Achten Sie bei GKE darauf, dass sich Knotensubnetze, Pod-Adressbereiche und Dienstadressbereiche nicht mit 172.17.0.0/16 überschneiden.
Kein Zugriff auf Managed Lustre über ein Peering-Projekt
Wenn sich Ihre Clientmaschinen oder GKE-Cluster in einem Peering-VPC-Netzwerk befinden und keine Verbindung zu Ihrer Managed Lustre-Instanz herstellen können, prüfen Sie Folgendes:
VPC-Peering allein leitet keinen Traffic an die von Managed Lustre verwendete Verbindung für den Zugriff auf private Dienste weiter. Wenn Sie eine Verbindung über Peering-VPC-Netzwerke herstellen möchten, verbinden Sie beide Netzwerke über das Network Connectivity Center.
Achten Sie darauf, dass die Firewallregeln sowohl im Host-VPC-Netzwerk als auch im Peering-VPC-Netzwerk TCP-Traffic über die Ports
988und6988zwischen Client-Subnetzen und dem zugewiesenen IP-Adressbereich der Instanz zulassen.
Eine detaillierte Anleitung zur Einrichtung und die entsprechenden gcloud-Befehle finden Sie unter VPC-Netzwerk konfigurieren.
Bereitstellung schlägt auf Shielded VMs mit Secure Boot fehl
Managed Lustre kann nicht auf Clientcomputern bereitgestellt werden, auf denen Secure Boot aktiviert ist, z. B. Shielded VMs. Der Versuch, das Lustre-Kernelmodul in einer Secure Boot-Umgebung zu laden, schlägt mit dem Fehler ERROR: could not insert 'lustre': Required key not available. fehl.
Informationen, die in einer Supportanfrage enthalten sein sollten
Wenn Sie den Bereitstellungsfehler nicht beheben können, erfassen Sie Diagnoseinformationen, bevor Sie eine Supportanfrage erstellen. Zum Generieren von Diagnoselogs mit sosreport ist SSH-Zugriff auf Ihren Clientcomputer oder Knoten erforderlich.
Compute Engine- und GKE Standard-Knoten
Erfassen Sie für Compute Engine-Clientmaschinen und GKE Standard-Knoten, auf denen der SSH-Zugriff aktiviert ist, Diagnoselogs mit dem Dienstprogramm sosreport. Das Dienstprogramm sosreport erfasst Systemprotokolle und Konfigurationsinformationen und generiert eine komprimierte Archivdatei.
sosreport installieren
Um zu prüfen, ob das Paket sosreport installiert ist und Lustre unterstützt, stellen Sie eine SSH-Verbindung zu Ihrem Clientcomputer her und führen Sie den folgenden Befehl aus:
sudo sos report --list-plugins | grep lustre
Wenn der Befehl nicht gefunden wird oder keine Ausgabe zurückgibt, installieren oder aktualisieren Sie sosreport für Ihr Betriebssystem:
Rocky Linux und RHEL
Verwenden Sie den Paketmanager dnf, um das Paket sos zu installieren:
sudo dnf install -y sos
Ubuntu
Ubuntu-Clientcomputer benötigen sosreport aus dem latest/edge-Kanal in snap, um Lustre-Diagnosedaten zu erfassen. Pakete, die mit apt installiert wurden, enthalten das Lustre-Plug-in nicht.
Wenn eine frühere Version von sosreport mit apt installiert wurde, entfernen Sie zuerst das Paket:
sudo apt remove -y sosreport
Installieren Sie sosreport mit snap:
sudo snap install sosreport --classic --channel=latest/edge
Container-Optimized OS
Verwenden Sie den Paketmanager apt in der Toolbox, um das Paket sosreport zu installieren:
sudo toolbox
sudo apt install sosreport -y
Bericht erstellen
Führen Sie den folgenden Befehl aus, um ein sosreport zu generieren:
sudo sos report --all-logs --batch --tmp-dir=/var
Hängen Sie das Archiv sosreport an Ihre Supportanfrage an.
Weitere Informationen zum Dienstprogramm sosreport finden Sie unter Debugging-Informationen mit sosreport erfassen.
GKE Autopilot-Cluster
GKE Autopilot blockiert den SSH-Zugriff auf Knoten und schränkt privilegierte Debugging-Container ein. Sie können sosreport nicht auf Autopilot-Knoten oder in Arbeitslastcontainern ausführen.
Wenn bei einem Autopilot-Cluster Fehler beim Bereitstellen auftreten, wenden Sie sich an den Cloud Customer Care.
Weitere Informationen zur Diagnose von GKE-Volume-Fehlern finden Sie unter Fehlerbehebung für den Managed Lustre-CSI-Treiber.