Skip to main content
  • Place orders quickly and easily
  • View orders and track your shipping status
  • Enjoy members-only rewards and discounts
  • Create and access a list of your products

Dell VxRail: Como executar a ferramenta VxVerify

Summary: Este artigo apresenta a ferramenta VxVerify do VxRail e mostra como executá-la com sucesso em um ambiente do VxRail.

This article applies to   This article does not apply to 

Instructions

Sumário:


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)


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

Por exemplo:
Menu Shell para executar o VxVerify no VxRail Manager
Menu Shell para executar o VxVerify no VxRail Manager
 

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 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:

Problemas de permissões ocorrem ao acessar alguns pacotes do Python em determinadas versões do VxRail 4.7 e no VxRail 7.0.010 ou posterior. O VxVerify pode ser executado como usuário root para resolver os problemas de permissão. 
  • Se o usuário root do vCenter não estiver incluído, os testes do VCSA não serão executados (exemplo de advertência abaixo), mas os testes do ESXi e do VxRM serão executados com ou sem o usuário root.
  • Uma advertência como a do exemplo abaixo poderá ser exibida se as credenciais de root do VCSA não forem fornecidas:
| vCenter_root           | Warning  21527 | warning: VCSA tests not run: no root password supplied                           .|
  • Uma advertência como a do exemplo abaixo poderá ser exibida se as credenciais de administrador do SSO não forem fornecidas:
| vCenter_admin          | Warning  21527 | warning: VCSA admin tests not run: no SSO credentials supplied                   .|
  • Para executar e criar logs, o VxVerify PRECISA ter permissões de gravação para a pasta /tmp/vxv mesmo que o usuário atual seja root. Se a permissão não for definida corretamente, outros usuários poderão ter problemas para executar o VxVerify no futuro. A prática recomendada é definir permissões que sejam as mais irrestritas possíveis.
  • Por padrão, ao ser executado, o VxVerify reinicia o VxRail Platform Services (/etc/init.d/vxrail-peservice) para limpar quaisquer informações obsoletas do Platform Services.


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)

Os pacotes do VxVerify .zip numerados x.40 e posteriores 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.
 
Nota: O link acima requer uma conta Dell registrada. Se o link não funcionar, primeiro faça log-in no Suporte Dell

Arquivo Readme

 


Recursos relacionados

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

 

Additional Information

 

     

      Affected Products

      VxRail, VxRail Appliance Series

      Products

      VxRail Appliance Family, VxRail Software
      Article Properties
      Article Number: 000021527
      Article Type: How To
      Last Modified: 21 Sept 2024
      Version:  45
      Find answers to your questions from other Dell users
      Support Services
      Check if your device is covered by Support Services.