2/22/2014
`
`VMware KB: Cloning and converting virtual machine disks with vmkfstools
`
`Knowledge Base
`
`Cloning and converting virtual machine disks with vmkfstools (1028042)
`
`Purpose
`
`This article provides information and instructions on the use of the vmkfstools command to convert virtual machine disks from one type to another.
`
`Resolution
`
`The vmkfstools command offers the ability to clone virtual machine content and also convert from one virtual machine disk (.vmdk) format into another.
`Note: The host operating system chosen to perform the conversion may not necessarily support running of virtual machines via the output format defined. vmkfstools maintains the possibility of exporting
`virtual disks for use in other VMware products which support alternative disk formats.
`
`To convert a virtual machine disk from one type to another:
`
`1. Shut down the virtual machine. Virtual machine disk files are locked while in-use by a running virtual machine.
`2. Log into the VMware vSphere Management Assistant (vMA). Alternatively, open a command-line interface after deploying the VMware vSphere CLI (vCLI). If terminal access is required:
`For VMware ESX 4.x and 3.x, log in via the terminal or SSH. For additional information, see Connecting to an ESX host using a SSH client (1019852) (http://kb.vmware.com/kb/1019852) .
`For VMware ESXi 4.1 and ESXi 5.x, see Using Tech Support Mode in ESXi 4.1 and ESXi 5.0 (1017910) (search.do?cmd=displayKC&docType=kc&docTypeID=DT_KB_1_1&externalId=1017910) .
`For VMware ESXi 4.0 and 3.x, see Tech Support Mode for Emergency Support (1003677) (http://kb.vmware.com/kb/1003677) .
`
`3. Run the following vmkfstools command to clone the disk from one format to another:
`From the ESX/ESXi terminal:
`
`vmkfstools -i input output -d format -a adaptertype
`
`From vMA/vCLI:
`
`vmkfstools --server <vCenter or ESX IP/Hostname> -i input output -d format -a adaptertype
`For example, to clone examplevm.vmdk from Datastor to Datastor 2 and thin-provision the destination copy:
`From the ESX/ESXi terminal:
`
`vmkfstools -i "/vmfs/volumes/Datastore/examplevm/examplevm.vmdk" "/vmfs/volumes/Datastore 2/newexamplevm/newexamplevm.vmdk" -d
`thin -a buslogic
`
`From vMA/vCLI:
`
`vmkfstools --server 10.21.49.14 -i '[Datastore] examplevm/examplevm.vmdk' '[Datastore 2] newexamplevm/newexamplevm.vmdk' -d thin
`-a buslogic
`
`Warning: If virtual machine snapshots or delta disks are present, ensure that the source chosen is the current snapshot delta disk. Failing to do so will result in an outdated destination copy. However, when using
`the command, the corresponding descriptor file for the latest delta disk needs to be used when cloning the disk.
`
`For example to clone and/or convert virtual machine disk with snapshot (otherwise known as a delta disk), examplevm-000001.vmdk and like above, from Datastore to Datastore 2 , with a
`thin-provisioned destination copy, run this command:
`From the ESX/ESXi terminal:
`
`vmkfstools -i "/vmfs/volumes/Datastore/examplevm/examplevm-000001.vmdk" "/vmfs/volumes/Datastore
`2/newexamplevm/newexamplevm.vmdk" -d thin -a buslogic
`From vMA/vCLI:
`
`vmkfstools --server 10.21.49.14 -i '[Datastore] examplevm/examplevm-000001.vmdk' '[Datastore 2] newexamplevm/newexamplevm.vmdk'
`-d thin -a buslogic
`Note the selection of examplevm-000001.vmdk , as opposed to examplevm.vmdk for the input file. Snapshot delta disk files are appended a sequencing number, differentiating one snapshot delta
`disk iteration or level from another. Selecting the most recent delta disk will ensure that the most recently stored data is cloned to the destination.
`Note: Running the vmkfstools -i command creates a cloned drive with an LSI controller, even if the source disk is using VMware Paravirtual. This results in the virtual machine failing to boot. To resolve
`this issue, change the controller type to the same as the source.
`
`For steps to identify a virtual machine's current snapshot, see Confirming a virtual machine's snapshot delta disk layout (1027887) (http://kb.vmware.com/kb/1027887) .
`
`Additional Information
`
`Commonly-used disk format options for vmkfstools:
`zeroedthick
`
`This is the default option for virtual machine disks created and stored on a VMFS datastore.
`
`http://kb.vmware.com/selfservice/microsites/search.do?language=en_US&cmd=displayKC&externalId=1028042
`
`1/3
`
`
`
`VMware KB: Cloning and converting virtual machine disks with vmkfstools
`
`Knowledge Base
`
`Cloning and converting virtual machine disks with vmkfstools (1028042)
`
`Purpose
`
`This article provides information and instructions on the use of the vmkfstools command to convert virtual machine disks from one type to another.
`
`Resolution
`
`The vmkfstools command offers the ability to clone virtual machine content and also convert from one virtual machine disk (.vmdk) format into another.
`Note: The host operating system chosen to perform the conversion may not necessarily support running of virtual machines via the output format defined. vmkfstools maintains the possibility of exporting
`virtual disks for use in other VMware products which support alternative disk formats.
`
`To convert a virtual machine disk from one type to another:
`
`1. Shut down the virtual machine. Virtual machine disk files are locked while in-use by a running virtual machine.
`2. Log into the VMware vSphere Management Assistant (vMA). Alternatively, open a command-line interface after deploying the VMware vSphere CLI (vCLI). If terminal access is required:
`For VMware ESX 4.x and 3.x, log in via the terminal or SSH. For additional information, see Connecting to an ESX host using a SSH client (1019852) (http://kb.vmware.com/kb/1019852) .
`For VMware ESXi 4.1 and ESXi 5.x, see Using Tech Support Mode in ESXi 4.1 and ESXi 5.0 (1017910) (search.do?cmd=displayKC&docType=kc&docTypeID=DT_KB_1_1&externalId=1017910) .
`For VMware ESXi 4.0 and 3.x, see Tech Support Mode for Emergency Support (1003677) (http://kb.vmware.com/kb/1003677) .
`
`3. Run the following vmkfstools command to clone the disk from one format to another:
`From the ESX/ESXi terminal:
`
`vmkfstools -i input output -d format -a adaptertype
`
`From vMA/vCLI:
`
`vmkfstools --server <vCenter or ESX IP/Hostname> -i input output -d format -a adaptertype
`For example, to clone examplevm.vmdk from Datastor to Datastor 2 and thin-provision the destination copy:
`From the ESX/ESXi terminal:
`
`vmkfstools -i "/vmfs/volumes/Datastore/examplevm/examplevm.vmdk" "/vmfs/volumes/Datastore 2/newexamplevm/newexamplevm.vmdk" -d
`thin -a buslogic
`
`From vMA/vCLI:
`
`vmkfstools --server 10.21.49.14 -i '[Datastore] examplevm/examplevm.vmdk' '[Datastore 2] newexamplevm/newexamplevm.vmdk' -d thin
`-a buslogic
`
`Warning: If virtual machine snapshots or delta disks are present, ensure that the source chosen is the current snapshot delta disk. Failing to do so will result in an outdated destination copy. However, when using
`the command, the corresponding descriptor file for the latest delta disk needs to be used when cloning the disk.
`
`For example to clone and/or convert virtual machine disk with snapshot (otherwise known as a delta disk), examplevm-000001.vmdk and like above, from Datastore to Datastore 2 , with a
`thin-provisioned destination copy, run this command:
`From the ESX/ESXi terminal:
`
`vmkfstools -i "/vmfs/volumes/Datastore/examplevm/examplevm-000001.vmdk" "/vmfs/volumes/Datastore
`2/newexamplevm/newexamplevm.vmdk" -d thin -a buslogic
`From vMA/vCLI:
`
`vmkfstools --server 10.21.49.14 -i '[Datastore] examplevm/examplevm-000001.vmdk' '[Datastore 2] newexamplevm/newexamplevm.vmdk'
`-d thin -a buslogic
`Note the selection of examplevm-000001.vmdk , as opposed to examplevm.vmdk for the input file. Snapshot delta disk files are appended a sequencing number, differentiating one snapshot delta
`disk iteration or level from another. Selecting the most recent delta disk will ensure that the most recently stored data is cloned to the destination.
`Note: Running the vmkfstools -i command creates a cloned drive with an LSI controller, even if the source disk is using VMware Paravirtual. This results in the virtual machine failing to boot. To resolve
`this issue, change the controller type to the same as the source.
`
`For steps to identify a virtual machine's current snapshot, see Confirming a virtual machine's snapshot delta disk layout (1027887) (http://kb.vmware.com/kb/1027887) .
`
`Additional Information
`
`Commonly-used disk format options for vmkfstools:
`zeroedthick
`
`This is the default option for virtual machine disks created and stored on a VMFS datastore.
`
`http://kb.vmware.com/selfservice/microsites/search.do?language=en_US&cmd=displayKC&externalId=1028042
`
`1/3
`
`
`
`2/22/2014
`
`thin
`
`VMware KB: Cloning and converting virtual machine disks with vmkfstools
`
`This is the default option for virtual machine disks stored on an NFS datastore. It allocates and commits space on demand, growing as more virtual disk space is used.
`
`Note: The configured size of thin-provisioned disks is correctly displayed using the ls command. The disk space consumed by disk files on a datastore is determined using the du command.
`
`eagerzeroedthick
`
`This is a specified format required for cross-host virtual machine clustering and VMware Fault Tolerance (FT) virtual machines. All blocks for the virtual machine disk are allocated and committed with
`written zeroes at the time of creation. Existing disks can be inflated to this format without destroying existing data. For more information, see Enabling clustering features for an existing virtual disk by
`converting in place (1035823) (search.do?cmd=displayKC&docType=kc&docTypeID=DT_KB_1_1&externalId=1035823) and Enabling clustering features for an existing virtual disk by converting while copying (1003491) (search.do?
`cmd=displayKC&docType=kc&docTypeID=DT_KB_1_1&externalId=1003491) .
`
`rdmp
`
`This is the default Raw Device Mapping format with Physical compatibility mode. Most SCSI commands are passed-through to the guest operating system to/from a mapped physical raw LUN. This is
`required for cross-host virtual machine clustering; both virtual machines share the same mapping file. This format does not support virtual machine snapshots. For more information, see (search.do?
`cmd=displayKC&docType=kc&docTypeID=DT_KB_1_1&externalId=3443266) Converting a virtual disk into a Raw Device Mapping (3443266) (search.do?cmd=displayKC&docType=kc&docTypeID=DT_KB_1_1&externalId=3443266) .
`
`rdm
`
`This is an additional available Raw Device Mapping format with virtual compatibility mode set. A subset of SCSI commands are passed-through to the guest operating system to/from a mapped physical
`raw LUN. An added benefit of this format is the support of virtual machine snapshots. For more information, see (search.do?cmd=displayKC&docType=kc&docTypeID=DT_KB_1_1&externalId=3443266) Converting a virtual disk
`into a Raw Device Mapping (3443266) (search.do?cmd=displayKC&docType=kc&docTypeID=DT_KB_1_1&externalId=3443266) .
`
`2gbsparse
`
`This format is compatible with Hosted (desktop) products such as VMware Fusion, Player, Server, Workstation, etc. Virtual machine disks are spanned across several 2GB extents to eliminate potential
`cross-platform file system compatibility issues. For example, FAT32 supports a maximum file size of 4GB. This format is not supported for running virtual machines in VMware ESX/ESXi 4.x and ESXi
`5.x.
`Additional information, types, and parameters are available in the vmkfstools manual pages and product documentation (http://www.vmware.com/support/pubs/) .
`Review the manual pages on VMware ESX 3.x and 4.x by running: man vmkfstools
`Review command information on ESXi 3.x and 4.x hosts or vMA and vCLI by running: vmkfstools --help
`For much more information, review Appendix C: Using vmkfstools from the ESX Configuration Guide in the product documentation (http://www.vmware.com/support/pubs/) pages for your respective version of
`VMware ESX/ESXi.
`
`See Also:
`
`Converting a virtual IDE disk to a virtual SCSI disk (1016192) (search.do?cmd=displayKC&docType=kc&docTypeID=DT_KB_1_1&externalId=1016192)
`
`See Also
`
`Enabling clustering features for an existing virtual disk by converting while copying (javascript:openDocumentLink('1003491',''))
`Determining if there are leftover delta files or snapshots that VMware vSphere or Infrastructure Client cannot detect (javascript:openDocumentLink('1005049',''))
`Converting a virtual IDE disk to a virtual SCSI disk (javascript:openDocumentLink('1016192',''))
`Using Tech Support Mode in ESXi 4.1 and ESXi 5.x (javascript:openDocumentLink('1017910',''))
`Cloning individual virtual machine disks via the ESX/ESXi host terminal (javascript:openDocumentLink('1027876',''))
`Enabling clustering features for an existing virtual disk by converting in place (javascript:openDocumentLink('1035823',''))
`Clonar y convertir el formato de discos de máquinas virtuales usando vmkfstools (javascript:openDocumentLink('2000993',''))
`Cómo clonar y convertir discos de máquinas virtuales con vmkfstools (javascript:openDocumentLink('2016869',''))
`Clonagem e conversão de discos de máquinas virtuais com vmkfstools (javascript:openDocumentLink('2018868',''))
`Converting a virtual disk into a Raw Device Mapping (javascript:openDocumentLink('3443266',''))
`
`Update History
`
` 11/21/2013 - Added ESXi 5.5 to Products
`
`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: Cloning and converting virtual machine disks with vmkfstools (http://kb.vmware.com/kb/1028042)
`
`Watch KBTV (http://blogs.vmware.com/kbtv/)
`
`Follow us (http://www.twitter.com/vmwarekb)
`
`Request New Content (http://www.vmware.com/landing_pages/knowledgebase-content-
`
`Read our blog (http://blogs.vmware.com/kb/)
`request.html)
`
`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) ))
`
`59 Ratings
`Actions
`Bookmark Document (javascript:addBookmark(actionBoxUtil.docURL, actionBoxUtil.docTitle);)
`Email Document (javascript:emailDoc(actionBoxUtil.extId, actionBoxUtil.sliceId, actionBoxUtil.docTitle, actionBoxUtil.cpplayer, actionBoxUtil.bbid))
`
`http://kb.vmware.com/selfservice/microsites/search.do?language=en_US&cmd=displayKC&externalId=1028042
`
`2/3
`
`
`
`2/22/2014
`
`VMware KB: Cloning and converting virtual machine disks with vmkfstools
`
`Print Document (javascript:window.print())
`Subscribe to Document (/selfservice/microsites/microsite.do?cmd=displayKC&docType=kc&docTypeID=DT_KB_1_1&externalId=1028042&format=rss)
`
` (http://www.addthis.com/bookmark.php?v=250&username=xa-4b5f42f36e60a29e)
`
`KB: 1028042
`
`Updated: Nov 20, 2013
`Categories:
`How to
`Languages:
`English
`
`Product(s):
`VMware ESX
`VMware ESXi
`VMware vSphere CLI
`VMware vSphere Management Assistant
`
`Product Version(s):
`VMware ESX 3.0.x
`VMware ESX 3.5.x
`VMware ESX 4.0.x
`VMware ESX 4.1.x
`VMware ESXi 3.5.x Embedded
`VMware ESXi 3.5.x Installable
`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 vSphere CLI 4.0
`VMware vSphere CLI 5.0
`VMware vSphere Management Assistant 4.0
`VMware vSphere Management Assistant 5.0
`VMware vSphere Management Assistant 5.1
`
`http://kb.vmware.com/selfservice/microsites/search.do?language=en_US&cmd=displayKC&externalId=1028042
`
`3/3
`
`
Accessing this document will incur an additional charge of $.
After purchase, you can access this document again without charge.
Accept $ Charge
Still Working On It
This document is taking longer than usual to download. This can happen if we need to contact the court directly to obtain the document and their servers are running slowly.
Give it another minute or two to complete, and then try the refresh button.
A few More Minutes ... Still Working
It can take up to 5 minutes for us to download a document if the court servers are running slowly.
Thank you for your continued patience.
This document could not be displayed.
We could not find this document within its docket. Please go back to the docket page and check the link. If that does not work, go back to the docket and refresh it to pull the newest information.
Your account does not support viewing this document.
You need a Paid Account to view this document. Click here to change your account type.
Your account does not support viewing this document.
Set your membership
status to view this document.
With a Docket Alarm membership, you'll
get a whole lot more, including:
- Up-to-date information for this case.
- Email alerts whenever there is an update.
- Full text search for other cases.
- Get email alerts whenever a new case matches your search.
One Moment Please
The filing “” is large (MB) and is being downloaded.
Please refresh this page in a few minutes to see if the filing has been downloaded. The filing will also be emailed to you when the download completes.
Your document is on its way!
If you do not receive the document in five minutes, contact support at support@docketalarm.com.
Sealed Document
We are unable to display this document, it may be under a court ordered seal.
If you have proper credentials to access the file, you may proceed directly to the court's system using your government issued username and password.
Access Government Site
