VxRail: come eseguire lo strumento VxVerify

Sommario:

• Introduzione a VxRail VxVerify
• Installazione di VxVerify
• Esecuzione di VxVerify (con vxverify.sh)
• Best practice per VxVerify
• Risoluzione dei problemi e raccolta dei registri
• Esecuzione di VxVerify (con Python)
• Versioni Python alternative
• Treno di versioni di VxVerify
• Download della versione più recente di VxVerify
• Risorse correlate

Introduzione a VxRail VxVerify:

• VxVerify è progettato per rilevare in modo proattivo i problemi che potrebbero causare inconvenienti o errori durante gli aggiornamenti di VxRail.
• Lo strumento VxVerify contiene all'interno un programma Python, denominato "minion", che viene inviato per l'esecuzione a ogni nodo ESXi. Il programma effettua una serie di controlli sull'host, ad esempio il controllo delle informazioni iDRAC e il controllo dell'integrità di vSAN per ciascun nodo.
• Dati i frequenti aggiornamenti dello strumento VxVerify, il ciclo di vita del "minion" è progettato per durare 21 giorni. Scaricare sempre la versione più recente prima di eseguire VxVerify. Consultare la sezione Download della versione più recente di VxVerify riportata più avanti.

Installazione di VxVerify:

• Per installare VxVerify, scaricare il file vxverify_x-x-xxx.zip più recente e copiarlo in VxRail Manager tramite SSH.
• In VxRail Manager, estrarre il file vxverify_x-x-xxx.zip ed eseguire VxVerify.
  • Il nome del file pyc di VxVerify include la versione del file, mentre negli esempi riportati di seguito viene utilizzato per semplicità vxverify.pycdegli host.
  • Se il file pyc viene rinominato, VxVerify può ugualmente essere eseguito da Python, come indicato di seguito, ma in questo caso il metodo dello script di menu per avviare VxVerify (vxverify.sh) non funziona.
• VxVerify viene eseguito per impostazione predefinita dalla cartella seguente, che è la posizione migliore in cui copiare il file (va creata, se necessario): 

/tmp/vxv

• VxVerify e VxRail utilizzano le stesse porte IP. I risultati di VxVerify vengono generati tramite SSH sui nodi e l'API di VxRM. Altre porte vengono utilizzate per controllare servizi specifici, ad esempio la porta 9090 per i nodi. (A partire dalla versione 8.0.300, la porta del servizio della piattaforma sul nodo viene modificata in 39090)
  • L'elenco completo delle porte è disponibile in VxRail Customer Firewall Configuration.  

Esecuzione di VxVerify (con vxverify.sh):

• L'utente mystic non dispone di autorizzazioni sufficienti per VxVerify, quindi utilizzare sudo o utilizzare su per accedere come root.
• Si consiglia di utilizzare il sistema di menu ((vxverify.sh)), che richiede all'utente il tipo di controllo integrità necessario in base agli input forniti.  

sudo ./vxverify.sh

Best practice per VxVerify: 

• VxVerify.sh richiede all'utente di specificare gli utenti root e SSO amministratore di vCenter e relative password per eseguire i test.
  • Se si utilizza vCenter gestito da VxRail, VxRail Engineering consiglia di specificare queste credenziali per consentire l'esecuzione completa di tutti i test.
  • Se si utilizza vCenter gestito dal cliente, questi test potrebbero segnalare impostazioni o condizioni su vCenter non applicabili a VxRail.
• La specifica delle credenziali root in VxVerify.sh consente l'esecuzione di test su VxRM aggiuntivi, ma l'accesso come utente standard, ad esempio "mystic", è sufficiente per tutti i test sugli host e per la maggior parte dei test su VxRM.

Risoluzione dei problemi e raccolta dei registri:

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

Guardare il seguente video "Dell VxRail: How to run the VxRail Verify Tool".

Esecuzione di VxVerify (con Python):

Ulteriori informazioni sono visibili ai destinatari dell'articolo.

Se si segue una procedura che include l'esecuzione diretta del file pyc di VxVerify senza lo script della shell (consultare la sezione Esecuzione di VxVerify (con VxVerify.sh) del presente articolo), VxVerify può essere eseguito direttamente da Python.

Le credenziali SSO e root devono essere aggiunte manualmente come argomenti, oltre al livello di codice di destinazione, durante l'esecuzione di VxVerify da Python:

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

• sudo : potrebbe essere necessario aggiungere sudo prima del comando precedente, se non si esegue lo strumento da root (lo stesso vale per VxVerify.sh).
• Il file pyc di Python è compilato per una famiglia di versioni Python specifica, ad esempio Python 3.6 (vxverify3). L'esecuzione del file pyc di VxVerify errato per la versione di VxRail determina una risposta di Python con errori "magic number".
• Nell'esempio precedente vengono richieste le password corrispondenti agli utenti specificati.
• Se l'utente root non è incluso, i test su vCSA-root non vengono eseguiti, mentre i test su ESXi e VxRM vengono eseguiti sia con che senza l'utente root.
• Se l'utente SSO non è incluso, i test su vCSA-admin non vengono eseguiti e alcuni test su VxRM presentano funzionalità ridotte.
• Senza le credenziali aggiuntive elencate in precedenza, VxVerify funziona comunque, ma non include i test che richiedono tali credenziali. Alcuni problemi non vengono quindi sottoposti a test, con la possibile conseguenza di esito negativo di un aggiornamento.

Versioni Python alternative

Alcune versioni di VxRail contengono più versioni di Python, il che significa che in tal caso potrebbe essere possibile eseguire più versioni di VxVerify. Tuttavia, VxVerify richiede la presenza di alcune librerie Python aggiuntive nelle varie cartelle "site-packages", che potrebbero non essere presenti per alcuni livelli Python. 

Il livello Python predefinito (che viene eseguito dal comando "python"), potrebbe non disporre dei pacchetti necessari e di conseguenza potrebbe essere necessario specificare il livello Python corretto nel comando Python. Esempio:

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

• sudo : potrebbe essere necessario aggiungere sudo prima del comando precedente, se non si esegue lo strumento da root (lo stesso vale per VxVerify.sh).

Treno di versioni di VxVerify:

Il pacchetto di download di VxVerify contiene le varie versioni di VxVerify per far fronte ai diversi livelli di Python che possono essere presenti in VxRail Manager:

• VxVerify 2.xx.xxx per VxRail 4.5, 4.7 e 7.0.000 (che utilizza Python 2.7)
• VxVerify 3.xx.xxx per VxRail 7.0.010 e versioni successive (che utilizzano Python 3.6)
• VxVerify 4.xx.xxx per VxRail 8.0.210 e versioni successive (che utilizzano Python 3.11)

Il pacchetto zip VxVerify contiene i pacchetti per tutte le versioni di VxRail supportate (come mostrato sopra).

L'esecuzione di VxVerify con vxverify.sh seleziona automaticamente il file pyc corretto, in modo che corrisponda al livello Python in esecuzione su VxRM.

Download della versione più recente di VxVerify:

Dell Technologies Services - Central VxVerity for VxRail

Consultare la sezione "Associated Files" per scaricare il file Readme con l'elenco completo delle modifiche.
 

Risorse correlate

Di seguito sono riportati alcune risorse consigliate correlate a questo argomento che potrebbero essere di interesse per l'utente:

• Come controllare lo stato della modalità di manutenzione ESXi dal punto di vista di vSAN (in inglese)
• Guida alla risoluzione dei problemi di Dell VxRail per gli host VMware ESXi con stato "Not Responding" (in inglese)