VxRail: Como executar a ferramenta VxVerify

Sumário:

• Introdução ao VxRail VxVerify
• Instalação do VxVerify
• Execução do VxVerify (usando vxverify.sh)
• Prática recomendada para o VxVerify
• Solução de problemas e coleta de logs
• Execução do VxVerify (usando Python)
• Versões alternativas do Python
• Série de versões do VxVerify
• Download do VxVerify mais recente
• Recursos relacionados

Introdução ao VxRail VxVerify:

• O VxVerify foi projetado para detectar proativamente problemas que podem causar complicações ou falhas durante os upgrades do VxRail.
• A ferramenta VxVerify descompacta um programa Python, denominado "minion", que é enviado para cada nó do ESXi. Esse "minion" analisa uma lista de verificações de host, como verificar as informações do iDRAC e analisar a verificação de integridade do vSAN para cada nó.
• Devido às atualizações frequentes da própria ferramenta VxVerify, o ciclo de vida do "minion" foi projetado para durar 21 dias. Sempre faça download da versão mais recente antes de executar o VxVerify. Consulte a seção Download do VxVerify mais recente abaixo.

Instalação do VxVerify:

• Para instalar o VxVerify, faça download do arquivo vxverify_x-x-xxx.zip mais recente e copie-o para o VxRail Manager usando SSH.
• No VxRail Manager, extraia o arquivo vxverify_x-x-xxx.zip e execute o VxVerify.
  • O nome do arquivo pyc do VxVerify inclui a versão do arquivo, enquanto os exemplos abaixo são simplificados para vxverify.pyc.
  • Se o pyc for renomeado, o VxVerify ainda poderá ser executado a partir do Python, conforme listado abaixo, mas o método de script de menu para iniciar o VxVerify (vxverify.sh) não funcionará.
• Por padrão, o VxVerify é executado da seguinte pasta, que seria o melhor local para copiar o arquivo (crie-o, se necessário): 

/tmp/vxv

• O VxVerify e o VxRail usam as mesmas portas IP. Os resultados do VxVerify são gerados usando SSH para os nós e a API do VxRM. Outras portas são usadas para verificar serviços específicos, como a porta 9090 para os nós. (A partir da versão 8.0.300, a porta de serviço da plataforma no nó é alterada para 39090)
  • Uma lista completa de portas pode ser encontrada na Configuração do firewall do cliente do VxRail  

Execução do VxVerify (usando vxverify.sh):

• O usuário mystic não tem permissões suficientes para o VxVerify, portanto, use sudo ou usar su para fazer login como root.
• É recomendável usar o sistema de menus ((vxverify.sh)), que solicita ao usuário que tipo de verificação de integridade é necessária com base nas entradas fornecidas.  

sudo ./vxverify.sh

Prática recomendada para o VxVerify: 

• VxVerify.sh pede para o usuário fornecer os nomes de usuário e as senhas de SSO de administrador e root do vCenter para executar os testes.
  • Se estiver usando um vCenter gerenciado pelo VxRail, a engenharia do VxRail recomenda fornecer essas credenciais para permitir que todos os testes sejam totalmente executados.
  • Se estiver usando um vCenter gerenciado pelo cliente, esses testes poderão relatar configurações ou condições no vCenter que não se aplicam ao VxRail
• As credenciais de root de VxVerify.sh permite que testes adicionais do VxRM sejam executados, mas fazer login como um usuário padrão, como "mystic", é suficiente para todos os testes de host e a maioria dos testes do VxRM.

Solução de problemas e coleta de logs:

| vCenter_root           | Warning  21527 | warning: VCSA tests not run: no root password supplied                           .|

| vCenter_admin          | Warning  21527 | warning: VCSA admin tests not run: no SSO credentials supplied                   .|

Assista ao vídeo a seguir: "Dell VxRail: Como executar a ferramenta de verificação VxRail".

Execução do VxVerify (usando Python):

O público-alvo do artigo pode visualizar informações adicionais.

Se você estiver seguindo um procedimento que inclua a execução direta do pyc do VxVerify, sem o script Shell (consulte a seção do artigo: Execução do VxVerify (usando VxVerify.sh), o VxVerify pode ser executado diretamente no Python.

Ao executar o VxVerify a partir do Python, o SSO e as credenciais raiz devem ser adicionados manualmente como argumentos, além do nível de código de destino:

python ./vxverify.pyc -r root -u administrator@vsphere.local -g 7.0.401

• sudo talvez precise ser inserido na frente do comando acima, se não estiver sendo executado com root (o mesmo se aplica a VxVerify.sh).
• O arquivo pyc do Python é compilado para uma família de versão específica do Python, como Python 3.6 (vxverify3). A execução do arquivo pyc incorreto do VxVerify para a versão do VxRail faz com que o Python responda com erros de "número mágico".
• O exemplo acima solicita as senhas que correspondem aos usuários especificados.
• Se o usuário root não estiver incluído, os testes de root do VCSA não serão executados, mas os testes do ESXi e do VxRM serão executados com ou sem o usuário root.
• Se o usuário SSO não estiver incluído, os testes de administrador do VCSA não serão executados e alguns testes do VxRM terão a funcionalidade reduzida.
• Sem as credenciais adicionais listadas acima, o VxVerify ainda é executado, mas não inclui testes que exigem essas credenciais. Portanto, testes para alguns problemas não são executados, podendo causar falha no upgrade.

Versões alternativas do Python

Algumas versões do VxRail contêm mais de uma versão do Python, o que significa que talvez seja possível executar mais de uma versão do VxVerify nessas versões. No entanto, o VxVerify requer que diversas bibliotecas adicionais do Python estejam presentes nas várias pastas "site-packages", que podem não estar presentes em alguns níveis do Python. 

O nível padrão do Python (que é executado com o comando "python"), pode não ter os pacotes necessários e, portanto, o nível correto do Python pode ter que ser especificado no comando do Python. Por exemplo,

python3.11 ./vxverify4.pyc -r root -u administrator@vsphere.local -g 8.0.210

• sudo talvez precise ser inserido na frente do comando acima, se não estiver sendo executado com root (o mesmo se aplica a VxVerify.sh).

Série de versões do VxVerify:

O pacote de download do VxVerify contém as várias versões do VxVerify para atender aos diferentes níveis do Python que podem estar presentes no VxRail Manager:

• VxVerify 2.xx.xxx para VxRail 4.5, 4.7 ou 7.0.000 (que usa o Python 2.7)
• VxVerify 3.xx.xxx para VxRail 7.0.010 ou posterior (que usa o Python 3.6)
• VxVerify 4.xx.xxx para VxRail 8.0.210 ou posterior (que usa o Python 3.11)

O pacote zip do VxVerify contém pacotes para todas as versões compatíveis do VxRail (conforme mostrado acima).

A execução do VxVerify usando vxverify.sh seleciona automaticamente o arquivo pyc correto para corresponder ao nível do Python em execução no VxRM.

Download do VxVerify mais recente:

Dell Technologies Services – Central VxVerity para VxRail

Consulte a seção "Arquivos associados" para fazer download do arquivo Readme e ver a lista completa de alterações.
 

Recursos relacionados

Aqui estão alguns recursos recomendados relacionados a este tópico que podem ser de seu interesse:

• Como verificar o status do modo de manutenção do ESXi sob a perspectiva do vSAN
• Guia de solução de problemas do Dell VxRail para hosts do VMware ESXi com status "Not Responding"