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.
Note: In the VDDK 5.5 release, VMware discontinued the Windows installer and 32-bit executables for Windows and Linux. The VDDK is available for 64-bit systems only.

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\VDDK670
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.
    Note: If vstor2 is already installed on a backup proxy, you should first uninstall it with vstor2uninstall.bat (from its corresponding VDDK version) then run the new install script.
  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

    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. On the Download page, choose the binary tar.gz for 64-bit Linux.
  2. Unpack the archive with tar to create the vmware-vix-disklib-distrib subdirectory. 
    $ tar xvzf VMware-vix-disklib-*.tar.gz
  3. Change to the newly created directory to see its subdirectories: 
    $ cd vmware-vix-disklib-distrib; ls
bin64  doc  FILES  include  lib32  lib64

    The bin64 subdirectory contains a reporting program and virtual disk manager. License terms are in the doc/EULA file. The sample program is under doc/samples. Header files in the include subdirectory are for compiling your VDDK applications. Normally the lib64 components are installed under /usr/lib, /usr/lib/vmware-vix-disklib/lib64 for instance.

  4. Install components as needed. You might want to edit your LD_LIBRARY_PATH environment to include the library installation path. Alternatively, you can add the library location to the list in /etc/ld.so.conf and run ldconfig as the superuser.