Memecahkan masalah koneksi klien

Jika mengalami masalah saat memasang atau menghubungkan ke sistem file Managed Lustre dari mesin klien atau cluster GKE, ikuti langkah-langkah berikut untuk mendiagnosis masalahnya.

Memastikan instance Managed Lustre dapat dijangkau

Pastikan instance Managed Lustre Anda dapat dijangkau dari lingkungan klien Anda.

Menguji keterjangkauan secara langsung menggunakan lctl ping memerlukan akses SSH ke mesin klien atau node GKE Standard:

sudo lctl ping IP_ADDRESS@tcp

Untuk mendapatkan nilai IP_ADDRESS, lihat Mendapatkan instance.

Ping yang berhasil akan menampilkan respons yang mirip dengan berikut ini:

12345-0@lo
12345-10.115.0.3@tcp

Ping yang gagal akan menampilkan hal berikut:

failed to ping 10.115.0.3@tcp: Input/output error

GKE Autopilot memblokir akses SSH node, sehingga mencegah penggunaan langsung lctl ping.

Jika ping gagal, atau jika Anda mendiagnosis konektivitas dari cluster Autopilot:

  • Pastikan instance Managed Lustre dan mesin klien atau cluster GKE Anda berada di jaringan VPC yang sama.

    Untuk mesin klien Compute Engine, bandingkan output perintah berikut:

    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)'
    

    Untuk cluster GKE, bandingkan output perintah berikut:

    gcloud container clusters describe CLUSTER_NAME \
      --location=LOCATION \
      --format='get(networkConfig.network)'
    
    gcloud lustre instances describe INSTANCE_NAME \
      --location=ZONE --format='get(network)'
    

    Output perintah gcloud compute instances describe dan gcloud container clusters describe diawali dengan https://www.googleapis.com/compute/v1/; semua yang mengikuti string tersebut harus cocok dengan output perintah gcloud lustre instances describe.

  • Tinjau aturan firewall jaringan VPC dan konfigurasi pemilihan rute untuk memastikan aturan tersebut mengizinkan traffic antara subnet klien dan instance Managed Lustre.

Memeriksa port penerimaan LNet untuk instance lama

Meskipun flag --gke-support-enabled tidak digunakan lagi dan tidak lagi diperlukan saat membuat instance Managed Lustre baru, Anda mungkin memiliki instance lama yang dibuat dengan flag ini.

Jika Anda terhubung ke instance lama yang mengaktifkan dukungan GKE, konfigurasikan LNet atau driver CSI untuk menggunakan port 6988:

Untuk menentukan apakah instance yang ada dikonfigurasi dengan flag lama ini, jalankan perintah berikut:

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

Jika perintah menampilkan gkeSupportEnabled: true, Anda harus mengonfigurasi LNet di mesin klien atau mengaktifkan flag port lama di cluster GKE.

Versi kernel Ubuntu tidak cocok dengan klien Lustre

Untuk instance Compute Engine yang menjalankan Ubuntu, versi kernel Ubuntu harus cocok dengan versi tertentu dari paket klien Lustre. Jika alat klien Lustre Anda gagal, periksa apakah instance Compute Engine Anda telah diupgrade otomatis ke kernel yang lebih baru.

Untuk memeriksa versi kernel Anda:

uname -r

Respons akan terlihat seperti ini:

6.8.0-1029-gcp

Untuk memeriksa versi paket klien Lustre Anda:

dpkg -l | grep -i lustre

Respons akan terlihat seperti ini:

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)

Jika ada ketidakcocokan antara versi kernel yang tercantum dari kedua perintah, Anda harus menginstal ulang paket klien Lustre.

Memeriksa dmesg untuk mengetahui error Lustre

Banyak peringatan dan error Lustre dicatat ke ring buffer kernel Linux. Perintah dmesg mencetak ring buffer kernel.

Untuk menelusuri pesan khusus Lustre, gunakan grep bersama dengan dmesg:

dmesg | grep -i lustre

Atau, untuk mencari error yang lebih umum yang mungkin terkait:

dmesg | grep -i error

Pemasangan Lustre di komputer klien multi-NIC gagal

Jika mesin klien memiliki beberapa pengontrol antarmuka jaringan, dan instance Managed Lustre berada di jaringan VPC yang terhubung ke NIC sekunder, seperti eth1, pemasangan instance mungkin gagal. Untuk mengatasi masalah ini, ikuti petunjuk untuk memasang menggunakan NIC sekunder.

Tidak dapat terhubung dari rentang subnet 172.17.0.0/16

Mesin klien Compute Engine dan cluster GKE dengan alamat IP dalam rentang subnet 172.17.0.0/16 tidak dapat memasang instance Managed Lustre. Untuk GKE, pastikan subnet node, rentang alamat Pod, dan rentang alamat Service tidak tumpang-tindih dengan 172.17.0.0/16.

Tidak dapat mengakses Managed Lustre dari project yang di-peering

Jika mesin klien atau cluster GKE Anda berada di jaringan VPC yang di-peering dan tidak dapat terhubung ke instance Managed Lustre, verifikasi hal berikut:

  • Peering VPC saja tidak merutekan traffic ke koneksi akses layanan pribadi yang digunakan oleh Managed Lustre. Untuk terhubung di seluruh jaringan VPC yang di-peering, hubungkan kedua jaringan melalui Network Connectivity Center.

  • Pastikan aturan firewall di jaringan VPC host dan jaringan VPC yang di-peering mengizinkan traffic TCP pada port 988 dan 6988 antara subnet klien dan rentang alamat IP yang dialokasikan untuk instance.

Untuk mengetahui petunjuk penyiapan langkah demi langkah dan perintah gcloud, lihat Mengonfigurasi jaringan VPC.

Pemasangan gagal di Shielded VM dengan Booting Aman

Lustre Terkelola tidak dapat dipasang di mesin klien yang mengaktifkan Booting Aman, seperti Shielded VM. Upaya memuat modul kernel Lustre di lingkungan Booting Aman gagal dengan error: ERROR: could not insert 'lustre': Required key not available.

Informasi yang perlu disertakan dalam permintaan dukungan

Jika Anda tidak dapat menyelesaikan kegagalan pemasangan, kumpulkan informasi diagnostik sebelum membuat kasus dukungan. Membuat log diagnostik menggunakan sosreport memerlukan akses SSH ke mesin atau node klien Anda.

Node Compute Engine dan GKE Standard

Untuk mesin klien Compute Engine dan node GKE Standard yang akses SSH-nya diaktifkan, kumpulkan log diagnostik menggunakan utilitas sosreport. Utilitas sosreport mengumpulkan log sistem dan informasi konfigurasi serta menghasilkan file arsip yang dikompresi.

Menginstal sosreport

Untuk memverifikasi bahwa paket sosreport telah diinstal dan menyertakan dukungan Lustre, lakukan SSH ke mesin klien Anda dan jalankan perintah berikut:

sudo sos report --list-plugins | grep lustre

Jika perintah tidak ditemukan, atau jika perintah tidak menampilkan output, instal atau update sosreport untuk sistem operasi Anda:

Rocky Linux & RHEL

Gunakan pengelola paket dnf untuk menginstal paket sos:

sudo dnf install -y sos

Ubuntu

Mesin klien Ubuntu memerlukan sosreport dari saluran latest/edge di snap untuk mengumpulkan diagnostik Lustre. Paket yang diinstal menggunakan apt tidak menyertakan plugin Lustre.

Jika versi sosreport yang lebih lama diinstal menggunakan apt, hapus paket terlebih dahulu:

sudo apt remove -y sosreport

Instal sosreport menggunakan snap:

sudo snap install sosreport --classic --channel=latest/edge

Container-Optimized OS

Gunakan pengelola paket apt dari dalam toolbox untuk menginstal paket sosreport:

sudo toolbox
sudo apt install sosreport -y

Membuat laporan

Untuk membuat sosreport, jalankan perintah berikut:

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

Lampirkan arsip sosreport ke kasus dukungan Anda.

Untuk mengetahui informasi selengkapnya tentang utilitas sosreport, lihat Mengumpulkan informasi proses debug menggunakan sosreport.

Cluster GKE Autopilot

GKE Autopilot memblokir akses SSH ke node dan membatasi container proses debug dengan hak istimewa. Anda tidak dapat menjalankan sosreport di node Autopilot atau dari dalam container workload.

Jika Anda mengalami kegagalan pemasangan pada cluster Autopilot, hubungi Cloud Customer Care untuk mendapatkan bantuan.

Untuk mengetahui informasi selengkapnya tentang cara mendiagnosis error volume GKE, lihat Memecahkan masalah driver CSI Managed Lustre.