Sie können das SoS-Tool (Supportability and Serviceability) auf der VMware Cloud Builder-Appliance ausführen, um ein Support-Paket zu generieren, das Sie zur Fehlersuche bei einem Fehler beim Hochfahren von VMware Cloud Foundation verwenden können.

Hinweis:

Nach einer erfolgreichen Aktivierung sollten Sie das SoS-Dienstprogramm nur auf der SDDC Manager-Appliance ausführen. Weitere Informationen finden Sie unter SoS-Tool (Supportability and Serviceability) im VMware Cloud Foundation-Administratorhandbuch.

Das SoS-Dienstprogramm ist kein Debug-Tool, stellt aber Integritätsprüfungsvorgänge bereit, die das Debuggen einer fehlgeschlagenen Bereitstellung erleichtern können.

Um das SoS-Dienstprogramm in VMware Cloud Builder auszuführen, melden Sie sich per SSH bei der VMware Cloud Builder-Appliance mithilfe des Administratorkontos admin an, geben Sie dann su ein, um zum Root-Benutzer zu wechseln, navigieren Sie zum Verzeichnis /opt/vmware/sddc-support und geben Sie ./sos gefolgt von den für den gewünschten Vorgang erforderlichen Optionen ein. 

./sos --option-1 --option-2 ... --option-n

Hilfeoptionen für das SoS-Dienstprogramm

Verwenden Sie diese Optionen, um Informationen zum SoS-Tool selbst anzuzeigen.

Option Beschreibung

--help

-h

Bietet eine Übersicht über die verfügbaren Optionen des SoS-Tools

--version

-v

Gibt die Versionsnummer des SoS-Tools an.

Allgemeine Optionen des SoS-Dienstprogramms

Dies sind allgemeine Optionen für das SoS-Dienstprogramm.

Option Beschreibung
--configure-sftp Konfiguriert SFTP für Protokolle.
--debug-mode Führt das SoS-Tool im Debug-Modus aus.
--force
Ermöglicht SoS-Vorgänge von der VMware Cloud Builder-Appliance nach der Aktivierung.
Hinweis: Diese Option sollten Sie in den meisten Fällen nicht verwenden. Sobald die Aktivierung abgeschlossen ist, können Sie das SoS-Dienstprogramm direkt über die SDDC Manager-Appliance ausführen.
--history Zeigt die letzten zwanzig ausgeführten SoS-Vorgänge an.
--log-dir LOGDIR "Gibt das Verzeichnis an, in dem die Protokolle gespeichert werden sollen."
--log-folder LOGFOLDER Gibt den Namen des Protokollverzeichnisses an.
--setup-json SETUP_JSON

Benutzerdefinierte setup-json-Datei für die Protokollerfassung.

SoS bereitet die Bestandsliste automatisch basierend auf der Umgebung vor, in der sie ausgeführt wird. Wenn Sie Protokolle für einen vordefinierten Satz von Komponenten erfassen möchten, können Sie eine setup.json-Datei erstellen und die Datei als Eingabe an SoS übergeben. Eine JSON-Beispieldatei ist im VMware Cloud Builder im Verzeichnis /opt/vmware/sddc-support/ verfügbar.
--skip-known-host-check Überspringt die angegebene Prüfung für SSL-Fingerabdruck für Host auf dem bekannten Host.
--zip Erstellt eine komprimierte TAR-Datei für die Ausgabe.

Optionen der Protokolldatei des SoS-Dienstprogramms

Option Beschreibung
--api-logs

Erfasst die Ausgabe von APIs.

--cloud-builder-logs Erfasst Cloud Builder-Protokolle.
--esx-logs

Erfasst ausschließlich Protokolle der ESXi-Hosts.

Protokolle werden aus jedem in der Bereitstellung verfügbaren ESXi-Host erfasst.

--no-clean-old-logs

Verwenden Sie diese Option, um zu verhindern, dass das Tool eine Ausgabe aus einer vorherigen Erfassungsausführung entfernt.

Standardmäßig löscht das Tool vor dem Schreiben der Ausgabe in das Verzeichnis die möglicherweise vorhandenen Ausgabedateien der vorherigen Ausführung. Wenn Sie die älteren Ausgabedateien beibehalten möchten, geben Sie diese Option an.

--no-health-check

Überspringt die Integritätsprüfung, die im Rahmen der Protokollerfassung ausgeführt wird.

--nsx-logs

Erfasst ausschließlich Protokolle der NSX Manager-Instanzen.

--rvc-logs

Erfasst ausschließlich Protokolle der Ruby vSphere Console (RVC). RVC ist eine Schnittstelle für ESXi und vCenter.

Hinweis: Wenn die Bash-Shell in vCenter nicht aktiviert ist, wird die RVC-Protokollerfassung übersprungen.
Hinweis: RVC-Protokolle werden standardmäßig nicht mit der ./sos-Protokollerfassung erfasst.
--sddc-manager-logs

Erfasst ausschließlich Protokolle des SDDC Manager.

--test

Erfasst Testprotokolle durch Überprüfen der Dateien.

--vc-logs

Erfasst ausschließlich Protokolle der vCenter Server-Instanzen.

Protokolle werden aus jedem in der Bereitstellung verfügbaren vCenter Server erfasst.

--vm-screenshots Erfasst Screenshots von allen VMs.

JSON-Generatoroptionen des SoS-Dienstprogramms

Die JSON-Generatoroptionen innerhalb des SoS-Dienstprogramms bieten eine Methode zum Ausführen der Erstellung der JSON-Datei aus einem abgeschlossenen Bereitstellungsparametern. Um den JSON-Generator auszuführen, müssen Sie mindestens einen Pfad zur Arbeitsmappe mit den Bereitstellungsparametern und den Designtyp mit der folgenden Syntax angeben: 
./sos --jsongenerator --jsongenerator-input JSONGENERATORINPUT --jsongenerator-design JSONGENERATORDESIGN
Option Beschreibung
--jsongenerator Ruft das JSON-Generator-Dienstprogramm auf.
--jsongenerator-input JSONGENERATORINPUT Geben Sie den Pfad zur Eingabedatei an, die vom JSON-Generator-Dienstprogramm verwendet werden soll. Beispiel: /tmp/vcf-ems-deployment-parameter.xlsx.
--jsongenerator-design JSONGENERATORDESIGN Verwenden Sie vcf-vxrail für VMware Cloud Foundation on Dell VxRail.
--jsongenerator-supress Bestätigung unterdrücken, um Bereinigung des Verzeichnisses zu erzwingen. (optional)
--jsongenerator-logs JSONGENERATORLOGS Legen Sie das Verzeichnis fest, das für Protokolle verwendet werden soll. (optional)

Optionen für die Systemstatusprüfung des SoS-Dienstprogramms

Das SoS-Dienstprogramm kann verwendet werden, um Integritätsprüfungen für verschiedene Komponenten oder Dienste durchzuführen, einschließlich Konnektivität, Computing und Speicher.

Hinweis: Die Optionen für die Integritätsprüfung sind in erster Linie für die Ausführung auf der SDDC Manager-Appliance konzipiert. Die Ausführung auf der VMware Cloud Builder-Appliance erfordert den Parameter --force, der das SoS-Dienstprogramm anweist, die SDDC Manager-Appliance anzugeben, die vom VMware Cloud Builder während des Aktivierungsvorgangs bereitgestellt wurde. Im Anschluss daran muss die Integritätsprüfung remote durchgeführt werden. Beispiel: 
./sos --health-check --force
Option Beschreibung
--certificate-health

Überprüft, ob die Komponentenzertifikate gültig sind (innerhalb des Ablaufdatums).

--connectivity-health

Führt eine Zustandsprüfung der Konnektivität durch, um zu prüfen, ob die verschiedenen Komponenten des Systems wie ESXi-Hosts, vCenter-Server, NSX Manager-VMs und SDDC Manager-VMs angepingt werden können.

--compute-health

Führt eine Computing-Integritätsprüfung durch.

--general-health

Überprüft ESXi-Einträge über alle Quellen hinweg, prüft den Betriebsstatus der Postgres-DB für Hosts, prüft ESXi auf Fehlerdumps und ruft den NSX Manager- und Cluster-Status ab.

--get-host-ips

Gibt Serverinformationen zurück.

--health-check

Führt alle verfügbaren Integritätsprüfungen durch.

--ntp-health

Überprüft, ob die Zeit auf den Komponenten mit dem NTP-Server in der VMware Cloud Builder-Appliance synchronisiert ist.

--services-health

Führt eine Integritätsprüfung für Dienste durch, um zu bestätigen, ob Dienste ausgeführt werden.

--run-vsan-checks Führt proaktive vSAN-Tests durch, um zu überprüfen, ob VMs innerhalb der vSAN-Datenträger erstellt werden können.

Beispielausgabe

Der folgende Text ist eine Beispielausgabe aus einem --ntp-health-Vorgang. 

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]

Der folgende Text ist eine Beispielausgabe aus einem --vm-screenshots-Protokollerfassungsvorgang. 

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]