Comando Set-ToolsRepo Run

Questo articolo illustra come utilizzare il comando Esegui Set-ToolsRepo completo, come scaricare e ospitare la versione corretta di GuestStore del file ZIP degli strumenti VMware, come viene eseguito il comando Esegui AVS e come è possibile convalidare il successo.

Quando usare Set-ToolsRepo esegui comando

Questo comando esegui deve essere usato per rendere disponibile una versione specifica degli strumenti VMware per l'installazione e gli aggiornamenti degli strumenti guest della macchina virtuale in un cloud privato soluzione Azure VMware. Quando si vuole pubblicare centralmente la versione GuestStore del file ZIP degli strumenti VMware nel percorso degli strumenti centrali vSAN in modo che tutti gli host pertinenti possano fare riferimento al pacchetto.

Prerequisiti

• URL HTTP/HTTPS accessibile pubblicamente che punta alla versione GuestStore del file ZIP di VMware Tools (fornito dal cliente). L'URL deve essere raggiungibile dall'ambiente di esecuzione dei comandi della soluzione Azure VMware.
• Autorizzazione per eseguire pacchetti di comando della soluzione Azure VMware nel portale di Azure per il cloud privato di destinazione.
• Il contenuto ZIP deve includere una directory payload di VMware Tools nel layout previsto.

Contenuto ZIP previsto

Il file ZIP caricato deve contenere la cartella con versione nella sezione seguente: vmware/apps/vmtools/windows64/vmtools-version<>/. Il nome della cartella deve seguire il formato vmtools-version<> ,ad esempio vmtools-12.4.0.

Opzione Convalida

L'opzione Convalida abilita una modalità di controllo di sola lettura per il repository Tools. Se specificato, Set-ToolsRepo controlla i file di metadati dell'archivio dati corrente senza apportare modifiche all'ambiente.

Quando usare l'opzione Convalida

• Prima di eseguire Set-ToolsRepo (controllo di base)
• Dopo aver eseguito Set-ToolsRepo (verificare che tutto sia sincronizzato)
• Se si sospetta un problema di repository/sincronizzazione e si vuole un rapido controllo di sola lettura

Cosa verifica l'opzione Convalida?

• Identifica tutti gli archivi dati vSAN in SDDC
• Legge i metadati del repository (top-level-metadata.json e version-metadata.json)
• Verifica che i metadati e lo stato dell'archivio dati siano coerenti e sincronizzati

Convalidare i risultati

• PASS: le versioni corrispondono e gli archivi dati sono sincronizzati
• FAIL: rilevata mancata corrispondenza/incoerenza

Errori comuni delle opzioni di convalida

• Mancata corrispondenza dei metadati → Rieseguire Set-ToolsRepo con un URL ZIP degli strumenti valido (senza -Validate opzione) per ridistribuire/ripristinare il repository, quindi eseguire Set-ToolsRepo -Validate per verificare che i metadati siano sincronizzati.
• GuestStore path not found → Il repository potrebbe essere mancante o inaccessibile; effettuare il deploy/reinizializzare eseguendo Set-ToolsRepo con un URL ZIP valido (senza l'opzione -Validate), quindi eseguire Set-ToolsRepo -Validate per verificare che il repository sia presente e sincronizzato.

URL ZIP degli strumenti

Il comando Set-ToolsRepo Run accetta un URL HTTP/HTTPS pubblicamente accessibile alla versione GuestStore del file ZIP di VMware Tools che verrà pubblicato nella posizione centrale degli strumenti vSAN. Prima di apportare modifiche, verificare che l'URL sia utilizzabile e che il file ZIP possa essere scaricato correttamente.

• L'URL usa HTTP o HTTPS ed è un collegamento di download diretto.
• Il file è raggiungibile senza autenticazione interattiva e può essere scaricato end-to-end.

Flusso di lavoro end-to-end

1. Il cliente scarica la versione necessaria degli strumenti VMware.
   • Il cliente ottiene la versione GuestStore del file ZIP degli strumenti VMware per la versione specifica che vuole pubblicare nel percorso degli strumenti centrali vSAN.
2. Il cliente ospita il file ZIP in un percorso HTTP/HTTPS accessibile pubblicamente.
   • Il cliente deve ospitare il file ZIP in un URL HTTP/HTTPS accessibile pubblicamente(ad esempio, qualsiasi server Web o archiviazione di oggetti in grado di gestire il file senza autenticazione interattiva). Specificano quindi l'URL di download diretto da usare con il comando Esegui.

3. Il cliente esegue il comando Run Set-ToolsRepo.
   • Eseguire il comando Esegui AVS e specificare l'URL ZIP condiviso nel passaggio 2. Al termine, l'output del comando indicherà l'esito positivo o fornirà un messaggio di errore.
4. Il pacchetto degli strumenti VMware viene pubblicato.
   • Al termine dell'esecuzione del comando, la versione richiesta degli strumenti VMware è disponibile dal percorso degli strumenti centrali vSAN per il cloud privato.
5. Gli host sono configurati per l'uso del repository vSAN
   • Come parte del comando Esegui, gli host ESXi pertinenti nel cloud privato vengono aggiornati per usare la posizione degli strumenti centrali vSAN come origine degli strumenti VMware.

Validation

Dopo aver eseguito correttamente il Set-ToolsRepo Esegui comando, assicurarsi di seguire i passaggi seguenti per la convalida.

• Passare al client vCenter ed esplorare l'archivio dati vSAN. verificare che la cartella version esista in GuestStore/vmware/apps/vmtools/windows64/
• Verificare che la versione corretta degli strumenti VMware sia disponibile per l'installazione o l'aggiornamento dall'interno di una macchina virtuale di test guest.
• Se si verificano problemi con VMware Tools dopo l'operazione di Esegui Comando riuscita, registrare l'output di Esegui Comando e aprire una richiesta di supporto.

Risoluzione dei problemi

Se l'esecuzione del comando ha esito negativo, le cause più comuni sul lato cliente sono che l'URL non è raggiungibile pubblicamente come collegamento di download diretto o il file ZIP non contiene la struttura di cartelle prevista.
Usare il messaggio di errore insieme ai passaggi per la risoluzione dei problemi elencati di seguito.

Problemi relativi all'URL o al download

• URL non raggiungibile o il download non riesce. Verificare che l'URL venga aperto da una rete esterna, sia un collegamento di download diretto e che non richieda token di accesso, autenticazione a più fattori o token con limitazioni di tempo.
• Errore TLS/SSL. Verificare che l'endpoint HTTPS supporti TLS moderno e presenti un certificato valido.

Problemi relativi alla struttura ZIP

• Impossibile trovare la cartella prevista. Verificare che il file ZIP contenga vmware/apps/vmtools/windows64/vmtools-<version> (inclusa la directory iniziale vmware/).
• Più versioni in un unico FILE ZIP. Carica un file ZIP che contenga solo la singola versione che intendi pubblicare, con una cartella chiamata vmtools-<version>.

Problemi relativi all'archivio dati

• Errore di pubblicazione/configurazione sul lato servizio. Se l'URL e la struttura ZIP sono corrette ma il comando continua a fallire, acquisire l'output completo del comando Run e aprire una richiesta di supporto.
• Errori intermittenti. Riprovare a eseguire il comando dopo aver confermato che l'URL ZIP è ancora valido e raggiungibile.

Opzione di aggiornamento degli strumenti VMware disattivata e non nella versione corrente

Issue

L'opzione VMware Tools Installa/Aggiorna appare disabilitata (in grigio) per le macchine virtuali in vCenter.
Questo problema può verificarsi quando i metadati del repository degli strumenti VMware nell'archivio dati vSAN non sono coerenti o non corretti.

Resolution

Controllare i metadati del repository in GuestStore

• Passare a:
  vSAN Datastore → GuestStore → vmware → apps → vmtools → windows64

• Verificare i file seguenti:
  • Metadati di primo livello:
    windows64/metadata.json

• Metadati specifici della versione:
  windows64/vmtools-version<>/metadata.json

Convalidare la coerenza dei metadati

• Le metadata.json di livello superiore e le metadata.json specifiche della versione devono:
  • Far corrispondere la stessa versione di VMware Tools
  • Essere coerenti tra loro (come illustrato negli screenshot di riferimento)
• Interpretazione:
  • Se corrispondono → metadati sono coerenti
  • Se non corrispondono →'incoerenza dei metadati esiste

Correzione della mancata corrispondenza dei metadati (se identificato)

• Se il file di primo livello non è corretto:
  • Eliminazione:
    windows64/metadata.json
    (Esempio: vSAN Datastore/GuestStore/vmware/apps/vmtools/windows64/metadata.json)
  • Carica il file windows64/metadata.json corretto dal pacchetto VMware Tools con la versione più alta tra quelli caricati
• Se il file specifico della versione non è corretto:
  • Eliminazione:
    windows64/vmtools-version<>/metadata.json
    (Esempio: vSAN Datastore/GuestStore/vmware/apps/vmtools/windows64/vmtools-version<>/metadata.json)
  • Caricare il file windows64/vmtools-version<>/metadata.json corretto dal pacchetto VMware Tools più alto caricato
• Assicurarsi che entrambi i file di metadati corrispondano alla stessa versione degli strumenti VMware

Attendere l'aggiornamento dell'host

• Attendere la propagazione della modifica tra gli host (fino a 24 ore)

Verificare la risoluzione

• Controllare nuovamente la macchina virtuale in vCenter
• L'opzione Installazione/aggiornamento degli strumenti VMware dovrebbe ora essere abilitata

Optional

• Eseguire Set-ToolsRepo -Validate per confermare la coerenza dei metadati

Passo successivo

Per altre informazioni sull'esecuzione dei comandi, vedere Eseguire comandi.