Virtual Disk API Programming Guide - Documentation - VMware

More documents

Recommendations

Info

Virtual Disk Programming Guide Read and Write VMDK with vSphere WS API Version 2.5 and later of the VMware vSphere WS API contain some useful methods to manage VMDK files. See the managed object type VirtualDiskManager, which contains about a dozen methods similar to those in the Virtual Disk API documented here. If you are interested, navigate to VMware Infrastructure SDK on the Web and click VI API Reference Guide for the 2.5 version or VMware vSphere WS API Reference Guide for the 4.0 version. Click All Types, search for VirtualDiskManager, and follow its link. 56 VMware, Inc.
7 Designing vSphere Backup Solutions 7 This chapter documents how to write backup and restore software for virtual machines running in vSphere, and contains the following sections about the vSphere Storage APIs – Data Protection (VADP): “Design and Implementation Overview” on page 57 “Low Level Backup Procedures” on page 64 “Low Level Restore Procedures” on page 73 “Tips and Best Practices” on page 81 “Windows and Linux Implementations” on page 83 For an overview of backup, and help designing your top‐level program structure, read the first section below. For details about implementing low‐level backup code, read the remaining sections. You should be familiar with virtual machines, snapshots, ESXi, vCenter, and Java. Design and Implementation Overview On vSphere, backups are usually done by taking a snapshot, to efficiency obtain a static image of the virtual machine. Snapshots are a view of a virtual machine at a certain point in time, and enable quick and clean backup operation. Snapshots also provide an incremental backup mechanism called changed block tracking. To back up virtual machines on vSphere, VMware recommends a two‐language solution. First use Java to code the backup program that contacts the host, takes a temporary snapshot, records virtual machine configuration, and (later) deletes the snapshot. Then use C++ or C to code the VDDK program that transfers virtual disk data from the snapshot to backup media. For restore, VMware recommends a two‐language solution. First use Java to code the program that instructs the virtual machine to halt, or re‐creates the target virtual machine from recorded configuration. Then use C or C++ to code the VDDK program that transfers saved data from backup media to virtual disk. The Backup Process These are the high‐level steps to back up a virtual machine running in vSphere: 1 Connect to the ESXi host containing the virtual machine targeted for backup. A side‐effect of this step is determining the arrangement and description of virtual machines on the host. 2 Tell the host to take a snapshot of the target virtual machine, using the vSphere API. The virtual machine continues to run while the snapshot view is static (quiesced). 3 Capture the virtual disk data and virtual machine configuration information (vim.vm.ConfigInfo). 4 On the ESXi host, use the VDDK (programming in C or C++) to open and read the virtual disk and snapshot files. Copy them to backup media, along with configuration information. 5 Tell the host to delete the backup snapshot, using the vSphere API. VMware, Inc. 57
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 and 16: 2 Installing the Development Kit 2
Page 17 and 18: To enable VDDK binaries on Windows
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: To virus scan hosted virtual disk 1
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 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 81 and 82: Restore Fails with Direct Connectio
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

You also want an ePaper? Increase the reach of your titles

Delete template?

Save as template?