Usare il comando run Set-ToolsRepo

Questo articolo illustra come utilizzare il comando Set-ToolsRepo run dall'inizio alla fine, come scaricare e pubblicare la versione GuestStore corretta del file ZIP di VMware Tools e come verificare che l'operazione sia riuscita.

Quando usare il comando Set-ToolsRepo run

Usa il comando Set-ToolsRepo run quando vuoi:

  • Rendere disponibile una versione specifica degli strumenti VMware per l'installazione e l'aggiornamento degli strumenti guest della macchina virtuale in un cloud privato soluzione Azure VMware.
  • Pubblicare centralmente la versione GuestStore del file ZIP degli strumenti VMware nella posizione centrale vSAN per gli strumenti VMware in modo che tutti gli host pertinenti possano fare riferimento al pacchetto.

Prerequisiti

  • Un URL HTTP o HTTPS pubblicamente accessibile che rimanda alla versione GuestStore del file ZIP di VMware Tools. L'URL deve essere raggiungibile dall'ambiente di esecuzione per soluzione Azure VMware eseguire i comandi.
  • Autorizzazione per eseguire i pacchetti di comandi Run Command di soluzione Azure VMware nel portale di Azure per il cloud privato di destinazione.

Contenuto ZIP previsto

Il file ZIP caricato deve:

  • Includere una directory payload di VMware Tools nel layout previsto.
  • Contenere la cartella versionata nella sezione 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 -Validate abilita una modalità di controllo di sola lettura per il repository degli strumenti VMware. Quando si specifica questa opzione, Set-ToolsRepo controlla i file di metadati dell'archivio dati corrente senza apportare modifiche all'ambiente.

Quando usare l'opzione -Validate

  • Prima di eseguire Set-ToolsRepo, come controllo di base
  • Dopo aver eseguito Set-ToolsRepo, per confermare che tutto sia sincronizzato
  • Se si sospetta un problema del repository o di sincronizzazione e si desidera un controllo rapido in sola lettura

Cosa controlla l'opzione -Validate

  • Identifica tutti gli archivi dati vSAN nel data center di Software-Defined (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

Risultati dell'opzione -Validate

  • PASS: le versioni corrispondono e gli archivi dati sono sincronizzati.
  • FAIL: viene rilevata una mancata corrispondenza o incoerenza.

Errori comuni delle opzioni di -Validate

  • Mancata corrispondenza dei metadati: eseguire Set-ToolsRepo di nuovo con un URL ZIP di VMware Tools valido (senza l'opzione -Validate ) per ridistribuire o ripristinare il repository. Quindi eseguire Set-ToolsRepo -Validate per verificare che i metadati siano sincronizzati.
  • Percorso di GuestStore non trovato: L'archivio potrebbe essere mancante o inaccessibile. Distribuire o 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 VMware

Il Set-ToolsRepo comando run accetta un URL HTTP o HTTPS accessibile pubblicamente alla versione GuestStore del file ZIP degli strumenti VMware che verrà pubblicato nella posizione centrale vSAN per gli strumenti VMware.

Prima che il comando apporta modifiche, viene eseguita la convalida di questi elementi:

  • 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 completo

  1. Scaricare la versione necessaria di VMware Tools.

    Ottenere la versione GuestStore del file ZIP degli strumenti VMware per la versione specifica da pubblicare nella posizione centrale vSAN per gli strumenti VMware.

  2. Ospitare il file ZIP in un URL HTTP o HTTPS accessibile pubblicamente. Ad esempio, usare qualsiasi server Web o archiviazione di oggetti in grado di gestire il file senza autenticazione interattiva.

    Specificare quindi l'URL di download diretto da usare con il comando run.

    Importante

    L'URL deve essere un collegamento di download diretto e raggiungibile senza autenticazione interattiva in modo che il comando di esecuzione possa recuperare il file ZIP.

  3. Eseguire il comando di esecuzione soluzione Azure VMwareSet-ToolsRepo. Fornire l'URL del file ZIP dal passaggio 2.

    Al termine del comando, l'output indica l'esito positivo o fornisce un messaggio di errore.

  4. Il pacchetto VMware Tools viene pubblicato.

    La versione richiesta è disponibile dalla posizione centrale vSAN per gli strumenti VMware per il cloud privato.

  5. Gli host sono configurati per l'uso del repository vSAN.

    Come parte del comando di esecuzione, gli host ESXi pertinenti nel cloud privato vengono aggiornati per usare la posizione centrale vSAN come origine degli strumenti VMware.

Validation

Dopo aver completato l'esecuzione del Set-ToolsRepo comando di esecuzione, seguire questa procedura di convalida:

  1. Passare al client vCenter ed esplorare l'archivio dati vSAN. Verificare che la cartella della versione esista in GuestStore/vmware/apps/vmtools/windows64/.

  2. Verificare che la versione corretta degli strumenti VMware sia disponibile per l'installazione o l'aggiornamento da una macchina virtuale di test guest.

  3. Se si verificano problemi con gli strumenti VMware dopo un'operazione di esecuzione riuscita, acquisire l'output del comando e aprire una richiesta di supporto.

Risoluzione dei problemi

Se il comando di esecuzione ha esito negativo, le cause più comuni sul lato cliente sono:

  • L'URL non è raggiungibile pubblicamente come collegamento di download diretto.
  • Il file ZIP non contiene la struttura di cartelle prevista.

Usare il messaggio di errore insieme ai passaggi seguenti per la risoluzione dei problemi.

Problemi relativi all'URL o al download

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

Problemi di struttura ZIP

  • Impossibile trovare la cartella prevista. Assicurarsi che il file ZIP contenga vmware/apps/vmtools/windows64/vmtools-<version> (inclusa la directory iniziale vmware/ ).
  • Più versioni in un unico file ZIP. Ospitare un file ZIP contenente solo la singola versione che si intende pubblicare, con una vmtools-<version> cartella.

Problemi relativi all'archivio dati

  • Errore di pubblicazione o configurazione sul lato servizio. Se l'URL e la struttura ZIP sono corretti ma il comando run continua a non riuscire, catturare l'output completo del comando e aprire una richiesta di supporto.
  • Errori intermittenti. Ripetere il comando di esecuzione dopo aver verificato che l'URL ZIP sia ancora valido e raggiungibile.

L'opzione di aggiornamento degli strumenti VMware non è disponibile e non nella versione corrente

L'opzione Installazione o aggiornamento degli strumenti VMware potrebbe essere disponibile (visualizzata in grigio) per le macchine virtuali in vCenter. Questa situazione può verificarsi quando i metadati del repository degli strumenti VMware nell'archivio dati vSAN non sono coerenti o non corretti.

Per la risoluzione, utilizzare le procedure seguenti.

Controllare i metadati del repository in GuestStore

  1. Passare a vSAN Datastore>GuestStore>vmware>apps>vmtools>windows64.

    Schermata del percorso GuestStore nel datastore vSAN.

  2. Verificare i file seguenti:

    • Metadati di primo livello: windows64/metadata.json.

      Schermata del file metadata.json principale nella directory windows64.

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

      Schermata del file metadata.json specifico per la versione all'interno della cartella della versione di vmtools.

Convalidare la coerenza dei metadati

Il file di primo livello metadata.json e il file specifico metadata.json della versione devono:

  • Usare la stessa versione di VMware Tools.
  • Essere coerenti tra loro (come illustrato negli screenshot di riferimento).

Se corrispondono, i metadati sono coerenti. Se non corrispondono, i metadati sono incoerenti.

Correzione della mancata corrispondenza dei metadati (se identificato)

Se il file di primo livello non è corretto:

  1. Eliminare windows64/metadata.json (ad esempio, vSAN Datastore/GuestStore/vmware/apps/vmtools/windows64/metadata.json).

  2. Caricare il file corretto windows64/metadata.json dal pacchetto VMware Tools più alto caricato.

Se il file specifico della versione non è corretto:

  1. Eliminare windows64/vmtools-<version>/metadata.json (ad esempio, vSAN Datastore/GuestStore/vmware/apps/vmtools/windows64/vmtools-<version>/metadata.json).

  2. Caricare il file corretto windows64/vmtools-<version>/metadata.json dal pacchetto VMware Tools più alto caricato.

Assicurarsi anche che entrambi i file di metadati corrispondano alla versione degli strumenti VMware.

Attendere l'aggiornamento dell'host

Attendere la propagazione della modifica tra gli host. Può richiedere fino a 24 ore.

Verificare la risoluzione

Controllare nuovamente la macchina virtuale in vCenter. L'opzione Installazione o aggiornamento degli strumenti VMware dovrebbe ora essere disponibile.

Conferma coerenza (facoltativo)

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

Contenuti correlati

  • Last updated on