Download and Install
VDT 2 is now available!
VDT 2 has been rewritten from the ground up to evolve from a simple collection of python scripts to a python based health reporting framework. This new version provides libraries that standardize the output and format of each check. This means that compatibility for additional products is coming soon!
Release Support:
- vdt 1.1.4 - vCenter Server 6.5, 6.7, and 7.0
- vdt 1.1.6 - vCenter Server 7.0 and 8.0
- vdt 2.0.x - vCenter Server 7.0 and 8.0
- Download the version of VDT compatible with your vCenter version that's attached to this article (see above).
- Use the file-moving utility of your choice (WinSCP for example) to copy the entire ZIP directory to /root on the node on which you wish to run it.
Note: If you have troubles connecting to a vCenter appliance using WinSCP, please see Error when uploading files to vCenter Server Appliance using WinSCP
- Change your directory to the location of the file, and unpack the zip:
cd /root/
unzip vdt-version_number.zip
- Run the tool with the command:
python vdt.py
You will be prompted for the password for [email protected]. Many checks will still run even if credentials are not supplied.
The tool will then proceed to run. You can review the output by scrolling up and down in the window. Each test should be self-explanatory in its meaning, findings, and directions. If any check isn’t clear in its direction, or a false positive is suspected, please report the issue to our team at [email protected] and we will address it.
Current Checks
- vCenter Basic Info
- SSO Checks (Lookup Service and Machine ID)
- Active Directory Integration
- vCenter Certificates
- VMdir Functionality
- Core Files
- vPostgres Database Usage
- Disk Space Usage
- DNS Functionality
- Time Sync & NTP Functionality
- Root Account Validity
- vCenter Services
- VCHA Check
- Syslog Functionality
- IWA/AD Checks
- Local Identity Source Check
- Solution User Checks
Troubleshooting
VDT 2.x
- Tests are timing out or taking too long:
As of version 2, a built in 10 second timer (configurable in vdt/vcenter/vc_cfg/vc_vdt.ini) activates and asks if you want to force the checks to keep going or skip it. If a forced test continues to hang, see the instructions in scenario 2.
- A test hangs or causes issues preventing script execution:
If a test hangs for an unreasonable amount of time or fails preventing execution of further tests, you can ctrl-c out of the script, then disable the check in the "vcenter/vc_cfg/vc_vdt.ini" file. For example, to disable the IWA/AD checks:
- From the VDT 2 directory, modify the vc_vdt.ini file:
vi ./vcenter/vc_cfg/vc_vdt.ini
- Find the following lines:
[category:vc_iwa_checks]
name = "IWA/AD Checks"
- Place a semi-colon before each line:
;[category:vc_iwa_checks]
;name = "IWA/AD Checks"
- Save the file:
:wq!
- One or more tests throw backtraces or python errors
- Collect a log bundle
- Proceed with traditional troubleshooting
- Report the issue to [email protected]
- You encounter inaccurate or strange results for any check
- Proceed with traditional troubleshooting
- Report the issue to [email protected]
VDT 1.x
- Tests are timing out or taking too long
- As of 1.1.6, a built in 20 second timer activates and asks if you want to force the checks to keep going or skip it. If a forced test continues to hang, see the instructions in scenario 2
- A test hangs for more than 10 seconds in earlier versions of VDT
- If a test hangs for an unreasonable amount of time, you can ctrl-c out of the script, then move the test it was running out of the ‘scripts’ directory. For example:
mv scripts/vc_ad_check.py /tmp/
- One or more tests throw backtraces or python errors
- Collect a log bundle
- Proceed with traditional troubleshooting
- Report the issue to [email protected]
- You encounter inaccurate or strange results for any check
- Proceed with traditional troubleshooting
- Report the issue to [email protected]