Se riscontri problemi di montaggio o connessione a un file system Managed Lustre da una macchina client o da un cluster GKE, segui questi passaggi per diagnosticare il problema.
Verifica che l'istanza Managed Lustre sia raggiungibile
Verifica che l'istanza Managed Lustre sia raggiungibile dal tuo ambiente client.
Per testare la raggiungibilità direttamente utilizzando lctl ping, è necessario l'accesso SSH alla macchina client o al nodo GKE Standard:
sudo lctl ping IP_ADDRESS@tcp
Per ottenere il valore di IP_ADDRESS, consulta Ottieni un'istanza.
Un ping riuscito restituisce una risposta simile alla seguente:
12345-0@lo
12345-10.115.0.3@tcp
Un ping non riuscito restituisce quanto segue:
failed to ping 10.115.0.3@tcp: Input/output error
GKE Autopilot blocca l'accesso SSH ai nodi, impedendo l'utilizzo diretto di lctl ping.
Se il ping non va a buon fine o se diagnostichi la connettività da un cluster Autopilot:
Assicurati che l'istanza Managed Lustre e la macchina client o il cluster GKE si trovino nella stessa rete VPC.
Per le macchine client di Compute Engine, confronta l'output dei seguenti comandi:
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)'Per i cluster GKE, confronta l'output dei seguenti comandi:
gcloud container clusters describe CLUSTER_NAME \ --location=LOCATION \ --format='get(networkConfig.network)' gcloud lustre instances describe INSTANCE_NAME \ --location=ZONE --format='get(network)'L'output dei comandi
gcloud compute instances describeegcloud container clusters describeè preceduto dahttps://www.googleapis.com/compute/v1/; tutto ciò che segue questa stringa deve corrispondere all'output del comandogcloud lustre instances describe.Esamina le regole firewall e le configurazioni di routing della rete VPC per assicurarti che consentano il traffico tra le subnet client e l'istanza Managed Lustre.
Controlla la porta di accettazione LNet per le istanze legacy
Sebbene il flag --gke-support-enabled sia deprecato e non sia più richiesto
durante la creazione di nuove istanze Managed Lustre, potresti avere
istanze precedenti esistenti create con questo flag.
Se ti connetti a un'istanza legacy in cui era abilitato il supporto di GKE, configura LNet o il driver CSI in modo che utilizzi la porta 6988:
Per le macchine client di Compute Engine, configura LNet in modo che utilizzi
accept_portPer i cluster GKE, abilita il driver CSI con il flag
--enable-legacy-lustre-port. Consulta Porte di comunicazione Lustre.
Per determinare se un'istanza esistente è stata configurata con questo flag legacy, esegui il seguente comando:
gcloud lustre instances describe INSTANCE_NAME \
--location=LOCATION | grep gkeSupportEnabled
Se il comando restituisce gkeSupportEnabled: true, devi configurare LNet sulle tue macchine client o attivare il flag della porta legacy sul tuo cluster GKE.
Mancata corrispondenza della versione kernel Ubuntu con il client Lustre
Per le istanze Compute Engine che eseguono Ubuntu, la versione kernel di Ubuntu deve corrispondere alla versione specifica dei pacchetti client Lustre. Se gli strumenti client Lustre non funzionano, controlla se l'istanza Compute Engine ha eseguito l'upgrade automatico a un kernel più recente.
Per controllare la versione kernel:
uname -r
La risposta è simile alla seguente:
6.8.0-1029-gcp
Per controllare la versione del pacchetto client Lustre:
dpkg -l | grep -i lustre
La risposta è simile alla seguente:
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)
Se esiste una mancata corrispondenza tra la versione kernel elencata da entrambi i comandi, devi reinstallare i pacchetti client Lustre.
Controlla dmesg per verificare la presenza di errori di Lustre
Molti avvisi ed errori di Lustre vengono registrati nel buffer circolare del kernel Linux. Il comando dmesg stampa il buffer circolare del kernel.
Per cercare messaggi specifici di Lustre, utilizza grep insieme a dmesg:
dmesg | grep -i lustre
In alternativa, per cercare errori più generali che potrebbero essere correlati:
dmesg | grep -i error
Il montaggio di Lustre su una macchina client multi-NIC non va a buon fine
Quando una macchina client ha più controller di interfaccia di rete e l'istanza di Managed Lustre si trova su una rete VPC connessa a una NIC secondaria, ad esempio eth1, il montaggio dell'istanza potrebbe non riuscire. Per risolvere il problema, segui le istruzioni per eseguire il montaggio utilizzando una NIC secondaria.
Impossibile connettersi dall'intervallo di subnet 172.17.0.0/16
Le macchine client di Compute Engine e i cluster GKE con un indirizzo IP nell'intervallo di subnet 172.17.0.0/16 non possono montare istanze di Managed Lustre. Per GKE, assicurati che le subnet dei nodi, gli intervalli di indirizzi dei pod e gli intervalli di indirizzi dei servizi non si sovrappongano a 172.17.0.0/16.
Impossibile accedere a Managed Lustre da un progetto in peering
Se le tue macchine client o i tuoi cluster GKE si trovano in una rete VPC in peering e non riescono a connettersi all'istanza Managed Lustre, verifica quanto segue:
Il peering VPC da solo non instrada il traffico alla connessione di accesso privato ai servizi utilizzata da Managed Lustre. Per connetterti tra reti VPC in peering, connetti entrambe le reti tramite Network Connectivity Center.
Assicurati che le regole firewall sia nella rete VPC host sia nella rete VPC in peering consentano il traffico TCP sulle porte
988e6988tra le subnet client e l'intervallo di indirizzi IP allocato dell'istanza.
Per istruzioni dettagliate sulla configurazione e i comandi gcloud, consulta Configura una rete VPC.
Il montaggio non riesce sulle Shielded VM con l'avvio protetto
Managed Lustre non può essere montato su macchine client con l'avvio protetto abilitato, ad esempio le Shielded VM. Il tentativo di caricare il modulo kernel Lustre in un ambiente con Avvio protetto non va a buon fine e genera l'errore:
ERROR: could not insert 'lustre': Required key not available.
Informazioni da includere in una richiesta di assistenza
Se non riesci a risolvere l'errore di montaggio, raccogli le informazioni di diagnostica prima di creare una richiesta di assistenza. La generazione dei log di diagnostica utilizzando sosreport richiede l'accesso SSH alla macchina o al nodo client.
Nodi Compute Engine e GKE Standard
Per le macchine client di Compute Engine e i nodi GKE Standard in cui è abilitato l'accesso SSH, raccogli i log di diagnostica utilizzando l'utilità sosreport. L'utilità sosreport raccoglie i log di sistema e le informazioni di configurazione e genera un file di archivio compresso.
Installa sosreport
Per verificare che il pacchetto sosreport sia installato e includa il supporto di Lustre,
connettiti tramite SSH alla macchina client ed esegui il seguente comando:
sudo sos report --list-plugins | grep lustre
Se il comando non viene trovato o non restituisce alcun output, installa o aggiorna sosreport per il tuo sistema operativo:
Rocky Linux e RHEL
Utilizza il gestore di pacchetti dnf per installare il pacchetto sos:
sudo dnf install -y sos
Ubuntu
Le macchine client Ubuntu richiedono sosreport dal canale latest/edge in
snap per raccogliere la diagnostica di Lustre. I pacchetti installati utilizzando apt non includono il plug-in Lustre.
Se una versione precedente di sosreport è stata installata utilizzando apt, rimuovi prima il pacchetto:
sudo apt remove -y sosreport
Installa sosreport utilizzando snap:
sudo snap install sosreport --classic --channel=latest/edge
Container-Optimized OS
Utilizza il gestore di pacchetti apt all'interno di toolbox per installare il pacchetto sosreport:
sudo toolbox
sudo apt install sosreport -y
Genera il report
Per generare un sosreport, esegui questo comando:
sudo sos report --all-logs --batch --tmp-dir=/var
Allega l'archivio sosreport alla richiesta di assistenza.
Per ulteriori informazioni sull'utilità sosreport, consulta
Raccolta di informazioni di debug utilizzando sosreport.
Cluster GKE Autopilot
GKE Autopilot blocca l'accesso SSH ai nodi e limita i container di debug con privilegi. Non puoi eseguire sosreport sui nodi Autopilot o all'interno dei container dei workload.
Se riscontri errori di montaggio su un cluster Autopilot, contatta l'assistenza clienti Google Cloud per ricevere aiuto.
Per saperne di più sulla diagnosi degli errori dei volumi GKE, consulta Risolvi i problemi del driver CSI di Managed Lustre.