Risolvere i problemi di connessione client

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 describe e gcloud container clusters describe è preceduto da https://www.googleapis.com/compute/v1/; tutto ciò che segue questa stringa deve corrispondere all'output del comando gcloud 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 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 988 e 6988 tra 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.