2/22/2016 VMware KB: Changed Block Tracking (CBT) on virtual machines

Knowledge Base

Changed Block Tracking (CBT) on virtual machines (1020128)

Purpose

Changed Block Tracking (CBT) is a VMware feature that helps perform incremental backups. VMware Data Recovery uses this technology and so can developers of backup and recovery software.

Resolution

Virtual machines running on ESX/ESXi hosts can track disk sectors that have changed. This feature is called Changed Block Tracking (CBT). On many file systems, CBT identifies the disk sectors altered between two
change set IDs. On VMFS partitions, CBT can also identify all the disk sectors that are in use.

Virtual disk block changes are tracked from outside virtual machines, in the virtualization layer. When software performs a backup, it can request transmission of only the blocks that changed since the last backup, or
the blocks in use. The CBT feature can be accessed by third­party applications as part of the vSphere APIs for Data Protection (VADP). Applications call VADP to request that the VMkernel return blocks of data that
have changed on a virtual disk since the last backup snapshot.

For CBT to identify altered disk sectors since the last change ID, these items are required:

The host must be ESX/ESXi 4.0 or later.
The virtual machine owning the disks to be tracked must be hardware version 7 or later.
I/O operations must go through the ESX/ESXi storage stack. So NFS is supported, as is RDM in virtual compatibility mode, but not RDM in physical compatibility mode. VMFS is supported, whether
backed by SAN, iSCSI, or local disk.
CBT must be enabled for the virtual machine (see below).
Virtual machine storage must not be (persistent or non­persistent) independent disk, meaning unaffected by snapshots.

For CBT to identify disk sectors in use with the special "*" change ID, these items are required:

The virtual disk must be located on a VMFS volume, backed by SAN, iSCSI, or local disk.
The virtual machine must have zero (0) snapshots when CBT is enabled, for a clean start.

In some cases, such as a power failure or hard shutdown while virtual machines are powered on, CBT might reset and lose track of incremental changes. In vSphere 4.1 and prior, Cold Migration (but not Storage
vMotion) could reset but not disable CBT. In vSphere 5.x versions earlier to vSphere 5.5 Update 2, storage vMotion resets CBT. For more information, see Changed Block Tracking is reset after a storage vMotion
operation in vSphere 5.x (2048201) (/selfservice/search.do?cmd=displayKC&docType=kc&docTypeID=DT_KB_1_1&externalId=2048201) .

To check if a virtual disk has CBT enabled:

1. Open the vSphere Client and select a powered­off virtual machine.
2. Click Edit > Settings > Options > Advanced/General > Configuration Parameters.
3. The configuration file (.vmx) of the virtual machine contains the entry:

ctkEnabled = "TRUE"  

Note: Set the value to False to disable CBT. For more information, see Enabling Changed Block Tracking (CBT) on virtual machines (1031873) (search.do?cmd=displayKC&externalId=1031873) .

4. For each virtual disk, the .vmx file contains the entry:

scsix:x.ctkEnabled = "TRUE"

5. For each virtual disk and snapshot disk there is a .ctk file. 

For example:

vmname.vmdk
vmname­flat.vmdk
vmname­ctk.vmdk
vmname­000001.vmdk
vmname­000001­delta.vmdk
vmname­000001­ctk.vmdk

Note: After a successful backup and full snapshot consolidation, there should be no snapshot related .ctk  files remaining in the datastore. For example: vmname­000001­ctk.vmdk.

Additional Information

For more information, see the section Changed Block Tracking on Virtual Disks in the Designing vSphere Backup Solutions section of the Virtual Disk API Programming Guide (http://pubs.vmware.com/vsphere­
50/topic/com.vmware.ICbase/PDF/vddk_prog_guide.pdf) .

If you are using VMware Horizon View and linked clone virtual machines, you should not be using CBT. Always ensure that CBT is disabled for the parent virtual machine. For more information, see Deploying or
recomposing View desktops fails when the parent virtual machine has CBT enabled (2032214) (/selfservice/search.do?cmd=displayKC&docType=kc&docTypeID=DT_KB_1_1&externalId=2032214) .

For related Changed Block Tracking articles, see:

Enabling or disabling Changed Block Tracking (CBT) on virtual machines (1031873) (/selfservice/search.do?cmd=displayKC&docType=kc&docTypeID=DT_KB_1_1&externalId=1031873) 
Resetting Changed Block Tracking for VMware vSphere virtual machines (2139574) (/selfservice/search.do?cmd=displayKC&docType=kc&docTypeID=DT_KB_1_1&externalId=2139574) 

https://kb.vmware.com/selfservice/microsites/search.do?language=en_US&cmd=displayKC&externalId=1020128 1/2
2/22/2016 VMware KB: Changed Block Tracking (CBT) on virtual machines

See Also

Enabling or disabling Changed Block Tracking (CBT) on virtual machines (1031873) ( http://kb.vmware.com/kb/1031873)
Deploying or recomposing View desktops fails when the parent virtual machine has CBT enabled (2032214) ( http://kb.vmware.com/kb/2032214)
Changed Block Tracking (CBT) en máquinas virtuales (2035435) ( http://kb.vmware.com/kb/2035435)
Changed Block Tracking (CBT) em máquinas virtuais (2037237) ( http://kb.vmware.com/kb/2037237)
Changed Block Tracking is reset after a storage vMotion operation in vSphere 5.x (2048201) ( http://kb.vmware.com/kb/2048201)
虚拟机上的块修改跟踪 (CBT) (2076678) ( http://kb.vmware.com/kb/2076678)
仮想マシン上の変更ブロックのトラッキング（CBT） (2078744) ( http://kb.vmware.com/kb/2078744)
Resetting Changed Block Tracking for VMware vSphere virtual machines (2139574) ( http://kb.vmware.com/kb/2139574)

Update History

 06/23/2011 ­ Added reference to 1031873.
11/01/2011 ­ Add known caveats, review by VADP core team. 
03/19/2015 ­ Added ESXi 5.5 and ESXi 6.0 to Products. Added note about VMware View Linked Clones to Additional Info section.
  

Request a Product Feature

To request a new product feature or to provide feedback on a VMware product, please visit the Request a Product Feature (http://www.vmware.com/contact/contactus.html?department=prod_request) page.
Permalink to: Changed Block Tracking (CBT) on virtual machines (https://kb.vmware.com/kb/1020128)

Read our blog (http://blogs.vmware.com/kb/)  Watch KBTV (http://blogs.vmware.com/kbtv/)  Follow us (https://twitter.com/vmwarecares)  Request New Content (http://www.vmware.com/landing_pages/knowledgebase­content­

1 (javascript:void( rate(1,this) ))
2 (javascript:void( rate(2,this) ))
3 (javascript:void( rate(3,this) ))
4 (javascript:void( rate(4,this) ))
5 (javascript:void( rate(5,this) ))

84 Ratings 
Actions
Bookmark Document (javascript:addBookmark(actionBoxUtil.docURL, actionBoxUtil.docTitle);)
Print Document (javascript:window.print())
Subscribe to Document (/selfservice/microsites/microsite.do?cmd=displayKC&docType=kc&docTypeID=DT_KB_1_1&externalId=1020128&format=rss)

 (https://www.addthis.com/bookmark.php?v=250&username=xa­4b5f42f36e60a29e) 

KB: 1020128

Updated: Dec 8, 2015
Categories:
Informational
Languages:
English

Product(s):
VMware ESX
VMware ESXi

Product Version(s):
VMware ESX 4.0.x
VMware ESXi 4.0.x Embedded
VMware ESXi 4.0.x Installable
VMware ESXi 4.1.x Embedded
VMware ESXi 4.1.x Installable
VMware ESXi 5.0.x
VMware ESXi 5.1.x
VMware ESXi 5.5.x
VMware ESXi 6.0.x

https://kb.vmware.com/selfservice/microsites/search.do?language=en_US&cmd=displayKC&externalId=1020128 2/2