In questa sezione sono elencate le opzioni specifiche che è possibile utilizzare con l'utilità SoS.

Per informazioni sulla raccolta dei file di registro mediante l'utilità SoS, vedere Raccolta dei registri per il sistema di VMware Cloud Foundation.

Opzioni della Guida dell'utilità SoS

Utilizzare queste opzioni per visualizzare informazioni sull'utilità SoS. Per queste opzioni accedere tramite SSH alla macchina virtuale di SDDC Manager utilizzando l'account utente vcf e immettere il comando seguente: 
sudo /opt/vmware/sddc-support/sos --option-name
Specificare la password vcf quando viene richiesta.
Opzione Descrizione

--help

-h

Fornisce un riepilogo delle opzioni dell'utilità SoS disponibili

--version

-v

Fornisce il numero di versione dell'utilità SoS.

Opzioni generiche dell'utilità SoS

Queste sono opzioni generiche dell'utilità SoS. Per queste opzioni, accedere tramite SSH alla macchina virtuale di SDDC Manager utilizzando l'account utente vcf e immettere il comando seguente: 
sudo /opt/vmware/sddc-support/sos --option-name
Specificare la password vcf quando viene richiesta.
Opzione Descrizione
--history Visualizza le ultime 20 operazioni SoS eseguite.
--force
Consente di eseguire le operazioni SoS mentre i workflow sono in esecuzione.
Nota: Si consiglia di non utilizzare questa opzione.
--configure-sftp Configura SFTP per i registri.
--setup-json SETUPJSON

File setup-json personalizzato per la raccolta dei registri.

SoS prepara automaticamente l'inventario in base all'ambiente in cui è in esecuzione. Se si desidera raccogliere i registri per un set di componenti predefinito, è possibile creare un file setup.json e passare il file come input a SoS. Un file JSON di esempio è disponibile in Appliance SDDC Manager all'indirizzo /opt/vmware/sddc-support/setup.sample.json.
--log-folder LOGFOLDER Specifica il nome della directory dei registri.
--log-dir LOGDIR Specifica la directory in cui archiviare i registri.
--enable-stats Attivare la raccolta statistiche di esecuzione SoS.
--debug-mode Esegue l'utilità SoS in modalità di debug.
--zip Crea un file TAR compresso per l'output.
--short Visualizzare i risultati dettagliati dell'integrità solo per errori e avvisi.
--domain-name DOMAINNAME

Specificare il nome del dominio del carico di lavoro in cui eseguire l'operazione SoS.

Per eseguire l'operazione in tutti i domini del carico di lavoro specificare --domain-name ALL.

Nota:

Se si omette il flag --domain-name e il nome del dominio del carico di lavoro, l'operazione SoS viene eseguita solo nel dominio di gestione.

È possibile combinare --domain-name con --clusternames per limitare ulteriormente l'ambito di un'operazione. Questo può essere utile in un ambiente scalato con un grande numero di host ESXi.
--clusternames CLUSTERNAMES

Specificare i nomi dei cluster vSphere associati a un dominio del carico di lavoro per cui si desidera raccogliere i registri ESXi e di Gestione carico di lavoro (WCP).

Inserire un elenco di cluster vSphere separati da virgole. Ad esempio --clusternames cluster1, cluster2.

Nota:

Se si specifica --domain-name ALL l'opzione --clusternames viene ignorata.

--skip-known-host-check Ignora il controllo specificato per l'identificazione personale SSL per l'host nell'host noto.
--include-free-hosts Raccogliere i registri per gli host ESXi gratuiti, oltre agli host ESXi in uso.
--include-precheck-report Questa opzione esegue le verifiche preliminari dell'aggiornamento di LCM e include il report di esecuzione delle verifiche preliminari dell'aggiornamento di LCM nelle operazioni del controllo dell'integrità di SoS.

Opzioni di riepilogo di VMware Cloud Foundation dell'utilità SoS

Queste opzioni forniscono dettagli di riepilogo dell'istanza di SDDC Manager, inclusi componenti e attività. Per queste opzioni, accedere tramite SSH alla macchina virtuale di SDDC Manager utilizzando l'account utente vcf e immettere il comando seguente: 
sudo /opt/vmware/sddc-support/sos --option-name
Specificare la password vcf quando viene richiesta.
Opzione Descrizione
--get-vcf-summary Restituisce informazioni sul sistema VMware Cloud Foundation, tra cui il programma CEIP, i domini del carico di lavoro, i cluster vSphere, gli host ESXi, le licenze, i pool di reti, l'SDDC Manager e i servizi VCF.
--get-vcf-tasks-summary Restituisce informazioni sulle attività di VMware Cloud Foundation, tra cui l'ora di creazione e lo stato dell'attività.
--get-vcf-services-summary Restituisce informazioni sul tempo di attività di SDDC Manager e sull'avvio e arresto dei servizi di VMware Cloud Foundation (ad esempio LCM).

Opzioni di correzione dell'utilità SoS

Utilizzare queste opzioni per gestire host ESXi e vCenter Server, inclusa l'abilitazione di SSH e il blocco degli host. Per queste opzioni, accedere tramite SSH alla macchina virtuale di SDDC Manager utilizzando l'account utente amministrativo vcf, immettere su per passare all'utente root., passare alla directory /opt/vmware/sddc-support e digitare il seguente comando: 
./sos --option-name
Nota:

Per le opzioni di correzione, se non si specifica un dominio del carico di lavoro, il comando influisce solo sul dominio di gestione.

Opzione Descrizione

--enable-ssh-esxi

Applica SSH a tutti i nodi ESXi nei domini del carico di lavoro specificati.

  • Per abilitare SSH nei nodi ESXi di un dominio del carico di lavoro specifico, includere il flag --domain-name DOMAINNAME.
  • Per abilitare SSH nei nodi ESXi di tutti i domini del carico di lavoro, includere il flag --domain-name ALL.

--disable-ssh-esxi

Disattiva SSH in tutti i nodi ESXi nei domini del carico di lavoro specificati.

  • Per disattivare SSH nei nodi ESXi di un dominio del carico di lavoro specifico. includere il flag --domain-name DOMAINNAME.
  • Per disattivare SSH nei nodi ESXi in tutti i domini del carico di lavoro, includere il flag --domain-name ALL.

--enable-ssh-vc

Applica SSH a vCenter Server nei domini del carico di lavoro specificati.

  • Per abilitare SSH in vCenter in un dominio del carico di lavoro specifico, includere il flag --domain-name DOMAINNAME.
  • Per abilitare SSH nei vCenter Server in tutti i domini del carico di lavoro, includere il flag --domain-name ALL.

--disable-ssh-vc

Disattiva SSH nei vCenter Server nei domini del carico di lavoro specificati.

  • Per disattivare SSH in vCenter Server in un dominio del carico di lavoro specifico. includere il flag --domain-name DOMAINNAME.
  • Per disattivare SSH nei vCenter Server in tutti i domini del carico di lavoro, includere il flag --domain-name ALL.

--enable-lockdown-esxi

Applica la modalità di blocco normale in tutti i nodi ESXi nei domini del carico di lavoro specificati.

  • Per abilitare il blocco sui nodi ESXi di un dominio del carico di lavoro specifico, includere il flag --domain-name DOMAINNAME.
  • Per abilitare il blocco nei nodi ESXi in tutti i domini del carico di lavoro, includere il flag --domain-name ALL.

--disable-lockdown-esxi

Disattiva la modalità di blocco normale nei nodi ESXi nei domini di lavoro specificati.

  • Per disattivare il blocco nei nodi ESXi di un dominio del carico di lavoro specifico, includere il flag --domain-name DOMAINNAME.
  • Per disattivare il blocco nei nodi ESXi di tutti i domini del carico di lavoro, includere il flag --domain-name ALL.
--ondemand-service ONDEMANDSERVICE Eseguire comandi negli host ESXi, vCenter Server. o entità di SDDC Manager per un determinato dominio del carico di lavoro. Specificare il dominio del carico di lavoro utilizzando --domain-name DOMAINNAME.

Sostituire ONDEMANDSERVICE con il percorso di un file di input .yml. (File di esempio disponibile all'indirizzo: /opt/vmware/sddc-support/ondemand_command_sample.yml).

Avviso: Prima di utilizzare questa opzione contattare l'assistenza VMware.
--ondemand-service Percorso del file JSON Includere questo flag per eseguire comandi in formato JSON su tutti gli host ESXi di un dominio del carico di lavoro. Ad esempio /opt/vmware/sddc-support/<nome del file JSON>
--refresh-ssh-keys Aggiorna le chiavi SSH.

Opzioni di controllo dell'integrità dell'utilità SoS

Questi comandi SoS vengono utilizzati per controllare lo stato di integrità dei vari componenti o servizi tra cui connettività, elaborazione, storage, database, domini del carico di lavoro e reti. Per queste opzioni, accedere tramite SSH alla macchina virtuale di SDDC Manager utilizzando l'account utente vcf e immettere il comando seguente: 
sudo /opt/vmware/sddc-support/sos --option-name
Specificare la password vcf quando viene richiesta.

Uno stato verde indica che l'integrità è normale, il giallo segnala che potrebbe essere necessaria attenzione e rosso (critico) indica che il componente richiede attenzione immediata.

Opzione Descrizione
--health-check

Esegue tutti i controlli dell'integrità disponibili.

Può essere combinato con --run-vsan-checks. Ad esempio: 
sudo /opt/vmware/sddc-support/sos --health-check --run-vsan-checks
--connectivity-health

Esegue controlli di connettività e convalide per le risorse dell'SDDC (NSX Manager, host ESXi, vCenter Server e così via). Questo controllo esegue un controllo dello stato del ping, un controllo dello stato della connettività SSH e un controllo della connettività API per le risorse dell'SDDC.
--services-health

Esegue un controllo dell'integrità dei servizi per verificare se i servizi in SDDC Manager (ad esempio Lifecycle Management Server) e vCenter Server sono in esecuzione.

--compute-health

Esegue un controllo dell'integrità delle risorse di elaborazione, inclusi le licenze host ESXi, storage su disco, partizioni del disco e stato di integrità.

--storage-health

Esegue un controllo sull'integrità del disco vSAN degli host ESXi e dei cluster vSphere.

Può essere combinato con --run-vsan-checks. Ad esempio: 
sudo /opt/vmware/sddc-support/sos --storage-health --run-vsan-checks
--run-vsan-checks Questa opzione non può essere eseguita autonomamente e deve essere combinata con --health-check o --storage-health.

Esegue un test di creazione della macchina virtuale per verificare l'integrità del cluster vSAN. L'esecuzione del test crea una macchina virtuale in ogni host nel cluster vSAN. Il test crea una macchina virtuale e la elimina. Se le attività di creazione ed eliminazione della macchina virtuale vengono eseguite correttamente, supporre che i componenti del cluster vSAN funzionano come previsto e che il cluster funzioni.

Nota: Non è necessario eseguire il test proattivo in un ambiente di produzione poiché crea traffico di rete e influisce sul carico di lavoro vSAN.
--ntp-health

Verifica se l'ora dei componenti è sincronizzata con quella del server NTP in Appliance SDDC Manager. Assicura inoltre che la data e ora dell'hardware e del software degli host ESXi rientri nei 5 minuti della Appliance SDDC Manager.

--dns-health Esegue un controllo di integrità DNS diretto e inverso.
--general-health

Controlla ESXi alla ricerca di dump degli errori e recupera lo stato di NSX Manager e del cluster.

--certificate-health

Verifica la validità dei certificati dei componenti e la relativa scadenza.

  • VERDE: il certificato scade tra più di 30 giorni.
  • GIALLO: il certificato scade tra 15-30 giorni.
  • ROSSO: il certificato scade tra meno di 15 giorni.
--composability-infra-health

Esegue un controllo dell'integrità della connettività API dell'infrastruttura componibile. Se non esiste alcuna infrastruttura componibile. questo flag viene ignorato. Se viene trovata, l'utilità controlla lo stato di connettività tramite l'API dell'infrastruttura componibile, come Redfish.

--get-host-ips

Restituisce i nomi host e gli indirizzi IP degli host ESXi.

--get-inventory-info

Restituisce i dettagli dell'inventario per i componenti di VMware Cloud Foundation, ad esempio vCenter Server NSX, SDDC Manager e host ESXi. Facoltativamente, aggiungere il flag --domain-name ALL per restituire i dettagli di tutti i domini del carico di lavoro.

--password-health
Controlla lo stato delle password nei componenti di VMware Cloud Foundation. Elenca i componenti con password gestite da VCF, la data dell'ultima modifica della password, la data di scadenza della password e il numero di giorni alla scadenza.
  • VERDE: la password scade tra più di 15 giorni.
  • GIALLO: la password scade tra 5-15 giorni.
  • ROSSO: la password scade tra meno di 5 giorni.
--hardware-compatibility-report Convalida gli host ESXi e i dispositivi vSAN ed esporta il report di compatibilità.
--version-health Questa operazione consente di controllare la versione dei componenti BOM (vCenter Server, NSX, ESXi ed SDDC Manager). Confronta l'inventario di SDDC Manager, la versione effettiva del componente BOM installata e le versioni dei componenti BOM per rilevare eventuali deviazioni.
--json-output-dir JSONDIR Genera i risultati di qualsiasi controllo di integrità come file JSON nella directory specificata, JSONDIR.

Esempio di comandi di controllo dell'integrità:

  • Controllare l'integrità della password solo nel dominio di gestione:
    ./sos --password-health
  • Controllare l'integrità della connettività per tutti i domini del carico di lavoro:
    ./sos --connectivity-health --domain-name ALL
  • Controllare l'integrità DNS per il dominio del carico di lavoro denominato sfo-w01:
    ./sos --dns-health --domain-name sfo-w01