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
  • Manage your Dell EMC sites, products, and product-level contacts using Company Administration.

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 may have been automatically translated. If you have any feedback regarding its quality, please let us know using the form at the bottom of this page.

Article Content


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.


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

  • O usuário mystic não tem permissões suficientes para o VxVerify, portanto, use sudo ou use 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 .zip do VxVerify com número x.40 ou posterior 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, faça login na Dell primeiro: https://www.dell.com/identity/global/LoginOrRegister

Arquivo Readme

 


Recursos relacionados

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

Additional Information

 

     

      Article Properties


      Affected Product

      VxRail, VxRail Appliance Series

      Product

      VxRail Appliance Family, VxRail Software

      Last Published Date

      24 Jul 2024

      Version

      42

      Article Type

      How To