클라이언트 머신 또는 GKE 클러스터에서 Managed Lustre 파일 시스템을 마운트하거나 연결하는 데 문제가 발생하면 다음 단계에 따라 문제를 진단하세요.
Managed Lustre 인스턴스에 연결할 수 있는지 확인
클라이언트 환경에서 Managed Lustre 인스턴스에 연결할 수 있는지 확인합니다.
lctl ping를 사용하여 연결 가능성을 직접 테스트하려면 클라이언트 머신 또는 GKE Standard 노드에 대한 SSH 액세스 권한이 필요합니다.
sudo lctl ping IP_ADDRESS@tcp
IP_ADDRESS 값을 가져오려면 인스턴스 가져오기를 참조하세요.
성공적인 핑은 다음과 비슷한 응답을 반환합니다.
12345-0@lo
12345-10.115.0.3@tcp
핑이 실패하면 다음이 반환됩니다.
failed to ping 10.115.0.3@tcp: Input/output error
GKE Autopilot은 노드 SSH 액세스를 차단하여 lctl ping의 직접 사용을 방지합니다.
핑이 실패하거나 Autopilot 클러스터에서 연결을 진단하는 경우:
Managed Lustre 인스턴스와 클라이언트 머신 또는 GKE 클러스터가 동일한 VPC 네트워크에 있는지 확인합니다.
Compute Engine 클라이언트 머신의 경우 다음 명령어의 출력을 비교합니다.
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)'GKE 클러스터의 경우 다음 명령어의 출력을 비교합니다.
gcloud container clusters describe CLUSTER_NAME \ --location=LOCATION \ --format='get(networkConfig.network)' gcloud lustre instances describe INSTANCE_NAME \ --location=ZONE --format='get(network)'gcloud compute instances describe및gcloud container clusters describe명령어의 출력에는https://www.googleapis.com/compute/v1/가 접두사로 추가됩니다. 이 문자열 뒤에 오는 모든 항목은gcloud lustre instances describe명령어의 출력과 일치해야 합니다.VPC 네트워크 방화벽 규칙 및 라우팅 구성을 검토하여 클라이언트 서브넷과 관리형 Lustre 인스턴스 간의 트래픽을 허용하는지 확인합니다.
기존 인스턴스의 LNet 허용 포트 확인
--gke-support-enabled 플래그는 지원 중단되었으며 새 Managed Lustre 인스턴스를 만들 때 더 이상 필요하지 않지만 이 플래그로 만든 기존 이전 인스턴스가 있을 수 있습니다.
GKE 지원이 사용 설정된 기존 인스턴스에 연결하는 경우 포트 6988을 사용하도록 LNet 또는 CSI 드라이버를 구성합니다.
Compute Engine 클라이언트 머신의 경우
accept_port을 사용하도록 LNet을 구성합니다.GKE 클러스터의 경우
--enable-legacy-lustre-port플래그를 사용하여 CSI 드라이버를 사용 설정합니다. Lustre 통신 포트를 참조하세요.
기존 인스턴스가 이 기존 플래그로 구성되었는지 확인하려면 다음 명령어를 실행합니다.
gcloud lustre instances describe INSTANCE_NAME \
--location=LOCATION | grep gkeSupportEnabled
명령어가 gkeSupportEnabled: true를 반환하면 클라이언트 머신에서 LNet을 구성하거나 GKE 클러스터에서 기존 포트 플래그를 사용 설정해야 합니다.
Ubuntu 커널 버전이 Lustre 클라이언트와 일치하지 않음
Ubuntu를 실행하는 Compute Engine 인스턴스의 경우 Ubuntu 커널 버전이 Lustre 클라이언트 패키지의 특정 버전과 일치해야 합니다. Lustre 클라이언트 도구가 실패하면 Compute Engine 인스턴스가 최신 커널로 자동 업그레이드되었는지 확인합니다.
커널 버전을 확인하려면 다음 안내를 따르세요.
uname -r
응답은 다음과 같습니다.
6.8.0-1029-gcp
Lustre 클라이언트 패키지 버전을 확인하려면 다음 안내를 따르세요.
dpkg -l | grep -i lustre
응답은 다음과 같습니다.
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)
두 명령어에 나열된 커널 버전이 일치하지 않으면 Lustre 클라이언트 패키지를 다시 설치해야 합니다.
dmesg에서 Lustre 오류 확인
많은 Lustre 경고 및 오류가 Linux 커널 링 버퍼에 로깅됩니다. dmesg 명령어는 커널 링 버퍼를 출력합니다.
Lustre 관련 메시지를 검색하려면 grep를 dmesg와 함께 사용합니다.
dmesg | grep -i lustre
또는 관련이 있을 수 있는 더 일반적인 오류를 찾으려면 다음을 실행합니다.
dmesg | grep -i error
멀티 NIC 클라이언트 머신에서 Lustre 마운트 실패
클라이언트 머신에 여러 네트워크 인터페이스 컨트롤러가 있고 Managed Lustre 인스턴스가 보조 NIC(예: eth1)에 연결된 VPC 네트워크에 있는 경우 인스턴스 마운트가 실패할 수 있습니다. 이 문제를 해결하려면 보조 NIC를 사용하여 마운트하는 안내를 따르세요.
172.17.0.0/16 서브넷 범위에서 연결할 수 없음
172.17.0.0/16 서브넷 범위의 IP 주소가 있는 Compute Engine 클라이언트 머신과 GKE 클러스터는 Managed Lustre 인스턴스를 마운트할 수 없습니다. GKE의 경우 노드 서브넷, 포드 주소 범위, 서비스 주소 범위가 172.17.0.0/16과 겹치지 않는지 확인합니다.
피어링된 프로젝트에서 Managed Lustre에 액세스할 수 없음
클라이언트 머신 또는 GKE 클러스터가 피어링된 VPC 네트워크에 있고 Managed Lustre 인스턴스에 연결할 수 없는 경우 다음을 확인하세요.
VPC 피어링만으로는 Managed Lustre에서 사용하는 비공개 서비스 액세스 연결로 트래픽을 라우팅하지 않습니다. 피어링된 VPC 네트워크 간에 연결하려면 Network Connectivity Center를 통해 두 네트워크를 연결합니다.
호스트 VPC 네트워크와 피어링된 VPC 네트워크의 방화벽 규칙이 클라이언트 서브넷과 인스턴스의 할당된 IP 주소 범위 간에 포트
988및6988에서 TCP 트래픽을 허용하는지 확인합니다.
단계별 설정 안내와 gcloud 명령어는 VPC 네트워크 구성을 참조하세요.
보안 부팅이 사용 설정된 보안 VM에서 마운트 실패
보안 VM과 같이 보안 부팅이 사용 설정된 클라이언트 머신에는 Managed Lustre를 마운트할 수 없습니다. 보안 부팅 환경에서 Lustre 커널 모듈을 로드하려고 하면 ERROR: could not insert 'lustre': Required key not available. 오류와 함께 실패합니다.
지원 요청에 포함할 정보
마운트 실패를 해결할 수 없는 경우 지원 케이스를 만들기 전에 진단 정보를 수집하세요. sosreport를 사용하여 진단 로그를 생성하려면 클라이언트 머신 또는 노드에 대한 SSH 액세스 권한이 필요합니다.
Compute Engine 및 GKE Standard 노드
SSH 액세스가 사용 설정된 Compute Engine 클라이언트 머신 및 GKE Standard 노드의 경우 sosreport 유틸리티를 사용하여 진단 로그를 수집합니다. sosreport 유틸리티는 시스템 로그와 구성 정보를 수집하고 압축된 보관 파일을 생성합니다.
sosreport 설치
sosreport 패키지가 설치되어 있고 Lustre 지원이 포함되어 있는지 확인하려면 클라이언트 머신에 SSH로 연결하고 다음 명령어를 실행합니다.
sudo sos report --list-plugins | grep lustre
명령어를 찾을 수 없거나 명령어가 출력을 반환하지 않으면 운영체제에 sosreport를 설치하거나 업데이트합니다.
Rocky Linux 및 RHEL
dnf 패키지 관리자를 사용하여 sos 패키지를 설치합니다.
sudo dnf install -y sos
Ubuntu
Ubuntu 클라이언트 머신은 Lustre 진단을 수집하기 위해 snap의 latest/edge 채널에서 sosreport가 필요합니다. apt를 사용하여 설치된 패키지에는 Lustre 플러그인이 포함되지 않습니다.
apt를 사용하여 이전 버전의 sosreport를 설치한 경우 먼저 패키지를 삭제합니다.
sudo apt remove -y sosreport
snap을 사용하여 sosreport을 설치합니다.
sudo snap install sosreport --classic --channel=latest/edge
Container-Optimized OS
toolbox 내에서 apt 패키지 관리자를 사용하여 sosreport 패키지를 설치합니다.
sudo toolbox
sudo apt install sosreport -y
보고서 생성
sosreport를 생성하려면 다음 명령어를 실행합니다.
sudo sos report --all-logs --batch --tmp-dir=/var
sosreport 보관 파일을 지원 케이스에 첨부합니다.
sosreport 유틸리티에 대한 자세한 내용은 sosreport를 사용하여 디버깅 정보 수집을 참조하세요.
GKE Autopilot 클러스터
GKE Autopilot은 노드에 대한 SSH 액세스를 차단하고 권한이 있는 디버깅 컨테이너를 제한합니다. Autopilot 노드 또는 워크로드 컨테이너 내부에서 sosreport를 실행할 수 없습니다.
Autopilot 클러스터에서 마운트 실패가 발생하면 Cloud Customer Care에 문의하여 도움을 받으세요.
GKE 볼륨 오류 진단에 대한 자세한 내용은 Managed Lustre CSI 드라이버 문제 해결을 참조하세요.