클라이언트 연결 문제 해결

클라이언트 VM 또는 인스턴스에서 Managed Lustre 파일 시스템을 마운트하거나 연결할 때 문제가 발생하면 다음 단계에 따라 문제를 진단하세요.

Managed Lustre 인스턴스에 연결할 수 있는지 확인

먼저 클라이언트 인스턴스에서 Managed Lustre 인스턴스에 연결할 수 있는지 확인합니다.

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

핑이 실패하면 다음 단계를 따르세요.

  • Managed Lustre 인스턴스와 클라이언트 인스턴스가 동일한 VPC 네트워크에 있는지 확인합니다. 다음 명령어의 출력을 비교합니다.

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

    출력 형식은 다음과 같습니다.

    https://www.googleapis.com/compute/v1/projects/my-project/global/networks/my-network
projects/my-project/global/networks/my-network

    gcloud compute instances describe 명령어의 출력에는 https://www.googleapis.com/compute/v1/이 접두사로 붙습니다. 이 문자열 뒤에 오는 모든 항목은 gcloud lustre instances describe 명령어의 출력과 일치해야 합니다.

  • VPC 네트워크의 방화벽 규칙과 라우팅 구성을 검토하여 클라이언트 인스턴스와 Managed Lustre 인스턴스 간의 트래픽을 허용하는지 확인합니다.

LNet 수락 포트 확인 (기존 인스턴스)

--gke-support-enabled 플래그는 지원 중단되었으며 새 Managed Lustre 인스턴스를 만들 때 더 이상 필요하지 않지만 이 플래그로 생성된 기존 인스턴스가 있을 수 있습니다.

GKE 지원이 사용 설정된 기존 인스턴스에 연결하는 경우 모든 클라이언트 Compute Engine 인스턴스에서 accept_port 6988을 사용하도록 LNet을 구성해야 합니다. gke-support-enabled 인스턴스에 LNet 구성을 참고하세요.

기존 인스턴스가 이 기존 플래그로 구성되었는지 확인하려면 다음 명령어를 실행합니다.

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

명령어가 gkeSupportEnabled: true를 반환하면 클라이언트 VM에서 LNet을 구성해야 합니다.

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 관련 메시지를 검색하려면 dmesg와 함께 grep를 사용하세요.

dmesg | grep -i lustre

또는 관련이 있을 수 있는 일반적인 오류를 찾으려면 다음 단계를 따르세요.

dmesg | grep -i error

다중 NIC VM에서 Lustre 마운트 실패

VM에 네트워크 인터페이스 컨트롤러 (NIC)가 여러 개 있고 Managed Lustre 인스턴스가 보조 NIC(예: eth1)에 연결된 VPC에 있는 경우 인스턴스 마운트에 실패할 수 있습니다. 이 문제를 해결하려면 보조 NIC를 사용하여 마운트하는 안내를 따르세요.

172.17.0.0/16 서브넷 범위에서 연결할 수 없음

IP 주소가 172.17.0.0/16 서브넷 범위에 속하는 Compute Engine 및 GKE 클라이언트는 Managed Lustre 인스턴스를 마운트할 수 없습니다.

피어링된 프로젝트에서 Managed Lustre에 액세스할 수 없음

피어링된 VPC 네트워크의 VM에서 Managed Lustre 인스턴스에 액세스하려면 Network Connectivity Center (NCC)를 사용해야 합니다. NCC를 사용하면 여러 VPC 네트워크와 온프레미스 네트워크를 중앙 허브에 연결하여 네트워크 간 연결을 제공할 수 있습니다.

NCC 설정 방법은 Network Connectivity Center 문서를 참고하세요.

보안 VM (보안 부팅)에서 마운트가 실패함

보안 VM에는 Managed Lustre를 마운트할 수 없습니다. 보안 부팅 환경에서 Lustre 커널 모듈을 로드하려고 하면 ERROR: could not insert 'lustre': Required key not available. 오류와 함께 실패합니다.

지원 요청에 포함할 정보

마운트 실패를 해결할 수 없는 경우 지원 케이스를 만들기 전에 진단 정보를 수집하세요. 이 섹션의 명령어를 실행하려면 클라이언트 머신에 대한 SSH 액세스 권한이 있어야 합니다.

sosreport 유틸리티는 시스템 로그와 구성 정보를 수집하고 압축된 tar 파일을 생성합니다.

sosreport를 생성하려면 클라이언트 머신에 SSH로 연결합니다. 그런 후 다음을 실행합니다.

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

명령어를 찾을 수 없는 경우:

Rocky Linux 및 RHEL

dnf 패키지 관리자를 사용하여 sos 패키지를 설치합니다.

sudo dnf install -y sos

Ubuntu

apt 패키지 관리자를 사용하여 sosreport 패키지를 설치합니다.

sudo apt update
sudo apt install -y sosreport

Container-Optimized OS

toolbox 내부에서 apt 패키지 관리자를 사용하여 sosreport 패키지를 설치합니다.

sudo toolbox
sudo apt install sosreport -y

지원 케이스에 sosreport 보관 파일을 첨부합니다.

sosreport 유틸리티에 관한 자세한 내용은 sosreport를 사용하여 디버깅 정보 수집을 참고하세요.