Use o vSphere On-disk Metadata Analyzer (VOMA) para identificar e corrigir incidentes de corrupção de metadados que afetam sistemas de arquivos ou volumes lógicos subjacentes.

Problema

Você pode verificar a consistência de metadados quando tiver problemas com um armazenamento de dados VMFS ou um recurso de flash virtual. Por exemplo, realize uma verificação de metadados se ocorrer uma das seguintes situações:

  • Você enfrenta interrupções de armazenamento.

  • Depois de reconstruir o RAID ou realizar uma substituição de disco.

  • Você vê erros de metadados no arquivo vmkernel.log semelhante ao seguinte:

    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 $
  • Você não pode acessar arquivos em um VMFS.

  • Você vê corrupção sendo relatada para um armazenamento de dados nas guias de eventos de vCenter Server.

Solução

Para verificar a consistência de metadados, execute o VOMA da CLI de um host ESXi. O VOMA pode ser usado para verificar e corrigir pequenos problemas de inconsistência para um armazenamento de dados VMFS ou volumes lógicos que suportam o armazenamento de dados VMFS.

O VOMA pode verificar e corrigir os seguintes itens.

Tabela 1. Funções VOMA

Funções VOMA

Descrição

Verificação e correção de metadados

Exemplos de verificação e correção de metadados incluem, entre outros, o seguinte:

  • Validação do cabeçalho do volume VMFS para consistência de metadados básicos.

  • Verificando a consistência de VMFS arquivos de recursos (arquivo de sistema).

  • Verificando o nome do caminho e a conectividade de todos os arquivos.

Verificação e correção de metadados de afinidade

Para habilitar a verificação de afinidade para VMFS6, use a opção -a|--affinityChk.

Vários exemplos de verificação e correção de metadados de afinidade incluem o seguinte:

  • Sinalizadores de afinidade em tipos de recursos e FS3_ResFileMetadata.

  • Validação de sinalizadores de afinidade na meta SFB RC (FS3_ResourceClusterMDVMFS6).

  • Validação de todas as entradas nas entradas identityInfo no rcMeta do RC, incluindo a chave de estouro, para garantir que não existam entradas inválidas. Verificando entradas ausentes.

Validação de diretório

O VOMA pode detectar e corrigir os seguintes erros:

  • Corrupção do bloco de hash do diretório.

  • Corrupção do mapa de alocação.

  • O link bloqueia corrupções.

  • Corrupções do bloco de entrada do diretório.

Com base na natureza da corrupção, o VOMA pode corrigir apenas as entradas corrompidas ou reconstruir totalmente o bloco de hash, os blocos de alocação de mapa e os blocos de link.

Arquivos perdidos e encontrados

Durante uma verificação do sistema de arquivos, o VOMA pode encontrar arquivos que não são referenciados em nenhum lugar do sistema de arquivos. Esses arquivos órfãos são válidos e completos, mas não têm um nome ou uma entrada de diretório no sistema.

Se o VOMA encontrar arquivos órfãos durante a verificação, ele criará um diretório chamado lost+found na raiz do volume para armazenar os arquivos órfãos. Os nomes dos arquivos usam o formato Arquivonúmero de sequência.

As opções de comando que a ferramenta VOMA usa incluem o seguinte.

Tabela 2. Opções de comando VOMA

Opção de comando

Descrição

-m|--module

Os módulos a serem executados incluem o seguinte:

vmfs

Se você não especificar o nome do módulo, essa opção será usada por padrão.

Você pode verificar os sistemas de arquivos VMFS e os sistemas de arquivos que suportam recursos de flash virtual. Se você especificar esse módulo, verificações mínimas também serão realizadas para o LVM.

lvm

Verifique os volumes lógicos que suportam os datastores VMFS.

ptbl

Verifique e valide VMFS partições, como MBR ou GPT. Se nenhuma partição existir, determine se as partições devem existir.

-f|--func

As funções a serem executadas incluem o seguinte:

query

Listar funções compatíveis com o módulo.

check

Verifique se há erros.

fix

Verifique e corrija os erros.

dump

Colete o despejo de metadados.

-a|--affinityChk

Incluir verificação e correção relacionadas à afinidade para VMFS6.

-d|--device

Indique o dispositivo ou disco a ser inspecionado. Certifique-se de fornecer o caminho absoluto para a partição do dispositivo que faz o backup do armazenamento de dados VMFS. Se o armazenamento de dados abranger vários dispositivos, forneça o UUID da extensão do cabeçalho.

Por exemplo, voma -m vmfs -f check -d /vmfs/devices/disks/naa.xxxx:x

Se você usar o comando -x|--extractDump, digite vários caminhos de dispositivo, com um qualificador de partição, separados por vírgula. O número de caminhos de dispositivo inseridos é igual ao número de dispositivos estendidos.

-b|--blockSize

Indique o tamanho do bloco de disco.

-s|--logfile

Especifique o caminho para o arquivo de log para gerar os resultados.

-x|--extractDump

Extraia o despejo coletado usando o VOMA.

-D|--dumpfile

Indique o arquivo de despejo para salvar o despejo de metadados coletados.

-v|--version

Exibe a versão do VOMA.

-h|--help

Exiba a mensagem de ajuda para o comando VOMA.

-Y

Indique que você executa o VOMA sem usar tabelas PE para resolução de endereços.

-Z| --file

Indique que você executa o VOMA em arquivos de dispositivo extraídos.

Exemplo

Colete o despejo de metadados de um volume estendido:

voma -m vmfs -f dump -d head_extent -D dump_filename

Extraia o despejo coletado de volta para os dispositivos de um volume estendido:

voma -x dump_filename -d head_extent,extent_2,extent_3...extent_n }

Usar o VOMA para verificar a consistência dos metadados

A tarefa demonstra como usar o VOMA para verificar a consistência de metadados VMFS. O VOMA pode ser usado para verificar e corrigir pequenos problemas de inconsistência para um armazenamento de dados VMFS ou um recurso de flash virtual. Execute o VOMA da CLI de um host ESXi.

Pré-requisitos

Desligue todas as máquinas virtuais em execução ou migre-as para um datastore diferente.

Procedimento

  1. Obtenha o nome e o número da partição do dispositivo que suporta o armazenamento de dados VMFS que você deseja verificar.
    #esxcli storage vmfs extension list
    As colunas Nome do dispositivo e Partição na saída identificam o dispositivo. Por exemplo:
    Volume Name  .....  Device Name                             Partition  
    1TB_VMFS6    .....  naa.xxxx                                   3
  2. Verifique se há VMFS erros.

    Forneça o caminho absoluto para a partição do dispositivo que suporta o armazenamento de dados VMFS e forneça um número de partição com o nome do dispositivo. Por exemplo:

    # voma -m vmfs -f check -d /vmfs/devices/disks/naa.xxxx:x

    A saída lista os possíveis erros. Por exemplo, a saída a seguir indica que o endereço de pulsação é inválido.

    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