Uso dell'utilità SoS in
È possibile eseguire l'utilità Supportability and Serviceability (SoS) in per generare un bundle di supporto che consente di eseguire il debug di un'attivazione di non riuscita.
Dopo aver eseguito l'attivazione correttamente, è consigliabile eseguire l'utilità SoS solo nella . 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 , accedere tramite SSH a 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
|
|---|---|
--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.
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 dopo l'attivazione. Nella maggior parte dei casi non è consigliabile utilizzare questa opzione. Una volta completata l'attivazione è possibile eseguire l'utilità SoS direttamente da . |
--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. setup.json e passare il file come input a SoS. Un file JSON di esempio è disponibile in 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. Se la shell Bash non è abilitata nel vCenter, la raccolta dei registri RVC verrà ignorata. I registri di RVC non vengono raccolti per impostazione predefinita con la raccolta dei registri ./sos. |
--sddc-manager-logs
| Raccoglie solo i registri di . |
--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
Le opzioni del generatore JSON all'interno dell'utilità SoS forniscono un metodo per eseguire la creazione del file JSON da una cartella di lavoro dei parametri di distribuzione completata. Per eseguire il generatore JSON, è necessario fornire almeno un percorso per la cartella di lavoro dei parametri di distribuzione e il tipo di progettazione utilizzando la seguente sintassi:
./sos --jsongenerator --jsongenerator-inputJSONGENERATORINPUT--jsongenerator-designJSONGENERATORDESIGN
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-vxrail per on Dell VxRail. |
--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.
Le opzioni del controllo dell'integrità sono progettate principalmente per l'esecuzione nella . La loro esecuzione in richiede il parametro
--force
che indica all'utilità SoS di identificare la distribuita da 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 .
|
--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]