Vous pouvez exécuter l'utilitaire de capacité de prise en charge et de facilité de maintenance (SoS, Supportability and Serviceability) sur la Dispositif VMware Cloud Builder Appliance pour générer un bundle de support, que vous pouvez utiliser pour dépanner un échec d'activation de VMware Cloud Foundation.

Note :

Après une activation réussie, vous devez uniquement exécuter l'utilitaire SoS sur la Dispositif SDDC Manager. Reportez-vous à la section Outil de capacité de prise en charge et de facilité de maintenance (SoS, Supportability and Serviceability) du Guide d'administration de VMware Cloud Foundation.

L'utilitaire SoS n'est pas un outil de débogage, mais il fournit des opérations de contrôle de santé qui peuvent faciliter le dépannage des échecs de déploiement.

Pour exécuter l'utilitaire SoS dans VMware Cloud Builder, connectez-vous via SSH à la Dispositif VMware Cloud Builder Appliance à l'aide du compte d'administrateur, entrez su pour basculer vers l'utilisateur racine, accédez au répertoire /opt/vmware/sddc-support, puis entrez ./sos suivi des options requises pour l'opération souhaitée. 

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

Options d'aide de l'utilitaire SoS

Utilisez ces options pour afficher des informations sur l'utilitaire SoS.

Option Description

--help

-h

Fournit un résumé des options de l'outil SoS disponibles

--version

-v

Fournit le numéro de version de l'utilitaire SoS.

Options génériques de l'utilitaire SoS

Il s'agit d'options génériques de l'utilitaire SoS.

Option Description
--configure-sftp Configure SFTP pour les journaux.
--debug-mode Exécute l'outil SoS en mode de débogage.
--force
Autorise les opérations SoS à partir de la Dispositif VMware Cloud Builder Appliance après l'activation.
Note : Dans la plupart des cas, vous ne devez pas utiliser cette option. Une fois l'activation terminée, vous pouvez exécuter l'utilitaire SoS directement à partit de la Dispositif SDDC Manager.
--history Affiche les vingt dernières opérations SoS effectuées.
--log-dir LOGDIR Spécifie le répertoire dans lequel stocker les journaux.
--log-folder LOGFOLDER Spécifie le nom du répertoire des journaux.
--setup-json SETUP_JSON

Fichier setup-json personnalisé pour la collecte de journaux.

L'utilitaire SoS prépare automatiquement l'inventaire en fonction de l'environnement dans lequel il s'exécute. Si vous souhaitez collecter des journaux pour un ensemble prédéfini de composants, créez un fichier setup.json et transférez-le en tant qu'entrée à l'utilitaire SoS. Un exemple de fichier JSON est disponible sur le dispositif VMware Cloud Builder dans le répertoire /opt/vmware/sddc-support/.
--skip-known-host-check Ignore la vérification spécifiée de l'empreinte numérique SSL de l'hôte connu.
--zip Crée un fichier .tar compressé pour la sortie.

Options des fichiers journaux de l'utilitaire SoS

Option Description
--api-logs

Collecte la sortie des API.

--cloud-builder-logs Collecte les journaux de Cloud Builder.
--esx-logs

Collecte les journaux à partir des hôtes ESXi uniquement.

Les journaux sont collectés à partir de chaque hôte ESXi disponible dans le déploiement.

--no-clean-old-logs

Utilisez cette option pour empêcher l'utilitaire de supprimer les sorties d'une exécution de collecte précédente.

Par défaut, avant d'écrire la sortie dans le répertoire, l'utilitaire supprime les fichiers de sortie précédente qui peuvent être présents. Si vous souhaitez conserver les anciens fichiers de sortie, spécifiez cette option.

--no-health-check

Ignore le contrôle de santé exécuté dans le cadre de la collecte de journaux.

--nsx-logs

Collecte les journaux à partir des instances de NSX Manager uniquement.

--rvc-logs

Collecte les journaux à partir de Ruby vSphere Console (RVC) uniquement. RVC est une interface pour ESXi et vCenter.

Note : Si le shell Bash n'est pas activé dans vCenter, la collecte des journaux RVC sera ignorée.
Note : Les journaux RVC ne sont pas collectés par défaut avec la collecte des journaux ./sos.
--sddc-manager-logs

Collecte les journaux à partir de SDDC Manager uniquement.

--test

Collecte les journaux de test en vérifiant les fichiers.

--vc-logs

Collecte les journaux à partir des instances de vCenter Server uniquement.

Les journaux sont collectés à partir de chaque serveur vCenter Server disponible dans le déploiement.

--vm-screenshots Collecte des captures d'écran de toutes les machines virtuelles.

Options du générateur de fichiers JSON de l'utilitaire SoS

Les options du générateur de fichiers JSON dans l'utilitaire SoS fournissent une méthode pour créer le fichier JSON à partir d'un classeur des paramètres de déploiement rempli. Pour exécuter le générateur de fichiers JSON, vous devez fournir au minimum un chemin d'accès au classeur des paramètres de déploiement et le type de conception à l'aide de la syntaxe suivante : 
./sos --jsongenerator --jsongenerator-input JSONGENERATORINPUT --jsongenerator-design JSONGENERATORDESIGN
Option Description
--jsongenerator Appelle l'utilitaire de génération de fichiers JSON.
--jsongenerator-input JSONGENERATORINPUT Spécifiez le chemin d'accès au fichier d'entrée à utiliser par l'utilisateur générateur JSON. Par exemple, /tmp/vcf-ems-deployment-parameter.xlsx.
--jsongenerator-design JSONGENERATORDESIGN Utilisez vcf-ems pour VMware Cloud Foundation.
--jsongenerator-supress Supprimez la confirmation pour forcer le nettoyage du répertoire. (Facultatif)
--jsongenerator-logs JSONGENERATORLOGS Définissez le répertoire à utiliser pour les journaux. (Facultatif)

Options du contrôle de santé de l'utilitaire SoS

L'utilitaire SoS peut être utilisé pour effectuer des contrôles de santé sur différents composants ou services, notamment la connectivité, le calcul et le stockage.

Note : Les options de contrôle de santé sont principalement conçues pour une exécution sur la Dispositif SDDC Manager. Leur exécution sur le Dispositif VMware Cloud Builder Appliance requiert le paramètre --force qui indique à l'utilitaire SoS d'identifier la Dispositif SDDC Manager déployée par VMware Cloud Builder pendant le processus d'activation, puis d'exécuter le contrôle de santé à distance. Par exemple : 
./sos --health-check --force
Option Description
--certificate-health

Vérifie que les certificats des composants sont valides (dans la date d'expiration).

--connectivity-health

Effectue un contrôle de santé de la connectivité pour vérifier si une commande ping peut être envoyée aux différents composants du système, tels que les hôtes ESXi, les instances de vCenter Server, les machines virtuelles de NSX Manager et la machine virtuelle de SDDC Manager.

--compute-health

Effectue un contrôle de santé de calcul.

--general-health

Vérifie les entrées ESXi sur toutes les sources, vérifie l'état opérationnel de la base de données Postgres pour les hôtes, vérifie les vidages de mémoire pour ESXi et obtient l'état de NSX Manager et du cluster.

--get-host-ips

Renvoie les informations du serveur.

--health-check

Effectue tous les contrôles de santé disponibles.

--ntp-health

Vérifie si l'heure sur les composants est synchronisée avec le serveur NTP dans la Dispositif VMware Cloud Builder Appliance.

--services-health

Effectue un contrôle de santé des services pour confirmer s'ils sont en cours d'exécution.

--run-vsan-checks Exécute des tests vSAN proactifs pour vérifier la capacité à créer des machines virtuelles dans les disques vSAN.

Exemple de sortie

Le texte suivant est un exemple de sortie d'une opération --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]

Le texte suivant est un exemple de sortie d'une opération de collecte de journaux --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]