Installing the VDDK Package
The VDDK is packaged as a compressed archive for Windows 64-bit and for Linux 64-bit. The VDDK packages include the following components:
Header files vixDiskLib.h and vm_basic_types.h in the include directory.
Function library vixDiskLib.lib (Windows) or libvixDiskLib.so (Linux) in the lib directory.
HTML reference documentation in the doc directory and sample program in doc/samples.
To install the package on Windows
1
On the Download page, choose the .zip file for Windows and download it to your development system.
2
Place the .zip file in a folder under Program Files – you can choose the name – and unpack it:
cd C:\Program Files\VMware\VDDK550
unzip VMware-vix-disklib-*.zip
3
Go to the bin subfolder, locate the vstor2install.bat script, and double-click to run it. The batch script should be run in place so that the current directory for execution is the bin subfolder. By running it, you implicitly accept the VMware license terms.
4
Edit the Windows registry with regedit and check for the following key. If this key exists from a previous VDDK install, right-click to delete it. Add a registry entry with the following key:
HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\VMware, Inc.\VMware Virtual Disk Development Kit
5
To this key add a DWORD value named VerifySSLCertificates, setting it to 1 if you want SSL certificates to be validated, or 0 if you want to prevent SSL certificates from being validated.
For convenience you might want to edit the Windows Path environment to include the VDDK installation folder, C:\Program Files\VMware\VDDK550\bin in the example above.
To Install the package on Linux
1
2
Unpack the archive with tar to create the vmware-vix-disklib-distrib subdirectory.
tar xvzf VMware-vix-disklib-*.tar.gz
3
cd vmware-vix-disklib-distrib
sudo ./vmware-install.pl
4
Read the license terms and type yes to accept them.
Software components install in /usr unless you specify otherwise.
You might want to edit your LD_LIBRARY_PATH environment to include the library installation path, /usr/lib/vmware-vix-disklib/lib64 for instance. Alternatively, you can add the library location to the list in /etc/ld.so.conf and run ldconfig as the superuser.
Repackaging VDDK Libraries
After you develop an application based on VDDK, you might need the VDDK binaries to run your application.
As described in Redistributing VDDK Components, partners can sign a license agreement to redistribute VDDK binaries that support VADP applications.
To enable VDDK binaries on Windows virtual machines without VDDK installed
1
2
Install VMware executables and DLLs from the \bin and \lib folders of the installed VDDK, and the vstor2-mntapi10.sys driver into the Windows\system\drivers folder or equivalent.
3
How to Find VADP Components
ESX/ESXi hosts and vCenter Server similarly implement managed objects that support inventory traversal and task requests. Before you write VADP software in Java, you need to download the vSphere Web Services SDK. You can find documentation and ZIP file for download on the VMware Web site.