Virtual Disk API Programming Guide - Documentation - VMware

More documents

Recommendations

Info

Virtual Disk Programming Guide See the VDDK Release Notes for specific versions, which change over time. Hosted products including VMware Workstation are neither tested nor supported. Storage Device Support VMware Consolidated Backup (VCB) had knowledge base article http://kb.vmware.com/kb/1007479 showing the support matrix for storage devices and multipathing. VMware does not provide a similar support matrix for VDDK and VADP. Customers must get this information from you, their backup software vendor. Installing the VDDK Package The VDDK is packaged as an executable installer for Windows, including 64‐bit libraries, or a compressed archive for Linux, with separate 32‐bit and 64‐bit packages. It includes 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 and sample program in the doc directory. To install the package on Windows 1 On the Download page, choose the binary .exe for Windows and download it to your desktop. 2 Run or double‐click the downloaded .exe installer. 3 Follow the on‐screen instructions. To unpack Windows 64-bit Libraries 1 Install VDDK on Windows as above. 2 Find vddk64.zip in the install directory, which by default is: C:\Program Files\VMware\VMware Virtual Disk Development Kit\bin 3 Unzip this into a location of your choice, taking care not to overwrite any existing files. Do not select the above bin directory as the extraction target! 4 You should see bin and lib directories. You can build your VixDiskLib and VixMntapi code against these. Be sure to add the bin directory to the Path when you run your binary. To Install the package on Linux 1 On the Download page, choose the binary tar.gz for either 32‐bit Linux or 64‐bit Linux. 2 Unpack the archive, which creates the vmware-vix-disklib-distrib subdirectory. tar xvzf VMware-vix-disklib.*.tar.gz 3 Change to that directory and run the installation script as the superuser: 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 need to edit your LD_LIBRARY_PATH environment to include the library installation path, /usr/lib/vmware-vix-disklib/lib32 (or 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” on page 14, partners can sign a license agreement to redistribute VDDK binaries that support VADP applications. 16 VMware, Inc.
To enable VDDK binaries on Windows virtual machines without VDDK installed Installing the Development Kit 1 Install the Microsoft Visual C++ (MSVC) redistributable, possibly as a merge module. The latest MSVC runtime works as side‐by‐side component, so manually copying it might not work on Vista. See details on the Microsoft Web site for the redistributable package, x86 processors or x64 processors. Side‐by‐side is also explained on the Microsoft Web site. 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\system32\drivers folder or equivalent. 3 Create and install your application, compiled in a manner similar to the vixDiskLibSample.exe code, discussed in Chapter 5, “Virtual Disk API Sample Code,” on page 43. 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. VMware, Inc. 17
Page 1 and 2: Virtual Disk Programming Guide Virt
Page 3 and 4: Contents About This Book 9 1 Introd
Page 5 and 6: Algorithm for vSphere Backup 39 Bes
Page 7 and 8: Restoring Virtual Disk Data 80 Raw
Page 9 and 10: About This Book The VMware ® Virtu
Page 11 and 12: 1 Introduction to the Virtual Disk
Page 13 and 14: Write to virtual disk, enabling off
Page 15: 2 Installing the Development Kit 2
Page 19 and 20: 3Vi Virtual Disk Interfaces 3 VMwar
Page 21 and 22: Thin Provisioned Disk Virtual Disk
Page 23 and 24: Adapter Types The library can selec
Page 25 and 26: Table 3-2. VMFS-3 Block Size for Ho
Page 27 and 28: 4Vi Virtual Disk API Functions 4 Th
Page 29 and 30: Initialize the Library Virtual Disk
Page 31 and 32: Free Memory from Get Information Vi
Page 33 and 34: Virtual Disk API Functions After yo
Page 35 and 36: Change the Parent for a Disk Virtua
Page 37 and 38: Location of Log Files Virtual Disk
Page 39 and 40: Clean Up After Disconnect Virtual D
Page 41 and 42: Virtual Disk API Functions IMPORTAN
Page 43 and 44: 5Vi Virtual Disk API Sample Code 5
Page 45 and 46: Virtual Disk API Sample Code The sa
Page 47 and 48: Virtual Disk API Sample Code If you
Page 49 and 50: 6Vi Practical Programming Tasks 6 T
Page 51 and 52: Creating Remote Disk Practical Prog
Page 53 and 54: To re-create data for any given day
Page 55 and 56: To virus scan hosted virtual disk 1
Page 57 and 58: 7 Designing vSphere Backup Solution
Page 59 and 60: Managed Object References Designing
Page 61 and 62: Designing vSphere Backup Solutions
Page 67 and 68:
"summary.config", "snapshot", "conf
Page 69 and 70:
Designing vSphere Backup Solutions
Page 71 and 72:
Page 73 and 74:
Checking for Namespace Designing vS
Page 75 and 76:
dynamicType = , operation = "add",
Page 77 and 78:
changeId = , parent = (vim.vm.devic
Page 79 and 80:
Page 81 and 82:
Restore Fails with Direct Connectio
Page 83 and 84:
Page 85 and 86:
Page 87 and 88:
A Virtual Disk Mount API A As of th
Page 89 and 90:
VixMntapi_OpenDiskSet() Virtual Dis
Page 91 and 92:
VixMntapi_FreeOsInfo() Frees memory
Page 93 and 94:
Sample VixMntapi Code Virtual Disk
Page 95 and 96:
B Errors Codes and Open Source B Th
Page 97 and 98:
Glossary D differential backup Savi
Page 99 and 100:
Index Numerics 32-bit and 64-bit 12
show all

Virtual Disk API Programming Guide - Documentation - VMware

Create successful ePaper yourself

Delete template?

Save as template?