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 di VMware Tolls per l'installazione e gli aggiornamenti degli strumenti guest della macchina virtuale in un cloud privato della 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.

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. Viene pubblicato il pacchetto degli strumenti VMware.
   • 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 Run, gli host ESXi rilevanti nel cloud privato vengono aggiornati per usare la posizione degli strumenti centrali di 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.

Passo successivo

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