Using the VCF Diagnostic Tool for vSphere Kubernetes Service (VKS/TKGs)

Products

• VMware vSphere Kubernetes Service
• VMware vCenter Server
• VMware vCenter Server 8.0

Issue/Introduction

The VCF Diagnostic Tool (VDT) is a diagnostic tool that is run on the VCSA and connects to Supervisor nodes via SSH. It runs through a series of checks on the system configuration and reports user-friendly PASS/WARN/FAIL results for known configuration issues. It also provides information (INFO) messages from certain areas which we hope will make detecting inconsistencies easier. The goal of these tests is to provide live diagnostic information to the user about their environment which might otherwise be missed.  

The utility is completely read-only for the entire environment. 

The utility logs to the following directory on the VCSA.

/var/log/vmware/vks/vdt/

Please send feedback/feature requests to [email protected]

DISCLAIMER: This script is currently in its beta release phase.
As such, it may contain bugs, errors, or incomplete features. Please leverage results with caution.

Environment

VCSA 8.x

Resolution

Using VCF-VDT:

1.Download the latest v2.2.x version of vSphere Diagnostic Tool from here. 

2.Use the file-moving utility of your choice (WinSCP for example) to copy the entire ZIP directory to the /root partition on the VCSA that manages the Supervisor you want to check.

3.SSH into the VCSA.

4.Change your directory to the location of the file, and unpackage the vdt zip file:

• cd /home/vcf/

• unzip vdt-<version>.zip

• cd vdt-<version>

5.If there is more than 1 Supervisor on the VCSA, VKS-VDT will choose the first Supervisor it finds in the VCDB, and it may not be the same each time. If you have a specific Supervisor you wish to run checks against, set the SUPERVISOR_NAME environment variable like so:

• export SUPERVISOR_NAME="EXACT_SUPERVISOR_NAME"

6.Run the tool with the command:

• python vdt.py -p vks

NOTE: If you have more than 1 supervisor and you would like to specify which supervisor to run the script against a particular supervisor, you can specify it like so;

• SUPERVISOR_NAME=sv_name python vdt.py -p vks