Loading

×Sorry to interrupt
CSS Error

Refresh

My Subscriptions

Loading

Knowledge Base

Recreating a missing virtual disk (VMDK) descriptor file for delta disks (1026353)

Last Updated: 2/16/2014Categories: How toTotal Views: 166322Language:
Chinese (Simplified)JapaneseEnglish

13 like this article

Subscribe to get an email
newsletter with new updates

13 people found this helpful Please provide article feedback:

Purpose

This article provides steps to recreate a delta virtual disk's descriptor file, based on the vmfsSparse disk format. This disk format is often facilitated by virtual machine snapshot functionality, live virtual machine clone operations, and Storage vMotion.

THE CONTENT OF THIS ARTICLE IS PROVIDED "AS-IS," AND TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW, VMWARE DISCLAIMS ALL OTHER REPRESENTATIONS AND WARRANTIES, EXPRESS OR IMPLIED, REGARDING THIS CONTENT, INCLUDING THEIR FITNESS FOR A PARTICULAR PURPOSE, THEIR MERCHANTABILITY, OR THEIR NONINFRINGEMENT. VMWARE SHALL NOT BE LIABLE FOR ANY DAMAGES ARISING OUT OF OR IN CONNECTION WITH THE USE OF THIS CONTENT, INCLUDING DIRECT, INDIRECT, CONSEQUENTIAL DAMAGES, LOSS OF BUSINESS PROFITS OR SPECIAL DAMAGES, EVEN IF VMWARE HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.

Resolution

A disk file of this type consists of a virtual disk descriptor file and paired delta extent file. These data files are based on the vmfsSparse format, intended to store delta content or "change data" for a period of time, otherwise known as a snapshot.

Notes:

For more information about virtual machine disk formats, see the Additional Information section in this article.

For more information on delta disk files and snapshots, see Understanding virtual machine snapshots in VMware ESXi and ESX (1015180).

To recreate a missing virtual disk (VMDK) descriptor file for delta disks:

Confirm if the virtual machine directory contains either another delta disk descriptor file, or a base disk's descriptor, for use as a basis or template. For example, you will see some or all of these files in the virtual machine directory:

drwxr-xr-x 1 root root 1400 Aug 16 09:39 .
drwxr-xr-t 1 root root 2520 Aug 16 09:32 ..
-rw------- 1 root root 32768 Aug 17 19:11 examplevm-000002-delta.vmdk
-rw------- 1 root root 32768 Aug 17 19:11 examplevm-000002.vmdk
-rw------- 1 root root 32768 Aug 16 14:39 examplevm-000001-delta.vmdk
-rw------- 1 root root 32768 Aug 16 14:39 examplevm-000001.vmdk
-rw------- 1 root root 16106127360 Aug 16 09:32 examplevm-flat.vmdk
-rw------- 1 root root 469 Aug 16 09:32 examplevm.vmdk
-rw------- 1 root root 18396 Aug 16 14:39 examplevm-Snapshot1.vmsn
-rw------- 1 root root 18396 Aug 17 19:11 examplevm-Snapshot2.vmsn
-rw------- 1 root root 397 Aug 16 09:39 examplevm.vmsn
-rwxr-xr-x 1 root root 1626 Aug 16 09:39 examplevm.vmx
-rw------- 1 root root 259 Aug 16 09:36 examplevm.vmxf

Notes:

Items highlighted in red are descriptor files which are ideally used as a template or base, if they are present.

If you are missing the base disk's descriptor file (or examplevm.vmdk), see Recreating a missing virtual machine disk (VMDK) descriptor file (1002511).

If you have additional delta files with intact descriptor files, you may copy one of them for use as a template. Alternatively, copy the base disk descriptor file, or use the right-most example in the table below and customize the copied content.

Warning: Ensure that character encoding for any files modified outside of an ESXi/ESX host console or SSH session conform to UTF-8. For more information, see the Preferred Editors section in Editing configuration files in VMware ESXi and ESX (1017022). Unsupported encoding results in failure to start the virtual machine.

For ESXi 5.0 and later, virtual machines have their delta files in the same directory as the disk they relate to. For more information on this change, see Changing the location of snapshot delta files for virtual machines in ESXi 5.0 (2007563)

For example, a virtual machine with two disks each on different datastores:

The first disk (disk.vmdk) is located on datastore1

The second disk (disk_1.vmdk) is located on datastore2

After taking a snapshot, the delta file for the first disk (disk-000001.vmdk) will be stored on datastore1, and the delta file for the second disk (disk_1-000001.vmdk) will be stored on datastore2.

Assume that the descriptor file for the delta disk examplevm-000001.vmdk is missing and that there are no issues with its associated delta file examplevm-000001-delta.vmdk.

To recreate the delta descriptor file, copy the current base disk descriptor file examplevm.vmdk with the name of the missing descriptor file examplevm-000001.vmdk:

# cp examplevm.vmdk examplevm-000001.vmdk

We can simply edit this new snapshot delta descriptor file to change its format from a base disk descriptor to a snapshot delta disk descriptor.

Modify the new examplevm-000001.vmdk delta descriptor file to contain this information:

Base disk descriptor file examplevm.vmdk

Recreated delta descriptor examplevm-000001.vmdk (originally copied from examplevm.vmdk)

# Disk DescriptorFile
version=1
encoding="UTF-8"
CID=19741890
parentCID=ffffffff
createType="vmfs"

# Extent description
RW 31457280 VMFS "examplevm-flat.vmdk"

# The Disk Data Base
#DDB

ddb.virtualHWVersion = "7"
ddb.longContentID = "5fd87dda1dc77cafd5be
881a19741890"
ddb.uuid = "60 00 C2 9e 3d 8d 45 82-dd 1f e4 93 22 da 9c 61"
ddb.geometry.cylinders = "1958"
ddb.geometry.heads = "255"
ddb.geometry.sectors = "63"
ddb.adapterType = "lsilogic"

# Disk DescriptorFile
version=1
encoding="UTF-8"
CID=7f3a1e17
parentCID=19741890
createType="vmfsSparse"
parentFileNameHint="examplevm.vmdk"

# Extent description
RW 31457280 VMFSSPARSE "examplevm-000001-delta.vmdk"

# The Disk Data Base
#DDB

ddb.longContentID = "5fd87dda1dc77cafd5be
881a19741890"

Notes:

If you are creating the snapshot descriptor file from the the base disk description make sure that you change the entry from VMFS to VMFSSPARSE.

If the base disk is greater than 2 TB (2 TB+ only supported in ESXi 5.5) in size, these changes are required:

createType="vmfsSparse" replaced with createType="seSparse"

VMFSSPARSE under Extent Description replaced with SESPARSE

examplevm-000001-delta.vmdk replaced with examplevm-000001-sesparse.vmdk

CID and parentCID values are Content Identifiers (CID). For more information on the CID and how to correct CID mismatch errors, see Resolving the CID mismatch error: The parent virtual disk has been modified since the child was created (1007969).

The recreated file requires use of the CID value from its parent. Update CID value with a random value. In the example above, examplevm.vmdk was the parent. Thus, the CID from examplevm.vmdk (the parent) matches the parentCID value from examplevm-000001.vmdk (the child).

If there are other child delta disks present, such as examplevm-000002.vmdk (not shown in the example above), review the parentCID for the child and ensure it matches the CID parameter of your recreated descriptor file.

Delta disks are in the vmfsSparse format; specify this for the createType parameter.

Set the parentFileNameHint to the parent virtual disk file. This contains a virtual machine base disk or a delta descriptor's file name.

Determining this may not be an immediately clear or simple process, depending on the information available.

Refer to the relevant vmware.log file(s) for the virtual machine when it last successfully started to determine the opening sequence of individual disk files:

vmx| DISK: OPEN scsi0:0 '/vmfs/volumes/4b96afb0-b2474ede-fc0b-001aa004abc2/examplevm/examplevm-000003.vmdk' persistent R[]
vmx| DISKLIB-VMFS : "/vmfs/volumes/4b96afb0-b2474ede-fc0b-001aa004abc2/examplevm/examplevm-000003-delta.vmdk" : open successful (10) size = 32768, hd = 65613. Type 8
vmx| DISKLIB-DSCPTR: Opened [0]: "examplevm-000003-delta.vmdk" (0xa)
vmx| DISKLIB-LINK : Opened '/vmfs/volumes/4b96afb0-b2474ede-fc0b-001aa004abc2/examplevm/examplevm-000003.vmdk' (0xa): vmfsSparse, 31457280 sectors / 15 GB.
vmx| DISKLIB-VMFS : "/vmfs/volumes/4b96afb0-b2474ede-fc0b-001aa004abc2/examplevm/examplevm-000002-delta.vmdk" : open successful (14) size = 32768, hd = 65614. Type 8
vmx| DISKLIB-DSCPTR: Opened [0]: "examplevm-000002-delta.vmdk" (0xe)
vmx| DISKLIB-LINK : Opened '/vmfs/volumes/4b96afb0-b2474ede-fc0b-001aa004abc2/examplevm/examplevm-000002.vmdk' (0xe): vmfsSparse, 31457280 sectors / 15 GB.
vmx| DISKLIB-VMFS : "/vmfs/volumes/4b96afb0-b2474ede-fc0b-001aa004abc2/examplevm/examplevm-000001-delta.vmdk" : open successful (14) size = 32768, hd = 65615. Type 8
vmx| DISKLIB-DSCPTR: Opened [0]: "examplevm-000001-delta.vmdk" (0xe)
vmx| DISKLIB-LINK : Opened '/vmfs/volumes/4b96afb0-b2474ede-fc0b-001aa004abc2/examplevm/examplevm-000001.vmdk' (0xe): vmfsSparse, 31457280 sectors / 15 GB.
vmx| DISKLIB-VMFS : "/vmfs/volumes/4b96afb0-b2474ede-fc0b-001aa004abc2/examplevm/examplevm-flat.vmdk" : open successful (14) size = 16106127360, hd = 65616. Type 3
vmx| DISKLIB-DSCPTR: Opened [0]: "examplevm.vmdk" (0xe)
vmx| DISKLIB-LINK : Opened '/vmfs/volumes/4b96afb0-b2474ede-fc0b-001aa004abc2/examplevm/examplevm.vmdk' (0xe): vmfs, 31457280 sectors / 15 GB.
vmx| DISKLIB-CHAINESX : ChainESXOpenSubChain: numLinks = 4, numSubChains = 1
vmx| DISKLIB-LIB : Opened "/vmfs/volumes/4b96afb0-b2474ede-fc0b-001aa004abc2/examplevm/examplevm-000003.vmdk" (flags 0xa).
vmx| DISK: OPEN '/vmfs/volumes/4b96afb0-b2474ede-fc0b-001aa004abc2/examplevm/examplevm-000003.vmdk' Geo (1958/255/63) BIOS Geo (0/0/0)

The parts highlighted in blue are the fundamental configuration parameters used in the virtual machine's virtual disk descriptor files. The layout of a virtual disk tree can be determined using the same log file, based on the sequence and timeline of files opened. In this example:

One disk for the virtual machine, SCSI 0:0, was opened. The file specified was examplevm-000003.vmdk.

This disk had a parent, and referenced examplevm-000002.vmdk. This also had a parent and referenced examplevm-000001.vmdk.

An intermediary disk file itself, it referenced examplevm.vmdk as its parent. This was the base disk for the virtual machine.

If there are no log files available, the creation or modification dates for the files in the directory may be considered when establishing delta disk ordering.

Reviewing the descriptor files for each of the remaining virtual machine delta disks will also shed light on the virtual machine's existing layout.

Warning: These files are not always ordered numerically. Incorrectly ordering the disk files can cause severe file system corruption in the guest operating system and/or trigger CID mismatch conditions when the virtual machine is powered on. If in doubt, stop and contact VMware Technical Support to file a support request. For more information, see Filing a Support Request in Customer Connect (2006985).

The Extent description specifies the corresponding data file containing the virtual machine disk's data:

RW 31457280 VMFS "examplevm-flat.vmdk"

The RW number is the number of 512-Byte sectors (or "sector count") for the extent or disk file. A base disk's RW value is used throughout the chain of delta disks attached to it; no child virtual disk files should deviate from the defined number and will contain the same value.

The DDB section, unlike base disk descriptor files, does not contain geometry information. Only a long content ID is used (which pertains to ESX 4.x virtual machines and newer):

ddb.longContentID = "5fd87dda1dc77cafd5be881a19741890"

This value also matches the parent disks (and base) associated to the delta virtual disk. Do not include geometry information for the delta disk descriptor files.

Related Information

For high to low-level information on virtual disks, see VMware Virtual Disks: Virtual Disk Format 5.0.

Recreating a missing virtual machine disk descriptor file
"The parent virtual disk has been modified since the child was created" error
Understanding VM snapshots in ESXi / ESX
Editing configuration files in VMware ESXi and ESX
How to file a Support Request in Customer Connect
Changing the location of snapshot delta files for virtual machines in ESXi 5.x
差分ディスクの失われた仮想ディスク (VMDK) 記述子ファイルを再度作成する
为增量磁盘重新创建丢失的虚拟磁盘 (VMDK) 描述符文件

Detectable by VMware SkylineTM

Actions

Copy

link to clipboard
copied!

Print

Language:
Chinese (Simplified)JapaneseEnglish

Attachments

Additional Resources

KB
•
End Of General Availability of the Free vSphere Hypervisor (ESXi 7.x and 8.x) (2107518)

Result 1 of 1

Ask The Community

Get answers quickly from VMware experts in the community

Post Subject

CONTINUE IN COMMUNITIES

Related Products:

Related Versions:

Take Our Survey

Cookie Preference Center

General Information on cookies

General Information on cookies

When you visit our website, we use cookies to ensure that we give you the best experience. This information does not usually directly identify you, but it can give you a more personalized web experience. Because we respect your right to privacy, you can choose not to allow some types of cookies by clicking on the different category headings to find out more and change your settings. However, blocking some types of cookies may impact your experience on the site and the services we are able to offer. Further information can be found in our

Cookie Policy.

Strictly Necessary

Strictly Necessary

Always Active

Strictly Necessary

Strictly necessary cookies are always enabled since they are essential for our website to function. They enable core functionality such as security, network management, and website accessibility. You can set your browser to block or alert you about these cookies, but this may affect how the website functions. For more information please visit www.aboutcookies.org or www.allaboutcookies.org.

Cookie Details‎

Performance

Performance

Performance

Performance cookies are used to analyze the user experience to improve our website by collecting and reporting information on how you use it. They allow us to know which pages are the most and least popular, see how visitors move around the site, optimize our website and make it easier to navigate.

Cookie Details‎

Please confirm your settings by refreshing the page.

Functional

Functional

Functional

Functional cookies help us keep track of your past browsing choices so we can improve usability and customize your experience. These cookies enable the website to remember your preferred settings, language preferences, location and other customizable elements such as font or text size. If you do not allow these cookies, then some or all of these services may not function properly.

Cookie Details‎

Please confirm your settings by refreshing the page.

Advertising

Advertising

Advertising

Advertising cookies are used to send you relevant advertising and promotional information. They may be set through our site by third parties to build a profile of your interests and show you relevant advertisements on other sites. These cookies do not directly store personal information, but their function is based on uniquely identifying your browser and internet device.

Cookie Details‎

Please confirm your settings by refreshing the page.

Advertising Cookies

Consent Leg.Interest

Select All Vendors

Select All Vendors

Select All Hosts

Select All

Clear Filters

Information storage and access

Apply

Confirm My Choices Reject All Allow All

Support Assistant