Async Patch Tool è un'utilità che consente di applicare patch critiche al di fuori del normale processo di gestione del ciclo di vita di VMware Cloud Foundation. Fornisce inoltre opzioni per la gestione di patch asincrone e l'aggiornamento di un'istanza di VMware Cloud Foundation che include patch asincrone.

Opzione della Guida di Async Patch Tool

Opzione Descrizione
-h, --help Fornisce informazioni sulle opzioni di Async Patch Tool.
Esempio: 
./vcf-async-patch-tool -h

Opzione Customer Experience Improvement Program (CEIP)

Async Patch Tool partecipa al programma Customer Experience Improvement Program (CEIP). È possibile abilitare o disattivare CEIP per Async Patch Tool.

Il programma Customer Experience Improvement Program fornisce informazioni che consentono a Broadcom di migliorare i prodotti e i servizi, di risolvere i problemi, nonché di consigliare agli utenti come distribuire e utilizzare al meglio i prodotti Broadcom. Nell'ambito del programma CEIP, Broadcom raccoglie regolarmente informazioni tecniche sull'uso dei prodotti e dei servizi Broadcom da parte delle organizzazioni oltre alle chiavi di licenza Broadcom di tali organizzazioni. Queste informazioni non permettono in alcun modo l'identificazione personale di alcun utente. Per ulteriori informazioni sul programma CEIP, fare riferimento al Trust & Assurance Center all'indirizzo http://www.vmware.com/trustvmware/ceip.html.
Opzione Descrizione
--ceip true/false Abilitare o disattivare la telemetria (CEIP) per Async Patch Tool.
Nota: L'opzione --ceip è deprecata. Quando si eseguono altre opzioni che utilizzano Async Patch Tool, ad esempio -l, --listAsyncPatch o -e, --enableAsyncPatch, sarà necessario specificare le impostazioni del programma CEIP.
Esempio: 
./vcf-async-patch-tool -ceip false

Opzione Elenca patch asincrone

Questa opzione richiede una connessione Internet. Utilizzare questa opzione prima di applicare una patch asincrona. Vedere Applicazione di una patch asincrona in VMware Cloud Foundation in modalità online e Applicazione di una patch asincrona in VMware Cloud Foundation in modalità offline.

Opzione Descrizione
-l, --listAsyncPatch Elenca le patch asincrone disponibili. Fare riferimento all'articolo 88287 della Knowledge Base per verificare quali versioni di VMware Cloud Foundation supportano ciascuna patch asincrona.
Input necessari Input facoltativi
--depotUser, --du

Immettere l'indirizzo e-mail del portale del supporto Broadcom per la connessione al depot VMware.
  • --sku

    Filtra l'elenco di patch asincrone in base allo SKU. Immettere VCF o VCF_ON_VXRAIL.

  • --productType, --ptype
    Filtra l'elenco delle patch asincrone in base al tipo di prodotto. Immettere ESX_HOST, NSX o VCENTER.
    Nota: Il tipo di prodotto ESX_HOST non è disponibile per VMware Cloud Foundation on Dell EMC VxRail.
  • --proxyServer, --ps

    Se ci si connette a Internet tramite un server proxy, utilizzare l'opzione --proxyServer, --ps per specificare il nome di dominio completo e la porta del server proxy. Ad esempio --proxyServer FQDN:port.
Esempio: 
./vcf-async-patch-tool --listAsyncPatch --depotUser [email protected] --productType VCENTER

Opzione Scarica patch (solo offline)

Questa opzione richiede una connessione Internet. Utilizzare questa opzione per scaricare una patch asincrona in un ambiente offline. Vedere Applicazione di una patch asincrona in VMware Cloud Foundation in modalità offline.

Opzione Descrizione
-d, --download Scarica la patch e gli artefatti specificati.
Input necessari Input facoltativi
  • --patch

    Immettere il prodotto e la versione (prodotto:versione) di una patch asincrona. Ad esempio: VCENTER:7.0.3.00300-19234570.

  • --depotUser, --du

    Immettere l'indirizzo e-mail del portale del supporto Broadcom per la connessione al depot VMware.

  • --partnerBundleDepotUserName, --pdu (solo VxRail)

    Immettere l'indirizzo e-mail del depot Dell EMC.
  • --op, --outputDirectory

    Immettere il percorso completo della posizione in cui scaricare la patch.

    Se non si specifica una directory di output, Async Patch Tool utilizza /root/apToolBundles.

  • --sddcManagerVersion

    Immettere la versione corrente di SDDC Manager. Ad esempio: 4.5.0.0. Questo limita il numero di bundle scaricati solo a quelli applicabili alla versione corrente di SDDC Manager.

  • --sku

    Filtra l'elenco di patch asincrone in base allo SKU. Immettere VCF o VCF_ON_VXRAIL.

  • --proxyServer, --ps

    Se ci si connette a Internet tramite un server proxy, utilizzare l'opzione --proxyServer, --ps per specificare il nome di dominio completo e la porta del server proxy. Ad esempio --proxyServer FQDN:port.
Esempio: 
./vcf-async-patch-tool -d --patch VCENTER:7.0.3.00300-19234570 --du [email protected] --sku VCF --sddcManagerVersion 4.5.0.0

Opzione Abilita patch

L'opzione Abilita patch deve essere eseguita nell'Appliance SDDC Manager. Dopo aver abilitato una patch asincrona, è possibile accedere all'Interfaccia utente di SDDC Manager e applicare la patch a tutti i domini del carico di lavoro. Vedere Applicazione di una patch asincrona in VMware Cloud Foundation in modalità online e Applicazione di una patch asincrona in VMware Cloud Foundation in modalità offline.

Opzione Descrizione
-e, --enableAsyncPatch L'abilitazione di una patch comporta la sincronizzazione dell'inventario, il download del bundle (solo in modalità online), l'abilitazione della verifica preliminare della patch e l'abilitazione della verifica successiva della patch. Carica inoltre la patch nel repository LCM interno dell'Appliance SDDC Manager.
Input necessari Input facoltativi
  • --patch

    Immettere il prodotto e la versione (prodotto:versione) di una patch asincrona. Ad esempio: VCENTER:7.0.3.00300-19234570.

  • --sddcSSOUser, --ssou

    Immettere l'utente SSO del dominio di gestione. Ad esempio: [email protected].

  • --sddcSSHUser, --sshu

    Immettere vcf.

  • --depotUser, --du (solo online)

    Immettere l'indirizzo e-mail del portale del supporto Broadcom per la connessione al depot VMware.

  • --partnerBundleDepotUserName, --pdu (solo VxRail online)

    Immettere l'indirizzo e-mail del depot Dell EMC.

  • --instanceType, --it

    Immettere ONLINE oppure OFFLINE.
  • --op, --outputDirectory

    Immettere il percorso completo della posizione in cui scaricare la patch (modalità online) o la posizione in cui è stata caricata la patch (modalità offline). Ad esempio, /nfs/vmware/vcf/nfs-mount/apToolBundles.

    Se non si specifica una directory di output, Async Patch Tool utilizza /root/apToolBundles.

  • --proxyServer, --ps

    Se ci si connette a Internet tramite un server proxy, utilizzare l'opzione --proxyServer, --ps per specificare il nome di dominio completo e la porta del server proxy. Ad esempio --proxyServer FQDN:port.
Esempio: 
./vcf-async-patch-tool -e --patch VCENTER:7.0.3.00300-19234570 --sddcSSOUser [email protected] --sddcSSHUser vcf --outputDirectory /nfs/vmware/vcf/nfs-mount/apToolBundles --it ONLINE

Opzione Verifica preliminare

Le verifiche preliminari vengono eseguite come parte delle opzioni -e, --enableAsyncPatch e -r, --enableVCFUpgrade. È inoltre possibile eseguire l'opzione Verifica preliminare da sola prima di abilitare una patch asincrona o un aggiornamento di VCF per assicurarsi che l'operazione venga eseguita correttamente. È necessario eseguire l'opzione Verifica preliminare nell'Appliance SDDC Manager.

Opzione Descrizione
--pre, --precheck Verifica che il sistema sia in grado di abilitare una patch asincrona o un aggiornamento di VCF.
Input necessari Input facoltativi
  • -e, --enableAsyncPatch o -r, --enableVCFUpgrade

    Per -r, --enableVCFUpgrade è necessario fornire la versione di destinazione di VCF. Ad esempio: 4.4.0.0.

  • --patch (solo abilitazione della patch)

    Immettere il prodotto e la versione (prodotto:versione) di una patch asincrona. Ad esempio: VCENTER:7.0.3.00300-19234570.

  • --sddcSSOUser, --ssou

    Immettere l'utente SSO del dominio di gestione. Ad esempio: [email protected].

  • --sddcSSHUser, --sshu

    Immettere vcf.

  • --depotUser, --du (solo online)

    Immettere l'indirizzo e-mail del portale del supporto Broadcom per la connessione al depot VMware.

  • --partnerBundleDepotUserName, --pdu (solo online, VxRail e abilitazione dell'aggiornamento di VCF)

    Immettere l'indirizzo e-mail del depot Dell EMC.

  • --instanceType, --it

    Immettere ONLINE oppure OFFLINE.

  • --op, --outputDirectory (solo offline)

    Immettere il percorso completo della posizione in cui sono stati caricati la patch o i bundle. Ad esempio, /nfs/vmware/vcf/nfs-mount/apToolBundles.
  • --op, --outputDirectory (solo online)

    Immettere il percorso completo della posizione in cui scaricare la patch o i bundle. Ad esempio, /nfs/vmware/vcf/nfs-mount/apToolBundles.

    Se non si specifica una directory di output, Async Patch Tool utilizza /root/apToolBundles.

  • --proxyServer, --ps

    Se ci si connette a Internet tramite un server proxy, utilizzare l'opzione --proxyServer, --ps per specificare il nome di dominio completo e la porta del server proxy. Ad esempio --proxyServer FQDN:port.
Esempio di modalità online: 
./vcf-async-patch-tool -e --pre --patch VCENTER:7.0.3.00300-19234570 --sddcSSOUser [email protected] --sddcSSHUser vcf --depotUser [email protected] --outputDirectory /nfs/vmware/vcf/nfs-mount/apToolBundles --it ONLINE
Esempio di modalità offline: 
./vcf-async-patch-tool --pre --enableVCFUpgrade 4.4.0.0 --sddcSSOUser [email protected] --sddcSSHUser vcf --outputDirectory /nfs/vmware/vcf/nfs-mount/apToolBundles --it OFFLINE

Opzione Verifica successiva

Le verifiche successive vengono eseguite come parte dell'opzione -e, --enableAsyncPatch. È inoltre possibile eseguire l'opzione Verifica successiva da sola dopo aver abilitato una patch asincrona. È necessario eseguire l'opzione Verifica successiva nell'Appliance SDDC Manager.

Opzione Descrizione
--post, --postcheck Verifica che una patch asincrona sia stata caricata nel repository LCM interno dell'Appliance SDDC Manager e che sia disponibile per l'aggiornamento.
Input necessari Input facoltativi
  • -e, --enableAsyncPatch
  • --patch

    Immettere il prodotto e la versione (prodotto:versione) di una patch asincrona. Ad esempio: VCENTER:7.0.3.00300-19234570.

  • --sddcSSOUser, --ssou

    Immettere l'utente SSO del dominio di gestione. Ad esempio: [email protected].

  • --sddcSSHUser, --sshu

    Immettere vcf.

  • --op, --outputDirectory

    Immettere il percorso completo della posizione di download del bundle utilizzata quando è stata abilitata la patch. Ad esempio, /nfs/vmware/vcf/nfs-mount/apToolBundles.

 Nessuno.
Esempio: 
./vcf-async-patch-tool -e --post --patch VCENTER:7.0.3.00300-19234570 --sddcSSOUser [email protected] --sddcSSHUser vcf --outputDirectory /nfs/vmware/vcf/nfs-mount/apToolBundles

Opzione Disattiva tutte le patch

Non è possibile abilitare le patch asincrone o gli aggiornamenti di VCF se nell'istanza di VMware Cloud Foundation sono già abilitate patch asincrone. Tutte le patch vengono disattivate quando si esegue Async Patch Tool con l'opzione -r, --enableVCFUpgrade. È inoltre possibile eseguire l'opzione --disableAllPatches da sola. È necessario eseguire l'opzione nell'Appliance SDDC Manager.

Opzione Descrizione
--da, --disableAllPatches Disattiva nel sistema tutte le patch asincrone che erano state abilitate in precedenza.
Input necessari Input facoltativi
  • --sddcSSOUser, --ssou

    Immettere l'utente SSO del dominio di gestione. Ad esempio: [email protected].

  • --sddcSSHUser, --sshu

    Immettere vcf.

 Nessuno.
Esempio: 
./vcf-async-patch-tool -disableAllPatches --sddcSSOUser [email protected] --sddcSSHUser vcf

Opzione Abilita aggiornamento VCF

L'opzione Abilita aggiornamento VCF deve essere eseguita nell' Appliance SDDC Manager. Se dopo aver applicato una patch asincrona, una o più versioni del componente VMware Cloud Foundation sono diverse da quelle specificate nella distinta base (BOM), è necessario utilizzare Async Patch Tool per eseguire l'aggiornamento da VMware Cloud Foundation. Dalla versione 4.x a VMware Cloud Foundation 4.y.
Nota: Se si esegue l'aggiornamento a VMware Cloud Foundation 5.0, non è necessario utilizzare Async Patch Tool per abilitare l'aggiornamento. È comunque consigliabile utilizzare Async Patch Tool per disattivare tutte le patch asincrone ed eseguire una sincronizzazione dell'inventario prima di eseguire l'aggiornamento a VMware Cloud Foundation 5.0.

L'opzione -r, --enableVCFUpgrade prepara un ambiente con patch asincrona per l'aggiornamento e carica i bundle di aggiornamento nel repository LCM interno dell'Appliance SDDC Manager. Vedere Aggiornamento di una versione con patch asincrona di VMware Cloud Foundation in modalità online e Aggiornamento di una versione con patch asincrona di VMware Cloud Foundation in modalità offline.

Opzione Descrizione
-r, --enableVCFUpgrade

Richiede la versione di destinazione per VCF. Ad esempio: 4.4.0.0.

 Abilita l'aggiornamento a una versione di destinazione di VMware Cloud Foundation.
Input necessari Input facoltativi
  • --sddcSSOUser, --ssou

    Immettere l'utente SSO del dominio di gestione. Ad esempio: [email protected].

  • --sddcSSHUser, --sshu

    Immettere vcf.

  • --depotUser, --du (solo online)

    Immettere l'indirizzo e-mail del portale del supporto Broadcom per la connessione al depot VMware.

  • --partnerBundleDepotUserName, --pdu (solo VxRail online)

    Immettere l'indirizzo e-mail del depot Dell EMC.

  • --instanceType, --it

    Immettere ONLINE oppure OFFLINE.

  • --op, --outputDirectory (necessario solo per la modalità offline)

    Immettere il percorso completo della posizione in cui sono stati caricati la patch o i bundle. Ad esempio, /nfs/vmware/vcf/nfs-mount/apToolBundles.
  • --op, --outputDirectory (facoltativo per la modalità online)

    Immettere il percorso completo della posizione in cui scaricare la patch o i bundle. Ad esempio, /nfs/vmware/vcf/nfs-mount/apToolBundles.

    Se non si specifica una directory di output, Async Patch Tool utilizza /root/apToolBundles.

  • --proxyServer, --ps

    Se ci si connette a Internet tramite un server proxy, utilizzare l'opzione --proxyServer, --ps per specificare il nome di dominio completo e la porta del server proxy. Ad esempio --proxyServer FQDN:port.
Esempio di modalità online: 
./vcf-async-patch-tool --enableVCFUpgrade 4.4.0.0 --depotUser [email protected] --sddcSSOUser [email protected] --sddcSSHUser vcf --it ONLINE
Esempio di modalità offline: 
./vcf-async-patch-tool --enableVCFUpgrade 4.4.0.0 --sddcSSOUser [email protected] --sddcSSHUser vcf --outputDirectory /nfs/vmware/vcf/nfs-mount/apToolBundles --it OFFLINE

Opzione Sincronizzazione inventario

La sincronizzazione dell'inventario viene eseguita come parte delle opzioni -e, --enableAsyncPatch e -r, --enableVCFUpgrade. È inoltre possibile eseguire l'opzione Sincronizzazione inventario da sola. È necessario eseguire l'opzione Sincronizzazione inventario nell'Appliance SDDC Manager.

Questa opzione aggiorna l'inventario di SDDC Manager con informazioni accurate sulle versioni di vCenter Server, NSX e VMware ESXi in esecuzione nell'istanza di VMware Cloud Foundation. È possibile che l'inventario di SDDC Manager non sia sincronizzato se si aggiorna uno di questi componenti all'esterno di VMware Cloud Foundation.

Opzione Descrizione
--performInventorySync, --sync Aggiorna l'inventario di SDDC Manager e salva un file CSV con informazioni su ogni componente di VMware Cloud Foundation.
File di output di esempio (in /home/vcf/asyncPatchTool/bin):
File CSV di esempio dall'operazione di sincronizzazione dell'inventario
Nota: In questo esempio, nessuna versione è stata aggiornata come parte della sincronizzazione dell'inventario.
Input necessari Input facoltativi
  • --sddcSSOUser, --ssou

    Immettere l'utente SSO del dominio di gestione. Ad esempio: [email protected].

  • --sddcSSHUser, --sshu

    Immettere vcf.

 Nessuno.
Esempio: 
./vcf-async-patch-tool --sync --sddcSSOUser [email protected] --sddcSSHUser vcf