È possibile eseguire l'utilità Supportability and Serviceability (SoS) in Appliance VMware Cloud Builder per generare un bundle di supporto che consente di eseguire il debug di un'attivazione di VMware Cloud Foundation non riuscita.
Dopo aver eseguito l'attivazione correttamente, è consigliabile eseguire l'utilità SoS solo nella Appliance SDDC Manager. Vedere Utilità Supportabiliy and Serviceability (SoS) nella Guida all'amministrazione di VMware Cloud Foundation.
L'utilità SoS non è uno strumento di debug ma fornisce operazioni di controllo dell'integrità che possono facilitare il debug di una distribuzione non riuscita.
Per eseguire l'utilità SoS in VMware Cloud Builder, accedere tramite SSH a Appliance VMware Cloud Builder utilizzando l'account amministrativo admin, quindi immettere su per passare all'utente root, passare alla directory /opt/vmware/sddc-support e digitare ./sos seguito dalle opzioni necessarie per l'operazione desiderata.
./sos --option-1 --option-2 ... --option-n
Opzioni della Guida dell'utilità SoS
Utilizzare queste opzioni per visualizzare informazioni sull'utilità SoS.
| Opzione | Descrizione |
|---|---|
|
|
Fornisce un riepilogo delle opzioni dell'utilità SoS disponibili |
|
|
Fornisce il numero di versione dell'utilità SoS. |
Opzioni generiche dell'utilità SoS
Queste sono opzioni generiche dell'utilità SoS.
| Opzione | Descrizione |
|---|---|
--configure-sftp |
Configura SFTP per i registri. |
--debug-mode |
Esegue l'utilità SoS in modalità di debug. |
--force |
Consente le operazioni di SoS da
Appliance VMware Cloud Builder dopo l'attivazione.
Nota: Nella maggior parte dei casi non è consigliabile utilizzare questa opzione. Una volta completata l'attivazione è possibile eseguire l'utilità SoS direttamente da
Appliance SDDC Manager.
|
--history |
Visualizza le ultime venti operazioni di SoS eseguite. |
--log-dir LOGDIR |
Specifica la directory in cui archiviare i registri. |
--log-folder LOGFOLDER |
Specifica il nome della directory dei registri. |
--setup-json SETUP_JSON |
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 VMware Cloud Builder nella directory /opt/vmware/sddc-support/. |
--skip-known-host-check |
Ignora il controllo specificato per l'identificazione personale SSL per l'host nell'host noto. |
--zip |
Crea un file tar compresso per l'output. |
Opzioni del file di registro dell'utilità SoS
| Opzione | Descrizione |
|---|---|
--api-logs |
Raccoglie l'output dalle API. |
--cloud-builder-logs |
Raccoglie i registri di Cloud Builder. |
--esx-logs |
Raccoglie solo i registri degli host ESXi. I registri vengono raccolti da ogni host ESXi disponibile nella distribuzione. |
--no-clean-old-logs |
Utilizzare questa opzione per impedire all'utilità di rimuovere output dall'esecuzione di una raccolta precedente. Per impostazione predefinita, prima di scrivere l'output nella directory, l'utilità elimina i file di output dell'esecuzione precedente che potrebbero essere presenti. Se si desidera conservare i file di output precedenti, specificare questa opzione. |
--no-health-check |
Ignora il controllo dell'integrità eseguito come parte della raccolta dei registri. |
--nsx-logs |
Raccoglie solo i registri delle istanze di NSX Manager. |
--rvc-logs |
Raccoglie solo i registri di Ruby vSphere Console (RVC). RVC è un'interfaccia per ESXi e vCenter.
Nota: Se la shell Bash non è abilitata nel vCenter, la raccolta dei registri RVC verrà ignorata.
Nota: I registri di RVC non vengono raccolti per impostazione predefinita con la raccolta dei registri ./sos.
|
--sddc-manager-logs |
Raccoglie solo i registri di SDDC Manager. |
--test |
Raccoglie i registri dei test verificando i file. |
--vc-logs |
Raccoglie solo i registri delle istanze di vCenter Server. I registri vengono raccolti da ogni server di vCenter disponibile nella distribuzione. |
--vm-screenshots |
Raccoglie le schermate di tutte le macchine virtuali. |
Opzioni del generatore JSON dell'utilità SoS
./sos --jsongenerator --jsongenerator-input JSONGENERATORINPUT --jsongenerator-design JSONGENERATORDESIGN
| Opzione | Descrizione |
|---|---|
--jsongenerator |
Richiama l'utilità generatore JSON. |
--jsongenerator-input JSONGENERATORINPUT |
Specificare il percorso del file di input che deve essere utilizzato dall'utilità generatore JSON. Ad esempio: /tmp/vcf-ems-deployment-parameter.xlsx. |
--jsongenerator-design JSONGENERATORDESIGN |
Utilizzare vcf-ems per VMware Cloud Foundation. |
--jsongenerator-supress |
Eliminare la conferma per forzare la pulizia della directory. (facoltativo) |
--jsongenerator-logs JSONGENERATORLOGS |
Impostare la directory da utilizzare per i registri. (facoltativo) |
Opzioni di controllo dell'integrità dell'utilità SoS
L'utilità SoS può essere utilizzata per eseguire controlli di integrità su vari componenti o servizi, tra cui connettività, elaborazione e storage.
--force che indica all'utilità SoS di identificare la
Appliance SDDC Manager distribuita da
VMware Cloud Builder durante il processo di attivazione e di eseguire quindi il controllo dell'integrità da remoto. Ad esempio:
./sos --health-check --force
| Opzione | Descrizione |
|---|---|
--certificate-health |
Verifica che i certificati dei componenti siano validi (entro la data di scadenza). |
--connectivity-health |
Esegue un controllo dell'integrità della connettività per verificare se è possibile eseguire il ping dei diversi componenti del sistema come host ESXi, vCenter Server, macchine virtuali di NSX Manager e macchina virtuale di SDDC Manager. |
--compute-health |
Esegue un controllo dell'integrità della risorsa di elaborazione. |
--general-health |
Verifica le voci ESXi in tutte le origini, controlla lo stato operativo del DB Postgres per gli host, verifica in ESXi la presenza di dump degli errori e recupera lo stato di NSX Manager, nonché del cluster. |
--get-host-ips |
Restituisce le informazioni sul server. |
--health-check |
Esegue tutti i controlli dell'integrità disponibili. |
--ntp-health |
Verifica se l'ora dei componenti è sincronizzata con quella del server NTP in Appliance VMware Cloud Builder. |
--services-health |
Esegue un controllo dell'integrità dei servizi per verificare se i servizi sono in esecuzione |
--run-vsan-checks |
Esegue test vSAN proattivi per verificare la possibilità di creare macchine virtuali all'interno dei dischi vSAN. |
Output di esempio
Il testo seguente è un output di esempio di un'operazione --ntp-health.
root@cloud-builder [ /opt/vmware/sddc-support ]# ./sos --ntp-health --skip-known-host --force Welcome to Supportability and Serviceability(SoS) utility! User passed --force flag, Running SOS from Cloud Builder VM, although Bringup is completed and SDDC Manager is available. Please expe ct failures with SoS operations. Health Check : /var/log/vmware/vcf/sddc-support/healthcheck-2020-02-11-23-03-53-24681 Health Check log : /var/log/vmware/vcf/sddc-support/healthcheck-2020-02-11-23-03-53-24681/sos.log SDDC Manager : sddc-manager.vrack.vsphere.local NTP : GREEN +-----+-----------------------------------------+------------+-------+ | SL# | Area | Title | State | +-----+-----------------------------------------+------------+-------+ | 1 | ESXi : esxi-1.vrack.vsphere.local | ESX Time | GREEN | | 2 | ESXi : esxi-2.vrack.vsphere.local | ESX Time | GREEN | | 3 | ESXi : esxi-3.vrack.vsphere.local | ESX Time | GREEN | | 4 | ESXi : esxi-4.vrack.vsphere.local | ESX Time | GREEN | | 5 | vCenter : vcenter-1.vrack.vsphere.local | NTP Status | GREEN | +-----+-----------------------------------------+------------+-------+ Legend: GREEN - No attention required, health status is NORMAL YELLOW - May require attention, health status is WARNING RED - Requires immediate attention, health status is CRITICAL Health Check completed successfully for : [NTP-CHECK]
Il testo seguente è un output di esempio di un'operazione di raccolta dei registri --vm-screenshots.
root@cloud-builder [ /opt/vmware/sddc-support ]# ./sos --vm-screenshots
--skip-known-host --force
Welcome to Supportability and Serviceability(SoS) utility!
User passed --force flag, Running SOS from Cloud Builder VM, although Bringup is completed
and SDDC Manager is available. Please expect failures with SoS operations.
Logs : /var/log/vmware/vcf/sddc-support/sos-2018-08-24-10-50-20-8013
Log file : /var/log/vmware/vcf/sddc-support/sos-2018-08-24-10-50-20-8013/sos.log
Log Collection completed successfully for : [VMS_SCREENSHOT]
