Kontrol af ensartethed i VMFS-metadata ved hjælp af vSphere On-Disk Metadata Analyzer (VOMA)
Summary: VOMA-værktøjet kan bruges til at udføre en filsystemkontrol af metadata.
Symptoms
- Når der er problemer med at få adgang til bestemte filer på et VMFS-datalager
- Når det ikke er muligt at ændre eller slette filer på et VMFS-datalager
- Når du forsøger at læse filer på et VMFS-datalager, mislykkes det med en fejl
Ugyldigt argument
Når du forsøger at ændre partitionstabellen, mislykkes med fejl:
Error: Read-only file system during write on /dev/disks/naa.600601603b503400de93e0a87e9ce211 SetPtableGpt: Unable to commit to disk
I filen /var/log/vmkernel kan man se poster, der ligner:
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
Følgende scenarier gælder for udførelse af en metadatakontrol:
- Miljøet oplever lagerafbrydelse.
- Efter en genopbygning af RAID-diskenheden eller udskiftning af en disk
- Der er metadatafejl i vmkernel.log filen.
- Det kan ikke få adgang til filer på et VMFS-datalager, der ikke findes på nogen anden vært.
Resolution
Forudsætninger:
Før du kører VOMA, skal du sikre dig, at:
- Sluk for alle virtuelle maskiner på det berørte datalager eller migreret til et andet datalager.
- Hvis du lukker en virtuel maskine, der kører på filer med bestemte typer beskadigede metadata af vSphere On-disk Metadata Analyzer, kan det gøre den virtuelle maskine og dens data permanent utilgængelige. På grund af dette tilrådes det altid at have aktuelle sikkerhedskopier af de virtuelle maskiner i miljøet.
- For VMFS-5/VMFS-6-datalagre er datalageret frakoblet på alle ESXi 7.x/8.x-værter.
- Hvis VOMA køres mod en diskenhed med adgang til en eller flere ESXi-værter, producerer VOMA en meddelelse, der ligner:
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
- Hvis VOMA køres mod en diskenhed med adgang til en eller flere ESXi-værter, producerer VOMA en meddelelse, der ligner:
Du kan kontrollere konsistensen af metadata ved at køre VOMA fra CLI på en ESXi-vært. VOMA kan bruges til at kontrollere og løse mindre uoverensstemmelser for et VMFS-datalager eller logiske diskenheder, der understøtter VMFS-datalageret.
VOMA kan kontrollere og rette følgende elementer.
| VOMA-funktioner | Beskrivelse |
|---|---|
Metadata check and fix |
Eksempler på kontrol og rettelse af metadata omfatter, men er ikke begrænset til, følgende:
|
Affinity metadata check and fix |
Hvis du vil aktivere affinitetskontrollen for VMFS6, skal du bruge ikonet -a|--affinityChk .Flere eksempler på kontrol og rettelse af affinitetsmetadata omfatter følgende:
|
Directory validation |
VOMA kan registrere og rette følgende fejl:
|
Lost and found files |
Under en filsystemkontrol kan VOMA finde filer, der ikke refereres til nogen steder i filsystemet. Disse forældreløse filer er gyldige og komplette, men har ikke et navn eller en mappepost på systemet. Hvis VOMA støder på forældreløse filer under scanning, oprettes der en mappe med navnet lost+found i roden af diskenheden til lagring af de forældreløse filer. Navnene på filerne bruger filformatet Filsekvensnummer. |
De kommandoindstillinger, som VOMA-værktøjet tager, omfatter følgende.
| Kommando Option | Beskrivelse |
|---|---|
-m|--module |
Tilgængelige moduler er:
|
-f|--func |
Funktioner modulet understøtter:
|
-a|--affinityChk |
Medtag en kontrol/rettelse relateret til tilknytning til VMFS6. |
-d|--device |
Enhed og disk, der skal bruges. F.eks.: voma -m vmfs -f check -d /vmfs/devices/disks/naa.xxxx:x |
-b|--blockSize |
Angiv diskblokstørrelsen. |
-s|--logfile |
Angiv stien til logfilen for at sende resultaterne. |
-x|--extractDump |
Udpak den indsamlede dump ved hjælp af VOMA. |
-D|--dumpfile |
Angiv dumpfilen for at gemme det indsamlede metadatadump. |
-v|--version |
Vis VOMA-versionen. |
-h|--help |
Vis hjælpemeddelelsen til VOMA-kommandoen. |
-Y |
Angiv, at VOMA kører uden brug af PE-tabeller til adresseopløsning. |
-Z| --file |
Angiv, at VOMA kører på udpakkede enhedsfiler. |
Procedure:
Få navnet og partitionsnummeret på den enhed, der sikkerhedskopierer det VMFS-datalager, du vil kontrollere.
#esxcli storage vmfs extent list
Kolonnerne Enhedsnavn og Partition i outputtet identificerer enheden. F.eks.:
Volume Name ..... Device Name Partition 1TB_VMFS6 ..... naa.xxxx 3
Kontroller, om der er VMFS-fejl.
Angiv den absolutte sti til enhedspartitionen, der sikkerhedskopierer VMFS-datalageret, og angiv et partitionsnummer med enhedsnavnet. F.eks.:
# 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
Referencedokumentation:
Brug af vSphere On-Disk Metadata Analyzer (VOMA) til at kontrollere VMFS-metadatakonsistens (broadcom.com)
Kontrol af metadataoverensstemmelse med VOMA (vmware.com)