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 describedangcloud container clusters describediawali denganhttps://www.googleapis.com/compute/v1/; semua yang mengikuti string tersebut harus cocok dengan output perintahgcloud 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 mesin klien Compute Engine, konfigurasikan LNet untuk menggunakan
accept_portUntuk cluster GKE, aktifkan driver CSI dengan flag
--enable-legacy-lustre-port. Lihat Port komunikasi Lustre.
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
988dan6988antara 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.