VOMA(vSphere On-disk Metadata Analyzer)를 사용하여 VMFS 메타데이터 일관성 확인

Summary: VOMA 툴을 사용하여 메타데이터의 파일 시스템 검사를 수행할 수 있습니다.

This article applies to This article does not apply to This article is not tied to any specific product. Not all product versions are identified in this article.

Symptoms

  • VMFS 데이터 저장소의 특정 파일에 액세스하는 데 문제가 있는 경우
  • VMFS 데이터 저장소의 파일을 수정하거나 지울 수 없는 경우
  • VMFS 데이터 저장소에서 파일을 읽으려고 하면 실패하고 오류가 발생함

 

인수
가 잘못되었습니다.파티션 테이블을 수정하려고 하면 다음 오류와 함께 실패합니다.

Error: Read-only file system during write on /dev/disks/naa.600601603b503400de93e0a87e9ce211
SetPtableGpt: Unable to commit to disk

/var/log/vmkernel 파일에서 다음과 유사한 항목을 볼 수 있습니다.

vmkernel: 0:00:20:51.964 cpu3:1085)WARNING: Swap: vm 1086: 2268: Failed to open swap file '/volumes/4730e995-faa64138-6e6f-001a640a8998/mule/mule-560e1410.vswp': Invalid metadata
vmkernel: 0:00:20:51.964 cpu3:1085)WARNING: Swap: vm 1086: 3586: Failed to initialize swap file '/volumes/4730e995-faa64138-6e6f-001a640a8998/mule/mule-560e1410.vswp': Invalid metadata
cpu11:268057)WARNING: HBX: 599: Volume 50fd60a3-3aae1ae2-3347-0017a4770402 ("<Datastore name>") may be damaged on disk. Corrupt heartbeat detected at offset 3305472: [HB state 0 offset 6052837899185946624 gen 15439450 stampUS 5 $

 

Cause

메타데이터 검사를 수행하는 데 적용되는 시나리오는 다음과 같습니다.

  • 환경에 스토리지 운영 중단이 발생합니다.
  • RAID 볼륨 재구축 또는 디스크 교체 후
  • vmkernel.log 파일에 메타데이터 오류가 있습니다.
  • 다른 호스트에 없는 VMFS 데이터 저장소의 파일에는 액세스할 수 없습니다.

 

Resolution

필수 구성 요소:
VOMA를 실행하기 전에 다음을 확인해야 합니다.

  1. 영향을 받는 데이터 저장소에 있는 모든 가상 머신의 전원을 끄거나 다른 데이터 저장소로 마이그레이션합니다.
    • vSphere On-disk Metadata Analyzer에 의해 특정 유형의 손상된 메타데이터가 있는 파일에서 실행 중인 가상 시스템을 종료하면 가상 시스템 및 해당 데이터를 영구적으로 사용할 수 없게 될 수 있습니다. 따라서 항상 가상 머신의 최신 백업을 환경에 두는 것이 좋습니다.
  2. VMFS-5/VMFS-6 데이터 저장소의 경우 모든 ESXi 7.x/8.x 호스트에서 데이터 저장소가 마운트 해제됩니다.
    • 하나 이상의 ESXi 호스트에 액세스할 수 있는 볼륨에 대해 VOMA를 실행하면 VOMA는 다음과 유사한 메시지를 생성합니다.
      voma -m vmfs -d /vmfs/devices/disks/naa.00000000000000000000000000:
      Checking if device is actively being used by other hosts
      Found 1 actively heart beating hosts on device '/vmfs/devices/disks/naa.00000000000000000000000000:1'
      1): MAC Address xx:xx:xx:xx:xx:xx

메타데이터 일관성을 확인하려면 ESXi 호스트의 CLI에서 VOMA를 실행합니다. VOMA는 VMFS 데이터스토어 또는 VMFS 데이터스토어를 지원하는 논리적 볼륨에 대한 사소한 불일치 문제를 확인하고 수정하는 데 사용할 수 있습니다.

 

VOMA는 다음 항목을 확인하고 수정할 수 있습니다.

VOMA 기능 설명
Metadata
check and fix
메타데이터 검사 및 수정의 예는 다음과 같으며 이에 국한되지는 않습니다.
  • 기본 메타데이터 정합성을 위한 VMFS 볼륨 헤더 검증
  • VMFS 리소스 파일의 일관성 검사
  • 모든 파일의 경로 이름 및 연결 확인
Affinity metadata
check and fix
VMFS6에 대한 선호도 검사를 활성화하려면 -a|--affinityChk 옵션을 선택합니다.
선호도 메타데이터 확인 및 수정의 몇 가지 예는 다음과 같습니다.
  • 리소스 유형 및 FS3_ResFileMetadata의 선호도 플래그
  • SFB RC 메타(FS3_ResourceClusterMDVMFS6)의 선호도 플래그 검증.
  • 오버플로 키를 포함하여 RC의 rcMeta에 있는 affinityInfo 항목의 모든 항목을 확인하여 잘못된 항목이 없는지 확인합니다. 누락된 항목이 있는지 확인합니다.
Directory validation
VOMA는 다음 오류를 감지하고 수정할 수 있습니다.
  • 디렉토리 해시 블록이 손상되었습니다.
  • 할당 맵 손상
  • 링크 블록 손상
  • 디렉토리 입력 블록이 손상되었습니다.
Lost and found files
파일 시스템 검사 중에 VOMA는 파일 시스템의 어디에서도 참조되지 않는 파일을 찾을 수 있습니다. 이러한 분리된 파일은 유효하고 완전하지만 시스템에 이름이나 디렉토리 항목이 없습니다.
VOMA는 스캔 중에 분리된 파일을 발견하면 볼륨의 루트에 lost+found라는 디렉토리를 생성하여 분리된 파일을 저장합니다. 파일 이름은 파일 시퀀스 번호 형식을 사용합니다.

VOMA 툴에서 사용하는 명령 옵션은 다음과 같습니다.

명령 옵션 설명
-m|--module
사용 가능한 모듈:
  • lvm
  • vmfs
  • ptbl
-f|--func
모듈이 지원하는 기능:
  • 쿼리 - 지원되는 함수 목록입니다.
  • 확인 - 오류가 있는지 확인합니다.
  • 수정 - 확인하고 수정합니다.
  • Advfix - VMFS 및 LVM 모듈을 확인하고 수정합니다.
  • 덤프 - 메타데이터 덤프를 수집합니다.
-a|--affinityChk
VMFS6에 대한 선호도 관련 검사/수정을 포함합니다.
-d|--device
사용할 디바이스 및 디스크입니다.
예:
voma -m vmfs -f check -d /vmfs/devices/disks/naa.xxxx:x
-b|--blockSize
디스크 블록 크기를 나타냅니다.
-s|--logfile
결과를 출력할 로그 파일의 경로를 지정합니다.
-x|--extractDump
VOMA를 사용하여 수집된 덤프를 추출합니다.
-D|--dumpfile
수집된 메타데이터 덤프를 저장할 덤프 파일을 나타냅니다.
-v|--version
VOMA 버전을 표시합니다.
-h|--help
VOMA 명령에 대한 도움말 메시지를 표시합니다.
-Y
주소 확인을 위해 PE 테이블을 사용하지 않고 VOMA가 실행됨을 나타냅니다.
-Z| --file
VOMA가 추출된 디바이스 파일에서 실행됨을 나타냅니다.

 

절차:
확인할 VMFS 데이터 저장소를 지원하는 디바이스의 이름과 파티션 번호를 확인합니다.

#esxcli storage vmfs extent list

출력의 디바이스 이름 및 파티션 열은 디바이스를 식별합니다. 예:

Volume Name  .....  Device Name                             Partition  
1TB_VMFS6    .....  naa.xxxx                                   3

VMFS 오류를 확인합니다.
VMFS 데이터 저장소를 지원하는 디바이스 파티션의 절대 경로를 입력하고 디바이스 이름과 함께 파티션 번호를 제공합니다. 예:

# voma -m vmfs -f check -d /vmfs/devices/disks/naa.xxxx:x
The output lists possible errors. For example, the following output indicates that the heartbeat address is invalid.
XXXXXXXXXXXXXXXXXXXXXXX
Phase 2: Checking VMFS heartbeat region
 ON-DISK ERROR: Invalid HB address
Phase 3: Checking all file descriptors.
Phase 4: Checking pathname and connectivity.
Phase 5: Checking resource reference counts.
Total Errors Found:           1

 

참조 설명서:
VOMA(vSphere On-Disk Metadata Analyzer)를 사용하여 VMFS 메타데이터 일관성 확인(broadcom.com)이 하이퍼링크는 Dell Technologies 외부의 웹사이트로 연결됩니다.
VOMA와 메타데이터 일관성 확인(vmware.com)이 하이퍼링크는 Dell Technologies 외부의 웹사이트로 연결됩니다.

 

Affected Products

VMware ESXi 7.x, VMware ESXi 8.x
Article Properties
Article Number: 000226655
Article Type: Solution
Last Modified: 28 Jan 2025
Version:  2
Find answers to your questions from other Dell users
Support Services
Check if your device is covered by Support Services.